OneClick WP Hello

Description

OneClick WP Hello makes it easy for your readers to reach you on WhatsApp — with a single click. Add a shortcode button anywhere, enable a site-wide floating button, route conversations to specific team members through an agent-selection popup, let readers share your content to WhatsApp, and track every click — all from a clean tabbed settings panel, no coding required.

Version 1.0.0 is a major rewrite that goes far beyond a simple contact button. Here is everything included:

Contact Button

• Shortcode [wa-hello] — place a WhatsApp contact button in any post, page, or widget
• Inline per-instance overrides: [wa-hello phone="628xx" text="Chat Now" message="Hi!" align="center"]
• Custom pre-filled message with full dynamic variable support
• Custom button label text
• Button alignment — Left, Center, or Right; set a global default or override per shortcode
• Show button only on mobile devices, or on all devices
• GDPR-ready: disable the button until the visitor accepts your Privacy Policy
• Open in new tab option

Floating Button

• Fixed-position floating WhatsApp button displayed across all pages
• Left or right screen position
• Three button styles: Circle (classic icon), Pill (icon + custom label text), Square (rounded corners)
• Custom pre-filled message — overridden automatically per agent when agents are active
• Optional tooltip label with smooth hover animation and customizable colors
• Hide on mobile devices option (viewport ≤ 768px)
• Open in new tab option

Multiple Agents

• Add unlimited WhatsApp contacts — each with a name, role, phone number, pre-filled message, and avatar photo
• When two or more agents are active, the floating button opens an accessible agent-selection popup
• When only one agent is active, the button links directly — no popup shown
• Three popup styles: Classic (bold green header), Minimal (neutral tones, hairline borders), Dark (dark card with green accents)
• Per-agent shift scheduling: assign work days and open/close hours so each agent only appears during their shift
• Target a specific agent directly from the shortcode: [wa-hello agent="2"]

WhatsApp Share Button

• Shortcode [wa-hello-share] — let readers share the current post to WhatsApp in one click
• Inline per-instance overrides: [wa-hello-share text="Share this" align="center"]
• Button alignment — Left, Center, or Right; set a global default or override per shortcode
• Auto-inject above content, below content, or both — no shortcode placement needed
• Configurable post type targeting
• Device visibility: All / Mobile only / Desktop only
• Customizable share message template with dynamic variable support
• Open in new tab option
• Gutenberg block included

Business Hours & Availability

• Enable a global weekly schedule — set active days, open time, and close time
• Full timezone selector so schedules respect the correct local time
• Offline behavior options: show the button normally, hide it, show a status badge, or display an offline message
• Optional online / offline status dot displayed on the floating button
• Per-agent shift scheduling works independently alongside global availability

Dynamic Message Variables

• Supported tokens: {page_title}, {page_url}, {site_name}, {site_url}, {site_tagline}, {current_date}, {current_time}, {post_author}, {post_date}, {post_excerpt}, {post_category}
• Works in contact button messages, floating button messages, agent messages, and share templates
• Variables are resolved client-side at the exact moment a visitor clicks — always current and accurate
• Visual variable picker chips in the admin panel for easy one-click insertion

Display Rules

• Show everywhere, include specific content only, or exclude specific content
• Post type checkboxes for fine-grained targeting
• Specific post/page ID list
• Homepage and archive page toggles
• Per-post / per-page meta box override: force show or force hide on any individual piece of content

Appearance

• Independent color controls for the shortcode button, floating button, and share button
• Background color, text/icon color, and hover color — each independently configurable
• Button size: Small / Medium / Large
• Border radius: Pill / Rounded / Square
• Drop shadow toggle
• Pulse animation: Off / Always / Timed (configurable interval in seconds)
• Tooltip background and text color

Chat Teaser Bubble

• Speech bubble displayed above the floating button to prompt visitors to start a chat
• Trigger options: Immediate / Time delay / Scroll depth percentage
• Typing animation — animated three-dot indicator plays before the message appears
• Cookie-based auto-dismissal so the bubble does not pester returning visitors
• Configurable re-show period in days
• Mobile visibility toggle

Analytics

• Built-in click counter for shortcode button, floating button, agent popup, and share button clicks
• Per-agent click breakdown so you can see which contact gets the most conversations
• WordPress Dashboard widget for at-a-glance stats without leaving the admin home screen
• Optional Google Analytics 4 event integration via gtag
• Optional Facebook Pixel custom event integration via fbq
• Fully configurable event names per button type
• Stats reset button

Advanced

• Export all settings and agent profiles as a JSON file for backup or migration
• Import settings from a previously exported JSON file — settings and agents restored in one step
• Reset all plugin settings to defaults with one click
• Opt-in data deletion on uninstall — data is preserved by default so a reinstall loses nothing

Developer-friendly

• Gutenberg blocks for both the contact button and the share button (server-side rendered)
• Translation-ready with a .pot file included; Indonesian (id_ID) translation bundled
• All user inputs sanitized, all outputs properly escaped
• Nonce verification on every admin form and REST endpoint
• Rate-limited REST tracking endpoint — 30 requests per IP per hour to prevent click inflation
• Settings stored in a single serialised wp_options row — no database table created
• Clean uninstall removes all options, transients, agent data, and analytics when opted in

Running a WooCommerce Store?

OneClick WP Hello handles general WhatsApp contact and sharing for any WordPress site. If you run a WooCommerce store and need deep WhatsApp integration by sending cart contents, product names, prices, and order summaries directly to WhatsApp, meet OneClick Chat to Order, the dedicated companion plugin:

• WhatsApp Buy Now and Add to Cart via Chat buttons on product pages
• Automatically sends product name, price, and quantity to WhatsApp
• Cart page WhatsApp checkout button — customers send their full cart in one message
• Thank You Page Override – Custom thank you page with WhatsApp button to send complete order details.
• Flexible button placement: product page, shop archive, cart page, order completion page, and more
• Fully compatible with latest WooCommerce
• Thousands of active WooCommerce stores worldwide

Get OneClick Chat to Order on WordPress.org | View Documentation