=== Livada SEO Lite ===
Contributors: florinlivada
Tags: seo, schema, sitemap, local-seo, open graph
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Real SEO hygiene, verified: proves nothing got lost when you migrate, scores your AI visibility, and speaks to AI agents.

== Description ==

**Livada SEO Lite** covers real SEO hygiene end to end, with zero front-end JavaScript and zero front-end CSS (except an opt-in 1 KB stylesheet for breadcrumbs). No time limit, nothing crippled — everything below works for as long as you use this plugin.

= What's in the box =

* **Meta** — title templates, meta description, canonical, robots
* **XML sitemap** — posts and pages
* **Schema** — WebSite, Article, and a business entity (Campground, Hotel, Bed & Breakfast, Restaurant, Store, and eight more types — whichever fits your business)
* **Open Graph & Twitter Cards** — auto-fill + per-post OG image override
* **Breadcrumbs** — shortcode, template tag, and an Elementor dynamic tag
* **On-page analysis** — 16 SEO checks + Flesch reading-ease score, live in the metabox
* **Robots.txt manager** — virtual robots.txt with a sitemap directive
* **AI-powered suggestions** — title, meta description, focus keyword and rewrite, via Anthropic Claude, OpenAI or Google Gemini (bring your own API key)
* **Image alt-text review** — list every attachment missing alt-text, edit inline, optional one-click AI-generated suggestion
* **Yoast / Rank Math / AIOSEO / SEOPress importer** — batched migration of your existing SEO data
* **Migration Verify** — snapshots what Google could already see on a page *before* you import, then diffs it against the same page *after* — so a switch from another SEO plugin is proven lossless, not just assumed
* **AI Visibility Score** — a free 0–100 score for how ready your site is to be discovered and cited by ChatGPT, Perplexity, Gemini and Google AI Overviews — the kind of number paid AI-visibility monitoring tools charge a monthly fee for
* **Full REST API** for every feature above
* **Built for AI agents** — an MCP-ready REST API (via WordPress's own Abilities API, 6.9+), a machine-readable API Catalog, and an Agent Skills manifest, so AI tools can discover and use what this plugin does — not just crawl it

= Why Livada SEO Lite? =

* **Proof, not just promises** — Migration Verify checks that switching from another SEO plugin didn't silently drop a tag Google could already see; the AI Visibility Score gives you a real, checkable number instead of a vague "your SEO looks good"
* **Genuinely light** — 0 KB front-end JS/CSS (an opt-in 1 KB stylesheet only if you use the breadcrumbs shortcode)
* **A real business entity, not just a page title** — describe your business once (name, address, phone, hours) and every page publishes it correctly to Google and AI assistants
* **AI-assisted, not AI-locked** — bring your own API key for any of three providers; nothing is metered or resold

= Designed for =

* Camping / hotel / B&B / restaurant sites
* Single-location local businesses
* Developers who want code they can actually read and modify
* Anyone who wants a real, working free SEO plugin

= Want more? =

Livada SEO Pro (a separate plugin, livada.io/livada-seo) adds redirects + a 404 monitor, multiple business locations, AEO (llms.txt + AI content markers), automatic image optimisation, hreflang for multilingual sites, WooCommerce schemas, a daily Site Audit, bulk editing tools, and more — sharing the SEO data you already entered in this plugin.

== External services ==

This plugin connects to the following third-party services. Each one is used only for the specific feature it powers — none of them runs unless you actively use that feature (and, for the AI providers, only after you've entered your own API key).

**AI-powered suggestions and image alt-text (Anthropic, OpenAI, Google Gemini)**

When you click one of the metabox's **AI ✨** buttons (title/description/keyword suggestions) or the Image SEO bulk editor's **AI** button (alt-text suggestions), this plugin sends the relevant page content (title, existing meta, or a small excerpt) to whichever provider you've configured, using the API key you provided under **Livada SEO → General**. Nothing is sent unless you both configured a key and clicked the button. Your API key is stored encrypted at rest.
* Anthropic (Claude): https://www.anthropic.com/legal/consumer-terms and https://www.anthropic.com/legal/privacy
* OpenAI: https://openai.com/policies/row-terms-of-use/ and https://openai.com/policies/row-privacy-policy/
* Google Gemini: https://ai.google.dev/gemini-api/terms and https://policies.google.com/privacy

**AI Visibility Score (Livada Observatory)**

This plugin includes an AI Visibility Score capability: when run, it sends your site's public homepage URL to Livada's Observatory scoring service, which returns a 0–100 score describing how ready the site is to be found and cited by AI assistants. No visitor or personal data is sent — only the site's own public URL.
* Service: Livada (https://livada.io) — terms of service and privacy policy: https://livada.io/cgv/ and https://livada.io/politique-confidentialite/

== Installation ==

1. Upload the `livada-seo-lite` folder to `/wp-content/plugins/`, or install directly from the WordPress.org Plugins screen.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Go to **Livada SEO → Schema** to describe your business (name, address, phone, hours).
4. Go to **Livada SEO → General** to (optionally) add an AI provider API key for suggestions and alt-text.
5. (Optional) Migrate from another SEO plugin under **Livada SEO → Tools**.

= Migrating from another SEO plugin =

1. Keep the other plugin active during the import.
2. Go to **Livada SEO → Tools** and click the matching **Import from …** button.
3. The import is batched and migrates titles, meta descriptions, focus keywords, canonical URLs and social profiles.
4. After the import succeeds, deactivate the other plugin and verify a few posts manually before deleting it.

== Frequently Asked Questions ==

= Does it work with Elementor? =

Yes. The on-page analyser renders Elementor content for accurate scoring.

= How does the AI-powered suggestion feature work? =

Add an API key for Anthropic, OpenAI or Google Gemini under **General**. The key is stored encrypted at rest, derived from your `wp_salt('auth')`. The metabox's **AI ✨** buttons then call your chosen provider and pre-fill the field with a suggestion you can edit before saving.

= What's the difference between this and Livada SEO Pro? =

Same underlying SEO data (titles, descriptions, business info) — Pro adds advanced features on top: multiple business locations, redirects, AEO, automatic image optimisation, hreflang, WooCommerce, Site Audit and bulk tools. They are two separate plugins; nothing in this plugin is disabled or time-limited.

= How do I uninstall cleanly? =

Use **Plugins → Delete**. `uninstall.php` removes every option, every post meta with the `_livada_seo_` prefix, and every plugin transient.

== Screenshots ==

1. Dashboard.
2. Schema settings — describe your business once.
3. SEO metabox with AI suggestions and live on-page checks.

== Changelog ==

= 1.0.0 =
* Initial release: meta, sitemap, schema, Open Graph, breadcrumbs, on-page analysis, robots.txt, AI suggestions, image alt-text review, and importers for Yoast/Rank Math/AIOSEO/SEOPress.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
