=== Aenima — AI Search Visibility ===
Contributors: technicalgraffiti
Tags: ai search, schema, llms.txt, ai visibility, local seo
Requires at least: 5.8
Tested up to: 6.9
Stable tag: 1.4.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Make your WordPress site visible to AI search engines — ChatGPT, Perplexity, Google AI and more. Free score check included.

== Description ==

**Most local businesses are invisible to AI search engines. Aenima fixes that.**

When someone asks ChatGPT, Perplexity or Google's AI Overview "find me a plumber in Bristol" or "best solicitor in Manchester" — AI doesn't search the web the way Google does. It looks for structured signals it can trust: Schema markup, an AI identity file (llms.txt), correct crawler access, and verified directory signals.

Without these, AI treats your site as an anonymous page with no verified identity. You don't get recommended. You don't exist to those customers.

**Aenima generates and installs the exact files AI engines need to find, understand and recommend your business.**

= What Aenima does =

* **Free AI visibility score** — checks your site against 5 technical signals and scores it out of 100. No account needed, always free.
* **Schema JSON-LD** — generates and embeds structured business data on every page of your site. Tells AI your name, type, location, services and contact details.
* **llms.txt** — publishes an AI identity file at yoursite.co.uk/llms.txt. AI crawlers read this to understand who you are before they read anything else.
* **Monthly auto-update** — on a Pro subscription, the plugin re-checks your score and regenerates your files every month automatically. Nothing to do — it runs while you sleep.
* **FAQ Schema** — auto-detects questions on your pages and marks them up so AI can use them as direct answers.

= Who is it for? =

Any UK local business that wants to appear in AI-generated answers — plumbers, electricians, solicitors, accountants, builders, architects, restaurants, retailers and more.

= Plans =

* **Free** — score check, unlimited, no account needed
* **Starter (£5.50/mo)** — Schema and llms.txt generated every month, downloaded and installed by you. Works on any website.
* **Pro (£7.50/mo)** — this plugin installs and updates everything automatically every month. WordPress only.

Subscribe at [aenima.co.uk](https://aenima.co.uk)

= External services =

This plugin connects to the Aenima API at **aenima.co.uk** to:

* Check your AI visibility score (free, no account needed)
* Add your API token from aenima.co.uk to activate file generation
* Generate your Schema and llms.txt files

Data sent: your website domain for score checks, your API token and domain for licence verification, your business details (name, address, phone, email, services) for file generation.

No data is sold or shared with third parties. Full privacy policy: [aenima.co.uk/privacy](https://aenima.co.uk)

This plugin uses the Aenima service operated by Technical Graffiti Ltd, Northamptonshire, England. Company No. 07180346.

== Installation ==

1. Upload the plugin via **Plugins → Add New → Upload Plugin** in your WordPress admin
2. Activate the plugin
3. Go to **Settings → Aenima**
4. Run a free score check to see your current AI visibility
5. Subscribe at aenima.co.uk to get your API token
6. Paste your token in Step 1 on the settings page
7. Fill in your business details
8. Click **Save & Update** — your Schema and llms.txt are generated and installed instantly

That's it. For Pro subscribers, everything updates automatically every month.

== Frequently Asked Questions ==

= Is the score check really free? =
Yes. You can check your AI visibility score as many times as you like, on any domain, with no account and no payment. Always free.

= Do I need a subscription to use the plugin? =
The score check is free. To generate and auto-install your Schema and llms.txt files you need a Starter (£5.50/mo) or Pro (£7.50/mo) subscription at aenima.co.uk.

= What is llms.txt? =
llms.txt is an emerging standard AI identity file — similar to robots.txt but for AI language models. It sits at yoursite.co.uk/llms.txt and tells AI crawlers exactly who you are, what you do, and how to contact you. AI engines increasingly read this before anything else on your site.

= What is Schema JSON-LD? =
Schema markup is structured data embedded in your page code that tells search engines and AI exactly what type of business you are, where you are, what you do, and how to contact you. Without it, AI has to guess — and often gets it wrong or ignores you entirely.

= Will this conflict with Yoast or Rank Math? =
Aenima generates a LocalBusiness schema which is different from the page/article schema that Yoast and Rank Math produce. They can coexist. If you see duplicate schema warnings, disable the organisation/local business schema output in your SEO plugin and let Aenima handle it.

= What happens if I cancel my subscription? =
Your Schema and llms.txt files stay on your site and keep working. They just won't update automatically any more. You can reactivate at any time — your token and settings are preserved.

= Does it work on non-WordPress sites? =
The plugin is WordPress only. For non-WordPress sites, the Starter plan at aenima.co.uk generates the files for you to download and install manually.

= Where do I find my API token? =
Log in to your account at aenima.co.uk, go to your dashboard, and copy your API token. Paste it into Settings → Aenima → Step 1.

== Screenshots ==

1. Settings page — score panel, token verification and business details form
2. Token verified — active confirmation with green status banner
3. Schema JSON-LD and llms.txt preview — generated and ready
4. WordPress dashboard widget — AI visibility score ring at a glance

== Changelog ==

= 1.4.1 =
* Version constant aligned with plugin header — 1.4.0 internal mismatch corrected
* Changelog entries added for all previous versions

= 1.4.0 =
* Version constant aligned with plugin header
* Internal code improvements and stability fixes

= 1.3.0 =
* Added Gemini visibility signal support
* Improved llms.txt generation with Quick Summary front-loaded for AI crawlers
* Added service areas section to llms.txt output
* Monthly refresh cron stability improvements

= 1.2.0 =
* Added token verification confirmation banner — green/amber/red status shown immediately after save
* Added data guard — Business Name and Town required before settings can be saved
* Added upgrade prompt for Starter plan users — direct link to Pro plan
* Updated brand colours throughout to match Aenima identity

= 1.1.0 =
* Improved score panel layout — horizontal grid with score ring, issues list and action button
* Added plan, last updated and next run stats below score button
* Added file preview boxes — Schema JSON-LD and llms.txt shown inline
* Added deactivation warning — reminds users subscription continues independently
* Improved admin notices — contextual warnings for missing token, inactive subscription and incomplete setup

= 1.0.0 =
* Initial release
* Free AI visibility score check
* Schema JSON-LD generation and injection
* llms.txt generation and file write
* Monthly auto-refresh via WordPress cron
* Licence verification against Aenima API

== Upgrade Notice ==

= 1.2.0 =
Adds token confirmation, data validation and upgrade prompt. Recommended update for all users.
