IdeaPlugins Callback — Documentation

Overview

IdeaPlugins Callback is a WordPress callback-request widget for businesses that want visitors to ask for a phone call. It works without WooCommerce and can automatically capture page context; when WooCommerce is active, product-page context is also recorded.

Quick start: use Display for visibility and placement, Form for visitor-facing content and fields, Appearance for visual styling, Popup for popup behavior, and Advanced for notifications, spam protection and developer controls.

Display modes

Left Side — floating vertical trigger on the left edge.
Right Side — floating vertical trigger on the right edge.
Bottom Fixed — full-width bar fixed to the bottom.

Left/Right modes can open the form as a Slide Panel or Popup. Bottom Fixed uses the bottom bar.

Installation & First Setup

Installation

Go to Plugins → Add New → Upload Plugin.
Upload the IdeaPlugins Callback ZIP.
Activate the plugin.
Open Callback in the WordPress admin menu.

Defaults are ready: the widget starts enabled, uses Bottom Fixed, and is enabled for desktop, tablet and mobile.

Recommended setup order

Display → choose position, device visibility, targeting and reveal timing.
Form → change title, subtitle, CTA and optional fields.
Appearance → match trigger/bar colors, sizes and animations.
Popup → only when a side mode uses Popup.
Advanced → enable email notifications and review spam protection.

Each major section has its own Save changes action.

Dashboard

The Dashboard summarizes callback activity.

Total Requests — all stored requests.
New Requests — requests awaiting follow-up.
Contacted — requests your team has contacted.
Completed — requests marked completed.

Quick actions

View Requests, Configure Display and Customize Form provide direct navigation.

Recent requests

The dashboard shows recent name, phone, email, page, date and status information. New requests are highlighted and the dashboard can refresh its snapshot automatically.

Callback Requests

Use Callback → Callback Requests to manage stored leads.

Search & filters

Search covers name, phone, email and company. Status filters are New, Contacted and Completed.

Sorting

Name, phone, date and status can be sorted. Results are paginated.

Request information

A request can contain name, phone, email, company, message, preferred callback time, department, service, additional information, page title, page URL, post ID, product ID when applicable, category, status, IP address, user agent and timestamps.

Actions

The admin interface supports request management actions including status changes, copying phone/email, viewing request information and permanent deletion of individual requests.

Reset is different from delete: Reset to defaults changes settings only; it never deletes callback requests.

Display

Open Callback → Display to control where, when and on which devices the widget appears.

General

Setting	Purpose	Default
Enable widget	Turns the frontend widget on/off.	On
Display mode	Left Side, Right Side or Bottom Fixed.	Bottom Fixed
Form display	Slide Panel or Popup for side modes.	Slide Panel
Visible on devices	Desktop, Tablet and Mobile independently.	All on

Visibility rules

Show everywhere
Homepage only
Selected pages
Selected posts
Selected categories

Selected pages/posts/categories use comma-separated numeric IDs such as 12,34,56. Category targeting applies to category archives and singular posts belonging to the selected categories.

Reveal timing

Immediately
After X seconds — 0–120 seconds
After X% scroll — 1–100%

Don't show again after close

Set 0–720 hours. 0 means the widget can show again without a cooldown.

Form

Open Callback → Form to change the visitor-facing form.

Text content

Title
Subtitle
Button text
Button icon

Fields

Full name and Phone number are always enabled and required. Optional fields are Email, Company, Message, Preferred callback time, Department, Service and Additional information.

Each optional field can be enabled, marked Required, and given its own Label, Placeholder and Icon.

Inputs & button style

Setting	Range/options	Default
Form width	280–720 px	420 px
Field spacing	4–40 px	16 px
Input radius	0–40 px	12 px
Button radius	0–40 px	12 px
Input size	Small/Medium/Large	Medium
Button size	Small/Medium/Large	Medium

Color controls include input background, border, focus border, input text, label, button background, hover background and button text.

Appearance

Open Callback → Appearance. Tabs are Trigger, Bottom Bar and Messages.

Trigger

For Left/Right modes: change Trigger text, icon, icon position and animation (None, Pulse, Bounce, Glow).

Setting	Range	Default
Icon size	12–48 px	20 px
Text size	10–24 px	14 px
Width	40–120 px	56 px
Height	60–260 px	140 px
Edge offset	0–200 px	24 px
Radius	0–60 px	14 px

Trigger background, text, icon and hover colors are configurable. The frontend includes a text-contrast guard.

Bottom Bar

Used only for Bottom Fixed. Configure height, padding, input width, button width, content spacing, background and border color.

Messages

Customize success title/message/button/icon and error title/message. The settings also include a success animation option.

