=== FloatMessage — Floating Messages & Live Chat === Contributors: talsibo Tags: floating-messages, live-chat, popup, notification, chat-widget Requires at least: 5.0 Tested up to: 6.9 Requires PHP: 7.4 Stable tag: 1.4.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Add floating messages, popups, and AI-powered live chat to WordPress. 13+ templates, scheduling, and geo targeting. == Description == **FloatMessage** lets you add floating messages and live chat to your WordPress site. Design notifications, popups, banners, and chat widgets in a visual dashboard — no code required. **Free 30-day trial** — no credit card required. Then $10/month or $100/year. = Features = * **One-click connect** — Link your FloatMessage account directly from the plugin settings page * **Visual dashboard** — Design and manage messages from a web-based editor * **Lightweight** — 15KB async script using Shadow DOM isolation * **Theme compatible** — Tested with popular themes and page builders including Elementor, Divi, and Gutenberg = Floating Messages = Create attention-grabbing messages that float on your pages: * **13+ professionally designed templates** — Banners, modals, notifications, newsletter forms, story carousels, sticky footers, blur overlays, and more * **Smart scheduling** — Show at specific times, days of week, or date ranges * **Geo targeting** — Target visitors by country (249 countries supported) * **Trigger rules** — Show on page load, after a delay, on scroll, or when the visitor tries to leave (exit intent) * **Click tracking** — Monitor views and clicks from your dashboard * **Dismiss behavior** — Control when dismissed messages reappear (session, duration, forever) = AI-Powered Live Chat = Talk to visitors in real time — or let AI handle it: * **Real-time messaging** — Visitors chat directly from your site * **AI auto-reply** — Powered by Google Gemini with customizable instructions and 13 preset templates (support, lead gen, sales, booking, and more) * **Admin takeover** — AI automatically stops when you reply manually * **Typing indicators** — Animated dots show while waiting for a reply * **Notification badges** — Pulsing red badge alerts visitors to new messages * **Custom positioning** — Place the chat bubble anywhere with pixel-perfect coordinates * **JavaScript API** — Programmatically control the widget (`FloatMessage.openChat()`, `hideChat()`, etc.) * **Pre-chat forms** — Collect name and email before the conversation starts * **Visitor tracking** — See country, city, page URL, and custom data for each visitor = Pricing = FloatMessage offers a simple, transparent pricing model: * **Free Trial** — 30 days of full access, no credit card required * **Pro Plan** — $10/month or $100/year (save 17%) for unlimited messages, chat, and all features The plugin shows your trial status and days remaining right in the WordPress admin. You'll get a heads-up when your trial is about to expire. = Built for WordPress = * **One-click connect** — Sign up or log in from the plugin settings page, account is linked automatically * **Auto domain setup** — Your WordPress domain is added to your FloatMessage account on connect * **Auto-updates** — New versions appear in your WordPress dashboard automatically * **Settings page** — Configure everything from Settings → FloatMessage * **Admin notices** — Get warned when your trial is expiring or has expired == Installation == = Automatic Installation = 1. Go to **Plugins → Add New** in your WordPress admin 2. Search for **"FloatMessage"** 3. Click **Install Now**, then **Activate** 4. Go to **Settings → FloatMessage** 5. Click **Connect FloatMessage Account** to sign up or log in — your account is linked automatically = Manual Installation = 1. Download the plugin ZIP from [floatmessage.com/downloads/floatmessage-live-chat.zip](https://floatmessage.com/downloads/floatmessage-live-chat.zip) 2. Go to **Plugins → Add New → Upload Plugin** 3. Upload the ZIP and click **Install Now** 4. Activate and configure under **Settings → FloatMessage** = Connect Your Account = 1. Go to **Settings → FloatMessage** in your WordPress admin 2. Click **Connect FloatMessage Account** 3. Sign up or log in on the FloatMessage website 4. You'll be redirected back automatically — your User ID is saved and your WordPress domain is added to your FloatMessage account = Manual Configuration = If you prefer, you can enter your User ID manually: 1. Log in to [floatmessage.com/dashboard](https://floatmessage.com/dashboard) 2. Find your **User ID** in the embed code snippet or under Chat Settings 3. Paste it into the WordPress plugin **User ID** field and save == Frequently Asked Questions == = Is FloatMessage free? = FloatMessage offers a **free 30-day trial** with full access to all features — no credit card required. After the trial, the Pro plan costs **$10/month** or **$100/year** (save 17%). = What happens when my trial expires? = Your floating messages and chat widget will stop appearing on your site. All your messages and settings are preserved — they'll resume as soon as you upgrade. The plugin will show a warning in your WordPress admin before and after expiration. = How do I connect my account? = Click the **Connect FloatMessage Account** button in the plugin settings page. This opens FloatMessage where you can sign up or log in. After authentication, your account is linked automatically and your WordPress domain is added to your FloatMessage dashboard. = Where do I find my User ID? = Your User ID is set automatically when you use the **Connect FloatMessage Account** button. If you need it manually, log in to [floatmessage.com/dashboard](https://floatmessage.com/dashboard) and find it in the embed code snippet or under Chat Settings. = Does it work with Elementor / Divi / WPBakery? = Yes. The plugin adds the script globally in the footer, so it works with every WordPress theme and page builder — including Elementor, Divi, WPBakery, Gutenberg, and GeneratePress. = Will it slow down my site? = The embed script is **15KB**, loads **asynchronously** in the footer, and uses **Shadow DOM** to prevent CSS conflicts. = Can I control the chat widget from JavaScript? = Yes! Enable the JavaScript API in your FloatMessage chat settings, then use: * `FloatMessage.openChat()` — Open the chat panel * `FloatMessage.hideChat()` — Hide the chat widget * `FloatMessage.toggleChat()` — Toggle open/close * `FloatMessage.showChat()` — Show the chat bubble See the full [JavaScript API documentation](https://floatmessage.com/docs/js-api). = Does the plugin update automatically? = Yes. When we release a new version, it appears in your WordPress dashboard alongside other plugin updates. One click to update. = Is my data secure? = All communication between your site and FloatMessage uses HTTPS. Chat messages are encrypted in transit. No visitor data is stored in your WordPress database — everything is managed securely on FloatMessage servers. = How do I get support? = Email us at **info@floatmessage.com** for questions, bug reports, or feature requests. We typically respond within 24 hours. == Screenshots == 1. **Settings page** — Connect your account or enter your User ID to get started 2. **Trial status** — See days remaining on your free trial with upgrade prompts 3. **Floating message** — A notification banner displayed on a website 4. **Live chat widget** — Chat bubble with typing indicator and notification badge 5. **FloatMessage dashboard** — Visual message editor with Copy ID button 6. **AI auto-reply** — Configure AI-powered chat responses == External services == This plugin relies on the FloatMessage service ([floatmessage.com](https://floatmessage.com)) to deliver floating messages and live chat functionality. = What data is sent and when = * **Embed script** — When a page loads on your site, the plugin loads a JavaScript file from `https://floatmessage.com/embed/floatmessage.js` to render your configured floating messages and chat widget. Your User ID is passed as a data attribute on the script tag. * **Account connection** — When you click "Connect FloatMessage Account", the plugin opens floatmessage.com/login with a callback URL pointing back to your WordPress admin. After authentication, FloatMessage redirects back with your User ID. Your WordPress domain is automatically added to your FloatMessage account during this process. * **Account status check** — When an admin visits the plugin settings page, the plugin sends your User ID to `https://floatmessage.com/api/wp-status` to check your plan/trial status. This response is cached for 4 hours. * **Live chat** — When visitors use the chat widget, messages are transmitted to FloatMessage servers in real time. No visitor data is stored in your WordPress database. All message and chat data is managed on FloatMessage servers. * [FloatMessage Terms of Service](https://floatmessage.com/terms) * [FloatMessage Privacy Policy](https://floatmessage.com/privacy) == Changelog == = 1.4.0 = * Simplified setup: only one field (User ID) — removed Message IDs and Custom API URL fields * One-click account connect: sign up or log in directly from the plugin settings page * Auto domain setup: your WordPress domain is automatically added to your FloatMessage account on connect * Improved WordPress compatibility: uses admin_init hook for redirect handling * Updated settings page UI with connect button and success notification = 1.3.0 = * Added new screenshots * Updated branding assets * 'Choose Your Agent' CTA button in chat settings * WordPress plugin documentation page = 1.2.0 = * Switched plugin assets from PNG to JPG for lighter file sizes * Updated icon and banner references = 1.1.0 = * Improved settings page with plan/trial status banner and pricing card * Added support contact (info@floatmessage.com) to settings and plugin links * Fixed upgrade button visibility in WordPress admin * Better promotional copy and documentation = 1.0.0 = * Initial release * Support for all 13+ floating message templates * Live chat widget integration with AI auto-reply * WordPress settings page with plan/trial status display * Auto-update support from floatmessage.com * Admin notices for trial expiration warnings * Settings and Docs links on Plugins page == Upgrade Notice == = 1.4.0 = Simplified setup with one-click account connect. Only User ID required now — Message IDs and API URL fields removed. Your WordPress domain is auto-added to your FloatMessage account. Update recommended. = 1.3.0 = New screenshots, branding update, Choose Your Agent CTA. Update recommended. = 1.2.0 = Lighter plugin assets (JPG). = 1.1.0 = Improved settings page with trial status display, pricing info, and support contact. = 1.0.0 = Initial release. Create a free FloatMessage account to start your 30-day trial — no credit card required.