=== AI AEO for WooCommerce ===

Tags: woocommerce, ai, aeo, schema, ai search, AI SEO
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Make your WooCommerce products understandable, matchable, and recommendable by AI systems like ChatGPT, Perplexity, and Google Gemini.

== Description ==

**AI AEO for WooCommerce** is built specifically for **Answer Engine Optimization (AEO)**.

Traditional SEO plugins optimize for rankings.  
This plugin optimizes your products for **AI understanding and retrieval**.

AI systems do not rank pages the way Google does.  
They extract structured data, interpret meaning, and recommend products based on confidence.

If your store lacks structured context, multilingual signals, and semantic clarity — your products will not be selected.

This plugin fixes that.

Learn more:  
<a href="https://wptruss.com/plugins/ai-aeo-seo-titles-for-woo-commerce/" target="_blank">
AI AEO for WooCommerce Plugin Overview
</a>

---

== 🧠 What problem does this solve? ==

Most WooCommerce stores are invisible in AI search because:

* Missing or incomplete structured data  
* Weak product semantics (keyword-based, not meaning-based)  
* No multilingual signals  
* No clear product entity definition  
* No FAQ or use-case context  
* Missing trust signals (shipping, returns, policies)  

Result: AI systems cannot confidently recommend your product.

---

== 🇪🇺 Why this is especially powerful for European WooCommerce stores ==

European eCommerce is inherently **multilingual and cross-border**.

Customers search in their native languages:

* English (base entity): “minimalist leather wallet for men”  
* German: “leder geldbörse herren”  
* French: “portefeuille cuir homme”  
* Spanish: “cartera minimalista hombre”  

But most WooCommerce stores only provide English product data.

AI systems rely on **language matching + semantic understanding**.  
If your product does not exist in the query language (even at a structured level), it is far less likely to be selected.

---

== 🧠 English → Multilingual mapping (how AI understands your product) ==

This plugin keeps your **original English product title as the base entity**, and generates multilingual equivalents that AI systems map back to the same product.

Example:

**Original (English base entity):**  
Minimalist RFID Leather Wallet for Men

**Generated multilingual titles:**

* German: Leder Geldbörse Herren Minimalistisch RFID  
* French: Portefeuille Cuir Homme Minimaliste RFID  
* Spanish: Cartera Minimalista Hombre RFID  
* Italian: Portafoglio Uomo Minimalista RFID  

AI systems use this structure to:

* Recognize all variations as the same product  
* Match queries across languages  
* Improve confidence in recommendations  

Instead of creating multiple translated pages, you create **one strong multilingual product entity**.

---

== 🚀 What this enables ==

A single product can now match:

* English: “best minimalist wallet for travel”  
* German: “leder geldbörse herren”  
* French: “portefeuille cuir homme”  
* Spanish: “cartera minimalista hombre”  

Without duplicating content or managing multiple language pages.

---

== 🇪🇺 The hidden problem with multilingual WooCommerce (example) ==

A customer in France searches:

* “portefeuille cuir homme”

Your product exists:

* “Minimalist RFID Leather Wallet for Men” (in English)

Even if you have a multilingual plugin installed, most setups:

* Keep English as the default product entity  
* Translate content at the page level  
* Do not inject multilingual meaning into structured data  

Result:

AI systems may NOT confidently match your product to the French query.

Why?

Because AI systems rely on:

* Structured signals  
* Entity consistency  
* Language-level matching  

Not just visible translated content.

---

== ⚠️ What actually happens ==

* Your product is in English  
* The user searches in French  
* AI cannot strongly map the query → product  
* Another store with better language signals gets recommended  

👉 You lose customers who were already searching for your product.

---

== ❌ Why multilingual plugins alone don’t solve this ==

Traditional multilingual setups:

* Create separate translated pages  
* Rely on default language indexing  
* Do not connect all languages to a single product entity  

AI systems still see:

* Fragmented or weak signals  
* No strong cross-language mapping  

So your product remains under-recommended.

---

== ✅ How this plugin solves it ==

This plugin keeps:

* One **English base entity**

And adds:

* Multilingual titles directly into structured data  
* Cross-language semantic signals  
* Strong entity mapping across languages  

Now AI systems can:

* Understand all language variations as the same product  
* Match queries across regions  
* Recommend your product with higher confidence  

---

Learn more about European multilingual strategy:


<a href="https://wptruss.com/europe/scale-your-woocommerce-store-to-43-european-languages-via-ai-schema/" target="_blank">
Scale your WooCommerce store to 43+ European languages via AI schema
</a>

---

== ✅ What this plugin actually does ==

= 1. Makes your products understandable to AI =

Generates AI-optimized product titles and context that help AI systems understand:

* What the product is  
* Who it is for  
* When and why it should be used  
* How it compares to alternatives  

This improves **entity matching and retrieval accuracy**.

--- 

= 2. Adds structured data AI systems rely on =

Automatically generates Schema.org markup:

* Product  
* Offer (price, currency, availability)  
* AggregateRating  
* FAQ schema  

This enables **machine-readable extraction**, not just indexing.

---

= 3. Adds multilingual product intelligence =

* Generates product titles in 90+ languages  
* Injects multilingual signals into structured data  

This allows AI systems to match queries across regions without requiring multiple translated pages.

---

