=== ObriiFlow Social Widget ===
Contributors: obriiflow
Tags: messenger, social, whatsapp, telegram, widget
Requires at least: 5.9
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Floating social messenger widget with icon carousel, greeting bubble, click stats, and full admin panel.

== Description ==

**ObriiFlow Social Widget** adds a floating button to your site that cycles through your social messenger icons in a carousel. Visitors click to open a list of all your social links in one place.

**Key features:**

* Icon carousel — cycles through all active messengers automatically
* Greeting bubble — customizable text bubble with delay timer
* Built-in stats — tracks widget views and clicks per messenger
* Admin panel — manage messengers, reorder via drag & drop
* Position control — left or right, with custom px offsets
* Multilingual — English, Ukrainian, Russian interface
* Supports: Instagram, Telegram, WhatsApp, Viber, Messenger, Facebook, TikTok, X/Twitter, LinkedIn, YouTube, Email

No coding required. Works with any theme.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`
2. Activate the plugin in **Plugins → Installed Plugins**
3. Go to **Social Widget → Messengers** and add your links
4. Go to **Social Widget → Settings** to configure position, bubble, and carousel

== Frequently Asked Questions ==

= Which messengers are supported? =
Instagram, Telegram, WhatsApp, Viber, Facebook Messenger, Facebook, TikTok, X/Twitter, LinkedIn, YouTube, and Email.

= Can I change the position of the widget? =
Yes. In Settings you can choose left or right side, and set custom pixel offsets from the edge and bottom.

= Does it track clicks? =
Yes. The Dashboard shows total views, total clicks, and a breakdown of clicks per messenger for the last 30 days.

= Is it compatible with page builders? =
Yes, tested with Elementor, Flatsome, and standard WordPress themes.

== Screenshots ==

1. Widget on the frontend — closed state with carousel
2. Widget on the frontend — open state with messenger list
3. Admin panel — Messengers page with drag & drop
4. Admin panel — Settings page
5. Admin panel — Dashboard with stats chart

== Changelog ==

= 1.0.1 =
* Initial public release

== Upgrade Notice ==

= 1.0.1 =
Initial release.