=== Corantr Media Desk ===
Contributors: hyncaconsulting
Tags: news, articles, editorial, drafts, content
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 8.1
Stable tag: 1.5.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Approved articles from Corantr Media Desk arrive on your site as drafts. Nothing is published until you press Publish.

== Description ==

[Corantr Media Desk](https://corantr.com) finds the news that matters to your readers, writes it from the sources' own facts in your site's voice, checks every claim, and waits for a person to approve each piece. This plugin connects your WordPress site to your Desk account:

* **Approved pieces arrive as drafts**, every 15 minutes or when you press "Check now": the article, its header image, tags, SEO title and description (for Yoast, Rank Math, SEOPress and others), in the category and under the author you choose.
* **Nothing is published by itself.** A person presses Publish in WordPress. The plugin tells the Desk who published the piece, and when.
* **Your Desk stays up to date with your site.** Weekly, the plugin sends the list of your published pages (so articles link to the right ones) and samples of your own writing (so they sound like you). You choose which content types it reads. It reads them from your database, so bot protection in front of your site doesn't get in the way.
* **Updates of published articles.** When one of your articles isn't doing well in Google, the Desk can rewrite it from its own facts. Once approved there, the rewrite arrives as a draft linked to the article; press "Apply update" and the live post gets the new text at the same address, with its image and comments kept and the old text under Revisions.
* **Know when the Desk needs you.** Ideas to review and pieces to approve are shown on your Dashboard, on the Posts screen and in the toolbar, with a link straight to them on the Desk.
* **Structured data** (NewsArticle or Article) on published pieces, which you can switch off if your SEO plugin adds it already.

There are no AI keys or AI calls on your site: the Desk does the writing. You need a Corantr Media Desk account (with a free trial).

== External services ==

This plugin talks to one service: **Corantr Media Desk** (https://corantr.com), run by Hynca Consulting Ltd. Terms: https://corantr.com/terms. Privacy: https://corantr.com/privacy.

Only once you connect the site with an API key from your Desk account:

* every 15 minutes it asks the Desk for approved pieces, downloads them and their images, and tells the Desk where it saved each draft;
* when a person publishes one of those pieces, it sends the Desk the published text, its address, who published it and when;
* when one of those pieces is later edited after publishing, unpublished, moved to the bin, restored or deleted, it tells the Desk what happened, who did it and when (with the text as it now stands, for an edit);
* weekly (and when you press "Sync pages now") it sends the titles and addresses of your published pages and posts, samples of your site's published writing, your post categories (names, slugs and descriptions), and the number of approved comments on posts that came from the Desk;
* when you turn "Write automatically for this site" on or off, it tells the Desk;
* when you apply an update of a published article, it tells the Desk the post's address, who applied it and when, with the new text.

At each check the Desk also answers with how many ideas and pieces are waiting for your team there, which the plugin shows to people who can publish.

Nothing is sent before you connect, and you can disconnect at any time.

== Installation ==

1. Install and activate the plugin.
2. On your Desk, open **Sites**, choose this site and press **Connect to WordPress**. Copy the key.
3. In WordPress, open **Corantr Media Desk**, paste the key and press **Connect**.
4. Under **Publishing**, choose the category and author for drafts.

== Frequently Asked Questions ==

= Will anything be published without me? =
No. Pieces are approved by a person on the Desk, arrive here as drafts, and stay drafts until someone presses Publish.

= Do I need an AI key? =
No. The Desk does the writing; this plugin makes no AI calls.

= Can I pause it? =
Yes. Turn off "Write automatically for this site" on the Corantr Media Desk screen. The Desk stops writing new pieces for the site; pieces already approved still arrive.

== Screenshots ==

1. The Corantr Media Desk screen: the connection and automatic writing, with their traffic lights, and the pieces that have arrived.

== Changelog ==

= 1.5.0 =
* Automatic updates: new versions come straight from Corantr Media Desk, and WordPress's auto-updates are switched on for this plugin (you can switch them off on the Plugins screen).
* The Corantr logo on the plugin's screen.

= 1.4.0 =
* Hynca Media Desk is now Corantr Media Desk, at corantr.com. The plugin talks to the Desk there; your connection, settings and drafts stay as they are.

= 1.3.0 =
* Updates of published articles: a rewrite approved on the Desk arrives as a draft linked to the article, and "Apply update" puts it into the live post (same address, image and comments; the old text stays under Revisions). The draft can't be published as a second post.
* What's waiting on the Desk (ideas to review, pieces to approve) is shown on the Dashboard, the Posts screen and in the toolbar, with links straight to it. The notice can be hidden until something new arrives.

= 1.2.0 =
* The Desk now hears what happens to its pieces after they arrive: a draft deleted without being published (the Desk takes that into account when choosing stories), a published post edited, unpublished or deleted, and a post restored from the bin.
* The weekly page sync also sends the number of approved comments on posts from the Desk.
* Your site's page on the Desk shows the last 90 days: drafts sent, published, deleted and still waiting, and how long publishing takes.

= 1.1.0 =
* Categories: the plugin sends your post categories to the Desk with the weekly page sync, the Desk suggests one for each piece (you can change it there), and the draft is filed in it. If there isn't one, your default category is used. The plugin never creates categories.

= 1.0.0 =
* First release in the WordPress.org directory, as Corantr Media Desk.
* Approved pieces from the Desk arrive as drafts, with their header image, tags and SEO fields, every 15 minutes or on "Check now".
* "Write automatically for this site": pause or resume new articles for the site on the Desk.
* Traffic lights for the connection and for automatic writing.
* Publishing a Desk piece tells the Desk who published it, when and where.
* Weekly, the site's pages and samples of its own writing are sent to the Desk.
* "What the Desk reads": choose which content types (pages, posts, products, any public type) the Desk may link to, and which it learns your voice from.

== Upgrade Notice ==

= 1.5.0 =
After this, the plugin keeps itself up to date.

= 1.4.0 =
The Desk's new name and address: Corantr Media Desk, corantr.com. Nothing to set up again.

= 1.3.0 =
Apply the Desk's updates of your published articles in one click, and see on your Dashboard when ideas or pieces are waiting for you.

= 1.2.0 =
The Desk learns from drafts you delete and sees which published pieces get comments. Nothing changes in how drafts arrive.

= 1.1.0 =
Drafts are filed in the category the Desk suggests. Press "Sync pages now" after updating to send your categories straight away.

= 1.0.0 =
First directory release.
