=== RankParse SEO ===
Contributors: rankparse, abhibavishi
Tags: seo, backlinks, domain authority, dashboard, embed
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.3.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

SEO health score, domain authority, backlink reports, and a hosted backlink widget for WordPress.

== Description ==

RankParse is an SEO data API (backlinks, domain authority, tech stack, and more) built on Common Crawl data.

This plugin connects your RankParse API key and adds four things to wp-admin:

* **SEO Health dashboard widget** — health score, domain authority, and referring domain count for this site, right on the main WordPress dashboard.
* **RankParse Report page** — a full backlink health report (risk flags, link quality breakdown, anchor text profile, top and risky backlinks, outbound link summary), refreshable on demand.
* **RankParse -> Customize** — preview and configure the hosted widget with accent/background colors, brand name, and height, then copy its shortcode. The admin preview is rendered locally; the hosted widget is loaded only where the shortcode or block is placed.
* **`[rankparse_score]` shortcode and block** — embeds RankParse's hosted backlink-report widget (a domain + email lead-capture form that emails visitors a PDF SEO report) anywhere on your site. The block editor shows a local preview; the hosted widget loads on the published page.

The dashboard widget and report page require a free RankParse API key (get one at [rankparse.com](https://rankparse.com)). The shortcode/block work without a key and carry a "Powered by RankParse" attribution. For agency white-labeling, add a separate public embed key under Settings; only use a key intended for public embeds because it is visible to visitors in the iframe URL.

= Usage =

Connect your API key under RankParse -> Settings, then check RankParse -> Report for the full backlink health report.

Shortcode:

`[rankparse_score]`

Optional attributes: `domain`, `color`, `bg`, `name`, `api_key`, `height`.

Or use the "RankParse Backlink Report" block from the block inserter.

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/rankparse-widget`, or install via the Plugins screen.
2. Activate the plugin.
3. Visit RankParse -> Settings and add your private RankParse API key (get a free one at [rankparse.com](https://rankparse.com)), plus an optional public embed key, domain override, accent color, and background color.
4. Check the RankParse dashboard widget or RankParse -> Report for this site's SEO health.
5. Add `[rankparse_score]` to any post or page, or insert the RankParse block, to embed the free report widget for visitors.

== Screenshots ==

1. RankParse -> Settings: connect an API key, and set a default domain, accent color, and background color.
2. The dashboard widget: health score, domain authority, and referring domains at a glance.
3. RankParse -> Report: full backlink health report with risk flags, link quality, and anchor profile.
4. The `[rankparse_score]` shortcode/block embedded on a page, with the site's own domain pre-filled.

== External services ==

This plugin embeds RankParse's hosted backlink-report widget from [rankparse.com](https://rankparse.com). When a visitor submits the embedded form, the visitor's domain and email address are sent to RankParse so it can generate and deliver the requested PDF report. The dashboard and Report page send the configured site's domain to [api.rankparse.com](https://api.rankparse.com) using the private API key configured in Settings.

An optional public embed key may be sent to the hosted widget to enable agency white-labeling. Any key in a public iframe URL is visible to visitors; use an agency key intended for embeds, not a private admin credential. See RankParse's [privacy policy](https://rankparse.com/privacy) and [terms of service](https://rankparse.com/terms).

== Changelog ==

= 0.3.2 =
* Replaced the external wp-admin Customize preview with a local preview.
* Made expired report refresh leases replaceable without a delete-then-add race.

= 0.3.1 =
* Added a separate public embed key setting so private dashboard credentials are not exposed in visitor-visible iframe URLs by default.
* Isolated dashboard/report caches by domain and API account, and made report refresh locking atomic.
* Added a clipboard fallback and completed the external-service disclosure.

= 0.3.0 =
* Added RankParse -> Customize: a live preview of the real embed widget with a color-picker, brand name, and height controls, ending in a copy-paste shortcode.
* Block editor color control upgraded to a real color-swatch panel.

= 0.2.0 =
* Added the SEO Health dashboard widget (`/v1/tools/domain-authority`).
* Added the full RankParse Report page (`/v1/link-audit`), with a cooldown-limited manual refresh.
* Restructured the admin menu under a top-level "RankParse" item (Report, Settings).
* Relabeled the API key field — it powers the dashboard widget and report.

= 0.1.0 =
* Initial release: shortcode + block embed of the hosted backlink-report widget.
