=== DidYouSEO — SEO Audit & Score Tracker ===
Contributors: sathish27
Tags: seo, seo audit, site audit, seo score, technical seo
Requires at least: 6.2
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

See DidYouSEO audit scores in your Posts list and editor, audit pages when you publish, and get an alert when a score drops.

== Description ==

DidYouSEO checks pages for 40+ technical and on-page SEO issues: titles, meta descriptions, headings, canonical tags, structured data, Open Graph tags, broken links and more. This plugin brings those scores into WordPress, so you see problems where you write.

**What it adds**

* An **SEO Score column** in your Posts and Pages lists, colour-coded at a glance, with an "Audit now" link for anything not yet checked.
* A **block editor sidebar** showing the current page's score, with a button to re-audit it.
* A **dashboard widget** with your site's overall score and its count of critical issues and warnings.
* **Audit on publish** (optional): new posts and pages are audited in the background when first published.
* **Score-drop alerts** (optional): an admin notice when a page scores lower than its previous audit.

**What it does not do**

The plugin doesn't change your content, your theme or your other SEO plugins' settings. It shows scores; you decide what to fix. It works alongside Yoast SEO, Rank Math and similar plugins.

**You need a DidYouSEO account**

A free account at [didyouseo.com](https://didyouseo.com) is enough to start. The free plan allows 20 API requests a day; each audit and each dashboard score refresh counts as one. Paid plans raise that limit.

== External services ==

This plugin connects to the DidYouSEO API (https://didyouseo.com/api/v1), a service run by DidYouSEO, to audit your pages and fetch scores. Nothing is sent until you connect an API key in Settings → DidYouSEO.

* **When you connect:** your API key is checked, and your site's address and name are registered with your DidYouSEO account.
* **When a page is audited** (you click "Audit now" or "Audit this page", or "Audit on publish" is on): the page's public URL and this site's webhook address are sent. DidYouSEO then fetches the public page, as a search engine would, and sends the result back to the webhook address. Post content is never sent from your site.
* **When the dashboard widget loads:** your site's score is requested, at most once an hour.

The service's [Terms of Service](https://didyouseo.com/terms) and [Privacy Policy](https://didyouseo.com/privacy) apply.

== Installation ==

1. Install the plugin from **Plugins → Add New**, or upload the `didyouseo` folder to `/wp-content/plugins/`.
2. Activate it.
3. Create a free account at [didyouseo.com](https://didyouseo.com), then create an API key under [Settings → API Keys](https://didyouseo.com/dashboard/settings?tab=api-keys).
4. In WordPress, go to **Settings → DidYouSEO**, paste the key, and click **Connect**.

== Frequently Asked Questions ==

= Do I need a DidYouSEO account? =

Yes. A free account is enough to get started.

= Does auditing use up my plan? =

Each audit is one API request. The free plan allows 20 requests a day, and the dashboard widget caches its score for an hour so it doesn't use them up.

= Where is my API key stored? =

In your WordPress database (the `wp_options` table), like other plugins' API keys. It is never shown in the settings page after saving, and **Disconnect** deletes it.

= How do scores get back into WordPress? =

When an audit finishes, DidYouSEO sends the result to `/wp-json/didyouseo/v1/webhook` on your site. Each delivery is signed with a secret unique to your API key, and the plugin rejects anything without a valid signature.

= Can I test on a local site? =

Yes. DidYouSEO needs to reach your pages, so expose your local site with a tunnel (for example ngrok) and enter its address under **Public URL (local development only)**.

= What happens when I delete the plugin? =

Its settings, stored scores and scheduled tasks are removed. Your DidYouSEO account and its data are not affected.

== Screenshots ==

1. SEO scores in the Posts list.
2. The DidYouSEO sidebar in the block editor.
3. The site score dashboard widget.
4. Settings → DidYouSEO.

== Changelog ==

= 1.0.0 =
* First release.
