=== Floatsy — Chat Button Widget ===
Contributors: berkayyavuz61
Tags: chat button, floating chat, live chat, click to chat, business hours
Requires at least: 5.6
Tested up to: 7.1
Requires PHP: 7.0
Stable tag: 2.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add a beautiful floating multi-platform chat widget. WhatsApp, Telegram, Instagram, Facebook and more — no coding needed.

== Description ==

**Floatsy** adds a stunning, fully customizable floating chat button stack to your WordPress website. Connect with your visitors instantly via the world's most popular messaging platforms. Zero coding required — configure everything from a modern, multilingual admin panel.

> 🌍 **11 Admin Panel Languages**: English, Turkish, Chinese, Spanish, Arabic, Hindi, Portuguese, Russian, Japanese, German, French

= Key Features =

**Multi-Platform Support**
* WhatsApp — with optional popup chat or direct link mode
* Telegram — link directly to your channel or username
* Instagram — link to your Instagram profile
* Facebook — Facebook Messenger direct link
* Phone — click-to-call button
* Email — click-to-email button
* Enable only the platforms you need — all others stay hidden

**Smart Fan Layout**
* 1 platform active → single floating button, direct action on click
* 2+ platforms active → one main button, animated fan-out on click
* Each platform button shows in its own brand color with smooth animations

**Per-Platform Visibility Control**
* Hide any platform on mobile devices independently
* Hide any platform on desktop independently
* Full control over which button appears where

**WhatsApp Popup Chat**
* Beautiful WhatsApp-style popup with chat bubble
* Custom agent name, profile photo, status text
* Custom welcome message and pre-filled message
* Online/Offline status based on business hours

**Business Hours**
* Set working days (Mon–Sun individually)
* Set start and end times
* Show custom offline message outside hours

**Appearance**
* 5 button shapes: Circle, Rounded Square, Square, Leaf, Drop
* Per-platform custom colors
* Pulse / ripple animation
* Notification badge with custom count
* Tooltip text next to button
* Configurable display delay

**Visibility Controls**
* Show/hide widget on desktop
* Show/hide widget on mobile
* Hide on specific pages by ID

**Multilingual Admin Panel**
* English · Türkçe · 中文 · Español · العربية · हिन्दी · Português · Русский · 日本語 · Deutsch · Français

= Installation =

1. Go to **Plugins → Add New → Upload Plugin**
2. Upload `floatsy-chat-widget.zip` and click Install Now
3. Activate the plugin
4. Go to **Floatsy Chat** in the left menu
5. Enable the platforms you want and enter your details
6. Click **Save Settings** — done!

== Frequently Asked Questions ==

= How do I set up WhatsApp? =

Go to Platforms tab, enable WhatsApp, enter your phone number with country code (no + sign). Example: 905551234567 for Turkey, 15551234567 for USA.

= Can I use only specific platforms? =

Yes! Each platform has its own enable/disable toggle. Enable only the ones you want.

= What happens with multiple platforms? =

When 2 or more platforms are enabled, a single main floating button appears. Clicking it reveals all platform buttons with a smooth fan animation. No clutter on your site.

= Can I hide a platform on mobile only? =

Yes! Each platform has "Hide on Mobile" and "Hide on Desktop" checkboxes. Mix and match as needed.

= How do business hours work? =

Enable Business Hours in the Availability tab. Set working days and hours. Outside those hours, the WhatsApp popup shows your offline message instead.

= Does it slow down my website? =

No. All scripts load only when the widget is active. The footprint is minimal and optimized for Core Web Vitals.

= Does Floatsy collect any data? =

Only if you allow it. On the settings page Floatsy asks whether you want to share anonymous usage statistics. Nothing is sent unless you click "Allow". You can turn it off anytime under General → Share Anonymous Usage Data. See the "Usage Statistics" section below for details.

= Can I change the admin panel language? =

Yes! Go to the Language tab and pick from 11 languages including Turkish, Arabic (RTL), Chinese, and more.

== Usage Statistics (Opt-in) ==

Floatsy can send anonymous usage statistics to help the developer understand how the plugin is used. This is **disabled by default** and only enabled after the site administrator explicitly opts in.

When enabled, once a day the site sends the following to Google Analytics (GA4 Measurement Protocol, `https://www.google-analytics.com/mp/collect`):

* A random site ID generated by the plugin (not linked to your domain or identity)
* Plugin version, WordPress version, PHP version
* Site locale and admin panel language
* Names of the enabled chat platforms (e.g. whatsapp, telegram)

No site URL, email address, personal data, phone numbers, settings content or visitor data is ever sent. The data is processed by Google — see the [Google Privacy Policy](https://policies.google.com/privacy) and [Google Analytics Terms](https://marketingplatform.google.com/about/analytics/terms/us/). You can opt out at any time under General → Share Anonymous Usage Data; deactivating the plugin also stops all sending.

== Screenshots ==

1. Frontend — single platform floating button
2. Frontend — multi-platform fan animation open
3. Frontend — WhatsApp popup chat
4. Admin panel — Platforms tab with all 6 platforms
5. Admin panel — WhatsApp popup settings
6. Admin panel — per-platform visibility controls
7. Admin panel — Business Hours tab
8. Admin panel — Language selector (11 languages)

== Changelog ==

= 2.1.0 =
* NEW: Optional, opt-in anonymous usage statistics (disabled until the admin allows it)
* NEW: "Share Anonymous Usage Data" toggle in the General tab
* IMPROVED: Missing translations now fall back to English

= 2.0.0 =
* NEW: Multi-platform support — WhatsApp, Telegram, Instagram, Facebook, Phone, Email
* NEW: Smart fan-out animation when multiple platforms are active
* NEW: Per-platform hide on mobile / hide on desktop controls
* NEW: Per-platform custom colors and labels
* NEW: Modular platform registry — easy to extend
* IMPROVED: Admin panel redesigned with platform management cards
* IMPROVED: Sidebar quick status live update
* IMPROVED: 11 admin panel languages (added Turkish)

= 1.0.0 =
* Initial release with WhatsApp floating button
* Popup chat and direct link modes
* 5 button shapes
* Business hours and offline message
* Visibility controls
* Multilingual admin panel

== Upgrade Notice ==

= 2.1.0 =
Adds an optional, opt-in anonymous usage statistics setting. Nothing is sent unless you allow it.

= 2.0.0 =
Major update — adds multi-platform support, per-platform visibility controls, and a redesigned admin panel. All existing WhatsApp settings are preserved.
