=== ChatHelp – Click to Chat Button, WooCommerce 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.5.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Add a WhatsApp chat button, WooCommerce WhatsApp order button & click-to-chat floating widget. Capture leads & convert visitors via chat.
== 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 with a built-in **analytics dashboard** to track real visitors, views, conversions, and leads over time.

**New in 3.5.0:** a completely rebuilt **React admin** with a modern interface, **multiple Chat Layouts** (create as many floating chat widgets as you need, each with its own agents, appearance, and behavior), and **Assign Layouts** to control exactly which posts, pages, or WooCommerce content each layout appears on. Settings now load and save over the **REST API** for a noticeably faster admin experience.

[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
- **Modern React Admin**: Fully rebuilt admin interface — fast, clean navigation and a dedicated layout editor. Settings are served over the WordPress REST API for quicker loads and saves.
- **Multiple Chat Layouts**: Create and manage as many floating chat widgets as you need, each with its own layout, agents, appearance, and behavior settings.
- **Assign Layouts**: Choose exactly where each saved Chat Layout appears — assign it to specific posts, pages, or WooCommerce content.
- **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
- **Analytics Dashboard**: Built-in real-time dashboard tracking visitors, views, conversions, and leads — with performance trendlines, device breakdown (Desktop/Mobile), and date-range filters (This Week, This Month, Custom, and more).
- **Layout-Aware Conversion Tracking**: Each chat layout fires a conversion event at the exact correct user action moment for accurate data.
- **Leads Export**: Export leads to CSV with a live progress state and clear success/error notifications.
- **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).
- **Security Hardened**: All dynamic output escaped and admin redirects made safe, following WordPress.org Plugin Check recommendations.

### 🌐 Compatibility & Performance
- **WordPress 7.0 Ready**: The WhatsApp Button block uses Block API version 3 for full compatibility with the iframe block editor.
- **Lean Download**: Legacy settings framework and unused bundled assets removed — roughly 2.6 MB smaller.
- **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

Pro options are now shown right inside the free admin with a **"PRO" badge** instead of being hidden — so you can see exactly what Pro adds before upgrading.

### 💬 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.
- **Multi-Agent Form**: Let visitors pick an agent and submit a form in the same chat flow.
- **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. Custom icon uploads supported.
- **Transition Effects for Circle Icon**: Choose from 4 smooth animation styles.
- **Flexible Bubble Positioning**: Place the floating chat bubble on the right or centered.
- **Responsive Positioning**: Set separate bubble positions and offsets for desktop and mobile.

### ⚙️ Advanced Controls & Integrations
- **Visibility Control Options**: Fine-tune where and when your chat appears — by templates, pages, posts, products, categories, and tags.
- **Content Visibility Rules**: Advanced per-layout rules for showing or hiding chat on specific content.
- **Webhooks Integration**: Connect with external systems and automation tools using custom webhooks.
- **Traffic Breakdown Analytics**: Unlock Countries, Pages, and Browsers reporting in the analytics dashboard.

== 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. Single Form WhatsApp chat widget with subject and message fields for direct customer support and lead capture.
2. Pre-Chat welcome message widget with agent profile and Start Chat button to boost WhatsApp engagement.
3. Floating WhatsApp button with "Need Help? Chat with us" call-to-action to increase customer conversions.
4. WooCommerce product page with "Order Via WhatsApp" buttons and an online support chat widget for instant ordering.
5. WooCommerce single product page "Get a Quote via WhatsApp" button with easy admin settings panel.
6. Multiple WhatsApp chat button styles and shortcode options - icons, avatars, hover effects, and customizable sizes.
7. Chat Help Pro analytics dashboard tracking visitors, views, conversions, leads, and device performance.
8. Single Form chat experience admin settings with WhatsApp number, form fields, pre-filled messages, and availability scheduling.
9. Leads management dashboard to view, filter, export, and track WhatsApp form submissions and visitor details.
10. ChatHelp WooCommerce settings for product page WhatsApp buttons with full styling and customization controls.
11. ChatHelp shortcode generator to add customizable WhatsApp chat buttons to any page, post, or widget.
12. ChatHelp advanced settings for WhatsApp URL options, webhooks, analytics, and custom CSS & JS.
13. WhatsApp Button Gutenberg block for adding chat buttons directly in the WordPress block editor.
14. WhatsApp chat button integration with Elementor page builder for drag-and-drop customization.

== Changelog ==
= 3.5.1 – 14 July 2026 =
* Fixed: Chat Layouts (and the Dashboard analytics) failed to load with a "Failed to load layouts" error when the site used the "Plain" permalink setting. REST requests are now built with the correct query-string separator so they work under any permalink structure.
* Fixed: Removed the development-only coding-standards packages (PHP_CodeSniffer / WPCS) from the committed vendor directory. Their test fixtures contained sample git merge-conflict markers that some editors flagged as real conflicts. Only the runtime autoloader is now included.

