=== PlugPage SEO ===
Contributors: ahmadjadon
Donate link: https://plugnest.space/plugpage-seo/
Tags: seo, on-page seo, meta, rank math, yoast
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Auto-fills focus keywords, meta titles, descriptions, OG tags & image alts for Rank Math & Yoast. Push every page to 80+ SEO score in one click.

== Description ==

**PlugPage SEO** analyzes every published page, post, and WooCommerce product on your WordPress site and automatically fills all on-page SEO fields — pushing your content to an 80+ score in both Rank Math SEO and Yoast SEO with a single click.

No configuration required. No API keys. No external services. Just install, click Fix All, and watch your SEO scores climb.

= What It Fixes =

* **Focus Keyword** — Intelligently extracted from your post title and site name, then set in both Rank Math and Yoast
* **SEO Title** — Keyword-first title optimized to 60 characters max, written for both SEO plugins
* **Meta Description** — Keyword-rich description (120–155 chars) auto-generated from your content
* **Open Graph Tags** — OG title and description for Facebook, Twitter/X, and LinkedIn shares
* **Robot Directives** — index, follow set correctly on every page
* **Schema Markup** — Article, Product, or WebPage JSON-LD schema generated per content type
* **Image Alt Texts** — Every image missing an alt attribute is automatically filled

= How It Works =

1. Go to **On-Page SEO → Analyze & Fix All** in your WordPress admin
2. Click **Fix All Pages** to auto-fill SEO fields across your entire site at once
3. Or click the individual **Fix** button on any page for precise, one-at-a-time control
4. A live progress log shows each page being optimized in real time

= Dashboard =

The Dashboard gives you a complete site-wide SEO health view at a glance:

* Total content count (pages, posts, products)
* Optimized vs. missing keyword count
* Live progress ring showing your optimization percentage
* Quick-access Analyze & Fix All button

= Keyword Extraction Intelligence =

PlugPage SEO uses a five-strategy keyword extraction system tailored to your content type:

1. **Products** — up to 4 meaningful title words
2. **Long titles** — 3-word phrase from the title
3. **Short titles** — brand name combined with title words
4. **Single-word titles** — brand + slug word combination
5. **Utility pages** (About, Cart, Checkout) — brand + slug anchor

= Works With =

* **Rank Math SEO** (recommended) — fills `rank_math_focus_keyword`, `rank_math_title`, `rank_math_description`, and all OG/schema fields
* **Yoast SEO** — fills `_yoast_wpseo_focuskw`, `_yoast_wpseo_title`, `_yoast_wpseo_metadesc`, and all OG fields
* **WooCommerce** — products detected automatically with product-optimized keyword strategy
* Any WordPress theme

= No External Services =

This plugin works entirely within your WordPress installation. No data is sent to any external server. No account is required. No API keys. No tracking. No telemetry.

== Installation ==

= Automatic Installation =

1. Go to **Plugins → Add New** in your WordPress admin
2. Search for **PlugPage SEO**
3. Click **Install Now**, then **Activate**
4. Go to **On-Page SEO** in the admin menu and click **Analyze & Fix All**

= Manual Installation =

1. Download the plugin zip file
2. Go to **Plugins → Add New → Upload Plugin**
3. Upload the zip file and click **Install Now**
4. Activate the plugin
5. Install Rank Math SEO or Yoast SEO if you have not already done so
6. Go to **On-Page SEO → Analyze & Fix All** and click **Fix All Pages**

== Frequently Asked Questions ==

= Does this plugin work without Rank Math or Yoast? =

No. You need at least one SEO plugin installed and active — either Rank Math SEO or Yoast SEO. PlugPage SEO writes directly to their meta fields. Without one of these plugins, there are no fields to write to.

= Will it overwrite my existing SEO data? =

Yes — that is the point. When you click Fix on a page, the plugin overwrites the focus keyword, SEO title, meta description, and OG tags for that page. If you have carefully written manual SEO titles you want to keep, use the individual Fix buttons instead of Fix All.

= Does it support WooCommerce products? =

Yes. Products are detected automatically and the keyword extraction uses a product-optimised strategy (up to 4 title words) to create the most relevant focus keyword.

= Does this plugin slow down my website? =

No. The plugin loads nothing on the front end for visitors. It runs entirely inside the WordPress admin area. There is zero performance impact on your site's page speed or Core Web Vitals.

= Does it send any data to external servers? =

No. All processing happens locally inside your WordPress database. No data is sent anywhere, ever. See the Privacy Policy section below.

= Can I fix one page at a time instead of the whole site? =

Yes. The Analyze & Fix All page shows every page, post, and product in a table. Each row has an individual Fix button so you can optimize pages one by one.

= What SEO score will my pages reach? =

Most pages reach 80–100 after fixing. The exact score depends on your content length and how well your post title aligns with the generated keyword. Pages with very short content or no descriptive title may score lower.

= Does it work with multisite? =

It has not been tested with WordPress Multisite. Use at your own risk on multisite installations.

== Screenshots ==

1. Dashboard — site SEO health ring, content stats, and a summary of what the plugin fixes
2. Analyze & Fix All — full content table with SEO scores, keywords, and per-page Fix buttons with live progress log
3. Plugins Needed — recommended free plugins to maximize your SEO results alongside PlugPage SEO

== Changelog ==

= 1.0.0 =
* Initial release
* Auto-fill focus keyword, SEO title, meta description, OG tags, robots directives, schema markup, and image alt texts
* Dashboard with site SEO health progress ring and full content statistics
* Analyze & Fix All page with batch processing and live real-time progress log
* Individual Fix button per post/page/product for precise control
* Full Rank Math SEO support (focus keyword, title, description, OG, schema)
* Full Yoast SEO support (focus keyword, title, description, OG tags)
* WooCommerce product detection and product-optimised keyword strategy
* Five-strategy keyword extraction engine
* Plugins Needed page with recommended free SEO and performance plugins

== Upgrade Notice ==

= 1.0.0 =
Initial release. No upgrade steps required.

== Privacy Policy ==

PlugPage SEO does not collect, store, or transmit any personal data. It does not use cookies, make any external HTTP requests, or send any information to the plugin author or any third party. All processing is performed locally within your WordPress installation and your own database.
