=== ORIOZ SEO AI ===
Contributors: oriozstudio
Tags: seo, ai, content generation, openrouter, content writer
Requires at least: 5.9
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Generate SEO-optimized posts via OpenRouter. Access hundreds of AI models with live pricing. Free, unlimited post generation.

== Description ==

**ORIOZ SEO AI** lets you generate fully SEO-optimized WordPress posts using any AI model available on OpenRouter — directly from your dashboard.

Full documentation: [https://oriozstudio.com/docs/orioz-seo-ai/](https://oriozstudio.com/docs/orioz-seo-ai/)

Add post titles to the queue, choose your AI model, hit Generate, and get a complete draft post ready to review and publish.

**Free plan includes:**

* Unlimited post generation
* OpenRouter support — access hundreds of AI models from one API key
* Dynamic model list with live pricing per 1M tokens
* Live API credit / balance display
* Cost estimation per post and for your full queue

**Pro — 1 site (upgrade at oriozstudio.com):**

* AI image generation — auto-generated featured image for every post
* Model fallback chains — automatic retry on next model if primary fails
* Yoast SEO, Rank Math, and AIOSEO meta field auto-fill
* AI alt text — SEO-optimized alt text on every image, automatically
* Custom content and meta description prompts

**Business — up to 3 sites (upgrade at oriozstudio.com):**

* Everything in Pro
* License covers up to 3 WordPress sites
* Post scheduling via WP-Cron
* Bulk generation with concurrency control
* AI title idea generator
* Keyword Planner — import a CSV of keywords, AI analyzes intent and priority

= Third-Party Services =

This plugin connects to OpenRouter to generate post content and fetch available models. By using this plugin you agree to its terms of service:

**OpenRouter** (required)
Used to fetch the list of available AI models and to send your post title to the model you selected in order to generate content. Your site's home URL is sent as an HTTP Referer header alongside your API key as required by the OpenRouter API. Data is only sent when you click "Load / Refresh Models" or "Generate" for a specific post.
* Service: [https://openrouter.ai](https://openrouter.ai)
* Terms of Service: [https://openrouter.ai/terms](https://openrouter.ai/terms)
* Privacy Policy: [https://openrouter.ai/privacy](https://openrouter.ai/privacy)

== Installation ==

1. Upload the `orioz-seo-ai` folder to the `/wp-content/plugins/` directory, or install directly through the WordPress plugin screen.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Go to **ORIOZ SEO AI > Settings** in your admin menu.
4. Enter your OpenRouter API key and click **Load / Refresh Models**.
5. Select a model and save settings.
6. Go to **Add Post Titles**, enter one post title per line, and click **Add to Queue**.
7. Switch to the **Post Queue** tab and click **Generate** next to any title.

== Frequently Asked Questions ==

= Is an API key required? =

Yes. You need an [OpenRouter API key](https://openrouter.ai/keys). The plugin does not include any built-in API credits.

= Are there any generation limits? =

No. The free plan allows unlimited post generation. You are only limited by your OpenRouter account balance.

= Which AI models are supported? =

Any text model available on OpenRouter — hundreds of models including GPT-4o, Claude, Gemini, Mistral, LLaMA, and many more.

= Is my API key stored securely? =

Your API key is stored in the WordPress options table using `update_option()`. It is never transmitted anywhere other than the official OpenRouter API endpoint when you trigger a generation or refresh the model list.

== Screenshots ==

1. Post queue with single-post generation and status badges
2. Add Post Titles — enter one title per line to add to the queue
3. Settings — API key and model selection
4. Credits & Cost — live balance and per-post cost estimation
5. Upgrade — Pro and Business plan features overview

== Upgrade Notice ==

= 1.0.0 =
Initial release — no upgrade steps required.

== Changelog ==

= 1.0.0 =
* Initial release.
* Unlimited post generation via OpenRouter.
* Dynamic model list with live pricing per 1M tokens.
* Live API balance display and per-post cost estimation.
