=== FloatClient – Multi-Channel Floating Contact Widget (WhatsApp, Telegram, Messenger) ===
Contributors: digitalinnovationglobal
Donate link: https://digitalinnovationglobal.com/floatclient
Tags: whatsapp, telegram, messenger, floating chat, contact button, click to chat, lead capture
Requires at least: 5.8
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect with your website visitors through WhatsApp, Telegram, and Messenger with an elegant, lightweight floating chat widget.

== Description ==

**FloatClient** is a lightweight, responsive floating contact button and messaging widget for WordPress. Let your visitors start a conversation on their favorite messaging app in one click.

Choose between WhatsApp, Telegram, and Facebook Messenger, customize colors, select from 4 beautiful themes, and control exactly where the widget appears on your site.

No third-party branding, no bloatware, and zero external script dependencies—just pure performance and clean code.

### 🌟 Key Features (Free)

* **3 Popular Channels:** WhatsApp, Telegram, and Facebook Messenger.
* **4 Stunning Visual Themes:**
  * **Classic:** Clean circular toggle button with smooth vertical sliding channel menu.
  * **Bubble:** Animated pulse ring effect with an interactive tooltip call-to-action.
  * **Card:** Expandable popup card with custom brand header and list of channels.
  * **Minimal:** Icon-only circular buttons with hover tooltips for a sleek modern look.
* **Page-Level Visibility Targeting:** Display on all pages, include only selected pages/posts, or exclude specific pages.
* **Position & Spacing Control:** Place the widget at bottom-right or bottom-left with custom horizontal/vertical margins.
* **Separation Margin:** Adjust the gap distance between channels and the toggle button.
* **Custom Welcome Message:** Pre-fill WhatsApp message text so visitors don't have to type from scratch.
* **Appearance Delay:** Set a delay in milliseconds before the widget smoothly fades in.
* **Custom CSS Editor:** Add your own CSS tweaks directly inside the admin panel.
* **Fully Accessible & Responsive:** Built with ARIA roles, keyboard escape navigation (`Esc`), and reduced motion support (`prefers-reduced-motion`).
* **Ultra Lightweight:** Pure Vanilla JavaScript on the frontend—no heavy jQuery, no external trackers, no slow load times.

---

### 🚀 FloatClient Pro (AI Powered)

Looking to automate customer support and capture leads 24/7? **FloatClient Pro** introduces intelligent features to grow your business:

* 🤖 **Smart AI Chatbot (Google Gemini & OpenAI):** Answer customer questions 24/7 using your own business FAQs and context.
* 📲 **1-Click WhatsApp Transfer:** The AI assistant summarizes customer inquiries and hands them off directly to your WhatsApp with pre-filled details.
* 📞 **Additional Channels:** Direct Phone Call (`tel:`), Email (`mailto:`), and Instagram Direct.
* 🎯 **Smart Conversion Triggers:** Automatically open the widget on Exit Intent (when visitors are about to leave) or after scrolling a percentage of the page.
* 📱 **Device-Specific Targeting:** Show specific channels only on mobile devices (like phone calls) or desktop.
* 📊 **Google Analytics 4 & Meta Pixel:** Automatically track button clicks and conversions in real-time.

== Installation ==

1. Upload the `floatclient` folder to your `/wp-content/plugins/` directory, or install directly through the WordPress Plugins screen.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to **Settings > FloatClient** to configure your channels, theme, and display preferences.
4. Save changes and visit your website to see the floating widget in action!

== Frequently Asked Questions ==

= Does FloatClient slow down my website? =
No. FloatClient is engineered for extreme speed. It uses lightweight Vanilla JavaScript on the frontend with zero third-party libraries. If no channels are configured or the page is excluded, no assets are loaded at all.

= How do I configure WhatsApp? =
Go to **Settings > FloatClient > Channels**, enable WhatsApp, and enter your full phone number including country code (e.g. `+34612345678` or `15551234567`). You can also customize the pre-filled message text.

= How do I configure Telegram? =
Enable Telegram in the Channels tab and enter your Telegram username without the `@` symbol (e.g. `myusername`).

= How do I configure Messenger? =
Enable Messenger in the Channels tab and enter your Facebook page username or ID.

= Can I hide the widget on specific pages? =
Yes! In **Settings > FloatClient > Visibility**, choose "All except selected" or "Only on selected pages" and check the pages where you want the widget to appear or be hidden.

== Changelog ==

= 1.0.0 =
* Initial public release as FloatClient.
* Added WhatsApp, Telegram, and Messenger channel support.
* Added 4 visual themes: Classic, Bubble, Card, and Minimal.
* Added custom spacing, margins, and opening gap settings.
* Added page targeting rules (all, include, exclude).
* Added Vanilla JS frontend with ARIA accessibility.
* Added full internationalization support.

== Upgrade Notice ==

= 1.0.0 =
First stable public release.