= 3.5.0 – 14 July 2026 =
* Added: Completely redesigned admin built with React — the same modern interface, navigation and page structure as WhatsApp Chat Help Pro.
* Added: Chat Layouts — create and manage multiple floating chat widgets, each with its own layout, agents, appearance and behavior settings, right from the new layout editor.
* Added: Assign Layouts — choose exactly where each saved Chat Layout appears by assigning it to specific posts, pages or WooCommerce content.
* Added: Pro-only options (Multi-Agent, Multi-Agent Form, Dark & Night bubble modes, custom icons, responsive positioning, content visibility rules and more) are now shown in place with a "PRO" badge instead of being hidden, so you can see exactly what Pro adds.
* Improved: Settings are now served over the REST API, which makes the settings pages load and save noticeably faster.
* Improved: The Leads menu item now opens the Leads screen directly.
* Improved: Exporting leads to CSV now shows a progress state and a success or error notification instead of failing silently.
* Improved: Security hardening across the plugin — all dynamic output is escaped and admin redirects use safe redirects, following the WordPress.org Plugin Check recommendations.
* Improved: The WhatsApp Button editor block now uses Block API version 3 for compatibility with the WordPress 7.0 iframe block editor.
* Changed: Webhooks settings are now a Pro feature — the section stays visible as a read-only preview with an Upgrade to Pro panel. (The free version never sent webhook requests; any saved values are preserved.)
* Changed: Removed the legacy Codestar settings framework and unused bundled assets (~2.6 MB smaller download).
* Fixed: The "rate us" prompt in the admin footer could disappear when another installed plugin also overrides the footer text.
* Note: All existing settings are preserved — this release does not change or reset any of your saved options.

= 3.4.3 – 28 June 2026 =
* Added: {shipping} placeholder for the WooCommerce Cart and Checkout pre-filled messages — inserts the customer's shipping first/last name, company, address line 1 & 2, city, state, postcode and country, with graceful fallback to billing details.
* Improved: On the Checkout page the {shipping} placeholder now refreshes from the live checkout form — including manual field edits, the "ship to a different address" toggle, and WooCommerce AJAX updates — so the WhatsApp message always sends the latest shipping information.
* Fixed: Product Page button could leak onto the Cart page (once per cart item); it is now scoped to single product pages only.
* Fixed: WhatsApp button not appearing on the WooCommerce Checkout block. The button was only hooked into the classic (shortcode) checkout actions, which do not fire on the block-based checkout; it is now rendered on the block-based checkout as well.

= 3.4.2 – 24 May 2026 =
* Fixed: Recommended free plugins grid for admin panel.

= 3.4.1 – 20 May 2026 =
* Added: WhatsApp Group support for the Form Chat, and Pre-Chat Message layouts — on submit, opens a copy-to-clipboard modal with the group invite URL on the "Go to WhatsApp" button.
* Added: Modal CTA inherits the send-button color settings via CSS variables (`--wHelp-color-primary`, `--wHelp-color-secondary`, `--text-color`, `--text-hover-color`).
* Improved: Form submit pipeline now forwards the WhatsApp type to the backend so the correct URL (number deep-link vs. group invite) is generated server-side.
* Improved: Modal closes via overlay click, close button, Escape key, or after navigating to WhatsApp; clipboard fallback for non-secure contexts and older mobile browsers.

= 3.4.0 – 13 May 2026 =
* Added: Analytics Dashboard — new first-item admin page with real-time visitor, view, and conversion tracking.
* Added: Performance Trendline chart showing visitors, views, conversions, and leads over time with toggle filters.
* Added: Device Breakdown — donut charts showing Desktop, Mobile, and Other device stats.
* Added: Traffic Breakdown section — Countries, Pages, and Browsers analytics (upgrade to Pro to unlock).
* Added: Layout-aware conversion tracking — each chat layout fires conversion at the correct user action moment.
* Added: Dashboard filter by date period (This Week, Last Week, This Month, Last Month, This Year, Last Year, Custom).

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

= 3.5.1 =
Bug-fix release: Chat Layouts and the analytics dashboard now load correctly on sites using the "Plain" permalink setting. Recommended for all users.

= 3.5.0 =
Major update: brand-new React admin, multiple Chat Layouts with per-layout agents and styling, Assign Layouts for precise placement, REST API-powered settings for faster loads, security hardening, and a 2.6 MB smaller download. All existing settings are preserved. Webhooks are now a Pro feature (the free version never sent webhook requests; saved values are kept).

= 3.4.0 =
Major update: introduces a built-in Analytics Dashboard with real-time visitor, view, conversion, and lead tracking — including performance trendlines, device breakdown, and flexible date filters. Upgrade recommended for all users.