=== Querzy — AI Shop Assistant for WooCommerce ===
Contributors: querzy
Tags: woocommerce, ai chatbot, product search, shop assistant, multilingual
Requires at least: 5.8
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 2.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered chat assistant for WooCommerce. Customers ask product questions in any language and get real product cards back. One-click setup.

== Description ==

**Querzy adds an AI shop assistant to your WooCommerce store in under 5 minutes — no feed setup, no developer needed.**

Your customers ask product questions at 2am and leave when no one answers. Querzy responds instantly, in any language, from your live product catalog.

This plugin connects to the Querzy cloud service (querzy.com) to power the AI assistant. A free Querzy account is required — see the External Services section below for full details.

= How it works =

1. Install and activate the plugin
2. Enter your Querzy site identifier and access key (from [querzy.com](https://querzy.com))
3. The plugin syncs your products automatically and adds the chat bubble to your storefront

That's it. No XML feeds to configure. No theme editing. No imports.

= What customers can ask =

* "Do you have treadmills under $500?"
* "Show me protein powders without soy"
* "What's the difference between these two barbells?"
* "Do you have this in size L?"

The assistant understands natural language in **100+ languages** — including Macedonian, Serbian, Albanian, Croatian, Turkish, Arabic, and more.

= Key features =

* **Zero setup friction** — products sync automatically on install; no separate feed plugin required
* **Real product cards** — answers include product images, prices, and direct links to buy
* **100+ languages** — understands and responds in the customer's language
* **Always up to date** — catalog syncs automatically whenever you add, update, or delete products
* **Lightweight** — single script tag, no jQuery dependency, no impact on page speed
* **Privacy-friendly** — no customer PII stored; all data processed in the EU (Hetzner, Germany)

= Requirements =

* A Querzy account — free during early access at [querzy.com](https://querzy.com)
* WooCommerce 6.0 or later
* WordPress 5.8 or later

== Installation ==

= Automatic installation =

1. Go to **Plugins → Add New** in your WordPress admin
2. Search for **Querzy**
3. Click **Install Now**, then **Activate**
4. Go to **Settings → Querzy** and enter your credentials

= Manual installation =

1. Download the plugin zip
2. Go to **Plugins → Add New → Upload Plugin**
3. Upload the zip and activate
4. Go to **Settings → Querzy** and enter your credentials

= First-time setup =

1. Sign up at [querzy.com](https://querzy.com) — free, no credit card required
2. Click **Add site** and register your store
3. Copy your **site identifier** and **access key** from the dashboard
4. Paste both into **Settings → Querzy** in your WordPress admin
5. Click **Save Settings** — the plugin will sync your catalog automatically

The chat bubble will appear on your storefront once your site is approved (usually within a few hours).

== Frequently Asked Questions ==

= Do I need to configure a product feed? =

No. The plugin syncs your WooCommerce products directly to Querzy. You do not need to install a separate feed plugin or configure any URLs.

= Is Querzy free? =

Yes, during early access. Sign up at querzy.com for a free account. Paid plans are available for higher query volumes.

= Which languages are supported? =

The AI understands and responds in 100+ languages, including English, Spanish, French, German, Macedonian, Serbian, Albanian, Croatian, Bulgarian, Turkish, Arabic, and more. It automatically detects the customer's language from their question.

= Will it slow down my store? =

No. The chat widget loads via a single deferred script tag and has no impact on your page's core render path or Core Web Vitals.

= What happens when I add or update products? =

The plugin automatically schedules a catalog sync within 30 seconds of any product save or delete. No manual action needed.

= Can I customise the widget colour? =

Yes. Contact support@querzy.com for help with custom styling.

= Where is my data stored? =

Product data and chat sessions are stored on EU infrastructure (Hetzner, Germany). No customer PII is retained. See the [privacy policy](https://querzy.com/legal/privacy) for full details.

= I lost my access key. How do I get a new one? =

Log in to [querzy.com](https://querzy.com), go to your dashboard, and register the site again. This rotates your key — the old key is immediately revoked.

= Does this plugin work without a Querzy account? =

No. The plugin requires a Querzy account to function. A free account is available at querzy.com. The plugin will not load the chat widget or sync products until valid credentials are entered in the settings page.

== External Services ==

This plugin connects to **Querzy** (https://querzy.com), a third-party AI-powered product search and chat service. External connections are made in two ways:

**1. Product catalog sync (server-side)**

When the plugin is activated, and whenever a product is saved or deleted in WooCommerce, the plugin sends your store's product catalog data to the Querzy API at `https://querzy.com/catalog/refresh`. The data transmitted includes: product IDs, titles, descriptions, prices, SKUs, categories, tags, and image URLs. This request is authenticated with the access key you enter in the plugin settings. No customer data (names, emails, addresses, order history) is transmitted.

**2. Chat widget (client-side)**

A JavaScript file is loaded from `https://querzy.com/widget.js` on your store's frontend. This script renders the chat bubble and handles all AI-powered conversations. Visitor messages entered into the chat are sent directly from the visitor's browser to Querzy's servers for processing. The plugin itself does not log or store visitor chat messages.

Use of this plugin constitutes acceptance of Querzy's terms and policies:

* Terms of Service: https://querzy.com/legal/terms
* Privacy Policy: https://querzy.com/legal/privacy

Store owners are responsible for disclosing the use of this service to their customers and for ensuring compliance with applicable data protection regulations (GDPR, CCPA, etc.) in their jurisdiction.

== Privacy ==

When a store visitor uses the Querzy chat widget, their typed messages are transmitted to Querzy's servers for AI processing. Store owners using this plugin should disclose the use of Querzy's AI chat service in their store's own Privacy Policy.

This plugin does not independently collect, store, or process visitor personal data. All data handling is governed by Querzy's Privacy Policy: https://querzy.com/legal/privacy

== Screenshots ==

1. The chat bubble on a live WooCommerce storefront — customers ask product questions and get real product cards back.
2. Settings page in the WordPress admin — enter your site identifier and access key to connect.
3. Example conversation: a customer asks "Do you have treadmills under $500?" and gets matching products with prices and direct links.

== Changelog ==

= 2.0.0 =
* Complete rewrite — replaces custom chat UI with the official Querzy widget (widget.js)
* Products sync automatically via WP-Cron and product save/delete hooks — no feed plugin needed
* Admin settings: site identifier field added; access key now required; native fetch() in admin JS
* Removed WP REST API proxy — widget calls Querzy directly, enabling streaming responses
* Switched to wp_enqueue_script + script_loader_tag filter for standards-compliant script loading
* No jQuery dependency

= 1.0.0 =
* Initial internal release

== Upgrade Notice ==

= 2.0.0 =
After upgrading, go to Settings → Querzy and confirm your site identifier is entered (new required field). Your saved access key is preserved — no re-entry needed.
