=== Redigo Social Chat ===
Contributors: depakar
Tags: whatsapp, chat, scroll to top, reading progress bar, floating button
Requires at least: 5.2
Tested up to: 7.1
Stable tag: 1.2.0
Requires PHP: 7.4
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Floating chat button, scroll-to-top button and reading progress bar that work together without overlapping, with a live preview.

== Description ==

Redigo Social Chat adds three lightweight floating elements to your site. Put the buttons in the same corner and they stack automatically, so they never overlap.

Chat button:
* Channels: WhatsApp (with prefilled message), phone, Telegram, email, SMS, Messenger, Viber, Signal and custom URL
* Bundled icons for every channel, plus Instagram, Facebook and X, or your own icon URL
* Text button or round icon-only button
* Colour pickers for button and text

Scroll to top:
* Show after a configurable scroll distance
* Square, rounded or circle shape, size from 36px to 64px
* Chevron, arrow or double chevron icon
* Optional progress ring that fills as the visitor scrolls
* Background, icon and ring colours
* Optional hide on mobile
* Smooth scrolling that respects the reduced motion preference
* Replaces a scroll-to-top button added by a supported theme, so only one shows

Reading progress bar:
* Separate from the scroll-to-top button
* Top or bottom of the screen, 2px to 12px high
* Bar colour, track colour and track opacity
* Optional hide on mobile
* Can hide a progress bar already added by your theme or a footer snippet
* Buttons move away from the bar automatically

Layout:
* Any corner for each button
* Stack order and gap when both buttons share a corner
* Separate desktop and mobile edge spacing

Settings page:
* Tabs for Chat Button, Scroll to Top, Progress Bar and Layout
* Live preview of everything as you edit

No external requests: all icons and scripts are bundled with the plugin.

= For developers =

Filters: `redigo_social_chat_defaults`, `redigo_social_chat_sanitize`, `redigo_social_chat_render_settings`, `redigo_social_chat_chat_url`, `redigo_social_chat_chat_attributes`, `redigo_social_chat_dock_items`, `redigo_social_chat_frontend_config`, `redigo_social_chat_admin_tabs`, `redigo_social_chat_disable_theme_scrolltop`, `redigo_social_chat_theme_progress_selectors`.

Actions: `redigo_social_chat_loaded`, `redigo_social_chat_admin_tab_{id}`, `redigo_social_chat_admin_preview_after`.

The admin preview fires a `rsc:preview` DOM event on `document` after each update.

== Installation ==

1. Upload the folder `redigo-social-chat` to `/wp-content/plugins/`.
2. Activate **Redigo Social Chat** from the Plugins screen.
3. Open **Redigo Social Chat** in the admin menu and save your preferred settings.

== Frequently Asked Questions ==

= My theme already has a scroll-to-top button. Will I see two? =

When the plugin's scroll-to-top button is enabled, it removes a supported theme's button. For other themes, turn off the theme's button or disable the plugin's scroll-to-top in the Scroll to Top tab.

= My site already has a reading progress bar. Will I see two? =

Keep "Replace Existing Bar" checked in the Progress Bar tab. It hides bars with the ID `read-progress-wrap`. Developers can add other selectors with the `redigo_social_chat_theme_progress_selectors` filter.

= How do I show only the chat icon without text? =

Leave the Button Text field empty. The button becomes a round icon.

== Credits ==

Brand icons from the SVG Logos and Simple Icons collections (CC0). Phone, email and SMS icons from Material Design Icons (Apache License 2.0).

== Changelog ==

= 1.2.0 =
* New: reading progress bar with position, height, colours and mobile options
* New: optional progress ring on the scroll-to-top button
* New: email, SMS, Messenger, Viber and Signal channels
* New: all icons bundled locally, no external requests
* New: more developer hooks for add-ons
* Tweak: phone, email, SMS and Viber links no longer open a new tab

= 1.1.0 =
* New: scroll-to-top button with position, threshold, shape, size, icon, colour and mobile options
* New: corner docks so buttons in the same corner stack instead of overlapping
* New: Layout tab with stack order, gap and separate mobile spacing
* New: tabbed settings page with colour pickers and a live preview of both buttons
* New: developer hooks for extending the plugin
* Fix: chat button corner position was not applied

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.2.0 =
Adds a reading progress bar, a progress ring option and five new chat channels. Existing settings are kept.
