=== Visibly AI — SEO & AEO Optimizer ===
Contributors: visiblyai
Tags: seo, schema, llms, ai, structured data
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered SEO and AEO for WordPress — rank in traditional search and get cited by AI answer engines.

== Description ==

Search is changing. Google AI Overviews, ChatGPT Search, and Perplexity are now primary discovery surfaces — and they don't rank pages the same way Google's blue links do. **Visibly AI** helps you win both.

AI analyzes your content and tells you exactly how to improve each article for both traditional search rankings and AI citations.

**Free features:**

* **llms.txt auto-generator** — Automatically creates and maintains an `llms.txt` file at your site root. AI crawlers use this to understand your content — think `robots.txt`, but for LLMs. Updates every time you publish or update a post.
* **Schema markup wizard** — Guided setup for FAQ, HowTo, and Article structured data. These are the schema types that AI engines prefer when pulling citations.
* **Visibility score** — A per-page score (green/amber/red) that tells you how AI-citable and search-optimized your content is: question/answer structure, heading hierarchy, meta description, concise definitions, and more.
* **Meta description editor** — Native meta description field built right into the editor. Works alongside Yoast and Rank Math — Visibly AI detects them and stays out of the way.

**Why Visibly AI?**

WordPress powers 43% of the web. As AI Overviews, ChatGPT Search, and Perplexity become primary discovery surfaces, content needs to be optimized for both traditional search and AI answer engines. Visibly AI handles both without adding complexity.

**Pro features (coming soon):**

* **AI article optimizer** — Connects to Claude AI to analyze your post and suggest specific improvements: better question/answer structure, stronger definitions, clearer headings.
* **Google Search Console integration** — See exactly which queries you rank for, where AI Overviews are appearing, and which articles are closest to page one.
* **Content gap analysis** — Find topics your competitors rank for that you're missing.
* **One-click improvements** — Accept AI suggestions directly in the editor.

== Installation ==

1. Upload the `aeo-optimizer` folder to the `/wp-content/plugins/` directory, or install via the WordPress plugin directory
2. Activate the plugin through the **Plugins** menu in WordPress
3. Go to **Visibly AI → Settings** to configure which content appears in your llms.txt
4. Visit **Visibly AI → llms.txt Preview** to confirm the file was created
5. Open any post or page in the editor — the **Visibly AI** sidebar panel shows your visibility score and schema tools

On activation, the plugin immediately generates your `llms.txt` file and saves it to your WordPress root. The file is publicly accessible at `yoursite.com/llms.txt`.

== Frequently Asked Questions ==

= What is llms.txt? =

llms.txt is an emerging standard (like robots.txt) that tells AI crawlers how to navigate your site. It's a Markdown file listing your key content with titles, URLs, and short descriptions. See llmstxt.org for the specification.

= Does this replace Yoast or Rank Math? =

No — it complements them. Visibly AI detects if you have Yoast or Rank Math active and uses their meta description data in its scoring. It won't output a duplicate meta description tag. The llms.txt, schema wizard, and AI score features work independently of both.

= Will this slow down my site? =

No. The llms.txt file is a static file written to disk on publish. AI crawlers access it directly — no PHP runs on each request. The schema markup is lightweight inline JSON-LD.

= What happens when I deactivate the plugin? =

The llms.txt file is removed from your site root on deactivation. Your content is unchanged.

= What happens when I delete the plugin? =

All plugin settings and the llms.txt file are permanently removed.

= My server won't let the plugin write to the root directory. What do I do? =

Visibly AI will show an admin notice with the exact path that needs to be writable. Ask your host to set write permissions on the WordPress root (`ABSPATH`), or switch to a host that allows it (most shared hosts do by default).

== Screenshots ==

1. Settings page — configure which content types appear in your llms.txt
2. llms.txt Preview — see and regenerate your file with one click
3. Editor sidebar — visibility score, meta description, and schema markup in one panel

== External Services ==

This plugin optionally connects to the Visibly AI API to provide AI-powered content optimization suggestions (Pro feature only). The free version of this plugin does not make any external API calls.

**Visibly AI API**

* What it does: Analyzes your post content and AEO signals, and returns specific copy-pasteable improvement suggestions powered by Claude AI (Anthropic).
* What data is sent: When you click "Analyze with AI" in the editor, the plugin sends your post's text content, a list of failing AEO signals, and your license key to the Visibly AI API.
* When it is sent: Only when a Pro user manually clicks the "Analyze with AI" button. No data is sent automatically or passively.
* License validation: When you save a Pro license key in the plugin settings, the key is sent to the Visibly AI API to confirm it is valid.
* Service provider: Visibly AI (getvisiblyai.com)
* Terms of Service: https://www.getvisiblyai.com/terms
* Privacy Policy: https://www.getvisiblyai.com/privacy

== Changelog ==

= 1.2.0 =
* Renamed all plugin prefixes from `aeo_` to `visai_` to meet WordPress.org uniqueness requirements
* No functional changes

= 1.1.0 =
* Fixed text domain mismatch (all strings now use `visibly-ai-seo-aeo-optimizer`)
* Removed comparative marketing language from readme
* Fixed JSON-LD XSS (escaped `</script>` in schema output)
* Fixed NonSingularStringLiteralText ternary in esc_html_e()
* Updated Contributors to `visiblyai`

= 1.0.0 =
* Initial release
* llms.txt auto-generator with settings page and preview
* Schema markup wizard (FAQ, HowTo, Article) with Gutenberg sidebar
* Visibility scorer — 8-signal content analysis with per-signal breakdown
* Native meta description field with character counter
* Freemium architecture with Pro feature placeholders

== Upgrade Notice ==

= 1.0.0 =
Initial release.
