=== WhatsApp Chat ===
Contributors: snehalpancholi
Tags: whatsapp, chat, floating button, click to chat, customer support
Requires at least: 6.0
Tested up to: 6.7
Stable tag: 1.0.0
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Floating WhatsApp click-to-chat button with single-agent and multi-agent popup modes.

== Description ==

WhatsApp Chat adds a polished, accessible floating button to your WordPress frontend that lets visitors start a WhatsApp conversation with a single tap. Choose between **Single Agent** mode (direct click-to-chat) or **Multi-Agent** mode (a popup listing your whole support team).

**Key Features**

* Single-agent mode — clicking the button opens WhatsApp with a pre-filled message.
* Multi-agent popup — display a branded team card with names, roles, avatars, and availability hours.
* Animated pulse ring and smooth slide-up popup transition.
* Greeting bubble that auto-dismisses after 5 seconds.
* Custom button color picker.
* Separate visibility controls for mobile and desktop.
* Exclude specific pages/posts by ID.
* WP Media Library integration for agent avatars.
* Fully accessible: ARIA roles, keyboard navigation, Escape key closes popup.
* Dark mode compatible via CSS `prefers-color-scheme`.
* No jQuery, no external libraries, vanilla ES6.
* Lightweight — under 6 KB CSS + JS combined (minified).

== Installation ==

1. Upload the `whatsapp-chat` folder to `/wp-content/plugins/`.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Go to **Settings > WhatsApp Chat**.
4. Enter your WhatsApp phone number (international format, no + or spaces, e.g. `14155551234`).
5. Choose Single or Multi-Agent mode, configure your team, and click **Save Settings**.

The floating button will appear immediately on the frontend.

== Frequently Asked Questions ==

= What format should I use for the phone number? =

Use the full international format without any symbols: country code followed by the number, no `+`, no spaces, no dashes. For example, a US number `+1 (415) 555-1234` becomes `14155551234`.

= Can I hide the button on specific pages? =

Yes. In **Settings > WhatsApp Chat > Visibility**, paste the comma-separated post/page IDs into the **Exclude Pages** field. You can find a page's ID in the URL when editing it in the WordPress admin (`post=42`).

= Does the plugin add any tracking or analytics? =

No. WhatsApp Chat does not collect, transmit, or store any visitor data. All click activity happens entirely between the visitor's browser and WhatsApp's servers via a standard `wa.me` URL.

== Changelog ==

= 1.0.0 =
* Initial release.
* Single-agent click-to-chat mode.
* Multi-agent popup mode with avatar support.
* Greeting bubble with auto-dismiss.
* Visibility controls for mobile/desktop.
* Page exclusion by post ID.
* Custom button color picker.
* AddonLogic auto-update integration.
