=== Better Chat Support for Messenger ===
Contributors: themeatelier, faysal61, shshakib2001, tamimaziz
Tags: facebook messenger, messenger chat, chat button, live chat, customer care
Donate Link: https://themeatelier.net/downloads/better-chat-support-for-messenger/
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.0
Stable tag: 2.2.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Add a Facebook Messenger chat button to WordPress — floating chat bubble, pre-filled messages, availability hours, and built-in analytics.

== Description ==

Better Chat Support for Messenger is a free WordPress plugin that adds a Facebook Messenger chat button to your website. Visitors click the floating chat bubble and start a conversation with you on Messenger in just a few clicks — no coding required.

Turn website visitors into conversations: when someone is browsing your products or services and has a question, they can message you instantly through the floating bubble or any of the call-to-action buttons included in the plugin. You get pre-filled messages, a name-and-message lead form, customizable buttons, availability control based on your timezone, offline messaging, and a built-in analytics dashboard — all in the free version.

**👁️[Plugin Demo](https://themeatelier.net/downloads/better-chat-support-for-messenger/#shortcode) | 🚀[Pro Version](https://themeatelier.net/downloads/better-chat-support-for-messenger/) | 👩🏼‍💻[Support](https://wordpress.org/support/plugin/better-chat-support/) | 🌟[Rate this plugin](https://wordpress.org/plugins/better-chat-support/reviews/#new-post)**

== Video demo ==
[youtube https://youtu.be/uskCC8jo4mo]

### WHY BETTER CHAT SUPPORT FOR MESSENGER

Facebook Messenger is one of the world's most-used messaging platforms, which makes it a natural customer support channel. This plugin lets you tap into it without any technical setup.

- **Lightweight and fast** — Installs in a few clicks and won't slow down your site.
- **Fully customizable** — Choose button styles, sizes, positions, colors, and animations to match your design.
- **Instant replies** — Respond to customers in real time instead of waiting on email or phone.
- **Save time and money** — Reduce repetitive calls and emails by routing inquiries to one place.
- **Build relationships** — Faster, friendlier support leads to higher satisfaction and repeat customers.
- **Privacy-friendly analytics** — Track visitors, views, and conversions from your own WordPress dashboard, with no third-party service required.

== CORE FEATURES ==

* **Single agent support** – Add a floating chat bubble tied to a single Facebook Messenger account so visitors can reach you instantly.

* **Call-to-action buttons** – Place Messenger buttons anywhere on your site — pages, posts, or sidebars — each with its own independent settings.

* **Availability hours** – Set active hours per day of the week for the floating bubble and individual buttons.

* **Timezone control** – Set your timezone so availability hours reflect your local time, not the visitor’s device clock.

* **Offline messaging** – Automatically show an offline status message to visitors outside your available hours.

* **GDPR compliance** – Enable a GDPR consent checkbox with your own custom notice before visitors start chatting.

* **Floating bubble animations** – Choose from multiple entrance and idle animations to make your chat widget stand out without custom CSS.

* **Elementor widget** – Drag-and-drop Elementor widget with full design control: colors, sizing, icons, and CTA text — no code required.

* **Gutenberg block** – Native block editor support with the same full design options as the Elementor widget.

* **Built-in Analytics Dashboard** – Track visitors, widget views, and conversions directly from your WordPress admin — no third-party service required. The React-powered dashboard displays a performance trendline chart, device breakdown (desktop, mobile, other), and country and browser statistics with date range filtering.

* **Shortcode support** – Use `[mcs_messenger]` to place a Messenger button anywhere on your site with 20+ attributes for full control over style, availability, colors, and CTA text.

* **Auto-open popup** – Configure the chat bubble to open automatically on page load, with an optional delay timer to trigger it after a set number of seconds.

* **Chat layout options** – Choose between an agent card layout (photo, name, greeting) and a simple button layout depending on your design preference.

* **Device visibility & positioning** – Show or hide the bubble per device (desktop, tablet, mobile) and set independent screen position with pixel-level offset for each.

* **Theme styles** – Switch between Flat and Custom theme styles, toggle light/dark mode, and upload a custom background image for the chat popup.

* **Custom colors** – Set primary and secondary colors to match your brand without touching any CSS.

* **Google Fonts** – Pick any Google Font for the chat widget typography directly from the settings panel.

* **Custom CSS & JavaScript** – Add your own CSS and JS from the Advanced settings tab — only loaded when the chat widget is active.

* **Translation ready** – Fully compatible with `.po`/`.mo` translation workflows and any WordPress translation plugin.


== PREMIUM FEATURES ==

👉 **Everything in Free:** You will get all the free features in premium version.

👉 **Unlimited Chat agents** You will able to add unlimited agents for chat in different way. There has several options to preset them like grid, list, search feature and many more.

👉 **Premium Support** If you face any issue and create a support ticket regarding that we will back to you within 6 hours with solution.

👉 **Lifetime update** The premium plugin is totally lifetime deal with lifetime new update. There is no need for yearly renewals.


## External services
Better Chat Support For Messenger uses [Appsero](https://appsero.com) SDK to collect some telemetry data upon user's confirmation. This helps us to troubleshoot problems faster & make product improvements.

Appsero SDK **does not gather any data by default.** The SDK only starts gathering basic telemetry data **when a user allows it via the admin notice**. We collect the data to ensure a great user experience for all our users.

Integrating Appsero SDK **DOES NOT IMMEDIATELY** start gathering data, **without confirmation from users in any case.**

Learn more about how [Appsero collects and uses this data](https://appsero.com/privacy-policy/).


== OTHER AMAZING PRODUCTS FROM ThemeAtelier ==
➡️ **[Better WhatsApp Chat Support](https://wordpress.org/plugins/chat-help/)** -  A WordPress plugin that allows website owners to easily add a WhatsApp chat bubble to their website and comes with Gutenberg, Elementor and Shortcode options.

➡️ **[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.

➡️ **[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 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.

➡️ **[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.
	
➡️ **[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.

== FREQUENTLY ASKED QUESTIONS ==

= Where do I get support? =

You can reach us through these channels:
<a href="https://wordpress.org/support/plugin/better-chat-support/">WordPress Plugin Directory</a> || <a href="https://themeatelier.net/create-support-ticket/">Support Ticket</a> || <a href="https://www.facebook.com/ThemeAtelier/">Facebook Page</a>

= How do I add the chat bubble to my site? =

After activating the plugin, go to **Messenger > Floating Chat** in your WordPress admin. Enter your Facebook Page ID, choose a chat layout, set your agent details, and save. The bubble will appear automatically on your site.

= Where do I find my Facebook Page ID? =

You can find your Page ID in your Facebook Page settings under "About", or by using a Facebook Page ID lookup tool. Enter the ID (numbers only) in the plugin’s Floating Chat settings.

= Can I add more than one agent? =

Yes. Multiple agents with a list or grid layout can be added in the premium version.

= Can I use the chat button in a specific location on a page? =

Yes. Use the shortcode `[mcs_messenger]`, the Gutenberg block, or the Elementor widget to place a Messenger button anywhere on your page or post.

= What shortcode attributes are available? =

The shortcode supports: `style`, `photo`, `background`, `hover_background`, `text_color`, `icon_color`, `border`, `border_radius`, `padding`, `top_label`, `main_label`, `online`, `offline`, `fbid`, `visibility`, `sizes`, `timezone`, and per-day availability (`sunday` through `saturday`).

= Can I show or hide the bubble on specific pages? =

Yes. The visibility option lets you display the bubble everywhere or restrict it to specific pages, posts, or post types.

= Can I control the bubble’s position on the screen? =

Yes. You can choose from bottom-right, bottom-left, right-middle, and left-middle positions, with pixel-level offset control for each. Independent positioning settings are available for desktop, tablet, and mobile.

= Is this plugin GDPR compatible? =

Yes. The plugin does not save any personal data by default and does not use cookies. You also have an option to show a GDPR compliance notice with a checkbox so users can consent before chatting.

= Does the plugin track analytics? =

Yes. Starting from v2.1.0, the plugin includes a built-in analytics system that tracks visitors, widget views, and conversions. The dashboard shows a performance trendline chart and a device breakdown (desktop, mobile, other), along with country and browser statistics — no third-party analytics service required.

= What is the Leads feature? =

When a visitor submits their information through the name/message form on the chat bubble, it is saved as a lead. You can view, filter, and delete leads from the **Messenger > Dashboard > Leads** page in the admin area.

= Can I customize the look of the bubble? =

Yes. You can choose between Flat and Custom theme styles, pick from 13+ bubble animations, set custom primary and secondary colors, control the bubble icon, tooltip, and add your own CSS.

= Can I set my availability hours? =

Yes. You can configure available hours for each day of the week, set your timezone, and choose what message to show visitors when you are offline.

= Is it translation ready? =

Yes. The plugin is fully translation ready. If your language is not available, you can translate it using any translation plugin or the standard WordPress `.po`/`.mo` workflow.

= Can I add custom CSS or JavaScript? =

Yes. The plugin has a dedicated Advanced settings tab where you can add custom CSS and custom JavaScript that load only when the chat widget is active.

= Will my data be deleted if I uninstall the plugin? =

That depends on your settings. The plugin has a "Clean up data on deletion" option in the Advanced tab. When enabled, all plugin data is removed from the database upon uninstallation.

== Installation ==

**From WordPress Dashboard (recommended)**

1. Go to **Plugins > Add New** in your WordPress admin.
2. Search for **Better Chat Support for Messenger**.
3. Click **Install Now**, then **Activate**.

**Manual Upload**

1. Download the plugin `.zip` file.
2. Go to **Plugins > Add New > Upload Plugin** and upload the `.zip` file, or extract and upload the plugin folder to `/wp-content/plugins/` via FTP.
3. Go to **Plugins** and click **Activate** next to Better Chat Support for Messenger.

**After Activation**

4. Go to **Messenger > Floating Chat** in your WordPress admin menu.
5. Enter your **Facebook Page ID** in the General tab.
6. Set your agent name, photo, subtitle, and greeting message.
7. Configure availability hours and timezone if needed.
8. Choose a bubble layout, position, animation, and theme style.
9. Click **Save** — the chat bubble will appear on your site immediately.
10. Visit **Messenger > Dashboard** to monitor visitors, views, conversions, and leads.

== Screenshots ==

1. Floating Messenger chat bubble with single-agent layout — agent photo, online status, pre-filled greeting message, and a Start Chat button (bottom-right position).
2. Floating chat bubble with an animated "How can I help?" text label on the trigger button.
3. Messenger chat bubble in the Custom theme style with a dark background image behind the greeting message.
4. Call-to-action button styles — pill-shaped Messenger buttons (Button Style 2) and dynamic agent cards showing live "I'm available" and "I'm not available" status based on availability hours.
5. Built-in Analytics Dashboard showing visitors, views, conversions, conversion rate, a performance trendline chart, and a device breakdown — no third-party service required.
6. Floating Chat settings — General tab with Facebook Page ID, agent greeting message, timezone, and per-day availability hours.
7. Header & Footer settings — agent photo, name, online and offline subtitles, header alignment, and Send Message button options.
8. Button settings — floating button style, open/close icons, button size, colors, border, notification badge, tooltip, and screen position.
9. Style settings — bubble animation, Flat and Custom theme styles, light/dark mode, primary and secondary colors, and Google Font selection.
10. Visibility settings — show the chat on desktop, tablet, or mobile, and control which pages, posts, or products display the bubble.
11. Shortcode generator — build a Messenger button with custom labels, colors, timezone, and availability, then copy the ready-made shortcode.
12. Advanced settings — clean-up data on deletion, open chat in a new tab, and add custom CSS and JavaScript to the chat widget.

== Changelog ==
= 2.2.1 – 11 June, 2026 =
* Fixed: PHP warning "preg_match_all(): Unknown modifier 'b'" triggered by the Help page reviews on some servers.

= 2.2.0 – 11 June, 2026 =
* Update: Complete admin panel redesign — migrated from Codestar Framework to React-based architecture
* Update: Improved overall user experience and performance of admin dashboard
* Update: Removed full-page reload issue — admin navigation now works with React Router (no reload on menu click)
* Update: Enhanced UI responsiveness and smoother navigation between Dashboard, Settings, Floating Chat, Shortcode, and Help pages
* Improved: All previously unstable or partially working options are now fully functional
* Improved: Better state management across admin settings
* Improved: Faster and more stable admin interactions
* Improved: Overall plugin UX consistency across all settings pages
* Fixed: Admin menu navigation reload issue (now fully SPA-based using React Router)
* Fixed: Several settings/options not working properly in previous Codestar version
* Fixed: UI inconsistency and broken behavior in older admin components
* Fixed: Improved handling of configuration changes without page reload
* Fixed: Stability issues in multiple admin settings fields

= 2.1.1 – 22 May, 2026 =
* Fixed: Conversion tracking for Gutenberg block, shortcode, and Elementor widget button clicks.

= 2.1.0 – 14 May, 2026 =
* Added: React-powered admin Dashboard as the new main plugin page.
* Added: Analytics system to track visitors, widget views, and conversions with date range filtering.
* Added: Analytics trend line chart showing visitors, views, and conversions over time.
* Added: Country and browser detection for analytics tracking.
* Added: Frontend tracking script injected automatically to capture widget interactions.
* Updated: Plugin main menu page now renders via React for a modern SPA experience.
* Updated: Plugin admin menu renamed to "Messenger".
* Updated: Floating Chat settings moved to a dedicated submenu page.

= 2.0.1 – 01 May, 2026 =
* Added: Theme Style option to choose different chat bubble designs (e.g., Flat and Custom styles).
* Added: Display Notification Icon option to show or hide the notification icon in the interface.

= 2.0.0 – 22 April, 2026 =
* Added: New “Simple Button” floating layout.
* Updated: Completely redesigned admin panel for improved usability.
* Updated: Refined option titles and descriptions for better clarity.
* Updated: Enhanced Gutenberg block settings and controls.
* Updated: Improved Elementor widget options and customization.

= 1.3.2 – 01 April, 2026 =
* Added: Floating Chat Layout field.
* Improved: Option dependency logic.
* Tested up to: WordPress 7.0.

= 1.3.1 – 11 March, 2026 =
* Added: Custom CSS and JavaScrip option under setting to the Advance tag.
* Added: More bubble position.
* Added: Visibility option for bubble.
* Fixed: Agent availability issue.
* Fixed: Device visibility issue.
* Update: Moved Clean-up Data on Deletion setting to the Advance tab. 

= 1.2.22 – January 27, 2026 =
* Removed: Appsero integration.
* Update: Some codebase.

= 1.2.21 – December 31, 2025 =
* Added: Data clean-up option on deletion.
* Added: Enable/disable option for the floating chat feature.
* Added: New shortcode attributes: background, visibility, size, and rounded corners.
* Fixed: Codebase refactored for improved stability and maintainability.
* Updated: Verified compatibility with the latest WordPress release.
* Updated: Verified compatibility with the latest PHP version.

= 1.2.20 December 21 2025 =
* Tested: WordPress 6.9 compatibility.

= 1.2.19 November 12 2025 =
* Updated: Ensured all data is properly sanitized, validated, and escaped.

= 1.2.18 October 25 2025 =
* Tested: WordPress 6.8.3 compatibility.
* Update: Improved some codebase

= 1.2.17 - July 29, 2025 =
* Added: Conditional check for photo display — if no photo is set, it won’t show a blank image.
* Fixed: Button CSS issues when using various animation styles.
* Updated: Plugin markup across different scenarios to ensure better compatibility with all types of themes.

= 1.2.16 - June 26, 2025 =
* Update: Plugin menu name to 'Messenger' for better useablity.
* Update: Recommanded plugins.
* Update: Upgrade to pro plugin menu.

= 1.2.15 - May 12, 2025 =
* Fixed: Timezone issues.
* Added: Position control option.

= 1.2.14 - April 22, 2025 =
* Tested: WordPress 6.8 compatibility.
* Fix: The translation-related warning with WP 6.8.

= 1.2.13 - April 09, 2025 =
* Updted: Some codebase.

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

1.2.11
* TESTED: WordPress 6.7.1 compatibility.

1.2.10
* TESTED: WordPress 6.7 compatibility.

=1.2.9=
* Added: Some translation strings.
* Fixed: Some eccaping issues.

=1.2.8=
* Fixed: Preview issue for agent photo
* Tested: WordPress 6.6.2

=1.2.7=
* Submenu hidden from admin side menu.
* Admin top bar menu hidden
* Nav style added as Inline.

=1.1.4=
* Change plugin display name
* Added compatibility with latest WordPress 6.3

=1.0.0=
* Initial release

== Upgrade Notice ==
= 2.2.1 =
Redesigned Help page with genuine 5-star reviews and a video popup, plus a fix for a PHP warning from the Help reviews. Recommended for all users.