=== TopRanker AI - SEO Optimizer ===
Contributors: toprankerai
Tags: seo, ai, openai, meta tags, optimization
Requires at least: 6.0
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered SEO optimization for your existing content. Generate meta titles, descriptions, keyphrases, and social meta using OpenAI.

== Description ==

TopRanker AI is a powerful WordPress plugin that uses OpenAI to optimize your existing posts, pages, and custom post types for search engines. Unlike content generators, TopRanker AI focuses on what you have already written and makes it SEO-ready with just one click.

**Stop guessing what makes good SEO. Let AI analyze your content and generate optimized:**

* **Meta Titles** - Get 3 compelling, click-worthy title suggestions under 60 characters
* **Meta Descriptions** - Generate 3 engaging descriptions with calls-to-action under 155 characters
* **Focus Keyphrases** - AI identifies the primary keyphrase plus 3 secondary keyphrases from your content
* **Excerpts** - Create engaging summaries that capture your key message
* **Open Graph Tags** - Optimize how your content appears when shared on Facebook and social media
* **Twitter Card Tags** - Perfect your content appearance for Twitter/X shares

**Key Features:**

* Works with Posts, Pages, and any Custom Post Type including WooCommerce Products
* Compatible with both Classic Editor and Gutenberg block editor
* SEO Coverage Dashboard shows which posts are missing optimization across your entire site
* SERP Preview lets you see exactly how your post will appear in Google search results
* Works alongside Yoast SEO, RankMath, and SEOPress - detect and sync or operate standalone
* Clean, modern interface that follows WordPress design standards
* 25 free optimizations per month to get you started

**Pro Features (Upgrade Available):**

* Unlimited optimizations
* Bulk optimize multiple posts at once
* Auto-generate image alt tags using AI vision
* Internal linking suggestions based on your existing content
* Schema markup generation (Article, FAQ, HowTo, Product, LocalBusiness)
* SEO score and audit checklist for each post
* WooCommerce product optimization with purchase-intent meta
* Auto-optimize on publish via background processing
* Optimization history with ability to revert to earlier versions
* Multi-language support for international sites
* Priority support

**Requirements:**

* An OpenAI API key (get one at platform.openai.com)
* WordPress 6.0 or higher
* PHP 7.4 or higher

**Privacy:**

TopRanker AI sends your post content to OpenAI's API for analysis. No data is stored on our servers. Please review OpenAI's privacy policy for information about how they handle data.

== Installation ==

1. Upload the `topranker-ai` folder to the `/wp-content/plugins/` directory, or install directly through the WordPress plugins screen.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Go to TopRanker AI > Settings and enter your OpenAI API key.
4. Click "Test Connection" to verify your API key works.
5. Start optimizing! Edit any post or page and look for the TopRanker AI panel.

**Getting an OpenAI API Key:**

1. Visit https://platform.openai.com and create an account or sign in.
2. Navigate to API Keys in your account settings.
3. Create a new secret key and copy it.
4. Paste the key in TopRanker AI settings.

== Frequently Asked Questions ==

= Do I need an OpenAI API key? =

Yes, TopRanker AI requires an OpenAI API key to function. You can get one at platform.openai.com. The plugin uses your own API key, so you have full control over usage and costs.

= How much does the OpenAI API cost? =

With the default model (gpt-4.1-nano), each text optimization costs approximately $0.01-0.03. Image analysis for alt tags costs slightly more per image. You can monitor your usage in your OpenAI dashboard.

= Does this work with Yoast/RankMath? =

Yes! TopRanker AI automatically detects if you have Yoast SEO, RankMath, or SEOPress installed. You can choose to: (1) Let TopRanker output meta tags independently, (2) Use suggest-only mode and copy suggestions to your SEO plugin, or (3) Sync mode that writes directly to your SEO plugin's fields.

= Is my content sent to a third party? =

Yes, your post content is sent to OpenAI's API for analysis. This is required for the AI to generate relevant SEO suggestions. No data is stored on our servers - the content goes directly from your site to OpenAI and back. Please review OpenAI's privacy policy for their data handling practices.

= What's the difference between free and Pro? =

The free version includes 25 optimizations per month for individual posts, including meta title, description, excerpt, keyphrases, and social meta generation. Pro unlocks unlimited optimizations, bulk processing, image alt tags, internal linking, schema markup, SEO audits, WooCommerce optimization, and more.

= Does this write content for me? =

No, TopRanker AI is not a content writer. It optimizes content you have already written. You write the post, then TopRanker AI analyzes it and generates SEO metadata like titles, descriptions, and keyphrases based on your existing content.

= Which OpenAI models are supported? =

TopRanker AI supports gpt-4.1-nano (default, fastest and cheapest), gpt-4.1-mini, and gpt-4.1. All models support vision for image alt tag generation. You can change the model in Settings.

== Screenshots ==

1. The Gutenberg sidebar panel showing optimization results with meta title and description suggestions.
2. Settings page with API key configuration, model selection, and usage tracking.
3. SEO Coverage Dashboard showing site-wide optimization status with percentage bars.
4. Classic Editor metabox with SERP preview showing how your post will appear in Google.
5. Bulk optimization page (Pro) for processing multiple posts at once.
6. Post list with SEO status column showing optimization status at a glance.

== Changelog ==

= 1.0.0 =
* Initial release
* Meta title and description generation with 3 suggestions each
* Excerpt generation from content
* Focus keyphrase detection (primary + 3 secondary)
* Open Graph and Twitter Card meta generation
* SERP preview in both editors
* SEO Coverage Dashboard with stats
* Classic Editor and Gutenberg support
* Yoast, RankMath, SEOPress compatibility
* Usage limits (25/month free)
* Pro: Bulk optimization
* Pro: Image alt tag generation with AI vision
* Pro: Internal linking suggestions
* Pro: Schema markup (Article, FAQ, HowTo, Product)
* Pro: SEO audit and scoring
* Pro: WooCommerce product optimization
* Pro: Auto-optimize on publish
* Pro: Optimization history with revert
* Pro: Multi-language support

== Upgrade Notice ==

= 1.0.0 =
Initial release of TopRanker AI. Requires OpenAI API key to function.
