=== 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: WordPress Plugin Directory || Support Ticket || Facebook Page = 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.