=== ChatHelp – Click to Chat Button, Chat to Order, Floating Chat & Form === Contributors: ThemeAtelier, faysal61, shshakib2001, tamimaziz Tags: whatsapp, whatsapp business, whatsapp chat, click to chat, woocommerce whatsapp Requires at least: 5.0 Tested up to: 7.0 Requires PHP: 7.0 Stable tag: 3.3.2 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Add WhatsApp click to chat with floating chat button, chat to order for WooCommerce, and chat forms to convert visitors into customers. == Description == WhatsApp Chat plugin for WordPress makes it simple to add **WhatsApp chat support** to your WordPress site with a customizable floating chat bubble, WooCommerce buttons, shortcode buttons, Gutenberg block, and Elementor widget. Whether you’re running a **WooCommerce store**, a blog, or a service website, Chat Help lets visitors connect with you instantly via **WhatsApp** or **WhatsApp Business**—even join your **WhatsApp Group** directly. Unlike traditional contact forms or delayed email responses, **WhatsApp click-to-chat buttons** give customers a familiar, fast, and trusted way to reach you. With **pre-filled messages**, **dynamic variables**, **agent lists**, **availability scheduling**, and **GDPR consent**, Chat Help ensures every conversation feels personal, professional, and convenient. By offering multiple layouts (Simple Button, Single Agent, Single Form, Multi-Agent List/Grid, and Advanced Button), you can design the perfect **WhatsApp chat bubble** that matches your brand and support needs. **Why Add WhatsApp Chat Support?** - 2.78+ billion users rely on WhatsApp for messaging worldwide - Customers prefer **instant messaging over email** for support and inquiries - A visible **WhatsApp chat button** builds trust and increases conversions - Businesses using **multi-agent WhatsApp chat** improve response time and satisfaction - Smart features like **pre-filled messages** and **WooCommerce product variables** reduce friction and boost sales With Chat Help, you’re not just adding a button—you’re creating a complete **WhatsApp customer support system** inside WordPress. [youtube https://youtu.be/B_xfMNOLP2A] **👁️[Plugin Demo](https://wpchathelp.com/) | 📖 [Documentation](https://wpchathelp.com/docs/) | 🚀[Pro Version](https://wpchathelp.com/pricing/) | 👩🏼‍💻[Support](https://wordpress.org/support/plugin/chat-help/) | 🌟[Rate this plugin](https://wordpress.org/support/plugin/chat-help/reviews/#new-post)** ## 👉 Key Features of Chat Help ## ### 💬 Core Chat Features - **Floating Chat Layouts**: Choose from multiple chat bubble styles: Single Form, Single Agent, Pre-Chat Message, Floating Button or disable the bubble. - **Single Form Builder**: Collect visitor details before chat with text/textarea fields, labels, placeholders, validation messages, and required fields. - **Multiple WhatsApp Types Supported**: Personal, Business, or Group — all formats supported in floating chats and buttons. - **Smart Pre-Filled Messages**: Ready-to-send messages with global variables (`{siteTitle}`, `{currentURL}`, `{date}`, `{ip}`) and WooCommerce variables (`{productName}`, `{productPrice}`, `{stockStatus}`). Conditional tags like `{PRODUCT_START}...{PRODUCT_END}` and `{LOGGEDIN_START}...{LOGGEDIN_END}` make messages dynamic. - **Leads Management**: Collect, search, filter, export, and analyze all chat leads with full form data and rich metadata — right from your WordPress dashboard. ### 🛒 Ecommerce & Integration - **WooCommerce Integration**: Add WhatsApp contact buttons across the entire shopping journey. - **Shop Page Button**: Allow customers to contact you directly from product listing pages. - **Product Page Button**: Show WhatsApp buttons before or after the Add to Cart button on single product pages. - **Cart Page Button**: Let customers ask questions before completing their purchase. - **Checkout Page Button**: Provide instant support at the final step to reduce cart abandonment. - **Order Thank You Page Button**: Keep communication open even after the order is placed. - **Auto Product Details**: Automatically include product name, SKU, price, sale price, stock status, product URL in the WhatsApp message, cart informations and order informations. - **Flexible Button Options**: Insert WhatsApp buttons anywhere with shortcodes, Gutenberg block, or Elementor widget. ### 🎨 Design & User Experience - **Custom Styling**: Change bubble colors, choose from 900+ Google Fonts, adjust padding, margins, and border radius. - **Icons**: Use different icon sets for bubble, submit, and circle open/close states. - **Tooltips**: Enable tooltips and customize text & width. - **Animations & Effects**: Smooth transitions and bubble animations for floating icons. - **Flexible Positioning**: Place bubbles bottom-right or bottom-left. ### ⚙️ Control, Compliance & Analytics - **Advanced Page Visibility**: Control where the bubble appears (templates, specific pages, etc.). - **Timezone & Availability**: Set availability per agent/button with automatic Online/Offline switching. - **GDPR Compliance**: Add a checkbox with your terms text (supports links & formatting). - **Google Analytics Tracking**: Track button clicks with GA events; add custom UTM parameters or dynamic values. - **Advanced Settings**: Clean uninstall, import/export settings, custom CSS/JS, and WhatsApp URL behavior control (API/web/intent). ### 🌐 Compatibility & Performance - **Elementor & Page Builder Ready**: Works seamlessly with Elementor, Gutenberg, WPBakery, Divi, Beaver Builder, Oxygen, and more. - **Multisite & Theme Compatibility**: Tested across multisite and popular themes (Astra, Divi, Kadence, GeneratePress, Avada, Neve, Blocksy, OceanWP, etc.). - **Multilingual Ready**: Translation-ready `.pot` file; compatible with WPML, Polylang, TranslatePress, Weglot, and Loco Translate. - **Developer-Friendly**: Clean, modular code for easy extension/customization. - **SEO & Performance Optimized**: Lightweight, fast-loading, and coded with SEO best practices. - **Complete Documentation & Tutorials**: Step-by-step guides and video tutorials. - **Reliable Support**: Fast, friendly support team ready to help. = Page Builders Ready = * Gutenberg * WPBakery * Elementor * Beaver Builder * SiteOrigin * Divi Builder * LayersWP * MotoPress * Cornerstone * Themify Builder etc. = Compatible with all major themes, including = * Hello Elementor * Astra * Divi * Kadence * Themify Ultra * OceanWP * Hestia * Inspiro * GeneratePress * Avada * Blocksy * Neve ### 🌟 PRO VERSION FEATURES ### 💬 Layouts & Forms - **Floating Chat Layouts**: Unlock all layouts — Single Form (with unlimited custom fields), Single Agent, Simple Button, Advanced Button, Multi-Agent List, and Multi-Agent Grid. - **Multi-Agent Chat Layout**: Display multiple agents in a sleek list or grid, letting users choose who to chat with. - **Advanced Button Layout**: Premium button style for stronger call-to-action and design flexibility. - **Unlimited Form Fields**: Build fully customized Single Form layouts with unlimited fields. ### 🎨 Design & User Experience - **Dark & Night Mode**: Switch to a modern dark theme for a sleek appearance. - **Icon Packs**: 2,000+ icons for Send Message, 2,000+ for Circle Button, and 200+ for Close Icon. - **Transition Effects for Circle Icon**: Choose from 4 smooth animation styles. - **Flexible Bubble Positioning**: Place the floating chat bubble on the right or centered. ### ⚙️ Advanced Controls & Integrations - **Visibility Control Options**: Fine-tune where and when your chat appears — by templates, pages, posts, products, categories, and tags. - **Webhooks Integration**: Connect with external systems and automation tools using custom webhooks. == Other Plugins from ThemeAtelier == == OTHER AMAZING PRODUCTS FROM ThemeAtelier == ➡️ **[WhatsApp Chat Help](https://wordpress.org/plugins/chat-help/)** - A flexible WhatsApp chat plugin that helps website visitors start instant conversations with you directly from your WordPress site. ➡️ **[Eventful – Events Showcase and Filter Bar for The Events Calendar](https://wordpress.org/plugins/eventful/)** - An event display plugin for The Events Calendar that helps you showcase events in clean, modern, and fully responsive layouts without any coding. ➡️ **[Greet – Video Bubble Warm Welcome Plugin](https://wordpress.org/plugins/greet-bubble/)** - A video welcome bubble plugin that helps you greet visitors warmly and provide quick contact options to boost engagement. ➡️ **[Domain For Sale](https://wordpress.org/plugins/domain-for-sale/)** - A domain listing and offer management plugin that helps you list domains, collect buyer offers, and manage secure sales with escrow payments directly from WordPress. ➡️ **[Eventful for Elementor – Events Showcase For The Events Calendar and Elementor](https://wordpress.org/plugins/eventful-for-elementor/)** - An Elementor addon for The Events Calendar that lets you design and display events using Elementor widgets with advanced, responsive layouts. ➡️ **[Better Chat Support For Messenger](https://wordpress.org/plugins/better-chat-support/)** - A Facebook Messenger chat plugin that allows visitors to contact you instantly through Messenger with customizable chat bubbles. == Frequently Asked Questions == = Where can I find Chat Help documentation and user guides? = For help setting up and configuring Chat Help, please refer to [Getting Started](http://wpchathelp.com/docs/). = Does this plugin support WhatsApp and WhatsApp Business? = Yes! Chat Help works with both personal WhatsApp and **WhatsApp Business** accounts. Just enter your phone number to start receiving messages. = Can I link to a WhatsApp Group instead of a personal chat? = Yes. Chat Help allows you to connect visitors directly to a **[WhatsApp Group](https://wpchathelp.com/docs/single-agent/)** using an invite link. This is useful for communities, support groups, or announcements. = Does the button use the official WhatsApp API? = Chat Help uses the official **wa.me (Click to Chat)** links provided by WhatsApp. No third-party or unofficial APIs are used. = Is it compatible with WooCommerce product pages? = Yes. You can enable a **[WhatsApp chat button on WooCommerce product pages](https://wpchathelp.com/docs/woocommerce-button/)**, allowing customers to ask questions about products directly. This feature can also be used as a **one-click WhatsApp order button**. = Can I add the WhatsApp button using shortcodes or page builders? = Yes. Chat Help supports **[shortcodes](https://wpchathelp.com/docs/shortcodes/)** and popular WordPress page builders such as **[Gutenberg](https://wpchathelp.com/docs/gutenberg-block-button/)** and **[Elementor](https://wpchathelp.com/docs/elementor-whatsapp-button/)**, allowing you to place the WhatsApp button anywhere on your site. = Can Chat Help save leads from form submissions? = Yes. When using the **[Single Form layout](https://wpchathelp.com/single-form/)**, you can optionally enable lead saving. Submitted form data will be stored in your WordPress dashboard under **WhatsApp Chat → Leads**. Learn more about **[WhatsApp Leads Management](https://wpchathelp.com/docs/leads-management/)**. This feature is optional. Other layouts do not store any user data. = Can I disable lead saving? = Yes. Lead saving is optional and can be enabled or disabled from the **[Single Form layout](https://wpchathelp.com/single-form/)** settings. = Does Chat Help store chat messages? = No. All messages are handled directly by WhatsApp. The plugin does not log or store conversations. = Is this plugin GDPR compliant? = Yes. Chat Help does not use cookies and does not store data by default. If lead saving is enabled in the **[Single Form layout](https://wpchathelp.com/single-form/)**, submitted form data is stored locally in your WordPress database and remains fully under your control. = Will Chat Help slow down my website? = No. Chat Help is lightweight and does not load external scripts unless required, ensuring fast page performance. = Does this plugin work if WhatsApp is not installed? = On desktop, WhatsApp Web will open in the browser. On mobile devices, the WhatsApp app must be installed. = Is the plugin translation ready? = Yes. The plugin is fully translation-ready and supports WordPress translation tools such as WPML, Polylang, or Loco Translate. = Can I add more than one WhatsApp agent? = Yes. Multiple agents are supported in the **[premium version](https://wpchathelp.com/pricing/)**, allowing you to route chats to different team members. == Installation == = AUTOMATIC INSTALLATION (EASIEST WAY) = * Visit **Plugins > Add New**. * Search for **ChatHelp**. * Install and activate the ChatHelp plugin. = MANUAL INSTALLATION = **Uploading in WordPress Dashboard** * Download chat-help.zip * Navigate to the ‘Add New’ in the plugins dashboard * Navigate to the ‘Upload’ area * Select chat-help.zip from your computer * Click ‘Install Now’ * Activate the plugin in the Plugin dashboard **Using FTP** * Download chat-help.zip * Extract the chat-help folder to your computer * Upload the chat-help folder to the /wp-content/plugins/ directory * Activate the plugin in the Plugin dashboard = After activation = * Go 'WhatsApp Chat' Menu from the left panel of admin * Configure settings as you want. [For basic usage, have a look at ChatHelp quick start guide](https://wpchathelp.com/docs/quick-start-guide/) == Screenshots == 1. WhatsApp contact form layout allowing visitors to send messages directly through WhatsApp chat with a click-to-chat button. 2. Pre-filled WhatsApp message feature allowing visitors to start chat with predefined text. 2. Floating WhatsApp chat popup with welcome message and one-click start chat button for WordPress. 3. Floating Click-to-Chat button for WordPress that lets visitors start a WhatsApp chat instantly. 4. Customizable WhatsApp chat widget with welcome message and one-click chat button. 5. WooCommerce WhatsApp chat button on product page allowing customers to request a quote or start chat. 6. Multiple WhatsApp chat button styles with shortcode support for pages, posts, and widgets. 7. Gutenberg block for adding a WhatsApp chat button anywhere in WordPress pages or posts. 8. Elementor widget for adding a WhatsApp chat button anywhere on your WordPress website. == Changelog == = 3.3.2 – 01 May 2026 = * Added: Theme Style option to choose different chat bubble designs (e.g., Flat and WhatsApp styles). * Added: Display Notification Icon option to show or hide the notification icon in the interface. * Fixed: Offline form submit issue. = 3.3.1 – 22 April 2026 = * Fixed: WooCommerce quantity form validation issue. = 3.3.0 – 13 April 2026 = * Added: New Floating layout called Pre-Chat Message. * Added: Filter by Agents option in the leads dashboard. * Fixed: Some documentation page links. = 3.2.4 – 05 April 2026 = * Added: Option to set a different subtitle when offline. * Fixed: Corrected logic to properly check both conditions for showing or hiding action buttons (e.g., Add to Cart, Checkout). * Fixed: Resolved an issue where changing primary and secondary colors in the floating layout incorrectly affected WooCommerce button styles. * Improved: Ensured button styles remain consistent and follow intended color settings across layouts. = 3.2.3 – 10 March 2026 = * Added: Button options for the product order thank you page. = 3.2.2 – 04 March 2026 = * Fixed: Device visibility issue. * Fixed: Popup auto-opening bug. * Improved: Typography consistency for better readability. * Added: Plugin overview video to the configuration help page. * Added: Single Form layout configuration video. = 3.2.1 – 27 February 2026 = * Added: Button options for the Cart page. * Added: Button options for the Checkout page. = 3.2.0 – 10 February 2026 = * Added: WooCommerce, shortcode, and settings as a submenu. * Added: Button options for the Shop page. * Update: Button size customization option. = 3.1.13 – 28 January 2026 = * Improved: General codebase improvements. = 3.1.12 – 24 January 2026 = * Update: Complete redesign of button styles across all components, including Floating Chat, WooCommerce buttons, Shortcodes, Gutenberg blocks, and Elementor widgets. * New: Added several new customization fields for each button to support advanced styling and control. * Improved: General codebase optimizations and internal improvements. = 3.1.11 - 19 January 2026 = * Updated: Plugin readme (FAQs and Installation sections). * Improved: General codebase improvements. = 3.1.10 - January 10, 2026 = * Fixed: Auto-open popup timeout not triggering correctly. * Fixed: Minor CSS styling issues. * Added: Button size customization options. = 3.1.9 - January 05, 2026 = * Fixed: Time-based availability issue. * Security: Added direct file access protection to all PHP files. * Improved: Enhanced overall security and compliance with WordPress.org Plugin Check requirements. = 3.1.8 - December 30, 2025 = * Added: WooCommerce hook options (woocommerce_short_description_after, woocommerce_after_main_content, woocommerce_product_meta_start, woocommerce_product_meta_end, woocommerce_before_single_product_summary, woocommerce_after_single_product_summary) to display WooCommerce buttons. = 3.1.7 - December 21, 2025 = * Fixed: Minor coding issues. = 3.1.6 - December 15, 2025 = * Tested: WordPress 6.9 compatibility. * Fixed: RTL CSS issues. = 3.1.5 - November 28, 2025 = * Added: chathelp_whatsapp_number filter to override the global WhatsApp number using post meta (e.g., directory or product phone numbers). * Added: Context-aware data (post_id, type, message) when generating WhatsApp URLs. * Added: chathelp_whatsapp_url filter to modify the final WhatsApp link. * Improved: WhatsApp URL generation for better extensibility without breaking existing behavior. * Improved: Device detection and URL formatting for consistent behavior across devices. * Improved: Codebase optimizations for performance and stability. = 3.1.4 - November 12, 2025 = * Security: Fixed a critical broken access control vulnerability in the REST API. * Security: Ensured all data is sanitized, validated, and escaped. = 3.1.3 - November 06, 2025 = * Added: Button styles for WooCommerce product pages. * Updated: Additional button position options for product pages. * Updated: Code improvements and compliance with WordPress Plugin Review Guidelines. * Fixed: Missing composer.json file when using Composer. * Security: Escaped all variables and options before output. = 3.1.2 - November 03, 2025 = * Added: Footer copyright notice in template files. = 3.1.1 - October 25, 2025 = * Tested: WordPress 6.8.3 compatibility. * Updated: Codebase improvements. = 3.1.0 - September 15, 2025 = * Added: Leads management (view, filter, and manage leads from the dashboard). * Fixed: Elementor loading issue. * Fixed: Minor CSS issues. = 3.0.0 - August 30, 2025 = * Updated: WhatsApp button block settings for better customization. * Added: Google Analytics integration for enhanced tracking. * Added: Typography options for floating buttons and chat bubble. * Updated: Admin panel for improved user experience. * Added: Demo and documentation links within field descriptions. = 2.2.14 - July 28, 2025 = * Fixed: Second tab hidden when the Single Form layout was not selected. * Fixed: Button hover background not updating when GDPR mode is enabled. * Added: Default animation class applied when switching from Pro to Free. = 2.2.13 - July 26, 2025 = * Added: Smart prefilled message support with variables and conditional logic. * Added: Conditional smart variables in the Message Agents field. * Added: [chat_help] shortcode to place buttons anywhere. * Updated: Codebase cleanup for performance and readability. * Updated: WooCommerce button visibility logic. = 2.2.12 - July 09, 2025 = * Added: Live test option for WhatsApp number and group URL. * Added: Predefined text conditions for WooCommerce buttons. * Fixed: WhatsApp group option not working. = 2.2.11 - July 02, 2025 = * Fixed: PHP warning during plugin activation. = 2.2.10 - July 01, 2025 = * Added: Predefined text option for WooCommerce buttons. * Fixed: Agent photo URL warning. * Updated: Admin UI for improved usability. * Updated: Bubble markup to prevent theme conflicts. * Updated: Gutenberg button block. = 2.2.9 - May 24, 2025 = * Added: Agent photo type field. = 2.2.8 - May 17, 2025 = * Fixed: URL protocol handling. = 2.2.7 - May 10, 2025 = * Fixed: Timezone-related issues. = 2.2.6 - April 22, 2025 = * Fixed: Translation-related warnings in WordPress 6.8. = 2.2.5 - April 18, 2025 = * Added: Plugin logo in the admin panel. * Updated: Save and Reset button UI colors. = 2.2.4 - April 08, 2025 = * Tested: WordPress 6.8 compatibility. * Updated: Plugin help page content. * Updated: Readme file content. = 2.2.3 - March 24, 2025 = * Added: WhatsApp group support. * Added: Redirection option for WhatsApp URLs. = 2.2.2 - March 20, 2025 = * Updated: Admin user experience. * Updated: CSS improvements. = 2.2.1 - March 01, 2024 = * Updated: New overview video. = 2.2.0 - February 22, 2024 = * Added: Support for unlimited form fields. * Updated: Admin options for improved usability. * Tested: WordPress 6.7.2 compatibility. = 2.1.3 - February 05, 2024 = * Added: No-icon option for send message button. * Added: Gutenberg block padding option. = 2.1.2 - January 29, 2024 = * Added: Option to disable floating chat. * Fixed: match expression converted to switch for compatibility. = 2.1.1 - January 29, 2024 = * Added: Gutenberg block padding options. * Updated: Visibility options with advanced features. * Updated: Icon picker improvements. = 2.1.0 - January 17, 2024 = * Added: Single-agent floating layout. * Added: Simple button floating layout. * Updated: Fully redesigned admin panel. * Updated: Option titles and descriptions. = 2.0.14 - November 16, 2024 = * Added: currentURL variable for message templates. * Added: WooCommerce button for single product pages. * Fixed: Reset functionality. * Updated: Default variable values. = 2.0.13 - November 05, 2024 = * Fixed: Minor CSS issues. = 2.0.12 - October 26, 2024 = * Added: Bubble button padding option. * Improved: PHP codebase. = 2.0.11 - October 21, 2024 = * Fixed: PHPCS warnings. * Updated: Required form input fields. * Improved: CSS codebase. = 2.0.10 - October 11, 2024 = * Updated: Code structure improvements. = 2.0.9 - October 04, 2024 = * Fixed: PHP errors, warnings, and notices. * Tested: PHP 8.1.12 compatibility. * Tested: WordPress 6.6.2 compatibility. = 2.0.8 - September 28, 2024 = * Fixed: Tooltip text escaping. * Fixed: Default tooltip width. = 2.0.7 - September 27, 2024 = * Added: Bubble button positioning with custom dimensions. * Added: Floating chatbox positioning options. * Added: Icon sets from the Icofont library. * Updated: Admin option organization. * Added: Button tooltips. * Tested: WordPress 6.6.2 compatibility. = 2.0.6 - September 05, 2024 = * Fixed: Shortcode button issues. = 2.0.5 - September 05, 2024 = * Added: Advanced settings tab. * Updated: Admin option order. * Fixed: Button CSS issues. * Updated: Admin menu position. = 2.0.4 - September 05, 2024 = * Added: Include/exclude page options. = 2.0.3 - September 03, 2024 = * Added: Enable/disable bubble icon option. * Added: Bubble button padding settings. = 2.0.2 - August 20, 2024 = * Fixed: Admin dashboard icon issues. * Added: Page-specific include/exclude options. = 2.0.1 - August 10, 2024 = * Added: Missing icons. * Fixed: Button animation CSS. = 2.0.0 - August 08, 2024 = * Updated: Code structure and compatibility. * Added: New text field. = 1.6.4 = * Added: Placeholder text for WhatsApp messages. = 1.6.3 = * Added: Options to customize Name and Message placeholders. = 1.6.2 = * Fixed: Paragraph font issues in some themes. * Added: Compatibility with latest WordPress version. = 1.6.1 = * Fixed: Font issues in some themes. = 1.6.0 = * Fixed: All issues reported by Plugin Checker. = 1.3.9 = * Added: Compatibility with WordPress 6.4.3. * Added: Admin help page with video. = 1.3.8 = * Added: Custom CSS and JS options. * Improved: Admin UI. * Added: WordPress 6.4.2 compatibility. = 1.3.7 - December 08, 2023 = * Improved: Code structure. = 1.3.6 - December 03, 2023 = * Updated: Plugin codebase. * Added: WordPress 6.4.1 compatibility. = 1.3.5 - October 19, 2023 = * Added: Missing translation strings. * Updated: Security improvements. * Updated: Deprecated Gutenberg hooks. * Added: WordPress 6.3.2 compatibility. = 1.3.4 - June 09, 2023 = * Updated: Plugin display name and banner text. = 1.3.3 - June 09, 2023 = * Added: WordPress 6.3 compatibility. * Fixed: Theme-related CSS conflicts. = 1.3.1 - June 14, 2023 = * Added: Auto-open popup option. * Added: Bubble visibility controls. = 1.3.0 - April 12, 2023 = * Added: Block buttons (basic and advanced). * Added: Block categories. * Added: Pro version link in settings. = 1.2.0 - March 09, 2023 = * Added: GDPR compliance checkbox. = 1.1.0 - January 21, 2022 = * Improved: Code compatibility. * Added: Bubble animations. * Added: Gutenberg button block. = 1.0 = * Initial release. == Upgrade Notice == Update to the latest version for new features, improvements, and bug fixes.