=== HolderChat Connector ===
Contributors: holderchat
Tags: chatbot, ai, live chat, customer support, knowledge base
Requires at least: 5.8
Tested up to: 7.0
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create an AI chatbot from your pages and posts — connect WordPress to HolderChat, sync content automatically, and embed the chat widget.

== Description ==

**HolderChat Connector** turns your WordPress site into an AI-powered support chatbot in one click.

Publish pages and posts as usual — the plugin syncs your content to [HolderChat](https://holderchat.com/), builds a knowledge base, and adds a chat widget to your site. Manage the bot from WordPress Admin or link the site to your HolderChat account for full dashboard access.

= Features =

* **One-click setup** — Create Chatbot provisions your site and starts the first sync
* **Automatic content sync** — Published pages and posts stay up to date (with debounced rebuild)
* **Content selection** — Choose which pages and posts to include or exclude
* **Frontend widget** — Chat bubble loaded from HolderChat CDN
* **Embedded dashboard** — Edit bot settings inside WP Admin
* **Account linking** — Connect the site to your holderchat.com login
* **AI chunking option** — Optional semantic chunking for better answers on long pages

= Requirements =

* WordPress 5.8 or later
* PHP 7.4 or later with OpenSSL recommended
* Outbound HTTPS access to **holderchat.com**
* A site administrator (`manage_options`)

= External service =

This plugin **requires** the HolderChat cloud service at [holderchat.com](https://holderchat.com/). Without it, the plugin cannot create or run a chatbot.

When you use the plugin, data is sent to HolderChat including:

* Your site domain and site name
* Published page and post content (title, URL, plain text, modification date)
* Connection credentials created during setup
* Visitor chat messages submitted through the widget (processed by HolderChat AI)

The chat widget script is loaded from `https://holderchat.com/dynamic/get.js`.

See [Privacy settings documentation](https://holderchat.com/documentation/privacy-settings/) for anonymization options. HolderChat is currently offered free during beta; terms may change at launch.

= Documentation =

* [Getting started](https://holderchat.com/documentation/getting-started-with-holderchat/)
* [WordPress Connector setup](https://holderchat.com/documentation/wordpress-connector-setup/)
* [Content selection](https://holderchat.com/documentation/wordpress-content-selection/)
* [Sync and rebuild](https://holderchat.com/documentation/wordpress-sync-and-rebuild-timing/)

== Installation ==

1. Upload the `holderchat-connector` folder to `/wp-content/plugins/`, or install through **Plugins → Add New** in WordPress.
2. Activate the plugin through the **Plugins** screen.
3. Go to **HolderChat** in the admin menu.
4. (Optional) Choose which content to sync and whether to use AI chunking.
5. Click **Create Chatbot** and wait until the bot status becomes Active.
6. (Recommended) Open **Settings** and click **Link to HolderChat account** to manage the bot from holderchat.com.

== Frequently Asked Questions ==

= Does this plugin work without holderchat.com? =

No. HolderChat Connector is a client for the HolderChat SaaS platform. An internet connection and access to holderchat.com are required.

= What content is synced? =

By default, all **published pages and posts**. You can enable custom selection on the Setup or Settings tab to include or exclude specific items. Unpublished or trashed content is removed from the knowledge base.

= Does the plugin send draft content? =

No. Only published content matching your selection is synced.

= How many chatbots can I create per site? =

One chatbot per connected WordPress site (domain).

= Can I disable the frontend widget? =

Yes. Go to **HolderChat → Settings** and uncheck **Show chat widget on frontend**.

= How do I resync all content? =

On the **Setup** tab, click **Sync all content now** after the site is connected.

= Is HolderChat free? =

During beta, chatbot creation is free with no credit card. See [holderchat.com](https://holderchat.com/) for current pricing.

= Where is my data stored? =

Connection settings are stored in your WordPress database (`wp_options`). Content and chat data are processed and stored on HolderChat servers. Uninstalling the plugin removes local connection options but does not automatically delete your HolderChat account or bot — contact support if needed.

== Screenshots ==

1. Setup tab — create chatbot and content selection
2. Dashboard tab — embedded HolderChat bot editor
3. Settings tab — widget, auto-sync, and account linking

== Changelog ==

= 1.0.0 =
* Initial public release
* One-click chatbot provisioning and content sync
* Auto-sync on post save with retry queue
* Content selection tree (include/exclude pages and posts)
* Frontend chat widget injection
* Embedded dashboard iframe
* Link / unlink HolderChat account
* AI chunking option
* Privacy policy integration for WordPress Privacy tool
* Widget script enqueued via wp_enqueue_script()
* SSL certificate verification enabled by default for HolderChat API requests

== Upgrade Notice ==

= 1.0.0 =
Initial release. Requires holderchat.com connectivity.

== Privacy Policy ==

HolderChat Connector sends site and content data to holderchat.com when you create or sync a chatbot. Visitor messages in the widget are sent to HolderChat for AI responses.

Data transmitted to HolderChat:

* Site domain and name
* Published page/post titles, URLs, plain-text content, and modification dates
* Site connection credentials (site ID and secret)
* Chat messages from website visitors using the widget

Data received from HolderChat:

* Chat widget JavaScript and API token
* Embedded dashboard URL for administrators
* Bot status information

For HolderChat privacy and anonymization options, visit:
https://holderchat.com/documentation/privacy-settings/

When you uninstall this plugin, local connection settings are removed from your WordPress database. Your HolderChat account and chatbot on holderchat.com are not automatically deleted — contact service@holderchat.com if you need data removed from HolderChat servers. To disconnect before uninstall, use Unlink in Settings.
