=== Recomaze - AI Chat Agent, AEO & GEO ===
Contributors: betterrecomaze
Tags: ai, aeo, geo, chatbot, woocommerce
Requires at least: 5.8.1
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.1.113
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

An AI chat agent for your site, plus the AEO and GEO work behind it: get found, cited and recommended when shoppers ask an AI what to buy.

== Description ==

Recomaze does two things for a WordPress site, and they feed each other.

**An AI chat agent on the site.** A conversational agent that answers visitor questions from your own catalog, policies and knowledge base - not generic AI answers - recommends the right product, and carries the visitor toward checkout.

**AEO and GEO.** AEO (Answer Engine Optimization) and GEO (Generative Engine Optimization) are two names for the same discipline: getting a site retrieved, understood and cited by AI assistants when they generate an answer. Recomaze tracks whether AI actually mentions you, fixes the reasons it does not, and publishes the content and machine-readable signals that make you quotable.

The loop between them is the point. The chat agent sees every question your visitors ask, including the ones it could not answer. Those failures become a work list for the AEO side - and content published for AEO comes back as knowledge the agent can answer from.

Traditional SEO competes for a position on a page of links. AEO competes to be inside the generated answer. A page can rank well in Google and never be quoted by an AI assistant, usually because nothing on it can be parsed into a clear, checkable claim.

= The AI chat agent =

* **Answers from your own content** - the agent replies from your catalog, knowledge base and policies, in your brand voice, instead of improvising.
* **Recommends products in conversation** - it surfaces the right item as part of the answer and links the visitor to it.
* **Your styling** - colors, placement, wording and the launcher are yours to set, so the agent looks like part of the site.
* **Preview mode** - turn the agent on for administrators only and try it on the live site before any visitor sees it.
* **Conversation analytics** - conversations, visitor journeys, KPIs and insights, so you can read what people actually ask.
* **Campaigns** - run targeted on-site campaigns through the agent.

= Gaps: what the agent could not answer =

Every conversation the agent handles badly is recorded as a **gap** and sorted into four buckets: *information missing*, *feature or product missing*, *cannot guide*, and *out of scope*. A gap is not a report you read and forget - each one carries a fix, and the fix is a button:

* Missing information becomes a **knowledge base article** the agent can answer from next time.
* A losing topic becomes an **AI Visibility article** drafted on that exact question.
* A vague product becomes a **product rewrite** in the Content Generator, focused on the attributes the visitor asked about.
* A policy question becomes a **policy update** in your knowledge base.

You can mark a gap resolved or dismiss it. The list is filtered by period, so you can see whether last month's holes actually got closed.

= AI Visibility =

* **Visibility scans** - ask the buying questions that matter in your niche and record which brands the AI names in the answer.
* **Tracked prompts** - keep a set of questions under continuous tracking and watch each one trend over time.
* **Competitor tracking** - see which brands take the mentions you do not, add competitors deliberately, and exclude ones that are not really rivals.
* **Cited sources** - see which pages an AI actually pulled from when it answered.
* **Mentioned vs cited** - being named and being used as a source are different results, and they are reported separately.
* **Funnel coverage** - see which stage of the buying journey your content covers and where it stops.
* **Scan history and wins/losses** - what moved since the last scan, in both directions.
* **Trending in your chat** - questions rising in your own visitor conversations, promoted into tracked prompts.

= Content that answers the question =

* **Content Generator** - draft articles against the questions you are losing, then publish them straight into WordPress posts.
* **Page templates** - reusable structures for the page types that earn answers, run across topics.
* **Content Checker** - check a draft against what answer engines can actually extract from it, and apply the fixes.
* **Optimized text pages and product content** - rewrite titles, descriptions and Q&A so an AI can lift a fact instead of guessing at marketing copy.
* **Prompt templates** - reusable generation prompts, so output stays consistent with how you write.
* **Scheduling and images** - schedule a publish, and get image suggestions with the draft.
* **Multi-language** - generate the same content in several languages.

= Catalog and context =

* **Catalog Quality** - scan products, score how AI-ready each one is, and fix them individually or in bulk.
* **Import** - bulk upload products and content.
* **Knowledge Base** - the source of truth the agent answers from: policies, shipping, returns, anything a visitor asks.
* **AI Company ID** - what you sell, who you sell to and how you talk, built once and pushed to everything the agent and the content generator produce.
* **Connectors and integrations** - connect the site so Recomaze can publish back to it, and plug into the rest of your stack.
* **Agentic Commerce Feed** - publish a machine-readable product feed for AI shopping agents.
* **llms.txt** - served automatically at `/llms.txt` and `/llm.txt`, the emerging convention for telling AI crawlers what a site is and what it offers. No file to write by hand.
* **AI crawler log** - every fetch of your llms.txt is recorded, so you can see which AI crawlers came, how often, and when they started.
* **Answer schema** - Article and FAQPage JSON-LD published in the page head, so an answer engine can lift a question and its answer directly. If Yoast or Rank Math already emits the Article, Recomaze steps aside and publishes only the FAQ, so the page never carries two.
* **SEO fields filled in for you** - articles published by Recomaze arrive with the focus keyphrase, SEO title and meta description already written into Yoast SEO's and Rank Math's own fields.
* **AI copilot in the admin** - ask it to do the work and it runs the steps for you.
* **Dashboard** - one AI-readiness score, the setup steps still open, and the latest articles, gaps and insights.

