=== Write Auto ===
Contributors: writeauto
Tags: seo, content, publishing, blog, automation
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.6.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Publishes Write Auto articles to your site with SEO title, description, focus keyword and schema set in Yoast SEO, Rank Math or AIOSEO.

== Description ==

This plugin receives articles from your Write Auto account and publishes them as posts. When Yoast SEO, Rank Math or All in One SEO is installed, it also fills in the post's SEO title, meta description, focus keyword (plus related keywords where your SEO plugin supports them), primary category and cornerstone/pillar flag, and adds the article's FAQ to your SEO plugin's schema.

**Narrow by design**

* Only ever changes posts it created. It cannot edit any other post; of other posts it reads only the titles and links of published ones (to suggest internal links).
* Cannot delete anything, manage users, plugins or themes, or change settings. The only files it adds are the images of the articles it publishes, attached to those posts.
* Will not overwrite a post you have edited in WordPress, and never restores a post you trashed.
* Every request is signed with a key only your site and your Write Auto account know; the key itself is never sent over the network.
* Disconnect at any time from WP Admin → Write Auto.
* Every action is listed under WP Admin → Write Auto → Activity.

== External services ==

This plugin connects to Write Auto (https://writeauto.com), the service you use to write and schedule articles.

* When you connect, you copy a connection key from this site into your Write Auto account. From then on, Write Auto sends signed requests to this site to publish posts, read your category list, and read the titles and links of published posts (for internal linking).
* In replies, this site sends Write Auto its address, language, timezone, WordPress/PHP/plugin versions, active SEO plugin, category list, published post titles and links, and the ID/status/link of each post it creates.
* When a post Write Auto created goes live later (you publish a draft, or a scheduled post's time comes), this site tells Write Auto that post's ID, address and publish time, in a request signed with your connection key, so Write Auto can share it (for example on your Facebook Page). Nothing is sent for any other post.
* When you add, rename or delete a category, this site tells Write Auto a minute later, in a request signed with your connection key, so Write Auto can read your category list again (its news automations publish to categories you choose). The notice says only that the categories changed; nothing about the categories themselves is sent with it.
* When you click "Let Write Auto manage this post" on the Posts screen, this site sends Write Auto that post's address, title and content, in a request signed with your connection key. Nothing is sent unless you click it.
* To check for plugin updates, this site requests https://app.writeauto.com/api/wp-plugin/manifest a few times a day. Like every request WordPress makes, it includes this site's address (in the user agent); nothing else about the site is sent.

This plugin also uses IndexNow (https://www.indexnow.org), which Bing and other search engines use to find new pages quickly. When Write Auto publishes or updates a live post, this site sends the post's address, the site's address and a key to https://api.indexnow.org/indexnow. Nothing about visitors or users is sent. It's skipped when another plugin already sends these, and you can turn it off under WP Admin → Write Auto → Settings. IndexNow's terms: https://www.indexnow.org/terms — Privacy policy: https://privacy.microsoft.com/privacystatement

Terms of service: https://writeauto.com/terms — Privacy policy: https://writeauto.com/privacy

== Installation ==

1. Upload and activate the plugin.
2. Go to WP Admin → Write Auto, choose which user posts are published as, and click Create connection key.
3. Copy the connection key and paste it into Write Auto under your brand's Web Connections. The Write Auto page shows when it has connected.

== Frequently Asked Questions ==

= My site is behind Cloudflare or a proxy and requests are refused as "insecure" =

Your site may report that requests aren't HTTPS even though visitors use HTTPS. Write Auto never sends to a non-HTTPS address, so you can safely add `add_filter( 'write_auto_require_ssl', '__return_false' );` to a small must-use plugin.

= A security plugin blocks the connection =

Some security plugins block REST API requests from visitors who aren't logged in. Allow the `write-auto/v1` namespace in that plugin's settings.

= Why doesn't my SEO plugin show a score for new posts? =

Yoast SEO and Rank Math calculate their scores in the post editor. The focus keyword, title and description are already set; the score appears the first time the post is opened in the editor.

== Changelog ==

= 1.6.0 =
* Hand one of your own published posts to Write Auto with "Let Write Auto manage this post" on the Posts screen, so it can be improved at the same address. Undoing a change puts back the post's own SEO title and description. Nothing changes unless you click it.
* New and updated posts from Write Auto are sent to IndexNow, so Bing and other search engines find them quickly. You can turn this off in Settings.

= 1.5.0 =
* When you add, rename or delete a category, Write Auto is told, so news automations publishing to your categories follow the change straight away instead of at their daily check.

= 1.4.0 =
* A clearer Write Auto page, with Overview, Activity, Settings and About & privacy tabs. The Overview walks you through connecting, shows which Write Auto the site is connected to and when it was last in touch, and checks everything publishing depends on. Settings holds the post author, the connection key and automatic updates.
* The Activity tab explains each result in plain words, says what to do about a problem, and can show just the problems.
* Posts from Write Auto are labelled on the Posts screen, with their own "Write Auto" view, and a post edited in WordPress (which Write Auto then won't overwrite) says so.

= 1.3.0 =
* When you publish a draft Write Auto sent, or a scheduled post goes live, Write Auto is told straight away, so it can share the post (for example on your Facebook Page) with its live link.
* News articles from Write Auto are marked up as NewsArticle in your SEO plugin's schema, arrive with their topic tags, and can show a byline (for example "Staff Reporter") as their author.

= 1.2.0 =
* Keep Write Auto up to date: the Connect screen offers automatic updates (on by default, your choice), and connected sites get a one-click "Turn on automatic updates" button.

= 1.1.0 =
* Articles arrive with their images: the cover is set as the featured image and the in-article image is placed in its section, both in the Media Library with alt text. Publishing again reuses them instead of uploading twice.
* Rank Math's table-of-contents check now recognises the table of contents in posts Write Auto created.

= 1.0.0 =
* Initial release.
