=== ClimbrIQ ===
Contributors: climbriq
Tags: seo, content, articles, publishing, automation
Requires at least: 6.0
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

Connects your site to ClimbrIQ so the SEO articles it writes for you are published here — as live posts or drafts.

== Description ==

[ClimbrIQ](https://climbriq.com) plans, writes and refreshes SEO articles for your business. This plugin is the WordPress end of that: it receives each finished article and publishes it on your site, so there is nothing to copy and paste.

**What it does**

* Publishes each article as a live post, or as a draft if you prefer to publish yourself.
* Sets the title, excerpt, featured image and slug, and fills in the SEO title and meta description for Yoast SEO, Rank Math or SEOPress when one of them is active.
* Updates the same post when ClimbrIQ refreshes an article — without changing whether it is published, and never touching a post you have moved to the bin.
* Shows recent activity under Settings → ClimbrIQ, so you can see what arrived and why anything failed.

**How it stays safe**

* ClimbrIQ can only reach this plugin's two endpoints, and every request must carry a valid signature from ClimbrIQ's private key. The plugin checks it with ClimbrIQ's public key, which is built into the plugin.
* Requests are tied to your connection and expire after five minutes, so they cannot be replayed or redirected to another site.
* The plugin can create and update only the posts it created itself. It cannot read, change or delete anything else on your site.
* Your connection token is never stored — only a fingerprint of it.

A ClimbrIQ account is required. Publishing to WordPress is part of the Autopilot plan.

== External services ==

This plugin connects your site to ClimbrIQ, an SEO content service run by Think Commerce Ltd (trading as ClimbrIQ).

* **What is received:** ClimbrIQ sends article content (title, body, excerpt, SEO title and description, slug and the address of a featured image) to this site's REST API when an article is published or refreshed, and a connection test when you click Test connection in ClimbrIQ.
* **What is sent back:** the ID, address and status of the post created or updated, and — for the connection test — the plugin and WordPress versions, the site name, the chosen author's display name, the publishing mode and which SEO plugin is active.
* **Featured images:** when an article has a featured image, this site downloads it from the address ClimbrIQ provides (ClimbrIQ's image storage).
* The plugin makes no other outgoing requests and sends no analytics.

ClimbrIQ [terms of service](https://climbriq.com/terms) and [privacy policy](https://climbriq.com/privacy).

== Installation ==

1. Install and activate the plugin (Plugins → Add New Plugin, search for "ClimbrIQ").
2. In your ClimbrIQ dashboard, open your brand, go to Integrations → WordPress and copy your connection token.
3. In WordPress, go to Settings → ClimbrIQ, paste the token, choose live posts or drafts, and click Save.
4. Back in ClimbrIQ, enter your site address and click Test connection.

== Frequently Asked Questions ==

= Do I need a ClimbrIQ account? =

Yes. The plugin only receives articles from ClimbrIQ; it does not write anything itself.

= Will articles go live without my approval? =

ClimbrIQ holds every article for 24 hours before sending it, and you can edit, hold or stop it in that time. If you would rather publish each one yourself, choose "Drafts" under Settings → ClimbrIQ.

= What happens if I edit a post in WordPress? =

Your edits stay until ClimbrIQ refreshes that article, when the refreshed version replaces the content. WordPress keeps the previous version in the post's revisions. The post's status and address never change.

= My site uses plain permalinks. Does it still work? =

Yes. ClimbrIQ falls back to the `?rest_route=` form of the REST API automatically.

= Connection test says something blocked the request =

A security plugin or firewall is blocking the WordPress REST API. Allow requests to `/wp-json/climbriq/` and test again.

= Does it work on multisite? =

Activate it on each site you want to connect; each site has its own token and settings.

== Changelog ==

= 1.0.0 =
* First release: signed publishing from ClimbrIQ, live posts or drafts, featured images, Yoast SEO / Rank Math / SEOPress titles and descriptions, activity log.

== Upgrade Notice ==

= 1.0.0 =
First release.
