=== 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: 2.1.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:
* FeedAgentX.com — Terms of Service:
---
== 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 ==
= 2.1.0 =
* OpenAI flat (file-upload) spec compliance: the feed now carries every required flat field.
* Eligibility flags are back as first-class settings — `is_eligible_search` / `is_eligible_checkout` are required by the spec; new optional `is_eligible_ads`. Store-wide defaults with per-product overrides on the product edit screen (Advanced tab).
* Brand is now emitted per product via the brand resolver (required field, max 70 chars).
* New per-variant data: scalar `gtin` + `mpn`, sale price window dates, weight + dimensions (with units), `is_digital`, pre-order `availability_date` (WooCommerce Pre-Orders).
* Availability enum aligned with the spec: `pre_order` (was `preorder`), new `unknown`; `discontinued` removed.
* Feed header now includes `store_country`, `target_countries` (new multi-select setting), and the seller block (name, URL, privacy policy, terms, return policy).
* Validator rewritten around the flat spec's 18 required fields and conditional rules; error paths use flat field names.
= 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 ==
= 2.1.0 =
Required update for the new OpenAI flat feed spec — restores eligibility flags, adds brand/seller/country fields, and rewrites validation. Review FeedAgentX → Feed Settings after updating.
= 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.”