=== BoostSEO ===
Contributors: boostmedia
Tags: seo, ai, meta, internal-links, schema
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

One-button AI SEO for WordPress. Scans every page, scores it 0-100, fixes meta titles and descriptions, adds internal links, and emits schema.

== Description ==

BoostSEO is a one-button AI SEO manager for WordPress. No SEO expertise required — the plugin learns what your site is about, scans every page, scores it, and proposes minimal, high-impact improvements. Nothing changes on your live site until you review and approve it, and every change can be undone.

The scan, the 0-100 SEO scoring, the page-builder detection, and the schema output all run locally on your own server and do not cost anything. The AI writing (calibration, keyword extraction, and meta-field suggestions) is powered by the BoostMedia SEO backend, a paid service metered in BoostCoins — see the External services section below.

Core features:

* **Site calibration** — The plugin reads your homepage and main navigation so it understands your business before it suggests anything. This shapes every keyword and meta suggestion that follows.
* **Full-site scan and SEO scoring** — Inventories every public post and page, then scores each one 0-100 with a plain-language list of what is missing or weak (titles, descriptions, headings, image alt text, internal links).
* **"Sticky" meta titles and descriptions** — Generates SEO titles and meta descriptions and writes them into the correct meta keys for whichever SEO plugin you already run, so they survive theme and editor changes. If no SEO plugin is active, BoostSEO outputs the tags itself.
* **E-E-A-T JSON-LD schema** — Emits a connected structured-data graph via wp_head — Organization, Person (the post author), WebSite (with site search), and BreadcrumbList, plus Article on posts and Product on WooCommerce products. Post content is never touched.
* **Semantic internal links** — Builds a keyword and embedding map of your content and suggests relevant internal links between related posts. Inserted links use a `[boostseo-link]` shortcode so they can be removed cleanly. Page-builder content is automatically skipped — Elementor, Divi, Beaver Builder, WPBakery, Oxygen, Bricks, and Brizy layouts are detected and left untouched to avoid breaking your design.
* **Review before apply, with per-change undo** — Every suggestion is stored as a proposed change. You review, approve, or reject each one, and you can undo any applied change individually or roll back in bulk. The original value is always saved first.
* **Plays well with your existing SEO plugin** — BoostSEO auto-detects Yoast SEO, Rank Math, All in One SEO, and SEOPress and writes into their fields instead of competing with them. If one of these is the active meta provider, BoostSEO defers to it and stays out of the page head.

BoostSEO also detects Elementor, Gutenberg, ACF, JetEngine, Toolset, WooCommerce, Polylang, and WPML so it behaves correctly on real-world sites.

== External services ==

BoostSEO uses the BoostMedia SEO backend (https://boostseo.boostmedia.co.il) to run the AI parts of the workflow and to manage BoostCoin credits. The local features — scanning, 0-100 scoring, page-builder detection, and schema output — work without any backend call and without credits. The AI writing is the paid service. No visitor personal data is sent.

What is sent, when, and why:

* **Site registration** — on first connection, the plugin sends the site URL to the backend to obtain a unique site_id and API key. These credentials are stored encrypted in wp_options.
* **Install report / heartbeat** — shortly after activation, and at most once per day when an administrator loads the WordPress admin, the plugin sends the site URL and plugin version to the backend so the operator can see which sites have the plugin installed and which version they run. No visitor or personal data is included.
* **AI analysis** — when you calibrate or generate suggestions, post titles, excerpts, and navigation menu metadata are sent to the backend, which forwards them to Google's Gemini API to derive site identity, extract keywords, and generate SEO meta-field suggestions.
* **BoostCoins credits** — the plugin displays your credit balance by fetching it from the backend. Every AI operation meters token usage to the backend for billing.
* **Payments** — the WordPress.org build of this plugin does NOT process payments in-app. Users who want more BoostCoins are directed to boostmedia.co.il.

External services referenced:

* BoostMedia SEO backend — Terms: https://boostseo.boostmedia.co.il/terms-of-service — Privacy: https://boostseo.boostmedia.co.il/privacy-policy
* Google Gemini (called by our backend, not directly by the plugin) — Terms: https://policies.google.com/terms — Privacy: https://policies.google.com/privacy

Requests are made when the site administrator triggers a scan, generates suggestions, re-calibrates the site, opens the Billing page, or applies SEO changes, plus a lightweight install report just after activation and a once-per-day heartbeat (site URL + plugin version) on admin load. The plugin never sends visitor data and never contacts the backend from a front-end (visitor) request.

== Installation ==

1. Upload the `boostseo` folder to `/wp-content/plugins/`.
2. Activate the plugin in the WordPress Plugins screen.
3. Open BoostSEO in the admin sidebar and hit "Improve My SEO".

== Frequently Asked Questions ==

= Do I need the paid AI service to use BoostSEO? =
No. The full-site scan, the 0-100 SEO scoring, page-builder detection, and the JSON-LD schema all run locally and are free. The AI writing — calibration, keyword extraction, and meta-field suggestions — is the paid service, metered in BoostCoins.

= Does BoostSEO work alongside Yoast / Rank Math / All in One SEO / SEOPress? =
Yes. The plugin detects which SEO plugin is active and writes suggestions into its meta keys, so you keep your existing setup. If one of these is your active meta provider, BoostSEO defers to it for the page head.

= Will it break my Elementor / Divi / page-builder layouts? =
No. BoostSEO detects Elementor, Divi, Beaver Builder, WPBakery, Oxygen, Bricks, and Brizy content and skips it when inserting internal links, so your builder layouts are never modified.

= Can I undo a change? =
Yes. The original value of every field is stored before modification, and the admin UI lets you undo per-change or roll back in bulk.

== Screenshots ==

1. Dashboard — one-click "Improve My SEO".
2. Scan Results — every post with its 0-100 score and issues.
3. Internal Links — the keyword-driven link graph.
4. Proposed Changes — review, approve, reject per change.
5. Billing — BoostCoin balance and usage history.
6. Settings — configure scan scope, SEO plugin preference, language.

== Changelog ==

= 1.0.0 =
* First public release.
* Site calibration that reads your homepage and navigation to understand your business.
* Full-site scan with 0-100 SEO scoring and a plain-language issue list per post.
* "Sticky" SEO titles and meta descriptions written into the active SEO plugin's meta keys (Yoast, Rank Math, All in One SEO, SEOPress), or output directly when none is active.
* E-E-A-T JSON-LD schema: Organization, Person (author), WebSite, BreadcrumbList, plus Article and Product, cross-referenced by @id.
* Semantic internal link suggestions with automatic page-builder skip (Elementor, Divi, Beaver Builder, WPBakery, Oxygen, Bricks, Brizy).
* Review-before-apply workflow with per-change undo and bulk rollback.
* Automatic detection of and deferral to existing SEO plugins.

== Upgrade Notice ==

= 1.0.0 =
First public release of BoostSEO: site calibration, full-site scan with 0-100 scoring, sticky meta fields, E-E-A-T schema, and semantic internal links — all review-first and reversible.

== Development ==

BoostSEO is built with WordPress, React, and Vite.

To build the admin UI:

1. `cd admin`
2. `npm install`
3. `npm run build` — outputs to `assets/dist/admin/`

The compiled `assets/dist/admin/` folder is committed so the plugin is runnable straight out of the ZIP. Source lives in `admin/src/` and is excluded from the WordPress.org build.

To build the release ZIP:

1. `python scripts/build_release_zip.py --target wordpress-org`
2. or `--target live` for the self-hosted variant.
