=== Mondivio AI Support Chat for WooCommerce ===
Contributors: mondivio
Tags: woocommerce, chatbot, ai, support, chat
Requires at least: 6.6
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Multilingual AI support chat for WooCommerce. Answers product, shipping and policy questions from your own store data — with your own AI API key.

== Description ==

Mondivio AI Support Chat adds an AI-powered chat widget to your WooCommerce store that actually knows your store:

* **Answers product questions from your live catalogue** — prices, availability, variations, alternatives — using WooCommerce data at the moment the customer asks.
* **Knows your shipping, returns and FAQ pages** — pick up to 100 pages it may use as knowledge, add free-text store notes; it never invents policies.
* **Replies in the customer's language** — a Dutch customer gets a Dutch answer, an English customer an English one. Your primary language plus up to 50 extra languages.
* **Conversation log in wp-admin** — read every conversation, delete any of them, and choose a retention period of 1–90 days after which they are removed automatically.
* **Bring your own AI key** — connect OpenAI, Anthropic (Claude), Google (Gemini) or any OpenAI-compatible endpoint. You pay your provider directly at their prices; typical cost for a small store is a few dollars per month. The plugin adds no markup.
* **Optional "Powered by" badge** — off by default; a checkbox on the Widget tab turns it on if you want to show it.

Everything in this plugin is fully functional with no key, account or usage limit. Guest order-status lookup and human hand-off tickets are not part of this plugin; they are available in the separately sold Mondivio AI Support Chat extension on WooCommerce.com.

= Privacy by design =

* Conversations are auto-deleted after your chosen retention period.
* Visitor IPs are anonymised by default (or not stored at all).
* Integrated with the WordPress privacy tools (data export and erasure).
* The assistant only ever sees public catalogue data and the pages you tick — never customer accounts, orders or payment data.

== External services ==

This plugin sends chat content to the AI provider **you configure and hold the account for**. Nothing is sent anywhere until you enter an API key and enable the chat.

Depending on your choice, messages (the customer's chat text and your configured store knowledge) are sent to one of:

* OpenAI — https://api.openai.com — [Terms](https://openai.com/policies/terms-of-use), [Privacy](https://openai.com/policies/privacy-policy)
* Anthropic — https://api.anthropic.com — [Terms](https://www.anthropic.com/legal/consumer-terms), [Privacy](https://www.anthropic.com/legal/privacy)
* Google (Gemini API) — https://generativelanguage.googleapis.com — [Terms](https://ai.google.dev/gemini-api/terms), [Privacy](https://policies.google.com/privacy)
* Or a custom OpenAI-compatible endpoint you control.

**No telemetry:** this plugin contains no third-party SDK and no analytics. No data is ever sent to the plugin author. The only outbound requests are to the AI provider you configure. Disclose your AI provider in your store's privacy policy.

== Installation ==

1. Install and activate the plugin (WooCommerce must be active).
2. Go to **WooCommerce → Mondivio AI Support Chat → AI Provider**, choose your provider, paste your API key and press **Save settings**, then **Test connection**.
3. On **Knowledge**, tick your shipping/returns/FAQ pages and add store notes.
4. On **General**, enable the chat. Done — the widget appears on your storefront.

== Frequently Asked Questions ==

= How do I get support? =

Post on the plugin's WordPress.org support forum, or email us directly at support@mondivio.com — we usually reply within one business day.

= Do I need my own OpenAI / Anthropic / Google account? =

Yes. You create an API key with the provider of your choice and paste it into the settings. You pay them directly for usage; a typical small store spends only a few dollars per month with the recommended small models.

= Is anything limited or locked? =

No. Every feature in this plugin is available from the moment you activate it. There is nothing to unlock and no usage quota.

= Can the assistant answer "where is my order?" =

Not in this plugin. It answers from your catalogue and the pages you select, and can point the customer to your account page or contact details. Verified guest order lookup and ticket hand-off are part of the separate Mondivio AI Support Chat extension on WooCommerce.com.

= Which languages are supported? =

The assistant replies in the language the customer writes in. Set your primary language and up to 50 extra languages on the Language tab.

= Does it work with caching and optimization plugins? =

Yes. The widget recovers automatically from stale nonces on page-cached sites (WP Rocket, LiteSpeed, W3TC, SiteGround Optimizer, Cloudflare APO) and ships opt-out attributes for JS delay/defer/combine (Rocket Loader, WP Rocket Delay JS, LiteSpeed). If your optimizer still delays it, add `mondivio-ai-support-chat-woocommerce` to its JS exclusion list.

= The chat does not respond — could a security plugin be blocking it? =

Possibly. Some hardening tools block the WordPress REST API for visitors (Solid Security "Restricted Access", All In One WP Security "Disallow unauthorized REST requests", Sucuri/Cloudflare WAF rules on /wp-json/). Allow the `/wp-json/wcsc/v1/` path. The plugin's settings screen runs a health check and warns you when the endpoint is blocked.

= Does it work with WPML or Polylang? =

Yes. Knowledge pages resolve to the visitor's language, product search is language-aware, and the assistant replies in the language the customer writes in.

== Screenshots ==

1. A product question answered from the live catalogue, right in the chat.
2. The chat launcher on a storefront — any theme, any language.
3. Two-minute setup: pick a provider (OpenAI, Claude, Gemini or any OpenAI-compatible endpoint), paste your key, test the connection.
4. The conversation log in wp-admin with retention settings.

== Changelog ==

= 1.0.0 =
* Initial release: live product search, knowledge pages, multilingual replies, conversation log with retention, GDPR export/erase, OpenAI / Anthropic / Google / custom providers.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
