=== SerenityMind AI SEO ===
Contributors: idanp1
Tags: seo, meta, woocommerce, google search console, ai
Requires at least: 6.2
Tested up to: 6.9.4
Stable tag: 0.2.175
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-powered SEO titles and meta descriptions for WordPress and WooCommerce, with GSC insights and a safe review-before-publish workflow.

== Description ==

SerenityMind AI SEO connects your WordPress site to an AI backend to generate optimized SEO titles and meta descriptions for your posts, pages, products, and categories — then lets you review, approve, or reject every suggestion before anything goes live.

**Key Features**

* **AI-generated SEO fields** — Automatically generate SEO titles and meta descriptions for posts, pages, WooCommerce products, and categories.
* **Review & Approve workflow** — Every AI suggestion lands in an approval queue. Nothing is written to your site until you explicitly approve it.
* **Google Search Console integration** — Connect your GSC property to see live impressions, clicks, CTR, and average position directly in your WordPress dashboard.
* **Priority Generate** — Surfaces your highest-opportunity pages (ranked by GSC data) so you generate SEO for what matters most first. Scores are normalized to 0–100 with color indicators (green/yellow/red).
* **Safe writeback** — Approved fields are written directly to post meta and term meta, compatible with standard SEO plugins.
* **WooCommerce ready** — Full support for products and product categories, including rich category descriptions.
* **Clean admin UI** — Minimal, distraction-free interface built into the WordPress admin. No front-end changes until you approve.

**How It Works**

1. Install and activate the plugin.
2. Enter your API URL and operator key in the plugin settings.
3. Optionally connect your Google Search Console property.
4. Go to Priority Generate or Backlog to trigger AI generation for your pages.
5. Review suggestions in the Approvals queue.
6. Approve — and the SEO fields go live instantly.

**External Services**

This plugin connects to an external API (your configured backend URL) to generate SEO suggestions. Data sent includes page URLs, titles, and existing content. No data is sent without your explicit configuration and action. Please review your backend provider's privacy policy.

== Installation ==

1. Upload the `serenitymind-ai-seo` folder to the `/wp-content/plugins/` directory, or install via the WordPress plugin screen.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Go to **SerenityMind AI SEO → Settings** and enter your Backend URL and Operator Key.
4. Optionally connect your Google Search Console property.
5. Navigate to **Priority Generate** or **Backlog** to start generating SEO suggestions.

== Frequently Asked Questions ==

= Do I need a license key? =

Yes. An active license (operator key) is required to generate AI suggestions. You can obtain one at personalaiseo.com.

= Will this interfere with Yoast SEO or RankMath? =

SerenityMind AI SEO writes to its own meta keys. If you use another SEO plugin, ensure there is no conflict in how meta tags are output. The plugin outputs standard `<title>` and `<meta name="description">` tags only when no other plugin is handling them.

= Does it work with WooCommerce? =

Yes. Products and product categories are fully supported, including bulk generation.

= Is anything published automatically? =

No. Every AI suggestion must be explicitly approved in the Approvals queue before it is written to your site.

= What data is sent to the external API? =

Page URLs, page titles, and existing content are sent to your configured backend for AI processing. No personal visitor data is transmitted.

== Screenshots ==

1. Approvals queue — review AI-generated SerenityMind AI SEO suggestions before publishing.
2. Priority Generate — pages ranked by Google Search Console opportunity score.
3. Settings page — connect your backend and Google Search Console property.
4. GSC stats panel — live impressions, clicks, CTR, and position in your dashboard.

== Changelog ==

= 0.2.175 =
* Plugin renamed to SerenityMind AI SEO.
* Approve All Drafts UX: button now shows count of drafts in current set; helper text clarifies multi-step approval for large batches.
* All inline JavaScript moved to wp_add_inline_script() — no raw script tags.
* Short description corrected to meet WordPress.org length requirements.

= 0.2.172 =
* Fix: completed-state progress card preserved real metrics after page reload.
* Fix: suppressed per-chunk last_message text while a job is still running.

= 0.2.148 =
* Priority Generate scores now displayed as X/100 with green/yellow/red color coding.
* GSC stats panel added to settings page (impressions, clicks, CTR, position, pages tracked).
* Stability improvements.

= 0.2.0 =
* Google Search Console integration.
* Priority Generate page with opportunity scoring.
* WooCommerce product and category support.

= 0.1.0 =
* Initial release.
* AI-generated SEO titles and meta descriptions.
* Review and Approve workflow.

== Upgrade Notice ==

= 0.2.175 =
Plugin renamed to SerenityMind AI SEO with improved bulk approval UX.
