=== WPCraftEngineer Product Finder for WooCommerce ===
Contributors: wpcraftengineer
Tags: woocommerce, product search, product recommendations, chatbot, ai
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.1.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-assisted product discovery for WooCommerce, with optional general store chat and optional external AI provider support.

== Description ==

WPCraftEngineer Product Finder for WooCommerce adds a floating chat widget that helps shoppers discover products through natural language.

It can work in two modes:

* **Keyword mode**: no external AI account required. The plugin uses on-site keyword matching and WooCommerce product data.
* **AI provider mode**: connect OpenAI, Google Gemini, or Anthropic to improve intent detection and reply quality.

With WooCommerce product recommendations enabled, shoppers can ask things like:

* “Show me products under $50”
* “I need a gift for a runner”
* “What are your newest arrivals?”
* “Do you have anything on sale?”

If WooCommerce recommendations are disabled, the widget can still act as a general store assistant using your configured welcome message, fallback message, and custom instructions.

= Features =

* Floating chat widget for the front end
* Optional WooCommerce product recommendations
* Keyword mode with no API key required
* Optional OpenAI, Google Gemini, and Anthropic provider support
* Product cards with image, price, rating, stock status, and product links
* Admin settings for color, bot name, greeting message, and chat history retention
* Option to hide out-of-stock products
* Preview and test screen in wp-admin

= Installation =

1. Upload the plugin ZIP in **Plugins → Add New → Upload Plugin**, or upload the folder to `/wp-content/plugins/`.
2. Activate **WPCraftEngineer Product Finder for WooCommerce**.
3. Go to **Product Finder** in wp-admin.
4. Configure the widget settings.
5. If you want AI provider mode, add an API key for OpenAI, Google Gemini, or Anthropic.

= Usage =

1. Enable the chatbot.
2. Decide whether to enable WooCommerce product recommendations.
3. Choose either keyword mode or an AI provider.
4. Visit the front end and test the widget.

= Notes =

* WooCommerce is optional, but product recommendations require WooCommerce to be installed and active.
* API keys are stored in your WordPress options table.
* The plugin stores short chat history in transients so follow-up questions can work for the configured number of days.

== External services ==

This plugin can connect to third-party AI services only when the site administrator selects a provider and enters an API key.

= OpenAI =

Used for optional intent parsing and response generation.

Data sent: the visitor's chat message, limited recent chat context, store-assistant instructions, and when WooCommerce recommendations are enabled, a short text summary of matched products.

When sent: only when OpenAI is selected as the AI provider and the widget processes a chat request or the admin runs the connection test.

Terms: https://openai.com/policies/services-agreement/
Privacy: https://openai.com/business-data/

= Google Gemini =

Used for optional intent parsing and response generation.

Data sent: the visitor's chat message, limited recent chat context, store-assistant instructions, and when WooCommerce recommendations are enabled, a short text summary of matched products.

When sent: only when Google Gemini is selected as the AI provider and the widget processes a chat request or the admin runs the connection test.

Terms: https://ai.google.dev/gemini-api/terms
Privacy: https://policies.google.com/privacy

= Anthropic =

Used for optional intent parsing and response generation.

Data sent: the visitor's chat message, limited recent chat context, store-assistant instructions, and when WooCommerce recommendations are enabled, a short text summary of matched products.

When sent: only when Anthropic is selected as the AI provider and the widget processes a chat request or the admin runs the connection test.

Terms: https://privacy.anthropic.com/
Privacy: https://docs.anthropic.com/en/docs/legal-center/privacy

== Frequently Asked Questions ==

= Does the plugin require WooCommerce? =

No. The chat widget can still run as a general store assistant without WooCommerce. WooCommerce is required only for product recommendations.

= Does the plugin require an AI API key? =

No. Keyword mode works without an external AI provider.

= Where are settings stored? =

Settings are stored in the WordPress options table using the plugin prefix `wcpfw_`.

== Changelog ==

= 1.1.0 =
* Initial public release.
