=== RefreshRank - Content Decay Detection & AI Refresh ===
Contributors: sheetlink
Tags: seo, content decay, search console, ai, content refresh
Requires at least: 6.5
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Find the posts losing search traffic with your Search Console data, then refresh them with AI - you review every change as a diff first.

== Description ==

Most blogs lose traffic the same way: not from a penalty, but from slow decay. Posts that ranked well in their first year drift down as competitors publish fresher content. RefreshRank finds those posts before the traffic is gone and helps you bring them back.

**How it works**

1. Click "Start free" - no signup form, no email required.
2. Connect Google Search Console (one click, standard Google consent screen).
3. RefreshRank analyzes 16 months of your search data and ranks every post by decay: how much traffic it is losing, and how much it could win back.
4. (Paid plans) Click Rewrite on a decaying post. The AI proposes a refreshed title, meta description, answer-first intro, an FAQ section, and date updates. You see every change side by side - current vs proposed - and nothing touches your post until you approve it.
5. Approved changes are applied as a normal WordPress revision, so you can always roll back.

**Free plan**

* Decay detection for one site
* Full ranked decay queue with scores, trends, and suggested actions
* Daily automatic sync with Search Console

**Paid plans**

* AI rewrites (titles, metas, intros, FAQs, date updates) with human approval on every change
* Monthly rewrite quotas by tier
* Multiple sites on one license
* White-label reports (top tier)

**What makes it different**

* **You approve everything.** RefreshRank never auto-publishes. Every AI proposal is a diff you accept or reject, and accepted changes are saved as revisions.
* **Self-hosted AI, flat pricing.** Rewrites run on RefreshRank's own inference servers - no per-token API bills, no OpenAI key to bring.
* **Built on your real data.** Decay scores come from your own Search Console clicks, impressions, and positions - not third-party estimates.

== External services ==

This plugin talks to the RefreshRank API (https://api.refreshrank.com), operated by the plugin author. It is required for the plugin to function - the decay analysis and AI rewriting happen there, not on your server.

What is sent, and when:

* **Account signup / license activation**: your site URL, when you click "Start free" or activate a license key.
* **Search Console connection**: handled entirely between Google and the RefreshRank server via OAuth. Google tokens are stored on the RefreshRank server and never on your WordPress site.
* **Decay queue**: your license key, when the plugin fetches your ranked queue.
* **AI rewrite requests** (paid plans): the title, meta description, and post content (up to 30KB) of the specific post you ask to rewrite, plus its top search queries. Content is processed on RefreshRank's own AI servers and is not shared with third-party AI providers.

Terms of service: https://refreshrank.com/terms - Privacy policy: https://refreshrank.com/privacy

== Frequently Asked Questions ==

= Is the free plan really free? =

Yes. Decay detection for one site is free forever - no trial, no card. Paid plans add AI rewrites, more sites, and white-label reports.

= Will the AI change my posts without asking? =

No, and it can't. Every proposed change is shown to you as a current-vs-proposed diff, and only applied after you click Approve. Applied changes are saved as standard WordPress revisions, so you can roll any of them back from the post editor.

= Do I need an OpenAI or other AI API key? =

No. Rewrites run on RefreshRank's own servers. Pricing is flat per plan - there are no per-token charges and no keys to manage.

= What data do you collect from Search Console? =

Per-page clicks, impressions, click-through rate, and average position, in 28-day windows over the last 16 months. That is what powers the decay score. The connection is read-only.

= Why don't I see any decaying posts? =

Three common reasons: Search Console is not connected yet (Step 2 in Settings), the first sync has not run yet (Step 3), or your content is genuinely holding its rankings - in which case, nothing to fix.

= Does it work with my SEO plugin? =

Yes. Meta description updates are written to Yoast SEO and Rank Math fields when those plugins are active, and always to RefreshRank's own field as a fallback.

== Screenshots ==

1. The decay queue: every post ranked by traffic decay and win-back potential.
2. Settings: three-step onboarding - account, Search Console, first sync.
3. The review modal: every AI proposal shown as current vs proposed before you approve.
4. An applied rewrite saved as a normal WordPress revision.

== Changelog ==

= 0.1.0 =
* Initial release: decay detection via Google Search Console, ranked decay queue, AI rewrites (title, meta, intro, FAQ, date updates) with diff approval, revision-safe apply, free plan with one-click signup, AppSumo code redemption.

== Upgrade Notice ==

= 0.1.0 =
Initial release.
