Description
ThemeVix Direct Chat Button helps WooCommerce stores and WordPress sites add a professional WhatsApp chat button so customers can contact you in one click. Messages can include product name, price, URL, cart details, and more — perfect for WhatsApp product enquiry, order questions, and customer support.
This plugin is not affiliated with, endorsed by, or sponsored by WhatsApp LLC or Meta Platforms, Inc. WhatsApp is a trademark of WhatsApp LLC.
Why store owners use it
- WhatsApp click to chat on product, cart, checkout, and shop pages
- Pre-filled WhatsApp messages with dynamic placeholders
- WooCommerce WhatsApp integration for product, cart, checkout, and archive loops
- Click analytics dashboard with KPIs, charts, and CSV export
- Google Analytics 4 (GA4) event tracking for button clicks
- Gutenberg block, Elementor widget, and
[tv_direct_chat]shortcode - GDPR consent and optional privacy notice
- Works on any WordPress site — even without WooCommerce (shortcode, block, floating button)
WooCommerce WhatsApp button
When WooCommerce is active, show a WooCommerce chat button on:
- Single product pages (multiple positions: before/after add to cart, after summary, after meta)
- Cart page (classic and block cart)
- Checkout page (classic and block checkout)
- Shop and product archive loops (optional)
Hide the button on selected products or categories. Override phone number or message per product in the WooCommerce product editor.
WhatsApp messaging features
- Two WhatsApp numbers with primary, alternate, or random routing
- Separate messages for product, cart, checkout, and shop/archive pages
- Up to 3 quick-reply template buttons on product pages
- Optional welcome message and business hours label
- Message placeholders for product and cart data (see below)
Button design
- Styles: rounded, pill, square, outline
- Sizes: small, medium, large
- Custom button and text colors
- Animations: bounce, pulse, shake, heartbeat
- Hover effects: darken, lighten, glow
- Custom CSS field
- RTL layout support
- Show or hide on mobile and desktop
Floating WhatsApp button
Add a simple site-wide WhatsApp floating button (bottom-left or bottom-right) with an optional tooltip label. When the Pro add-on’s advanced floating widget is active, the free floating button is replaced automatically.
Analytics & GA4
Click analytics (built in):
- Admin dashboard under TV Direct Chat Analytics
- Overview with KPIs: total clicks, daily average, all-time clicks, this month
- Period filters: 7, 30, 90, or 365 days
- Breakdowns by page type, device, button type, and top products
- Daily click trend chart
- CSV export
- Optional anonymous click tracking (page type, device, button type, product ID — no IP addresses)
Google Analytics 4:
- Configure under Settings Google Analytics
- Send custom WhatsApp click events to your GA4 property
- Measurement ID, custom event name, product/page parameters
- Debug mode for browser console testing
When the optional Pro add-on is active, its analytics and GA4 settings take over and the free analytics menu is hidden.
Tools & setup
- Click-to-chat link generator with copy button
- Basic QR code preview in admin (for testing your chat link)
- JSON settings import/export
- 3-step setup wizard after activation (phone, display options, finish)
Blocks, shortcodes & Elementor
- Gutenberg block: search for Chat Button in the block inserter (
directchat/chat-button) - Elementor widget: WhatsApp Chat Button
- Shortcode:
[tv_direct_chat](alias:[directchat_button])
Shortcode attributes: phone, text, message, style, color, text_color, size, icon, newtab, class
Privacy & GDPR
- Optional GDPR consent checkbox before chat links open
- Optional privacy notice under the button with policy URL
- Click analytics stores anonymous event data only (no IP addresses)
- Suggested privacy policy text included for WordPress Privacy Policy guide
Optional Pro add-on
A separate premium add-on (sold on ThemeVix.com, not WordPress.org) adds multi-agent routing, advanced floating widget, lead capture, display rules, scheduling, WooCommerce automation, AI chatbot, and more. The free plugin works fully on its own.
Message placeholders
Available in message fields and templates:
{product_name}— Product name{product_price}— Product price (formatted){product_url}— Product permalink{shop_name}— Site name{product_sku}— Product SKU{variation}— Selected variation attributes (variable products; updated via storefront JavaScript){quantity}— Selected quantity (variable products; updated via storefront JavaScript){cart_total}— Cart total (cart/checkout messages){cart_count}— Number of items in cart
Shortcode examples
Basic:
[tv_direct_chat]
With custom attributes:
[tv_direct_chat phone="+1234567890" text="Chat on WhatsApp" message="Hi, I need help!"]
External Services
This plugin connects to external services only when a feature that requires them is used.
WhatsApp (wa.me) — required for chat links
When a visitor clicks a WhatsApp button, their browser opens a URL like:
https://wa.me/<phone_number>?text=<pre-filled_message>
The phone number comes from your plugin settings. The message may include product name, price, URL, shop name, SKU, cart total, and related store data from your own site. Data is sent only when the visitor clicks the button.
- Service: WhatsApp
- Terms: WhatsApp Terms of Service
- Privacy: WhatsApp Privacy Policy
Google Analytics 4 — optional
When GA4 tracking is enabled in Settings Google Analytics, the plugin loads Google Tag (googletagmanager.com/gtag/js) and sends custom click events to your GA4 property using the Measurement ID you provide. Events may include page type, page URL, and product data depending on your settings.
- Service: Google Analytics
- Terms: Google Terms of Service
- Privacy: Google Privacy Policy
QR Server — optional, admin only
The Tools tab displays a QR code preview of your chat link using api.qrserver.com. This request is made only in the WordPress admin when viewing the QR preview, not on the public storefront.
- Service: QR Server API
- Privacy: Refer to the QR Server / goQR website for their privacy terms.
Privacy Policy Suggestions
This plugin can store:
- Plugin settings in the WordPress options table
- Anonymous click analytics in a custom database table (
directchat_clicks) when tracking is enabled — page type, device type, button type, and optional product ID. No IP addresses. - GA4 event data is processed by Google when GA4 integration is enabled
Screenshots







