=== Chat Help – Click to Chat Button & Form ===
Contributors: ThemeAtelier
Tags: whatsapp, whatsapp business, whatsapp chat, click to chat, woocommerce whatsapp
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.0
Stable tag: 3.0.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

WhatsApp Chat🔥 Unlimited customer support tool that allows visitors to engage using "WhatsApp" or "WhatsApp Business". WhatsApp button included.

== 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.

**👁️[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, or disable the bubble with No Floating Chat.
- **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.

### 🛒 Ecommerce & Integration
- **WooCommerce Integration**: Add WhatsApp buttons before/after Add to Cart. Auto-pull SKU, price, sale, and stock details. Engage customers directly from product or shop pages.
- **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**: Flawless across multisite and major 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.

== Full Features & Setup Guide ==
https://youtu.be/RNwVAoGQssI

= 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 AMAZING PRODUCTS FROM ThemeAtelier ==

➡️ **[Darkify Dark Mode](https://wordpress.org/plugins/darkify/)** -  Lightweight, customizable WordPress dark mode plugin for a sleek, accessible, and eye-friendly experience on both frontend and admin dashboard.

➡️ **[Eventful – Events Showcase For The Events Calendar](https://wordpress.org/plugins/eventful/)** -  Elevate your event management with this dynamic addon, enhancing ‘The Events Calendar’ with versatile layouts, advanced filtering, and user-friendly features for superior event showcasing.
	
➡️ **[Domain For Sale](https://wordpress.org/plugins/domain-for-sale/)** - Transform your unused domain names into cash with this easy-to-use plugin that provides a professional template, customizable options, and a contact form for effortless selling.

➡️ **[Greet – Video Bubble Warm Welcome Plugin](https://wordpress.org/plugins/greet-bubble/)** - A powerful and user-friendly video bubble plugin for WordPress that provides website owners with the opportunity to create a dynamic and engaging welcome experience for their visitors.

➡️ **[Eventful for Elementor – Events Showcase For The Events Calendar and Elementor](https://wordpress.org/plugins/eventful-for-elementor/)** -  Elevate your event management with this dynamic addon, enhancing ‘The Events Calendar’ with versatile layouts, advanced filtering, and user-friendly features for superior event showcasing.

== FREQUENTLY ASKED QUESTIONS ==

= Where do I get Support? =

You can contact us trough this channels
<a href="https://wordpress.org/support/plugin/chat-help/">WordPress Plugin Directory</a> || <a href="https://themeatelier.net/contact/">Website</a> || <a href="https://www.facebook.com/ThemeAtelier/">Facebook Page</a> 

= Can I add more than one agent? =
Yes. Multiple agents can be added in premium version.

= Is this plugin GDPR compatible? =
Yes, The plugin don’t save any personal data and don’t use cookies. You also have option to show GDPR compliance notice with checkbox so user can agree.

= Is it translation ready? =
Yes. The plugin is totally translation ready. If it's not support in your language you need to edit it with any translation plugin.

== Installation ==

1. Upload plugin directory to the `/wp-content/plugins/` directory.
2. Activate the plugin.
3. Access 'WhatsApp Chat' menu in left panel of your dashboard and configure as you need.

== Screenshots ==
1. Single Form
2. Single Agent
3. Simple Button
4. Dark Mode
5. WooCommerce Button
6. Shortcode Buttons
7. Gutenberg Button Block

== Changelog ==
= 3.0.0 - August 30, 2025 =
Update: WhatsApp button block settings for better customization.
Added: Google Analytics for enhanced tracking and insights.
Added: Typography options for floating buttons and bubble.
Update: Full admin panel enhanced for better user experience.
Added: Added Demo/Docs link within each field for to understand each field.

= 2.2.14 - July 28, 2025 =
Fixed: Issue where the second tab was 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 version.

= 2.2.13 - July 26, 2025 =
* New: Smart Prefilled Message support with variables and conditional logic — works across all layouts (WooCommerce, Shortcodes, Buttons, Blocks).
* New: Conditional Smart Variables now supported in "Message Agents" field for Single Agent layout.
* New: Added `[chat_help]` shortcode to place buttons anywhere.
* Update: Codebase cleanup for better performance and readability.
* Update: WooCommerce button now remains hidden unless WhatsApp number or group link is configured.

= 2.2.12 - July 09, 2025 =
New: Live test option for WhatsApp number and group url.
New: Condition for predefined text for WooCommerce buttons.
New: Advanced condition for showing floating chat only if number or group link added.
Fixed: Group option not working issue.

= 2.2.11 - July 02, 2025 =
Fixed: PHP warning that occurred during plugin activation.

= 2.2.10 - July 01, 2025 =
New: Added predefined text option for WooCommerce buttons.
Fixed: Resolved agent photo URL warning.
Updated: Refreshed admin UI for improved usability.
Update: Bubble markup for avoiding conflict issue in different themes.
Update: Gutenberg button block.

= 2.2.9 - May 24, 2025 =
Added: Agent photo type field.

= 2.2.8 - May 17, 2025 =
* Fixed: URL protocol.

= 2.2.7 - May 10, 2025 =
* Fixed: Timezone issues.

= 2.2.6 - April 22, 2025 =
* Fixed: The translation-related warning was found with WP 6.8.

= 2.2.5 - April 18, 2025 =
* Added: Plugin logo on admin panel.
* Updated: Save & Reset button's UI color to match with plugin.

= 2.2.4 - April 08, 2025 =
* Tested: WordPress 6.8 compatibility.
* Update: Plugin help page content.
* Updated: Plugin readme content.

= 2.2.3 - March 24, 2025 =
* Added: WhatsApp group option.
* Added: Redirection option for WhatsApp URL.

= 2.2.2 - March 20, 2025 =
* Updated: Plugin admin user experience.
* Updated some CSS codebase.

= 2.2.1 - Mar 01, 2024 =
* Update: New overview video

= 2.2.0 - Feb 22, 2024 =
* Flexibility: Now supports unlimited fields for ultimate customization!
* Update: Admin options for a more intuitive experience.
* Tested: WordPress 6.7.2 compatibility.

= 2.1.3 - Feb 05, 2024 =
* Added: No icon option for send message button.
* Added: Gutenberg block padding option for simple button.

= 2.1.2 - Jan 29, 2024 =
* Added: Option for turn off floating chat.
* Fixed: match expression converted to switch for Compatibility.

= 2.1.1 - Jan 29, 2024 =
* Added: Gutenberg block padding option for buttons.
* Update: Updated visibility option with advanced fetures.
* Update: Icon fields options updated with easy inline pick.

= 2.1.0 - Jan 17, 2024 =
* Added: Single agent floating layout.
* Added: Simple button floating layout.
* Updated: Fully re-designed admin panel.
* Updated: Options title and descriptions.

= 2.0.14 - Nov 16, 2024 =
* Added: currentURL variable for message template.
* Added: WooCommerce button for single page.
* Fixed: Reset functionalities
* Updated: Default values for different variables.

= 2.0.13 - Nov 05, 2024 =
* Fixed: Some CSS issue.

= 2.0.12 - Oct 26, 2024 =
* Added: Bubble button padding Option.
* Improved: Some PHP Codebase.

= 2.0.11 - Oct 21, 2024 =
* Fixed: Some warnings from PHPCS.
* Update: Make required form input fields.
* Improved: Some CSS Codebase.

= 2.0.10 - Oct 11, 2024 =
* Update: Some code structures

= 2.0.9 - Oct 04, 2024 =
* Fixed: Some PHP errors, warning, notices
* Fixed: Latest PHP 8.1.12 compatible
* Checked: WordPress 6.6.2 compatiblity

= 2.0.8 - Sep 28, 2024 =
* Fixed: Tooltip help text strong tag escaping.
* Fixed: Default tooltip width.

= 2.0.7 - Sep 27, 2024 =
* NEW: Position bubble button from screen with specific dimension.
* NEW: Added positioning option for floating chatbox.
* NEW: Added all icon sets from icofont library.
* NEW: Renamed option tabs names.
* NEW: Order admin options for better access.
* NEW: Added button tooltip.
* Update: Code compatibility.
* TESTED: WordPress 6.6.2 compatibility.

= 2.0.6 - Sep 05, 2024 =
* Fix: Shortcode buttons. 

= 2.0.5 - Sep 05, 2024 =
* Added: Added advanced tab and moved advanced settings there.
* Updated: Existing options order for better user experience.
* Fixed: Button CSS issues.
* Update: Admin menu position.

= 2.0.4 - Sep 05, 2024 =
* Added: All available pages for include and exclude pages option

= 2.0.3  – Sep 03, 2024 =
* Added: New option for enable/disable button icon on the bubble
* Added: New option to set paddings for bubble button

= 2.0.2  – Aug 20, 2024 =
* Fix: Icons for admin dashboard
* Added: Exclude/include option for chat bubble on specific pages

= 2.0.1  – Aug 10, 2024 =
* Added: Missing icons
* Fix: Animation CSS for buttons

= 2.0.0  – Aug 08, 2024 =
* Fix: Update code structure
* Update: Code compatibility with latest WordPress version
* Update: Code compatibility with latest PHP version
* Added: New text field

= 1.6.4 =
* Added placeholder text on original whatsapp message.

= 1.6.3 =
* Added options to change Name and Message field placeholder text.

= 1.6.2 =
* Fixed paragraph font issue for some themes
* Added plugin compatibility with latest WordPress

= 1.6.1 =
* Fixed font issue for some themes

= 1.6.0 =
* Fixed all errors comes on plugin checker

= 1.3.9 =
* Compatibility for WordPress 6.4.3
* Added help page in admin panel to showcase help video.

= 1.3.8 =
* Compatibility for WordPress 6.4.2
* Added options for custom CSS and JS
* Improve admin UI for better experience

= 1.3.7 - Dec 08, 2023 =
* Improve coding structures

= 1.3.6 - Dec 03, 2023 =
* Update plugin codebase
* Compatibility for WordPress 6.4.1

= 1.3.5 - Oct 19, 2023 =
* Added missing strings for translation
* Updated security
* Added Compatibility for WordPress 6.3.2
* Updated deprecated hooks for gutenberg block category

= 1.3.4 - Jun 09, 2023 =
* Change plugin display name
* Change banner text

= 1.3.3 - Jun 09, 2023 =
* WordPress 6.3 compatibility
* Fixed some CSS to avoid some themes conflict

= 1.3.1 - Jun 14, 2023 =
* Auto open popup option
* Visibility option for bubble

= 1.3.0 - Apr 12, 2023 =
* Added new block buttons for basic and advanced
* Added category option for block
* Added pro version link in plugin setting

= 1.2.0 - Mar 09, 2023 =
* Added - GDPR compliance checkbox 

= 1.1.0 - Jan 21, 2022 =
* Improve - Code Compatibility
* Added - different bubble button animations
* Added - Gutenberg block for buttons

= 1.0 =
* Initial release

== Upgrade Notice ==
It’s recommended to have a backup of your website before hitting the update button.