=== rankd — Content Quality Scorer ===
Contributors: voiddo
Tags: seo, readability, writing, content, editor
Requires at least: 6.0
Tested up to: 6.9
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Score any post's quality 0-100 before you publish. Connects to your rankd account and uses your rankd verdict quota.

== Description ==

**rankd** scores the post you are writing on a 0-100 quality scale, in the editor sidebar. Six axes — readability, structure, length, links, images, title — plus actionable suggestions on what to fix before you hit publish.

The plugin connects to your rankd account. Each WordPress verdict uses the same rankd quota as the web product: free accounts get 2 verdicts per day; Pro gets 500 verdicts per month.

= What it does =

* **Editor sidebar verdict** — opens as a meta box on every post and page edit screen
* **Six axes scored 0-100** — readability, structure, length, links, images, title
* **Actionable suggestions** — short, specific, ranked by impact
* **Quota-aware** — runs only when you click, so typing does not burn verdicts
* **Works in Gutenberg and Classic Editor** — auto-detects which one you are using

= External service and pricing =

This plugin sends the post title, post content, and site URL to `https://rankd.voiddo.com/api/wp/content-score` when you click **run rankd verdict**. It does not send content while you type. It does not write post meta, publish content, or alter your post.

A rankd account and WordPress API token are required. Free rankd accounts include 2 verdicts per day. rankd Pro includes 500 verdicts per month and is available at $4.99/month or $49.99/year. Pricing and quota may be changed on the rankd pricing page, and the active quota returned by rankd is shown after each verdict.

Service pages:

* Pricing: https://rankd.voiddo.com/pricing
* Privacy: https://rankd.voiddo.com/privacy
* Terms: https://rankd.voiddo.com/terms
* Support: support@voiddo.com

= Why a sidebar scorer =

Existing SEO plugins focus on keyword targeting and serialize their advice across multiple panels. rankd answers a different question: "is this post structurally good before I worry about keywords?" — readability, sectioning, link density, image alt text, title length. The basics that lift any post regardless of niche.

= Six axes scored =

* **Readability** — sentence length and word complexity (lower is easier)
* **Structure** — H2/H3 distribution and section count
* **Length** — sweet-spot around 800-2000 words; penalty at the extremes
* **Links** — outbound + internal density (1 per ~250 words is healthy)
* **Images** — at least one image with alt text on posts over ~200 words
* **Title** — 30-65 characters is the SEO sweet spot

The composite is a weighted average; each axis is exposed individually so you can see what is dragging.

= How it differs from generic readability tools =

* Lives where you write — the WordPress editor sidebar — not a separate site
* Uses the same rankd quota and upgrade path as the main product
* Runs on explicit click only — no quota burn while typing
* Keeps the verdict separate from publishing — you decide what to change

== Installation ==

1. Upload the `rankd-content-quality-scorer` folder to `/wp-content/plugins/`, or install via Plugins → Add New → Upload Plugin
2. Activate the plugin through the **Plugins** menu
3. Create a rankd account at https://rankd.voiddo.com/
4. Open https://rankd.voiddo.com/me and create a WordPress token
5. In WordPress, go to **Settings → rankd** and paste the token
6. Edit any post or page — the **rankd — content quality score** meta box appears in the sidebar

== Frequently Asked Questions ==

= Does this plugin send any data to a server? =

Only when you click **run rankd verdict**. The plugin sends the current post title, content, and site URL to rankd, receives the score, and displays it in the editor. It does not send data while you type.

= Does it work with Gutenberg and Classic Editor? =

Yes — both. The plugin auto-detects the active editor and reads the post content from whichever is in use.

= Does it work for custom post types? =

Yes. The meta box registers on every public post type, so it appears for posts, pages, products, custom CPTs registered with `public => true`.

= How is the score computed? =

A weighted average across six axes (readability, structure, length, links, images, title). The verdict is computed by rankd and returned with the active account quota snapshot.

= Is the scoring opinionated about SEO? =

The structural axes (length, headings, alt text, link density, title length) follow general SEO best practice that holds across most niches. The plugin does NOT do keyword density or competitor analysis — that is intentionally out of scope. rankd answers "is this structurally good?" — your existing SEO plugin still does keyword work.

= Will future versions add cloud features? =

The plugin is already a rankd-connected service client. Any additional remote feature will remain explicit and quota-aware.

= Multisite support? =

Yes. Network-activate or per-site activate — behavior is identical.

= Is it open source? =

Yes — GPL-2.0-or-later, like every plugin on this directory.

= How do I report a bug? =

Email support@voiddo.com or open an issue on our public tracker.

== Screenshots ==

1. Publish-ready post (composite 87) — six axis breakdown with actionable suggestions
2. Fair-tier post (composite 48) — five ranked, specific fixes appear in the suggestions panel

== Changelog ==

= 1.0.0 — 2026-04-30 =
* Initial release
* Sidebar scoring on every post and page edit screen
* Six axes — readability, structure, length, links, images, title
* Actionable, ranked suggestions
* Gutenberg + Classic Editor support
* rankd account token support
* Free 2/day and Pro 500/month quota enforcement
* Localizable — Text Domain `rankd-content-quality-scorer`

== Upgrade Notice ==

= 1.0.0 =
First release. No upgrade path needed.

== About ==

Built by vøiddo — a small studio shipping AI-flavoured products, free dev tools, Chrome extensions and weird browser games.
