=== AgentShop ===
Contributors: sameerkhansf
Tags: woocommerce, analytics, tracking, llm, ai
Requires at least: 6.0
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Track LLM-driven traffic and optimize conversions for your WooCommerce store.

== Description ==

AgentShop helps WooCommerce store owners understand and optimize traffic coming from AI assistants like ChatGPT, Claude, Gemini, and Perplexity.

= Features =

* **LLM Traffic Tracking** - Automatically detect and track visitors referred from AI assistants
* **Conversion Analytics** - Track the full customer journey from page view to purchase
* **Real-time Events** - Server-side and client-side event tracking for accurate data
* **GDPR Compliant** - Built-in privacy controls and data export/erasure support
* **llms.txt Support** - Automatically serve llms.txt for AI assistant discovery

= How It Works =

1. Install and activate the plugin
2. Connect your store to AgentShop with one click
3. Start tracking LLM-driven traffic automatically

= Requirements =

* WordPress 6.0 or higher
* WooCommerce 7.0 or higher
* PHP 7.4 or higher
* HTTPS enabled (required for blog publishing feature)

= Third-Party Service =

This plugin connects to the AgentShop service to provide analytics and tracking functionality.

**Service Provider:** AgentShop (https://useagentshop.com)

**Data Transmitted:**

* Page view events (URL, timestamp, referrer)
* Product view events (product ID, name, price)
* Add to cart events (product details, quantity)
* Order events (order ID, total, items - no personal customer data)
* LLM/AI referral source detection
* Anonymous visitor identifiers

**When Data is Sent:**

* When visitors browse your store (page views, product views)
* When visitors add items to cart
* When orders are placed
* During webhook delivery for real-time sync

**Links:**

* Service Website: https://useagentshop.com
* Privacy Policy: https://useagentshop.com/privacy
* Terms of Service: https://useagentshop.com/terms

= Cookies =

This plugin uses the following cookies:

* **agentshop_cid** - Stores a unique customer identifier for analytics. Expires after 2 years.
* **agentshop_sid** - Stores a session identifier. Expires when the browser is closed.
* **agentshop_llm** - Stores the detected LLM/AI source for attribution. Expires after 30 days.

All cookies are first-party cookies set on your domain. No third-party tracking cookies are used.

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/agentshop/`
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Go to WooCommerce > AgentShop to connect your store

== Frequently Asked Questions ==

= Do I need an AgentShop account? =

Yes, you'll need a free AgentShop account to use this plugin. You can sign up at https://app.useagentshop.com/sign-up

= Is my data secure? =

Yes, all data is transmitted securely over HTTPS and we follow industry best practices for data protection.

= Does this work with WooCommerce HPOS? =

Yes, the plugin is fully compatible with WooCommerce High-Performance Order Storage (HPOS).

= Does this work with Cart and Checkout Blocks? =

Yes, the plugin is fully compatible with WooCommerce Cart and Checkout Blocks.

= What data does AgentShop collect? =

AgentShop collects anonymous analytics data including page views, product interactions, and order events. No personally identifiable information (PII) is collected or stored without explicit consent. See the "Third-Party Service" section for full details.

= How do I delete my data? =

You can use WordPress's built-in privacy tools (Tools > Export/Erase Personal Data) to export or delete AgentShop tracking data associated with customer email addresses. For complete deletion from AgentShop servers, contact info@useagentshop.com.

== Privacy Policy ==

AgentShop is designed with privacy in mind:

= Data Collection =

* Analytics data is collected only when tracking is enabled in settings
* Customer data is anonymized before transmission
* No personal data is stored locally beyond order metadata

= GDPR Compliance =

* Integrates with WordPress privacy tools for data export and erasure
* Provides suggested privacy policy text for your site
* Respects Do Not Track browser settings (when enabled in settings)

= Data Retention =

* Local tracking metadata is tied to WooCommerce order retention
* Data on AgentShop servers follows our data retention policy at https://useagentshop.com/privacy

= User Rights =

Users can request data export or deletion through WordPress privacy tools or by contacting the store administrator.

== Screenshots ==

1. Product catalog with AI visibility tracking — see which products AI assistants are recommending
2. Analytics dashboard — track AI-driven sales, conversion rates, and visitor sources like ChatGPT, Claude, and Gemini
3. AI Prompts report — discover what questions AI assistants are asking about your products

== Changelog ==

= 1.0.0 =
* Initial release
* LLM source detection for ChatGPT, Claude, Gemini, Perplexity, and Grok
* Server-side order tracking
* Client-side pixel tracking
* Webhook integration for real-time events
* llms.txt support
* GDPR data export and erasure
* Blog publishing via Application Passwords

== Upgrade Notice ==

= 1.0.0 =
Initial release of AgentShop.