= Where your site can appear =

Recomaze prepares content for the assistants people actually ask, including ChatGPT, Claude, Perplexity, Google Gemini, Google AI Overviews and Microsoft Copilot. These are independent services; Recomaze is not affiliated with or endorsed by any of them, and no plugin can guarantee a mention in a generated answer. What Recomaze does is remove the reasons a site gets skipped: thin content, no machine-readable summary, no structured answers, nothing published against the question being asked.

= How it works =

1. Install, activate, and connect the site to Recomaze from the WordPress admin.
2. Recomaze reads your site and builds your AI Company ID: what you offer, who for, in what voice.
3. It scans AI assistants for the questions in your niche and reports where you stand against your competitors.
4. It fixes what it can - content, product text, knowledge base, llms.txt, schema - and drafts what is missing.
5. The chat agent goes live, and every question it cannot answer comes back as a gap with a fix attached.

= WooCommerce optional =

Recomaze runs on any WordPress site. A content site that wants the chat agent and the AEO work installs it and never touches a product. When WooCommerce is active, the catalog features switch on as well: product scanning and scoring, bulk product rewrites, product recommendations in chat, the product feed and order tracking.

== External Services ==
This plugin connects to the following external services:

1. **Recomaze API**  
   - Domain(s):  
     - `https://api.recomaze.ai`  
     - `https://stagingapi.recomaze.ai` (for testing and staging environments)
   - Purpose:  
     The API is used to retrieve user-specific product recommendations, update user preferences, and refresh authentication tokens.
   - Data Sent:  
     - Plugin token (used for authentication)  
     - Store domain (to identify the WooCommerce store)  
     - Interaction events such as user preferences or clicks  
     - Product details from orders, including:
       - Product names  
       - Product characteristics (e.g., categories, attributes)  
       - Product prices  
   - Terms of Use: [https://recomaze.ai/tos/](https://recomaze.ai/tos/)  
   - Privacy Policy: [https://recomaze.ai/privacy-policy/](https://recomaze.ai/privacy-policy/)

2. **Recomaze Tracking UI**  
   - Domain(s):  
     - `https://trackui.recomaze.ai`  
     - `https://stagingtrackui.recomaze.ai` (for testing and staging environments)
   - Purpose:  
     The tracking service is used to display UI components such as recommendation popups and gather anonymous usage metrics to optimize recommendations.
   - Data Sent:  
     - Client ID associated with the WooCommerce store.  

3. **Recomaze Admin Service**  
   - Domain(s):  
     - `https://admin.recomaze.ai`  
   - Purpose:  
     This service is used to send logs for monitoring and debugging purposes.
   - Data Sent:  
     - Plugin events and API interaction logs.  

4. **Recomaze Collector Service**  
   - Domain(s):  
     - `https://collector.recomaze.ai`  
   - Purpose:  
     The collector service is used to retrieve reports for analytics and recommendations.
   - Data Received:  
     - Analytics reports and performance insights.

== Installation ==

= From the WordPress admin =
1. Go to Plugins > Add New and search for "Recomaze".
2. Click Install Now, then Activate.
3. Open the Recomaze menu in the admin sidebar and follow the setup.

= Manual installation =
1. Upload the `recomaze-ai-personalization` folder to `/wp-content/plugins/`.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Open the Recomaze menu in the admin sidebar and follow the setup.

== Frequently Asked Questions ==

= Do I need WooCommerce to use this plugin? =
No. Recomaze works on any WordPress site, including a blog or a content site with no shop at all - the chat agent, AEO and GEO features all run without it. WooCommerce is only needed for the catalog features: product scanning and scoring, bulk product rewrites, product recommendations and the product feed.

= What is AEO? =
AEO stands for Answer Engine Optimization: optimizing a site so AI assistants can retrieve, understand and cite it when they generate an answer, rather than optimizing only for a ranked list of links.

= What is GEO? =
GEO stands for Generative Engine Optimization. It is used interchangeably with AEO and describes the same goal: being the source a generative AI builds its answer from.

= How is AEO different from SEO? =
SEO competes for a position on a results page the visitor still has to click. AEO competes to be inside the answer itself. The work is different: facts stated plainly, structure a machine can parse, and content published against the question actually being asked.

= How do I get my products recommended by ChatGPT? =
An AI recommends what it can retrieve and verify. In practice that means pages that state facts plainly, a machine-readable summary of the site, structured data an assistant can lift, and content that answers the question. Recomaze automates all four and then tracks whether the mentions appear.

= What is a gap? =
A gap is a conversation your chat agent handled badly - a question it could not answer, a product it could not find, a visitor it could not guide. Recomaze groups them by type and attaches a fix to each: draft the missing knowledge base article, write the article on that topic, rewrite the product, or update a policy.

= What is llms.txt and does this plugin create one? =
llms.txt is a plain-text file at the root of a site telling AI crawlers what the site is, what it offers and where the important content lives - robots.txt, aimed at language models. Recomaze generates and serves it at `/llms.txt` and `/llm.txt` automatically.

= Does this plugin add schema markup? =
Yes. Content generated by Recomaze is published with Article and FAQPage JSON-LD in the page head, so answer engines can extract a question and its answer directly.

= Can I see whether AI assistants mention my site? =
Yes. Recomaze tracks a set of buying questions, records which brands are named in the answers and which sources are cited, and reports your share over time next to the competitors taking the rest.

= Does it work with my SEO plugin? =
Yes, and it feeds them. When Recomaze publishes an article it fills in Yoast SEO's and Rank Math's own fields on that post - focus keyphrase, SEO title and meta description - so the post arrives complete instead of needing a second pass. It never touches your site-wide SEO settings, sitemaps or existing posts, so nothing it does conflicts with Yoast, Rank Math or All in One SEO.

= Is there a free version? =
Yes. The free tier includes the AI discoverability audit, an action plan and a monthly credit allowance, with paid plans for larger catalogs and higher volumes.

= What data is shared with external services? =
The plugin shares site domain, product details and interaction events with the Recomaze API. The External Services section above lists every service, what is sent and why.

== Changelog ==

= 1.1.113 =
* Fixed: clicking an agent in the plan picker scrolled the whole app frame half off the window with no way back. The frame can no longer be scrolled by a script, and View plans scrolls the page itself.

= 1.1.112 =
* Plans & Billing is rebuilt: the plans come from the Recomaze catalog, annual or monthly, picked the way recomaze.ai/pricing picks them, and the page opens on Starter paid annually.

= 1.1.111 =
* Settings: the Platform card flips to Connected on its own once the login is saved in the other tab, no reload needed.

= 1.1.110 =
* Settings: the Recomaze Platform login is set on custom.recomaze.ai, not typed into the plugin.

= 1.1.109 =
* New Settings page: connect the store to the Recomaze Platform with your email and password.

= 1.1.108 =
* Fixed: articles published as a custom post type lost their Article schema entirely when Yoast or Rank Math was active; the schema now steps aside only on posts and pages, where those plugins actually print their own.
* Fixed: a comma inside a focus keyphrase split it into two Rank Math keywords. A payload with no primary keyphrase now promotes the first secondary instead of leaving the post without one.

= 1.1.107 =
* Published articles now pass their secondary focus keyphrases to Rank Math, so its keyword density reflects every term the article uses for its subject.

= 1.1.106 =
* The plan cards on Plans & Billing line up: every button sits at the bottom of its card and the Enterprise card no longer sits lower than the others.

= 1.1.105 =
* The Automation module is gone from the sidebar; the Agentic Commerce Feed page is still reachable by link.
* Sidebar logo fix.

= 1.1.104 =
* Sidebar polish: Content Studio reordered, clearer names, the logo back in the rail, and the search field no longer loses its padding to the WordPress admin styles.

= 1.1.103 =
* New sidebar.
* Fixed: an Article schema published beside Yoast's or Rank Math's own gave the page two publication dates. Recomaze now publishes only the FAQ schema when an SEO plugin owns the Article.
* Fixed: schema on non-English sites printed mangled characters, from escapes lost when WordPress unslashed the stored value.
* Fixed: featured images arrived with empty alt text; the cover's alt is written to the media library now.

= 1.1.102 =
* Fixed: the Analytics tab crashed to "Something went wrong loading this page" whenever it was reloaded or refreshed, from a React hook declared after an early return.
* Fixed: on a site without WooCommerce, the product import scheduled at activation and the Import Products endpoint called a WooCommerce function that does not exist and fatalled. Both are guarded now.
* The listing documents the AI crawler log and the SEO fields written for Yoast and Rank Math.

= 1.1.101 =
* Declared compatibility with WordPress 7.1 and added the WooCommerce compatibility headers.

= 1.1.100 =
* The listing and plugin description are rewritten around the chat agent, AEO and GEO, and now cover gaps, AI Visibility, content, catalog and llms.txt.
* Corrected: WooCommerce is not required. The plugin runs on any WordPress site.
* The trial banner quotes the launch price actually charged, not the list price.

= 1.1.98 =
* Launch offer is a fixed price for the first 6 billing cycles.
* Fixes to the sidebar, article colours, popup preview settings and AI Visibility.
