=== RankPush Connector ===
Contributors: hosepeeg
Tags: seo, content, automation, publishing, ai
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.2.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Publish AI-generated, SEO-optimized articles from RankPush to your WordPress site — SEO fields and featured images included.

== Description ==

RankPush Connector is the official first-party plugin for [RankPush](https://rankpush.ai). RankPush researches keywords, writes a month of articles, and — with this plugin installed — publishes them straight to WordPress on autopilot.

The plugin exposes a small, authenticated REST namespace (`rankpush/v1`) that only your RankPush account can call, using a single site-generated API key. It does what the standard WordPress REST API can't:

* Writes the **focus keyword, SEO title, and meta description** to your SEO plugin (Rank Math, Yoast, or All in One SEO) so every article ships fully optimized.
* Side-loads the **featured image** into your media library.
* Keeps posts it created **in sync** on later edits, and never touches posts it didn't create.

**Fully automated.** Articles publish live as RankPush writes them — no copy-paste, no extra clicks. Prefer editorial review? Switch to **drafts-only mode** on the plugin's settings page and every article will wait in your admin for approval instead.

This is a clean-room GPLv2 implementation. It makes no outbound calls on its own; it only responds to authenticated requests from RankPush.

== Installation ==

1. In your WordPress admin, go to **Plugins → Add New** and search for **"RankPush Connector"**.
2. Click **Install Now**, then **Activate**.
3. Go to **Settings → RankPush**. Copy the generated **API Key** (starts with `rpush_`).
4. In RankPush, open **Settings → Integrations → WordPress**, paste your site URL and the API key, and click **Connect WordPress**.
5. (Optional) Prefer to review each article first? Untick **"Allow RankPush to publish posts live"** on the Settings → RankPush page to receive drafts instead.

== Frequently Asked Questions ==

= Do I need an SEO plugin? =
No, but it's recommended. If Rank Math, Yoast, or All in One SEO is active, the plugin fills their focus-keyword / SEO-title / meta-description fields automatically.

= Will it publish articles live automatically? =
Yes — that's the point. Articles go live as RankPush writes them. If you'd rather review first, switch to drafts-only mode on the Settings → RankPush page.

= Is my API key safe? =
The key is stored in your own database and required (in constant-time comparison) on every request. You can regenerate it at any time from Settings → RankPush, which instantly revokes the old one.

= What data leaves my site? =
None. The plugin never initiates outbound connections; it only receives article content from RankPush over authenticated requests you control.

== Changelog ==

= 0.2.4 =
* Listing metadata cleanup and plugin URI update. No functional changes.

= 0.2.3 =
* Directory review housekeeping. No functional changes.

= 0.2.2 =
* Listing metadata updates (author, description). No functional changes.

= 0.2.1 =
* Corrected plugin header (Contributors, Plugin URI, Author URI).

= 0.2.0 =
* Live publishing is now the default (drafts-only remains available as an opt-in on the settings page).

= 0.1.0 =
* Initial release: authenticated `rankpush/v1` REST namespace, SEO-plugin field writing (Rank Math / Yoast / AIOSEO), featured-image side-loading, and edit-sync for plugin-created posts.

== Upgrade Notice ==

= 0.2.0 =
New installs publish live by default. Existing installs keep whatever publishing mode they had configured.
