=== Shop2LLM ===
Contributors: athenalion
Tags: ai, woocommerce, llms.txt, ai agent, ai visibility, ai search, ai discovery, mcp, chatgpt, product search, ai readiness, robots.txt
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 8.1
Stable tag: 1.0.5
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Make your WooCommerce store visible to AI assistants. Auto-generates llms.txt, robots.txt, JSON-LD, and MCP server — connect ChatGPT to your products in 1 click.

== Description ==

**Shop2LLM** is the simplest way to make your WooCommerce products discoverable by AI assistants like ChatGPT, Claude, and Gemini. One-click setup — no complex configuration.

The free version supports **ChatGPT** with 2 AI tools: product search and product detail.

= Supported AI Platforms (Free) =

* 🧠 **ChatGPT Desktop** — products appear in ChatGPT's tool palette

= How It Works =

1. **Activate** the plugin (requires WooCommerce)
2. **Copy** the AI connection URL from the settings page
3. **Paste** into ChatGPT
4. **Done** — AI agents can now search your products

= Features =

* **2 AI tools** — product search and product detail
* **AI agent standard** — the protocol used by ChatGPT, Claude, and other AI assistants
* **Product search** — AI agents search by keyword, category, price, stock
* **Product details** — full product info including description, images, ratings
* **No usage limits** — unrestricted AI calls
* **Auto-generated API key** — secure Bearer token authentication
* **ChatGPT support** — one-click setup
* **Auto Product Schema** — JSON-LD for AI readability
* **AI directory page** — auto-generated llms.txt
* **Crawler-friendly robots.txt** — invite AI bots to index your store

= What AI Agents Can Do (Free) =

* "Search for wireless headphones under $100"
* "Show me the top-rated summer dresses in stock"
* "What's the price of product #42?"
* "Find products in the 'electronics' category"

== Installation ==

1. Upload the `shop-to-llm` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to Settings → Shop2LLM 🤖
4. Copy your AI connection URL
5. Paste into ChatGPT

= Requirements =

* WordPress 6.0+
* PHP 8.1+
* WooCommerce 8.0+

== External Services ==

This plugin connects to the following external services **only when Analytics is explicitly enabled** (opt-in, disabled by default):

* **api.aiproductscout.shop/fincore/v1/free/ping** — monthly heartbeat with SHA256-hashed site identifier, platform, plugin/PHP/WooCommerce/WordPress version numbers. Used to distinguish active vs inactive installs.
* **api.aiproductscout.shop/fincore/v1/crawler/log** — when AI crawlers visit your store, sends crawler type, page URL, and user agent.

No personal customer data, order information, or product data is transmitted. All data transmission stops when Analytics is disabled in Settings.

== Frequently Asked Questions ==

= Does this require a FinCore cloud account? =

No. Shop2LLM runs entirely on your WordPress server. No external cloud dependency for the core features. Optional analytics and crawler tracking require opt-in consent — see the data privacy section below.

= Is my store data sent to external servers? =

Product data stays on your server. AI agents connect directly to your WordPress REST API.

= What data does the plugin send to external servers? =

External data transmission is **opt-in** and disabled by default. When you enable Analytics in the plugin settings, SHA256-hashed site metadata (platform, plugin/PHP/WooCommerce/WordPress version numbers) is sent to our cloud service via a monthly heartbeat. AI crawler visits are also reported — this includes the crawler type, page URL, user agent, and an anonymized site identifier.

No personal customer, order, or product data is transmitted. You can disable analytics at any time in Settings. See our privacy policy at https://shop2llm.com/privacy for details.

= What's the difference between Free and Pro? =

Free supports ChatGPT with 2 AI tools (product search + product detail). Pro adds cart, checkout, order tools, and support for more AI platforms. Upgrade at https://shop2llm.com/fincore/v1/page/prolanding

= Is this secure? =

Yes. All AI connections require Bearer token authentication. The API key is auto-generated and can be rotated anytime.

== Screenshots ==

1. AI Visibility Dashboard — visibility score, 7-day trends, AI value estimation
2. AI Search Activity & Crawler Visits — see what AI searches for and which platforms visit
3. AI Platforms — supported platforms with Free/Pro badges + upgrade CTA

== Changelog ==

= 1.0.5 =
* Add: Opt-in analytics with monthly heartbeat (SHA256-hashed, disabled by default)
* Add: AI Growth Progress tracker — 5-step milestone progress bar
* Add: Peer Comparison card — your store score vs average
* Add: Achievement badges (Store Live / AI Discovered / First Search / Power User)
* Add: Community social proof bar with weekly download stats
* Add: Smart Dynamic CTA — context-aware upgrade prompts
* Add: Inline Pro upgrade links across all dashboard cards
* Add: 5-star review request trigger on crawler + search milestones
* Fix: PHP warnings for undefined variables in AI Growth Progress
* UI: Unified Pro CTA color to indigo #6366f1
* UI: Wizard progress bar with step counter
* Backend: New /v1/stats public endpoint for community download counts

= 1.0.4 =
* Privacy: Anonymous activation ping with SHA256-hashed site identifier (replaces plain site_url)
* Feature: Monthly cloud heartbeat ping to distinguish active vs inactive installs
* Privacy: Removed site_name from telemetry; only hashed hostname sent
* Endpoint: Migrated from /v1/free/register to /v1/free/ping

= 1.0.3 =
* Improve: search keywords and short description for better discoverability

= 1.0.2 =
* Add: HPOS (High Performance Order Storage) compatibility declaration
* Add: WooCommerce Marketplace support
* Fix: remove invalid contributor

= 1.0.1 =
* Security: fix permission_callback granting access when API key is empty
* Security: prevent settings save from clearing API key
* Fix: Author URI and readme URLs to use bare domain
* Fix: add wp_unslash before sanitize_text_field on POST inputs
* Fix: proper escaping for dynamic HTML attributes and display values
* Remove: load_plugin_textdomain (WP 4.6+ auto-loads by slug)
* Dev: bump Tested up to 7.0

= 1.0.0 =
* Initial release
* AI agent standard support (MCP JSON-RPC protocol)
* ChatGPT integration with 2 AI tools (search + detail)
* Auto-generated API key with Bearer token auth
* Auto Product Schema (JSON-LD) for AI readability
* AI directory page (llms.txt)
* Crawler-friendly robots.txt (12 AI crawlers)
* Admin dashboard — AI visibility, search activity, crawler logs
* Full i18n support — POT + 14 G20 language PO templates
* Product feed XML for Google Shopping
* wp_enqueue_style compliant admin CSS

== Upgrade Notice ==

= 1.0.0 =
Initial release — Shop2LLM for WooCommerce!

== Privacy ==

This plugin can optionally connect to external services provided by FinCore. All external data transmission is **opt-in** and disabled by default:

* **Analytics (Settings → Shop2LLM → Analytics)** — when enabled, anonymized site metadata (hashed site identifier, platform, version numbers) and AI crawler visits (crawler type, page URL, user agent) are sent to our cloud service. This can be disabled at any time.

* **api.aiproductscout.shop/fincore/v1/free/ping** — called when analytics is first enabled, to register hashed site metadata.
* **api.aiproductscout.shop/fincore/v1/crawler/log** — called when AI crawlers visit your store, if analytics is enabled.

No personal customer data, order information, or product data is transmitted. All external calls use HTTPS and are non-blocking (will not affect site performance if the service is unavailable).

Privacy Policy: https://shop2llm.com/
Terms of Service: https://shop2llm.com/
