=== Adwings Chat Platform Widget ===
Contributors: advertisingwing1
Tags: chat, live chat, customer support, helpdesk, messaging
Requires at least: 6.3
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Plugin URI: https://wp-chat.advertisingwing.com

Embeddable live chat widget for customer support, powered by the Adwings Chat Platform service.

== Description ==

Adwings Chat Platform Widget adds a real-time chat bubble to every front-end page of your WordPress
site so visitors can talk to your support agents without leaving the page.

Features:

* One-click install — paste your site key and you're live
* Real-time messaging powered by Socket.IO
* Shadow-DOM isolated UI so theme styles can't break the widget
* Configurable accent color and corner placement
* Zero PHP-side socket logic — everything runs in the visitor's browser

You will need an account on the Adwings Chat Platform service to obtain a site key.

== External services ==

This plugin connects to the Adwings Chat Platform service (by default
`https://chat-api.advertisingwing.com`, or a custom endpoint configured via the optional
"Server URL" setting), in order to load the chat widget script and exchange chat messages
between site visitors and support agents in real time.

What data is sent and when:

* The visitor's browser loads the widget JavaScript from the configured Server URL (or the
  optional Widget Script URL override) on every front-end page view of your site.
* When a visitor opens the chat and sends a message, their message content and an
  auto-generated session identifier are sent from the visitor's browser to the configured
  Server URL over HTTPS / WebSocket. No data is sent from the WordPress server itself.
* As with any HTTP/WebSocket request, the connection inherently exposes the visitor's IP
  address and browser User-Agent to the configured service, but the service does not store
  them; only the message content and session identifier are persisted.
* The site key you enter in the plugin settings is rendered as a `data-key` attribute on
  the widget `<script>` tag so the service can identify your site.

The plugin does not transmit any data to third parties on its own. The service you connect
to is operated by the URL you configure in the plugin settings; please refer to that
service's own terms and privacy policy for how it handles transmitted data.

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/adwings-chat-platform-widget/`, or install through the
   WordPress Plugins screen.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Go to **Settings → Adwings Chat Platform Widget** and enter your **Site Key**.
4. Optionally set a custom **Server URL**, widget color, and position. Save changes.

The widget will appear automatically on all non-admin pages.

== Frequently Asked Questions ==

= Where do I get a site key? =

Sign up at the Adwings Chat Platform Widget dashboard and create a site. The site key is shown on the
site's settings page.

= Can I pin a specific widget version? =

Yes. Set **Widget Script URL** in the plugin settings to a versioned URL such as
`https://cdn.example.com/widget-v1.2.3.js`. Leave blank to always load the latest build.

= Does this work with caching plugins? =

Yes. The widget script is loaded directly from our CDN, so page caches don't affect it.

= Does the widget call back to my WordPress server? =

No. All traffic flows from the visitor's browser to the Adwings Chat Platform service over
HTTPS and WebSocket. WordPress only renders a single `<script>` tag.

= Will the widget appear before I configure it? =

No. The widget is only enqueued once the Site Key setting has a value, so nothing is
loaded on the front end until you finish configuration.

== Screenshots ==

1. Settings page in WP Admin.
2. Chat bubble in the bottom-right of a page.
3. Open chat conversation.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
First public release.
