ChatHelp – Click to Chat Button, WooCommerce Chat to Order & Floating Chat Form

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

3.5.3 – 28 July 2026

• Fixed: Assign Layouts — the "Select Post(s)" field now follows the row's "Post Type" selection (e.g. picking Page lists Pages), instead of always listing Posts regardless of the chosen type.
• Fixed: The "Floating Chat" sidebar group (Global Chat, Chat Layouts, Leads) collapsed after refreshing an admin page instead of staying open, hiding the submenu items until they were reopened.

3.5.2 – 15 July 2026

• Security: Fixed an authenticated (Contributor and above) stored Cross-Site Scripting vulnerability in the [chat_help] / [ctw] shortcode. The number and group attributes were written into an unquoted data-number / data-group HTML attribute, allowing a crafted value to break out and inject an event handler. Attribute values are now output inside quotes with esc_attr(), and the number / group inputs are additionally sanitized to allowed characters. Reported by Wordfence (CVE-2026-15799).

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.