=== SuperSeller for WooCommerce ===
Contributors: webillium
Tags: woocommerce, ai chatbot, customer support, product recommendations, shopping assistant
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add an AI chatbot to WooCommerce for product recommendations, customer support, product sync, and an optional storefront chat widget.

== Description ==

SuperSeller for WooCommerce adds an AI chatbot and shopping assistant to your store. It syncs WooCommerce products with SuperSeller so the assistant can answer customer questions, recommend products, and provide 24/7 customer support through an optional storefront chat widget.

Use SuperSeller to connect your WooCommerce catalog to an AI assistant that understands your products, store information, shipping details, and return policy. Product sync is opt-in, the chat widget is optional, and no customer, order, or payment data is sent.

The plugin provides:

* WooCommerce product sync for AI-powered product recommendations
* Optional AI chatbot widget for 24/7 customer support
* Knowledge base sync for shipping, return policy, FAQs, and store information
* Privacy-focused opt-in controls before any data is shared
* Complete control over what data is shared

**Key Features:**

* One-click WooCommerce product sync with SuperSeller
* Automatic product updates when prices, stock, or product details change
* Optional AI chat widget for customer questions and product recommendations
* Knowledge base integration for store policies and custom FAQs
* Privacy-focused with full opt-in controls
* No technical knowledge required

**Requirements:**

