A fully-featured WhatsApp contact and sharing plugin for WordPress. Add a shortcode button, a floating button, an agent-selection popup, a share button, business-hours scheduling, a chat teaser bubble, click analytics, and more — all from a clean tabbed settings panel, no coding required.
- Shortcode
[wa-hello]— place a WhatsApp contact button in any post, page, or widget - Per-instance overrides via shortcode attributes:
phone,text,message,align,agent - Custom pre-filled message with dynamic variable support
- Button alignment — Left, Center, or Right (global default + per-shortcode override)
- Show on all devices or mobile only
- GDPR-ready: disable until visitor accepts your Privacy Policy
- Open in new tab option
- Fixed-position button displayed site-wide
- Left or right screen position
- Three styles: Circle, Pill (icon + label text), Square
- Optional tooltip with hover animation and customisable colours
- Hide on mobile (viewport ≤ 768 px)
- Open in new tab option
- Unlimited WhatsApp contacts — each with name, role, phone, message, and avatar
- When two or more agents are active → accessible agent-selection popup
- When one agent is active → direct link, no popup
- Three popup styles: Classic, Minimal, Dark
- Per-agent shift scheduling (days + hours)
- Target a specific agent from the shortcode:
[wa-hello agent="2"]
- Shortcode
[wa-hello-share]— let readers share the current post in one click - Per-instance overrides:
text,align - Button alignment — Left, Center, or Right (global default + per-shortcode override)
- Auto-inject above content, below content, or both
- Device visibility: All / Mobile only / Desktop only
- Customisable share message template with dynamic variable support
- Gutenberg block included
- Global weekly schedule — active days, open time, close time
- Full timezone selector
- Offline behaviour: show normally, hide, show status badge, or show offline message
- Online / offline status dot on the floating button
- Per-agent shift scheduling works independently alongside global schedule
Tokens resolved client-side at the moment of click — always current:
| Token | Resolves to |
|---|---|
{page_title} |
Current page title |
{page_url} |
Current page URL |
{site_name} |
Site name |
{site_url} |
Site URL |
{site_tagline} |
Site tagline |
{current_date} |
Today's date |
{current_time} |
Current time |
{post_author} |
Post author name |
{post_date} |
Post publish date |
{post_excerpt} |
Post excerpt |
{post_category} |
Post primary category |
- Show everywhere, include list, or exclude list
- Post type checkboxes
- Specific post/page ID list
- Homepage and archive toggles
- Per-post / per-page meta box override (Force Show / Force Hide)
- Independent colour controls for shortcode button, floating button, and share button
- Background, text/icon, and hover colours
- Button size: Small / Medium / Large
- Border radius: Pill / Rounded / Square
- Drop shadow toggle
- Pulse animation: Off / Always / Timed (configurable interval)
- Tooltip background and text colour
- Speech bubble above the floating button to prompt visitors
- Trigger: Immediate / Time delay / Scroll depth
- Typing animation (three-dot indicator)
- Cookie-based auto-dismissal with configurable re-show period
- Mobile visibility toggle
- Built-in click counter per button type (shortcode, floating, agent popup, share)
- Per-agent click breakdown
- WordPress Dashboard widget
- Optional Google Analytics 4 (
gtag) event integration - Optional Facebook Pixel (
fbq) event integration - Configurable event names per button type
- Stats reset
- Export all settings + agent profiles as JSON
- Import from JSON (allowlisted keys only)
- Reset to plugin defaults
- Opt-in data deletion on uninstall
| Requirement | Minimum |
|---|---|
| WordPress | 6.2 |
| PHP | 7.4 |
| Tested up to (WordPress) | 7.0 |
| Tested up to (PHP) | 8.4 |
No additional libraries or build tools required. No database tables created.
- Go to Plugins → Add New in your WordPress dashboard.
- Search for OneClick WP Hello.
- Click Install Now → Activate.
- Download the
.zipfrom WordPress.org. - Go to Plugins → Add New → Upload Plugin, upload the zip, click Install Now.
- Activate the plugin from the Plugins screen.
- Clone or download this repository into your
wp-content/plugins/directory:git clone https://github.com/walterpinem/oneclick-whatsapp-hello.git wp-content/plugins/oneclick-whatsapp-hello
- Activate from Plugins in the WordPress dashboard.
- After activation go to WP Hello in the left admin menu.
- Enter your WhatsApp number (digits only, with country code, e.g.
6281234567890) on the Button & Shortcode tab. - Place
[wa-hello]in any post, page, or widget to display the contact button. - To enable the floating button, go to the Floating Button tab and check Display Floating Button.
- To add team members, open the Agents tab.
[wa-hello]
[wa-hello phone="6281234567890" text="Chat Now" message="Hi!" align="center"]
[wa-hello agent="2"]
| Attribute | Default | Description |
|---|---|---|
phone |
(admin setting) | WhatsApp number with country code |
text |
(admin setting) | Button label |
message |
(admin setting) | Pre-filled WhatsApp message |
align |
(admin setting) | left / center / right |
agent |
— | Force a specific agent by ID |
[wa-hello-share]
[wa-hello-share text="Share this article" align="center"]
| Attribute | Default | Description |
|---|---|---|
text |
(admin setting) | Button label |
align |
(admin setting) | left / center / right |
oneclick-whatsapp-hello/
├── whatsapp-hello.php # Plugin bootstrap
├── uninstall.php # Data cleanup on deletion
├── readme.txt # WordPress.org readme
├── includes/
│ ├── class-ocwahello-admin.php
│ ├── class-ocwahello-agents.php
│ ├── class-ocwahello-analytics.php
│ ├── class-ocwahello-appearance.php
│ ├── class-ocwahello-availability.php
│ ├── class-ocwahello-frontend.php
│ ├── class-ocwahello-importexport.php
│ ├── class-ocwahello-settings.php
│ ├── class-ocwahello-share.php
│ ├── class-ocwahello-teaser.php
│ ├── class-ocwahello-visibility.php
│ ├── functions-sanitize.php
│ ├── functions-svg.php
│ ├── functions-utility.php
│ ├── whatsapp-hello-button.php
│ └── whatsapp-hello-gdpr.php
├── assets/
│ ├── css/ # Frontend and admin stylesheets
│ └── js/ # Frontend and admin scripts
├── blocks/
│ ├── wa-hello-contact/ # Gutenberg contact button block
│ └── wa-hello-share/ # Gutenberg share button block
├── admin/ # Admin-side views / partials
└── languages/
├── oneclick-whatsapp-hello.pot
├── oneclick-whatsapp-hello-id_ID.po
└── oneclick-whatsapp-hello-id_ID.mo
- No database tables — all settings stored in a single serialised
wp_optionsrow (ocwahello_settings). - Conditional asset loading — agents, availability, and teaser CSS/JS are enqueued only when those features are active.
- Security — nonce verification on all forms and REST endpoints; capability checks (
manage_options) on all admin actions; all output escaped; import uses an allowlist of known keys. - Rate limiting — analytics REST endpoint is limited to 30 requests per IP per hour via transients.
- Translation — text domain
oneclick-whatsapp-hello;.potfile included. To regenerate:wp i18n make-pot . languages/oneclick-whatsapp-hello.pot --domain=oneclick-whatsapp-hello - Uninstall — opt-in data deletion; when enabled, removes all options, transients, and analytics on plugin deletion.
| Locale | Language | Status |
|---|---|---|
id_ID |
Indonesian (Bahasa Indonesia) | Bundled |
Contributions for additional languages are welcome. Open a pull request with your .po file.
Major rewrite. Highlights:
- Multiple agents with accessible agent-selection popup (Classic / Minimal / Dark styles)
- WhatsApp Share Button with auto-inject and Gutenberg block
- Dynamic message variables (11 tokens)
- Business hours / availability scheduling with per-agent shift support
- Display rules with per-post meta box override
- Full appearance customisation (colours, size, border radius, pulse animation)
- Floating button style variants (Circle / Pill / Square)
- Button alignment control for shortcode and share buttons
- Chat teaser bubble with typing animation
- Click analytics with GA4 and Facebook Pixel integration
- Import / Export / Reset settings
- Tabbed admin panel (10 tabs)
- Rebranded to OneClick WP Hello; code cleanup
- Initial release and early fixes
This plugin is licensed under the GNU General Public License v3.0.
Walter Pinem
- Website: walterpinem.me
- WordPress.org: profiles.wordpress.org/walterpinem
- Plugin page: wordpress.org/plugins/oneclick-whatsapp-hello
Running a WooCommerce store? Meet OneClick Chat to Order — purpose-built WhatsApp integration for WooCommerce:
- WhatsApp Buy Now and Add to Cart via Chat buttons on product pages
- Sends product name, price, quantity, and variations automatically
- Cart page WhatsApp checkout button
- Multiple store agents and sales representatives
- Thousands of active WooCommerce stores worldwide