=== FeedAgentX – Connector for FeedAgentX.com ===
Contributors: feedagentx
Tags: woocommerce, chatgpt, product feed, openai, feedagentx
Requires at least: 6.2
Tested up to: 6.9
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect your WooCommerce store to FeedAgentX.com for ChatGPT Commerce integration.

== Description ==

**FeedAgentX** is the official WordPress plugin that connects your WooCommerce store to [FeedAgentX.com](https://feedagentx.com).

It securely reads your product catalog (titles, prices, stock, images, categories, etc.)  
and transmits it to the **FeedAgentX.com** platform, where it is validated, normalized,  
and formatted for **ChatGPT’s Product Feed and Instant Checkout integrations**.

FeedAgentX.com ensures your WooCommerce store can appear naturally  
within ChatGPT’s shopping and recommendation experiences —  
allowing users to discover and purchase your products directly inside ChatGPT.

This plugin does **not** process payments or orders.  
It only exposes your product data through a protected, read-only REST API —  
accessible exclusively to your verified FeedAgentX.com account.

**Key Features**
* 🔒 Secure, read-only REST API connection
* 🧠 Automatically prepares data for ChatGPT Feed and Instant Checkout
* ⚙️ JSON feed optimized for FeedAgentX.com schema
* 🕓 Full & Delta feed generation
* 🔑 Token-based authentication
* 🧾 Product change tracking (price, stock, category)
* 🧩 Lightweight and fully compatible with WooCommerce

---

### 🧠 What is FeedAgentX.com?

[FeedAgentX.com](https://feedagentx.com) is a SaaS platform that helps WooCommerce stores  
connect to **ChatGPT’s Agentic Commerce Protocol (ACP)** ecosystem.

It collects your product data via this connector plugin, validates it against OpenAI’s  
feed specification, and securely delivers it to ChatGPT — enabling AI-powered discovery  
and seamless Instant Checkout experiences.

FeedAgentX.com can also distribute your verified data to future AI commerce engines  
and analytics services as the ecosystem expands.

---

== Installation ==

**Requirements**

* WordPress 6.2 or later
* PHP 8.1 or later
* WooCommerce 5.0 or later

**Steps**

1. Install the plugin from **Plugins → Add New** in your WordPress admin, or upload the `.zip` and activate it.
2. Make sure WooCommerce is installed and active.
3. Go to **FeedAgentX → Settings**.
4. Click **Generate token** to create a read-only API token.
5. Copy the API endpoints shown on the Settings page:
   * Full feed: `/wp-json/feedagentx/v1/feed/full`
   * Delta feed: `/wp-json/feedagentx/v1/feed/changes`
   * Health check: `/wp-json/feedagentx/v1/health`
6. Sign in at [FeedAgentX.com](https://feedagentx.com) and paste the site URL and token into the connect-store form.

---

== Frequently Asked Questions ==

= ❓ Can I use this plugin without FeedAgentX.com? =
No. This plugin is designed exclusively for use with your verified FeedAgentX.com account.

= 🔐 How is access secured? =
All endpoints require a valid **Bearer Token**, generated in the plugin settings.  
Tokens can be revoked or regenerated anytime.

= 🧾 What data is shared? =
Only product catalog data — title, price, stock, SKU, brand, category, image URLs, and availability.  
No personal data, orders, or payments are processed.

= 💬 How does it connect to ChatGPT? =
FeedAgentX.com validates your product data and submits it to ChatGPT’s  
Agentic Commerce Protocol (ACP), powering its product search and Instant Checkout features.

= 💾 How often does it sync? =
FeedAgentX.com controls synchronization frequency and fetches your data automatically.

---

== External services ==

This plugin connects your WooCommerce store to **FeedAgentX.com**, a third-party SaaS platform operated by FeedAgentX. The plugin itself does **not** make outbound calls; instead it exposes a read-only REST API that the FeedAgentX.com service pulls from after you connect your store.

**What data is shared with FeedAgentX.com:**

* Product catalog data: titles, descriptions, prices, stock levels, SKUs, brands, categories, image URLs, product attributes, and variant data.
* Plugin and platform metadata: plugin version, schema version, WordPress / WooCommerce / PHP versions, store currency, and target country.
* No customer information, order data, or personal data is read or transmitted.

**When data is shared:**

* Only after a site administrator generates an API token in **FeedAgentX → Settings** and pastes it into a connected workspace at FeedAgentX.com.
* Every request must include a valid Bearer token. Tokens can be revoked from the plugin's Settings page at any time, which immediately stops all access.

**Service provider:**

* FeedAgentX.com — Privacy Policy: <https://feedagentx.com/privacy/>
* FeedAgentX.com — Terms of Service: <https://feedagentx.com/terms/>

---

== Server configuration (recommended) ==

The plugin writes diagnostic logs to `wp-content/uploads/feedagentx-logs/`.
The directory is protected from direct web access by `.htaccess` (Apache) and
`web.config` (IIS), which the plugin generates automatically.

**If your site runs on Nginx**, those files are ignored. Add the following block
inside your server config to deny direct access to the log directory:

`
location ~* /wp-content/uploads/feedagentx-logs/ {
    deny all;
    return 404;
}
`

The logs only contain route names, error messages, and migration events —
authentication tokens are never written to disk — but production sites should
still block external reads.

---

== Security notes ==

* All endpoints require a Bearer token; tokens compare in constant time
  (`hash_equals`) and rotate from the admin UI.
* Authenticated requests have a per-token rate limit (default 120/min).
* Failed-auth requests have a per-IP rate limit (default 10/min) to defend
  against brute force and log spam.
* Logging defaults to INFO level with 14-day file retention.
* Log directory is protected with `.htaccess` + `web.config`; Nginx admins
  must add the rule above.

---

== Screenshots ==
1. FeedAgentX settings panel with token and endpoint URLs  
2. JSON feed preview  
3. Connection status screen showing successful sync with FeedAgentX.com

---

== Changelog ==

= 1.0.0 =
* Initial public release.
* Read-only REST API for the OpenAI Agentic Commerce Protocol (ACP) "Upcoming" schema (Product → Variants nested).
* Variant expansion: variable WooCommerce products emit one Variant per WC variation.
* Full feed (`/feed/full`) and cursor-based delta sync (`/feed/changes`) with explicit `/feed/changes/ack` endpoint.
* `Authorization: Bearer` token authentication, per-token rate limiter for authenticated requests, per-IP rate limiter for unauthenticated requests.
* Per-product brand resolver (Woo Brands, YITH, Perfect Brands, meta, attributes).
* File-based daily-rotated logger; log directory protected by generated `.htaccess` + `web.config`.
* Settings page with Connection / Feed / Brand / Diagnostics tabs.
* Clean uninstall: drops plugin table, removes options, clears scheduled events.
* Requires PHP 8.1+ and WooCommerce 5.0+.

---

== Upgrade Notice ==

= 1.0.0 =
Initial stable release — Connect WooCommerce to FeedAgentX.com and enable ChatGPT commerce integrations.

---

== License ==
This plugin is licensed under the GPL-2.0-or-later license.  
It only shares catalog data with your verified FeedAgentX.com account.  
No customer, order, or personal information is collected.

---

> “FeedAgentX — The official WooCommerce connector for ChatGPT’s Agentic Commerce ecosystem.”