Blocks
This plugin provides 1 block.
- Chat Button
Installation
- Upload the plugin to
/wp-content/plugins/themevix-direct-chat-button/or install from the WordPress Plugins screen. - Activate ThemeVix Direct Chat Button.
- Complete the setup wizard (opens after first activation) or go to TV Direct Chat Settings.
- Enter your WhatsApp number in E.164 format (e.g.
+12025551234). - Choose button style, display locations, and messages.
- Optional: enable click analytics under Analytics Click Tracking or GA4 under Settings Google Analytics.
WooCommerce: Product, cart, checkout, and shop buttons require WooCommerce. Shortcode, Gutenberg block, and floating button work without WooCommerce.
FAQ
-
What phone number format should I use?
-
Use E.164 format with country code, no spaces or dashes. Example:
+12025551234 -
Can I use this without WooCommerce?
-
Yes. The
[tv_direct_chat]shortcode, Chat Button Gutenberg block, and floating WhatsApp button work on any WordPress site. WooCommerce is required for automatic product, cart, checkout, and shop/archive buttons. -
Go to TV Direct Chat Settings Display and choose Button Position.
-
Can I customize the pre-filled WhatsApp message?
-
Yes. Edit the message fields under Settings General and Settings Display. Use placeholders like
{product_name}and{product_price}. -
Does this work with variable products?
-
Yes. The
{variation}and{quantity}placeholders update on the storefront when shoppers change options on variable product pages. -
Does this support WooCommerce block cart and checkout?
-
Yes. Cart and checkout buttons support both classic WooCommerce templates and WooCommerce Blocks.
-
Does this plugin track clicks?
-
Yes, optionally. Enable Enable Click Tracking under Analytics Click Tracking or in Settings Tools. Data is stored in your WordPress database. No IP addresses are saved. You can export reports to CSV from the Analytics Overview.
-
Does this plugin support Google Analytics 4?
-
Yes. Go to Settings Google Analytics, enter your GA4 Measurement ID, and enable tracking. WhatsApp button clicks are sent as custom GA4 events. Use Debug Mode while testing.
-
Is this plugin GDPR compliant?
-
The plugin includes an optional GDPR consent checkbox and privacy notice. You control the consent text and privacy policy link. Click analytics and GA4 are optional and can be disabled.
-
Do I need a WhatsApp or WhatsApp Business account?
-
Yes. This plugin creates click-to-chat links that open WhatsApp (
wa.me). You need an active WhatsApp account linked to the phone number in your settings. -
What is the difference between the free plugin and the Pro add-on?
-
The free plugin includes the WooCommerce WhatsApp button, templates, analytics dashboard, GA4, GDPR tools, shortcode, Gutenberg block, Elementor widget, and basic floating button. The optional Pro add-on adds multi-agent support, advanced floating widget, lead capture, display rules, scheduling, WooCommerce automation, and related premium features.
-
Is WooCommerce HPOS supported?
-
Yes. The plugin declares compatibility with WooCommerce High-Performance Order Storage (HPOS).
Reviews
There are no reviews for this plugin.
Contributors & Developers
“ThemeVix Direct Chat Button — WooCommerce WhatsApp Chat” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “ThemeVix Direct Chat Button — WooCommerce WhatsApp Chat” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.2.0
- Checkout page WhatsApp button (classic and block checkout)
- Shop and archive loop button support
- 3-step setup wizard after activation
- Full click analytics dashboard (Overview, Click Tracking, KPIs, daily trend chart, CSV export)
- Google Analytics 4 integration with debug mode (Settings tab)
- Click-to-chat link generator, QR preview, and JSON import/export in Tools
- Basic floating WhatsApp button
- Second phone number with alternate/random modes
- Welcome message and business hours label
- Per-product phone, message, and hide overrides
- Elementor WhatsApp Chat Button widget
- Works without WooCommerce for shortcode, Gutenberg block, and floating button
- WooCommerce HPOS compatibility declared
- Placeholders:
{variation},{quantity},{cart_total},{cart_count}
1.1.0
- Shop/archive loop chat button
- Custom CSS and mobile/desktop visibility toggles
- Settings import/export (JSON)
- Additional message placeholders
1.0.0
- Initial release
- WhatsApp click-to-chat button for WooCommerce product and cart pages
- Pre-filled messages with placeholders
- Button styles, sizes, colors, animations, and hover effects
- Shortcode and Gutenberg block
- GDPR consent and privacy notice
- Product and category exclusions
- Quick-reply templates and RTL support