= 4. Prepares your store for AI-driven discovery =

Instead of optimizing for:

* Rankings  

You optimize for:

* AI answers  
* Product recommendations  
* Cross-language discovery  

---

== 🔍 Why this is different from SEO plugins ==

SEO plugins:

* Optimize meta titles and keywords  
* Focus on rankings  

This plugin:

* Optimizes for AI systems (ChatGPT, Perplexity, Gemini)  
* Structures product data for machine understanding  
* Improves likelihood of being selected in AI-generated answers  

This is not SEO.  
This is **AEO (Answer Engine Optimization)**.

---

== 📈 Example queries your products can match ==

* English: best minimalist wallet for travel  
* German: leder geldbörse herren  
* French: portefeuille cuir homme  
* Spanish: cartera minimalista hombre  
* English: bluetooth headphones for flights  
* English: privacy messaging app without phone number  

AI systems use structured understanding to match these queries to your products.

---

== ⚙️ Features ==

* AI-powered product title generation using Google Gemini, OpenAI (ChatGPT), and Anthropic (Claude)
* Multilingual support (90+ languages)  
* Schema.org structured data (Product, Offer, Rating, FAQ)  
* Batch processing for large catalogs  
* Product collections with shortcode support  
* XML sitemap integration  

---

== 🧩 How it works ==

1. Select your WooCommerce products  
2. Generate AI titles and structured data  
3. Review and publish  
4. Your store becomes AI-readable and machine-friendly  

---

== 📌 Who should use this plugin? ==

* WooCommerce stores targeting European or global markets  
* Stores selling across multiple languages  
* Large product catalogs  
* Founders exploring AI search visibility  
* Anyone preparing for post-SEO discovery  

---

== ⚠️ Important ==

This plugin does NOT guarantee rankings.

It improves your chances of being:

* Understood  
* Matched  
* Recommended  

…by AI systems like ChatGPT, Perplexity, and Google Gemini and more.

---

== Requirements ==

* WooCommerce 7.0 or higher  
* A Google Gemini API key (https://aistudio.google.com/app/apikey)  

---

== Installation ==

1. Install and activate WooCommerce  
2. Upload and activate this plugin  
3. Go to **AI AEO > Settings**  
4. Enter your Google Gemini API key  
5. Select target languages  
6. Open any product and click **Generate AI Preview**  
7. Review and save  

---

== Frequently Asked Questions ==

= Is this plugin free? =

Yes, a free version is available with core AEO features.

A premium version with advanced capabilities is planned.

---

= Do I need an API key? =

Yes. You need a Google Gemini API key to generate AI content.

---

= What AI models are used? =

Supports Google Gemini (gemini-1.5-flash), OpenAI (GPT-4o), and Anthropic (Claude 3.5 Sonnet).

---

= Does this work with all product types? =

Yes, all WooCommerce product types are supported.

---

= Is this GDPR compliant? =

Yes. Only product data is sent to the AI provider. No customer data is transmitted.

---

= Is this affiliated with WooCommerce? =

No. This is an independent plugin and is not affiliated with WooCommerce or Automattic.

---

== External Services ==

This plugin connects to the Google Gemini API.

* Service: https://ai.google.dev/  
* Data sent: product title, description, categories, attributes  
* When: only on manual generation or batch processing  
* API key: provided by you, requests go directly to Google  
* Terms: https://ai.google.dev/terms  
* Privacy: https://policies.google.com/privacy  

No customer personal data is sent.

== Changelog ==
= 1.5 =
* Fixed: Data Integrity page was blank — added missing render_page(), init(),
  and AJAX handlers (toggle override, toggle exclusion) to PKDP_Admin_Integrity.
* Fixed: Merchant Feed page was blank — added missing render_page(), init(),
  and flush rewrite rules AJAX handler to PKDP_Admin_Feed.
* Fixed: PHP Fatal error on PHP 8 — "non-static method PKDP_Feed::init()
  cannot be called statically" caused by a stale WP-Cron database entry.
  PKDP_Feed::init() is now a static singleton factory that also prevents
  double hook registration.
* Fixed: pkdp-sitemap-products.xml and pkdp-sitemap-entities.xml returning
  404 — PKDP_Sitemaps::init() and PKDP_Shortcodes::init() were included but
  never hooked into plugins_loaded in the main plugin file.
* Added: PKDP product sitemaps are now registered as a provider inside the
  WordPress built-in sitemap (/wp-sitemap.xml → /wp-sitemap-pkdp-1.xml),
  making AI-processed products discoverable via the standard WP sitemap index.
* Improved: Merchant Feed admin page now shows cache status, all feed and
  sitemap URLs with one-click copy, and a Flush Rewrite Rules button.
* Improved: Data Integrity page now shows a live AEO readiness dashboard —
  total products, AEO-ready count, issues list with per-field override
  checkboxes, and product exclusion support.
= 1.4.1 =
* Added: Settings UI to configure OpenAI and Anthropic API keys.
* Added: Option to select the default AI provider for title generation.
* Improved: AI provider routing logic and detailed error reporting.

---

== Screenshots ==

1. AI product title generation inside WooCommerce editor  
2. Multilingual product titles across multiple languages  
3. Structured data (JSON-LD) preview for validation  
4. Batch processing interface  
5. Product collections with shortcode output  