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

WooCommerce AI chatbot — customers ask product questions in natural language, get real product cards back. Works in 100+ languages. One plugin.

== 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 access key from [querzy.com](https://querzy.com?utm_source=wordpress-org&utm_medium=plugin-listing&utm_campaign=readme) — your store domain is detected automatically
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)

Works with all WooCommerce themes out of the box — no CSS conflicts, no template overrides, no custom code required.

= Requirements =

* A Querzy account — free during early access at [querzy.com](https://querzy.com?utm_source=wordpress-org&utm_medium=plugin-listing&utm_campaign=readme)
* 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?utm_source=wordpress-org&utm_medium=plugin-listing&utm_campaign=readme) — free, no credit card required
2. Click **Add site** and register your store using your store's domain
3. Copy your **access key** from the Querzy dashboard
4. Go to **Settings → Querzy** in your WordPress admin — your store domain is detected automatically
5. Paste your access key and 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 ==

= Does Querzy require any API keys or AI configuration? =

No. Everything is managed via the Querzy dashboard. Install the plugin, paste your access key, and the AI reads your WooCommerce catalog automatically. No AI setup, no third-party API keys to manage.

= Does Querzy work with my WooCommerce theme? =

Yes. Querzy injects a floating chat bubble that is completely theme-independent. It works with Storefront, Astra, Flatsome, OceanWP, and any custom theme — no CSS conflicts, no template overrides required.

= 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](https://querzy.com?utm_source=wordpress-org&utm_medium=plugin-listing&utm_campaign=readme) 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](https://querzy.com?utm_source=wordpress-org&utm_medium=plugin-listing&utm_campaign=readme). 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. A customer asks "Do you have protein powder without soy?" — Querzy returns 3 matching product cards with images, prices, and Add to Cart buttons, live on a WooCommerce storefront.
2. The Querzy settings page — store domain auto-detected, one access key field, catalog sync status visible. Setup done in under 2 minutes.
3. A customer asks a product question in Macedonian — Querzy responds with matching product cards in the same language. One of 100+ supported languages, including low-resource ones no competing plugin handles.

== Changelog ==

= 2.5.1 - 2026-08-16 =
* Chat widget now tags itself as coming from this plugin in your Querzy analytics, so opens/
  sessions from WordPress sites are distinguishable from other integrations. No settings change
  needed — this is automatic.

= 2.5.0 - 2026-07-29 =
* Product sync now fetches and sends your catalog a page at a time instead of loading every
  product into memory at once — fixes sync failing or timing out on large catalogs.
* If a sync is interrupted (e.g. a server error partway through), "Sync now" no longer gets
  permanently stuck saying a sync is already in progress — it now recovers automatically.

= 2.4.0 - 2026-07-26 =
* Added a separate Sync Key, distinct from the Widget Key — product catalog sync now requires
  it specifically. The Widget Key (safe to embed publicly, used by the chat widget) no longer
  has catalog-write access on its own. If you're updating from an earlier version, get your new
  Sync Key from your Querzy dashboard and enter it in Settings → Querzy before your next sync.
* Sync Key field is now masked (password-style input) in the settings page.

= 2.3.0 - 2026-07-25 =
* Added Cloudflare Turnstile support to the embedded chat widget (bot-abuse protection).
* Backend URL is no longer merchant-configurable — always querzy.com. Simplifies setup and
  removes a self-hosting-style misconfiguration/SSRF vector.

= 2.2.0 - 2026-07-23 =
* Simplified the settings page — removed the self-hosting URL field (Querzy is a hosted service, not something you self-host) and the technical "store domain" field. Connecting your store is now a single "Get your access key" button.
* Sync status now shows plain-language messages instead of technical log text, with a "Show technical details" section for support requests.
* Added a best-effort sync-log beacon so support can see sync attempts without the merchant needing to report anything.

= 2.1.0 - 2026-06-10 =
* Setup is now faster — your site identifier is filled in automatically, no copy-pasting required
* Performance and stability improvements

= 2.0.0 - 2026-06-05 =
* Responses now stream in real time — customers see answers appearing word by word instead of waiting for the full reply
* Products sync automatically whenever you add, edit, or remove items — no manual refresh, no separate feed plugin required
* Widget is lighter and faster — no jQuery dependency, no effect on page load scores
* Security hardening and reliability improvements

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 2.1.0 =
No action needed — settings and credentials are preserved automatically.

= 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.
