=== Vibebun AI SEO Meta ===
Contributors: vibebun
Tags: seo, meta, ai, yoast, rank math
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.2.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Unified SEO meta for Yoast, Rank Math, AIOSEO, The SEO Framework & SEOPress, with AI suggestions via the WordPress AI Client or a custom endpoint.

== Description ==

Vibebun AI SEO Meta gives you a single admin screen to view and edit SEO meta across every post on your site, regardless of which SEO plugin is active. Supported:

* Yoast SEO
* Rank Math
* All in One SEO (AIOSEO)
* The SEO Framework
* SEOPress

Generate meta titles, descriptions, and Open Graph copy with one click. On WordPress 7.0+, AI suggestions use the **WordPress core AI Client**: you configure a provider once at the site level (Settings → Connectors) and this plugin uses it — no API key is handled by the plugin. You can also point the plugin at your own **custom or local OpenAI-compatible endpoint** (a self-hosted gateway, Ollama, LM Studio, and similar) by entering its URL, model, and API key under AI SEO Meta → Settings.

The unified meta editor works on WordPress 6.0 and newer. AI suggestions need either WordPress 7.0+ (which ships the AI Client) or a custom endpoint you configure; on WordPress older than 7.0, AI runs only when a custom endpoint is set. If no AI is configured, the unified meta manager still works as a full-featured editor.

== External Services ==

How AI suggestions reach a provider depends on your WordPress version and settings.

On WordPress 7.0 and newer, AI runs through the **WordPress core AI Client**. When you click "AI Suggest" or "Generate All", your post title and a short content excerpt (up to ~80 words) are passed to WordPress core, which forwards them to the provider configured under **Settings → Connectors** (or to a custom endpoint you enter in this plugin's settings, registered into the core AI Client). This plugin does not contact any provider directly on 7.0+.

On WordPress older than 7.0 (no core AI Client), AI only works if you explicitly configure a **custom endpoint** in this plugin's settings (an endpoint URL, model, and API key that you provide). In that case, and only on your action, the plugin sends your post title and a short excerpt directly to the URL you specified. There is no default or hardcoded destination — the plugin contacts only the endpoint you enter. No data is sent automatically.

This plugin stores no provider credentials of its own beyond the optional custom-endpoint key you choose to save (which can instead be supplied via the `VIBEBUNAISEO_CUSTOM_AI_API_KEY` constant or environment variable). When you use a core Connector on 7.0+, the provider and key are owned by WordPress core, not this plugin.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`.
2. Activate through the Plugins menu.
3. Set up AI: on WordPress 7.0+, configure a provider under **Settings → Connectors** (provided by WordPress core) or enter a custom endpoint in the plugin settings; on older WordPress, enter a custom OpenAI-compatible endpoint under **AI SEO Meta → Settings**.
4. Go to **AI SEO Meta → Settings** to customize prompts, language, and display options.

== Frequently Asked Questions ==

= Do I need an API key? =

Not in this plugin. AI suggestions use the WordPress 7.0 core AI Client, and the site administrator configures the AI provider and its API key once under **Settings → Connectors**. This plugin never asks for or stores a key.

= Does the plugin send data to your servers? =

No. The plugin has no servers in the loop. AI requests go through WordPress core to the provider the administrator configured. We never see your content or credentials.

= Does it work on WordPress older than 7.0? =

Yes. The unified meta editor works on WordPress 6.0+. For AI suggestions on WordPress 7.0+, configure a provider under Settings → Connectors (or a custom endpoint in the plugin settings). On WordPress older than 7.0, AI suggestions work only if you configure a custom OpenAI-compatible endpoint (URL + model + API key) in the plugin settings.

= Which SEO plugin do I need? =

The plugin works with Yoast SEO, Rank Math, All in One SEO, The SEO Framework, or SEOPress. If none are installed, it uses its own generic meta storage.

= Can I use it without AI? =

Yes. If no AI provider is configured (or you're on WordPress < 7.0 without a custom endpoint configured), the unified meta editor works independently of AI.

== Screenshots ==

1. Meta Manager — unified post list with SEO status badges, inline editing, and AI suggestions.
2. Settings — AI provider status, language, custom prompts, and display options.

== Changelog ==

= 1.2.0 =
* Test Connection now validates the custom endpoint you are configuring, not whichever site Connector is active.
* Test Connection uses the values currently entered in the form — no need to save first.
* The custom endpoint URL is now used exactly as entered (include the full path, e.g. https://your-host/v1/chat/completions); the plugin no longer appends a path.

= 1.1.0 =
* Add custom / local OpenAI-compatible AI endpoints (base URL + model + API key).
* On WordPress 7.0+, custom endpoints register into the core AI Client (no direct provider calls).
* On WordPress 6.0–6.x, a direct server-side fallback (BYOK) enables AI without the core AI Client.
* Lower "Requires at least" to WordPress 6.0.

= 1.0.0 =
* Initial release.
* Adapters: Yoast, Rank Math, AIOSEO, The SEO Framework, SEOPress.
* AI suggestions powered by the WordPress 7.0 core AI Client (no API keys handled by the plugin).
* Unified meta manager table with quality score and bulk generate.
* Language selection for AI-generated metadata (30 languages).