* WordPress 5.8 or higher
* WooCommerce plugin (active)
* PHP 7.4 or higher
* SuperSeller account (get one at https://superseller.online)

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/superseller-for-woocommerce` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to WooCommerce > SuperSeller to configure the plugin.
4. Paste your SuperSeller API Key (from https://superseller.online/dashboard/api-keys). The connected company is detected automatically — no separate Company ID is required.
5. Click "Test Connection" to confirm the key is valid; you'll see the company name it is bound to.
6. Tick the privacy consent, choose whether to enable automatic product sync and/or the chat widget, and click "Save Settings".

**How to set up product synchronization with WooCommerce:**

1. Sign up at https://superseller.online and log in to your dashboard.
2. Open https://superseller.online/dashboard/companies and create (or pick) the company that represents this WooCommerce store.
3. Open https://superseller.online/dashboard/api-keys, click "Create New Key", select that company, and copy the full `sk_live_…` (or `sk_test_…`) value — it is shown only once.
4. In WordPress, go to WooCommerce → SuperSeller, paste the API key, click "Test Connection". You should see "Connected to: <Your Company Name>".
5. Save the privacy consent, enable "Automatic Product Sync", and click "Save Settings".
6. Open WooCommerce → SuperSeller → Knowledge Base if you want to push your store information, shipping details and return policy as well, then click "Sync Knowledge Base".
7. Run "Sync All Products Now" once for the initial bulk import. After that, every product create / update / delete in WooCommerce will be sent to SuperSeller automatically.

**What is sent to SuperSeller and when:**

* Product create / update / delete events (only after consent + sync enabled).
* Knowledge base entries you choose to sync (store info, shipping, returns, custom entries).
* No customer, order, or payment data.

== Frequently Asked Questions ==

= What data does this plugin send to SuperSeller? =

The plugin only sends product information (name, description, price, SKU, stock status, image URLs) and optionally knowledge base content (shipping info, return policy, store details). No customer personal data or order information is transmitted.

= Do I need a SuperSeller account? =

Yes, you need a SuperSeller account to use this plugin. Sign up for free at https://superseller.online

= Is the sync automatic? =

You can choose. The plugin offers both manual and automatic sync options. Automatic sync is opt-in and requires your explicit consent.

= Will this slow down my site? =

No. The plugin uses background processes for syncing and has minimal impact on your site's performance.

= Can I disable the widget? =

Yes, the chat widget is completely optional. You can enable product sync without the widget, or vice versa.

= Can I use this as a WooCommerce AI chatbot? =

Yes. SuperSeller can add an optional AI chatbot widget to your WooCommerce storefront after you enable privacy consent and turn on the widget setting.

= Does SuperSeller recommend WooCommerce products? =

Yes. After product sync is enabled, SuperSeller can use your synced WooCommerce catalog to help shoppers find relevant products and compare options.

= Can the chatbot answer shipping and return policy questions? =

Yes. You can sync knowledge base content such as shipping information, return policies, store details, FAQs, and selected WordPress pages or posts.

= Is this GDPR compliant? =

Yes, the plugin is designed with privacy in mind. All data sharing requires explicit opt-in consent, and you can disable sync at any time.

= Where can I get support? =

For plugin support, please visit https://superseller.online/support or contact us at support@superseller.online

== Screenshots ==

1. WooCommerce AI chatbot settings and API connection
2. Product sync and privacy consent controls
3. Optional AI chat widget for product recommendations
4. WooCommerce product sync status and logs

== Changelog ==

= 1.2.0 =
* Top-level "SuperSeller" admin menu with Settings + Knowledge Base submenus, custom inline-SVG icon (matches the size of native WP menu icons).
* Polished admin UI: brand-aligned indigo→violet gradient hero with white logo, branded white canvas (replaces the WP gray background), centered content like professional plugins.
* Privacy Consent moved directly under the API Key field; the Sync, Widget and Branding controls are disabled and dimmed until consent is given.
* Knowledge Base page picker — pick any published WordPress page or post and push it to the SuperSeller knowledge base in one click.
* Stable knowledge-base IDs (`wp_page_<id>`) — re-syncing the same page now overwrites instead of creating duplicates. Deleting a tracked page automatically removes the matching knowledge entry from SuperSeller.
* "Sync All Products" now shows a real progress card with a smooth gradient bar, shimmer animation, counter ("X / Y · P%") and completed / failed states.
* Better error diagnostics on Test Connection: backend response preview (HTTP status + first 200 chars) is shown when the response is not valid JSON; the API key is sent under both `Authorization: Bearer` and `X-API-Key` headers in case a host strips one of them.
* Settings page reordered — "Getting Started" and "How to generate an API Key" now appear above the form.

= 1.1.0 =
* Single-key setup: paste the API key and the connected company is detected automatically (no separate Company ID).
* Test Connection now shows the company name the key is bound to.
* Hardened "Test Connection" so credentials can be verified before saving them.
* Chat widget script is now properly enqueued via WordPress (wp_enqueue_script + script_loader_tag) instead of inline output.
* Activation no longer depends on `is_plugin_active`, which is unavailable during `plugins_loaded`.
* `$_POST` values in the knowledge-base form handlers are now `wp_unslash()`ed before sanitization.
* Admin pages no longer turn black on OS-level dark mode.

= 1.0.0 =
* Initial release
* Automatic product sync with SuperSeller
* Optional chat widget integration
* Knowledge base sync
* GDPR-compliant opt-in mechanisms
* Full privacy controls

== Privacy Policy ==

**What data does this plugin collect and share?**

This plugin shares the following data with SuperSeller (https://superseller.online) when sync is enabled:

* Product names
* Product descriptions
* Product prices
* Product SKUs
* Product stock status
* Product images (URLs only)
* Product categories

Optionally, if knowledge base sync is enabled:

* Shipping methods and costs
* Return policy information
* Store contact information

**Where is data sent?**

Data is sent to SuperSeller's API at https://superseller.online/api/

**When is data sent?**

Product data is sent only when product synchronization is enabled and privacy consent has been saved in the plugin settings. Knowledge base data is sent only when a site administrator starts knowledge base sync. The chat widget script is added to the public site only when the widget is enabled and privacy consent has been saved.

**Public links and branding**

The plugin can optionally display a "Powered by SuperSeller" link on the public site. This is disabled by default and is shown only when a site administrator explicitly enables the branding setting.

**Does this plugin collect personal data?**

No. This plugin does not collect or transmit any customer personal information, order data, or payment details.

**How can I opt-out?**

You can disable product sync and widget at any time from the plugin settings page. To completely remove all data, deactivate and delete the plugin.

**Third-party service:**

This plugin relies on SuperSeller (https://superseller.online), a third-party service. By using this plugin, you agree to SuperSeller's Terms of Service and Privacy Policy:

* Terms of Service: https://superseller.online/terms
* Privacy Policy: https://superseller.online/privacy

== Upgrade Notice ==

= 1.2.0 =
Major UI refresh, dedicated SuperSeller admin menu, Knowledge Base page picker, dedup on knowledge-base sync, polished progress bar for product sync. Recommended update.

= 1.1.0 =
Single-key setup: paste your API key and the connected company is detected automatically. If you upgrade from 1.0.0, your existing Company ID stays in place; you no longer need to manage it manually.

= 1.0.0 =
Initial release of SuperSeller for WooCommerce.
