=== ZillaMetrics Chat ===
Contributors: zillametrics
Tags: chatbot, analytics, integration, license
Requires at least: 5.7
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Donate link: https://zillametrics.com/

Clean admin UI for integrating ZillaMetrics bot with WordPress. Includes License and Preview Bots screens.

== Description ==

This plugin provides an extensible admin interface for connecting a ZillaMetrics standalone bot to your WordPress site. It ships with four admin pages:

* **Welcome / About** — Overview and quick actions.
* **License** — Save and manage your license key.
* **Activate Script/Bot** — Toggle the frontend script/bot and set options.
* **Preview Bots** — List and preview available bots tied to your license.

All screens are separated into individual view files so you can easily edit the content to match your product's exact needs.

**Important:** This plugin connects to external ZillaMetrics services to provide chat functionality. Please review the "External Services" section below for details on what data is transmitted and to which services.

== External Services ==

This plugin relies on external services provided by ZillaMetrics to deliver chat functionality to your website. Below is a detailed description of each service, what data is transmitted, when, and links to relevant terms and privacy policies.

### 1. ZillaMetrics Chat Widget Service (CDN)

**What it does:**
The plugin loads the ZillaMetrics chat widget scripts and styles from our Content Delivery Network (CDN) to provide real-time chat functionality on your website. This service automatically delivers the latest version of the chat widget, ensuring you always have access to new features, security updates, and bug fixes without needing to update the plugin.

**Resources loaded:**
* `https://cdn.zillametrics.com/chat-widget.js` - Core chat widget JavaScript
* `https://cdn.zillametrics.com/widget-bundle.js` - Chat widget bundle and dependencies
* `https://cdn.zillametrics.com/chat-widget.css` - Chat widget styles

**When data is sent:**
* Scripts and styles are loaded on every frontend page where the chat widget is enabled
* Chat widget communicates with ZillaMetrics servers when visitors interact with the chat
* User interactions, messages, and chat session data are transmitted to provide the chat service

**What data is collected:**
* Website visitor information (IP address, user agent, browser information)
* Chat messages and conversations
* Page URL where chat is initiated
* User behavior and interaction data with the chat widget
* Any information voluntarily provided by visitors through the chat interface

**Service Provider:** ZillaMetrics Inc.
**Terms of Service:** https://zillametrics.com/tos/
**Privacy Policy:** https://zillametrics.com/privacy-policy

### 2. ZillaMetrics License Verification API

**What it does:**
The plugin connects to the ZillaMetrics API to verify your license key and retrieve your account information, including available chat bots and configuration settings.

**API Endpoint:**
* `https://api.zillametrics.com/wp-json/zillametrics/v1/license/verify-basic`

**When data is sent:**
* When you enter and save your license key in the admin settings
* Data is only sent from the WordPress admin area, never from the frontend
* Transmission occurs only when an administrator actively saves the license settings

**What data is sent:**
* Your license key
* Product ID (identifier for this plugin)
* WordPress site URL (for domain validation)
* Plugin version number

**What data is received:**
* License validation status
* Available chat bots associated with your account
* Account plan information
* License expiration date

**Service Provider:** ZillaMetrics Inc.
**Terms of Service:** https://zillametrics.com/tos/
**Privacy Policy:** https://zillametrics.com/privacy-policy

### Important Privacy Notes

* The chat widget service processes visitor data to provide real-time chat functionality
* All chat data is stored on ZillaMetrics servers and is subject to ZillaMetrics' privacy policy
* As a site owner, you are responsible for informing your visitors about the use of this chat service in your own privacy policy
* No chat functionality is loaded until you activate a valid license
* You can disable the chat widget at any time by deactivating your license in the plugin settings

By using this plugin, you acknowledge that:
1. Your website will connect to external ZillaMetrics services
2. Visitor data will be transmitted to and processed by ZillaMetrics servers
3. You have reviewed and agree to ZillaMetrics' Terms of Service and Privacy Policy
4. You will inform your website visitors about the use of this third-party chat service in your privacy policy

== Installation ==

1. Upload the plugin zip via **Plugins → Add New → Upload Plugin** and activate.
2. Go to **ZillaMetrics** in the wp-admin menu.
3. Add your **License** and use the **Activate Script/Bot** and **Preview Bots** tabs as needed.

== Frequently Asked Questions ==

= Does this automatically load a frontend script? =
Not by default. Use the **License** screen to authenticate your license and the bot will automatically load `wp_head` or `wp_footer` hooks.

= Where do I edit the tab content? =
Under `admin/views/` you'll find `about.php`, `license.php`, and `preview.php`—each file renders its own admin page.

== Screenshots ==

1. Welcome screen
2. License page
3. Preview Bots page

== Upgrade Notice ==

= 1.0.1 =
Updated to comply with WordPress.org guidelines. Added comprehensive external services documentation and fixed hardcoded file paths.

= 1.0.0 =
Initial release with 4-tab admin structure and WordPress.org-ready headers.

== Changelog ==

= 1.0.1 =
* Added comprehensive external services documentation in readme
* Fixed hardcoded file path for admin spinner - now uses CSS animation
* Improved compliance with WordPress.org plugin guidelines
* Better disclosure of data transmission to ZillaMetrics services

= 1.0.0 =
* Initial release with 4-tab admin structure and WordPress.org-ready headers.
