=== TopSlot AI Visibility ===
Contributors: topslot
Tags: ai, seo, schema, structured-data, aeo
Requires at least: 5.6
Tested up to: 6.6
Requires PHP: 7.4
Stable tag: 1.3.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Render your TopSlot AI-visibility fixes into WordPress server-side, and apply approved meta + content recommendations with preview and one-click revert.

== Description ==

TopSlot measures how AI answer engines (ChatGPT, Gemini, Claude, Perplexity) see your brand and generates the fixes that help them cite you. This plugin applies those fixes on a WordPress site.

**Why server-side.** The TopSlot browser pixel only helps AI crawlers that run JavaScript. Many of them do not. This plugin writes the exact same fixes — schema, meta description, freshness signals — directly into the HTML WordPress renders, so every crawler sees them in the raw page.

**What it does**

* On-page fixes: injects your TopSlot JSON-LD schema, meta description, and freshness signals into `<head>`, server-side. It reads the same feed the pixel uses.
* Meta title and description: applies TopSlot recommendations into your existing SEO plugin's own fields (Yoast SEO, Rank Math, and All in One SEO), so there are never duplicate tags; falls back to its own fields when no SEO plugin is present.
* Content deployment: review meta and content recommendations you accepted in TopSlot and apply them from **TopSlot AI Visibility → Content**. Content updates save a WordPress revision so any change is one-click revertible. New pages are created as drafts — nothing is ever auto-published.

**Safe by design**

* On-page rendering never blocks a page load — fixes are cached locally and refreshed hourly in the background.
* Content is sanitized before it is written and every content change is a revision you can revert.
* An API key is only needed for meta and content deployment. On-page fixes work with just a brand ID.

== Installation ==

1. In your TopSlot dashboard, open **Connectors → WordPress** and copy your **Brand ID** (and, for content deployment, create an **API key** under Settings → API).
2. Upload and activate this plugin, or install the ZIP from **Plugins → Add New → Upload Plugin**.
3. Open the **TopSlot AI Visibility** menu and click **Connect with TopSlot** — sign in, pick your brand, and the Brand ID and API key fill in automatically. (You can also enter them manually under Settings.) To deploy your attribution pixel, paste the pixel snippet from your TopSlot dashboard (Pixel → Install) into the Settings screen.

== Frequently Asked Questions ==

= Do I need an API key? =
Only for meta and content deployment. On-page schema and meta rendering work with just your Brand ID.

= Will this conflict with my SEO plugin? =
No. It detects Yoast SEO and Rank Math and writes into their fields, and it never emits a meta description when your SEO plugin already outputs one.

= Can it break my content? =
Content updates go through WordPress revisions, so any change can be reverted in one click. New pages are created as drafts.

== Changelog ==

= 1.3.0 =
* Connect with TopSlot in one click: sign in, pick your brand, and the Brand ID and API key fill in automatically. No copying required. Manual entry is still available.

= 1.2.0 =
* Fixed a fatal error on activation in the Dashboard screen.
* New AI Readiness Audit: live on-site checks (search visibility, AI bot access in robots.txt, sitemap, llms.txt) plus per-page meta and content-length checks.
* Generate and serve /llms.txt built from your published pages.
* Deploy Microsoft Clarity by pasting your snippet or project id (only the validated id is stored; a clean tag is re-emitted).

= 1.1.0 =
* One unified "TopSlot AI Visibility" menu (Dashboard, Content, Settings) replacing the split Settings/Tools screens.
* New Dashboard home screen with connection + status at a glance.
* Deploy your TopSlot attribution pixel by pasting the snippet (only the pixel id is stored; a clean script tag is re-emitted).
* Content screen now shows an overview of your published pages and their current meta.
* Setup prompt guides you to Settings until a brand is connected.

= 1.0.0 =
* Initial release: server-side on-page fixes, SEO-plugin-aware meta, and reviewed content deployment.