Popup

Open Callback → Popup. These settings apply when a side mode uses Form display = Popup.

Setting	Range/options	Default
Width	280–800 px	460 px
Max width	50–100 vw	94 vw
Overlay opacity	0–100%	55%
Radius	0–60 px	20 px
Close style	Circle/Ghost	Circle
Animation	Fade/Scale/Slide	Scale
Position	Center/Top	Center

Behavior

Close on outside click and Close on Esc key can be enabled independently.

Advanced

Open Callback → Advanced. It contains Notifications, Spam Protection and Developer tabs.

Notifications

Enable email notifications
Notification email
Email subject
Email template

Supported placeholders: {name}, {phone}, {email}, {page_title}, {page_url}, {site_name}.

Spam Protection

Honeypot — hidden field for simple bots; filled honeypot submissions are not stored.
Rate limiting — repeated submissions are restricted.
Rate limit window — 5–600 seconds; default 30.
Duplicate detection window — 1–1440 minutes; default 10.

Developer

Debug mode — browser-console diagnostics.
Disable animations.
Respect “reduce motion” system setting.
Custom CSS.
Delete all data on uninstall.
Reset to defaults — settings only; requests are preserved.

Email Notifications

Go to Advanced → Notifications, enable notifications, enter the destination address, then customize subject/template and save.

Delivery uses WordPress wp_mail(). Reliable delivery therefore depends on the site's mail/SMTP setup. The request is stored before notification handling, so a notification failure does not intentionally invalidate an already-saved request.

WooCommerce Integration

WooCommerce is optional. When active, a submission from a WooCommerce product page can store the relevant product ID in addition to page context. The plugin does not require WooCommerce cart or checkout functionality.

Responsive & Accessibility

Desktop, Tablet and Mobile visibility can be controlled independently from Display. The frontend uses semantic buttons, dialog attributes and ARIA labels. Reduced-motion support is included, and animations can also be disabled from Advanced.

Data, Privacy & Security

Stored data

Requests are stored in a dedicated table using the WordPress database prefix and the ideaplnewplg20i_requests table name.

Security

Frontend nonce validation.
Admin nonce and manage_options capability checks.
Server-side sanitization and validation.
Prepared database queries / WordPress database APIs.
Honeypot and rate/duplicate protection.

Privacy

Requests may contain contact information, IP address and user agent. The site owner is responsible for privacy notices, retention and legal compliance appropriate to their use.

Uninstall

By default, deactivation/deletion does not remove requests. Full cleanup occurs only if Delete all data on uninstall was enabled before deletion.

Updates & Safe Settings

Each settings group is stored independently, so saving one section does not reset unrelated settings. Installation/upgrade routines are additive and designed to preserve existing settings and callback requests.

Safe update behavior: normal plugin updates do not intentionally delete callback request data.

Troubleshooting

Widget not visible

Check Display → Enable widget.
Check Desktop/Tablet/Mobile visibility.
Review visibility rule and IDs.
Check reveal timing.
Check the close cooldown.
Clear relevant cache layers.

Email not arriving

Confirm notifications are enabled and the address is valid. Test the site's WordPress mail/SMTP configuration because the plugin uses wp_mail().

Widget stays hidden

Review Don't show again after close. A non-zero value intentionally hides it for that number of hours after closing.

Need diagnostics

Use Advanced → Developer → Debug mode to add diagnostic information to the browser console.

FAQ

Does it require WooCommerce?

No.

Can I show it only on selected pages?

Yes. Use Display → Visibility rules → Selected pages and enter page IDs.

Can optional fields be required?

Yes. Enable the field and tick Required.

Does Reset to defaults delete leads?

No. It restores settings only.

Does deactivation delete data?

No. Data is preserved.

Can all plugin data be deleted?

Yes, if Delete all data on uninstall is enabled before deletion.

Changelog

1.2.0

Fixed false frontend errors after successful submissions.
Improved expired nonce handling for cached pages.
Corrected duplicate/rate-limit time-window handling.
Improved Bottom Fixed error presentation.
Improved admin preview controls.
Added email column and copy interactions.
Added new-request dashboard/sidebar indicators and automatic dashboard refresh.

1.1.1

Fixed overflowing admin controls and overlapping labels.
Added header branding and improved version placement.
Kept other plugin notices outside the branded header.

1.1.0

Modern indigo/coral palette.
Premium admin refinements.
Save/copy toast notifications.
Improved slide-panel backdrop.
Fixed frontend input icon/placeholder overlap.
Automatic text contrast protection.

1.0.0

Initial release.

Support

IdeaPlugins Callback is developed and maintained by IdeaPlugins.