=== CartAmplify for WooCommerce ===
Contributors: iachi
Tags: woocommerce, recommendations, search, ai, product recommendations
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 1.0.7
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered product recommendations, search, and category browsing for WooCommerce.

== Description ==

CartAmplify supercharges your WooCommerce store with AI-powered product recommendations, intelligent search, and enhanced category browsing.

**Features:**

* AI-powered product recommendations (upsells, cross-sells, related products)
* Intelligent search with suggestions
* Enhanced category browsing with filters and sorting
* User event tracking for personalized recommendations
* Multi-language support via WPML and Polylang
* Page builder integrations (Gutenberg, Elementor, WPBakery)
* Shortcodes for flexible placement of search and recommendation widgets

**External Service Dependency:**

This plugin connects to the CartAmplify external API at [cartamplify.com](https://cartamplify.com) to provide its core functionality.

= When data is sent =

* **On every page load** (when the plugin is active and configured): A user event is sent containing the page URL, event type (product view, cart view, category view, home page, search, add-to-cart, purchase), and the visitor's language.
* **On product page views:** The viewed product ID and any attribution token from the referring recommendation/search.
* **On cart page views:** All products currently in the cart (IDs, prices, quantities) and a cart identifier.
* **On purchase completion:** Order total, currency, all purchased product details, and the cart identifier.
* **On search/browse:** The search query, active filters, page categories, and returned product IDs.
* **On product create/update/delete (admin):** Full product catalog data including titles, descriptions, prices, images, categories, attributes, stock status, and URLs.

= What user data is transmitted =

* Visitor ID (anonymous, randomly generated, stored in WooCommerce session)
* IP address
* User Agent string
* WordPress user ID (transmitted as an irreversible MD5 hash, only for logged-in users)
* Full page URL including query parameters

No data is transmitted until the plugin is configured with valid API credentials. All communication uses HTTPS.

* [CartAmplify Terms of Service](https://cartamplify.com/terms)
* [CartAmplify Privacy Policy](https://cartamplify.com/privacy)

== Installation ==

1. Upload the `cartamplify-for-woocommerce` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Follow the onboarding wizard to connect your store to CartAmplify.
4. Configure your API credentials in the CartAmplify settings page.

== Screenshots ==

1. Onboarding wizard – Connect your store to CartAmplify by entering the API URL and API token.
2. Onboarding wizard – Create your first personalised up-sell recommendation on the product page and choose a recommendation model.
3. Onboarding wizard – Create your first personalised cross-sell recommendation on the cart page and choose a recommendation model.
4. Onboarding wizard – Product catalog synchronisation complete and ready to use.
5. Search settings – Replace WooCommerce's default search with CartAmplify, or keep your theme's search form while powering results with CartAmplify.
6. Category settings – Replace WooCommerce category page results with AI-powered CartAmplify rankings.
7. Recommendations management – Manage recommendation widgets, copy shortcodes for Gutenberg / Elementor / WPBakery, and override WooCommerce's default up-sell, related, and cross-sell sections.

== Frequently Asked Questions ==

= Does this plugin require WooCommerce? =

Yes. WooCommerce must be installed and activated for CartAmplify to function.

= Does this plugin connect to an external service? =

Yes. CartAmplify connects to the CartAmplify API (cartamplify.com) to provide AI-powered recommendations and search. Product data, user events, and search queries are sent to the API over HTTPS. See the "External Services" section in the description for full details.

= What PHP version is required? =

PHP 7.4 or higher is required.

= Does this plugin support multi-language stores? =

Yes. CartAmplify integrates with both WPML and Polylang for multi-language support.

== Changelog ==

= 1.0.7 =
* Improved plugin metadata and WordPress Plugin Directory compliance
* Added LICENSE file and readme.txt
* Removed custom updater in favor of WordPress.org updates

= 1.0.5 =
* Added health-check ping endpoint

= 1.0.0 =
* Initial release
* AI-powered product recommendations
* Intelligent search with autocomplete
* Enhanced category browsing
* WPML and Polylang support
* Gutenberg, Elementor, and WPBakery integrations
