=== Vectorank AI ===
Contributors: vectorank
Tags: woocommerce, recommendations, ai, personalization, product suggestions, smart search, spell correction
Requires at least: 5.8
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered product recommendations, smart search with spell correction, and personalized shopping experiences for WooCommerce.

== Description ==

Vectorank AI connects your WooCommerce store to the Vectorank AI recommendation engine. It automatically:

* **Tracks user behavior** — product views, add-to-cart actions, and purchases
* **Syncs your product catalog** — keeps the recommendation engine up to date
* **Displays AI recommendations** — on product pages, cart, and home/shop pages
* **Smart search** — AI-powered search with spell correction and instant suggestions

= Recommendation Strategies =

* **Co-occurrence** — "Customers who bought this also bought..."
* **Session-based** — Based on the visitor's current browsing session
* **Similar products** — Attribute-based similarity (category, color, price)
* **Personalized** — Based on the user's purchase and browsing history
* **Bestsellers** — Cold-start fallback showing popular products
* **Hybrid** — Combines all strategies with weighted scoring

= Features =

* Zero-config event tracking (view, cart, purchase)
* Automatic daily product sync
* AI-powered search with spell correction
* Instant search suggestions with product previews
* Admin panel under WooCommerce menu
* Test connection button
* Manual sync & co-occurrence rebuild tools
* Guest user tracking with anonymous IDs
* Responsive product grid with loading states
* AJAX-based recommendation loading (no page speed impact)
* Shortcode support for custom widget placement

= Third-Party Service =

This plugin connects to the **Vectorank AI API** (https://api.vectorank.com) to provide AI-powered recommendations and search. The following data is sent to the service:

* Product catalog information (names, prices, categories, images)
* Anonymized user behavior events (product views, cart additions, purchases)
* Search queries for spell correction and suggestions
* Customer data for personalized recommendations

By using this plugin, you agree to the [Vectorank Terms of Service](https://vectorank.com/terms) and [Privacy Policy](https://vectorank.com/privacy).

== Installation ==

1. Upload the `vectorank-ai` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to WooCommerce → Vectorank AI
4. Enter your API Key (get one free at [vectorank.com](https://vectorank.com))
5. Click "Test Connection" to verify
6. Click "Sync All Data" to initialize your recommendations

== Frequently Asked Questions ==

= Do I need a Vectorank account? =

Yes. Sign up for free at [vectorank.com](https://vectorank.com) to get your API key. Your first 30 days include 1,000 free requests.

= Does this slow down my site? =

No. Recommendations are loaded asynchronously via AJAX after the page renders. Event tracking uses `sendBeacon` for non-blocking requests.

= How does guest tracking work? =

Guest visitors receive a random UUID stored in localStorage. This allows the system to build session-based recommendations even for non-logged-in users. No personally identifiable information is collected.

= Can I customize where recommendations appear? =

Yes. Each widget (home, product, cart) supports either automatic placement or shortcode mode. Use shortcodes like `[vectorank_home_recommendations]` to place widgets anywhere.

== Screenshots ==

1. Dashboard overview with quick stats
2. Widget settings with live preview
3. AI search suggestions in action
4. Product page recommendations
5. Admin tools for sync and matrix rebuild

== Changelog ==

= 1.0.0 =
* Initial release
* Event tracking: view, cart, purchase
* Product catalog sync with daily auto-refresh
* AI recommendations on product, cart, and home pages
* AI-powered search with spell correction
* Instant search suggestions
* Admin settings panel with dashboard
* Shortcode support for custom placement
