=== Rank A Lot ===
Contributors: rankalot
Tags: seo, autopilot, blog, meta description, elementor
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connects your site to the Rank A Lot SEO autopilot: publishes blog posts and updates SEO titles and descriptions, with a backup and undo.

== Description ==

Rank A Lot is an SEO autopilot service (https://rankalot.pl/). It finds the questions your customers ask in Google, writes and publishes posts on your blog, improves page titles and descriptions and checks the results. This plugin is the WordPress connector of the service: it lets Rank A Lot make those changes on your site without FTP and without your admin password.

What the plugin does:

* publishes and updates blog posts as native Gutenberg blocks, with the featured image, category, language (Polylang) and SEO description;
* saves the SEO title and description of posts and pages in Yoast SEO, Rank Math, All in One SEO or SEOPress;
* changes text in pages built with Elementor (text only, never the layout or styles) and in classic pages;
* keeps a copy of the page or post before every change, so each change can be undone with one request;
* never overwrites content it did not create unless the service explicitly asks for it, and never takes a published page offline;
* serves the IndexNow key file and adds internal links between posts;
* checks the weight of images and can replace an image file with a smaller version prepared by the service (the original is kept and can be restored).

What the plugin does not do:

* it does not change your theme, layout, styles or other plugins;
* it does not read user accounts, e-mail addresses, passwords, comments or orders;
* it does nothing until you connect it with a one-time code, and every request must be signed.

The plugin is useful only together with a Rank A Lot account. It is translated into Polish (Polska wersja językowa: translate.wordpress.org).

== External services ==

This plugin connects your site to the Rank A Lot service (https://rankalot.pl/). It is needed for the plugin to work: all changes it makes are ordered by the Rank A Lot server.

When it connects: only after the site administrator creates a one-time connection code (Settings, Rank A Lot, "Create connection code") and gives it to Rank A Lot. From then on the Rank A Lot server sends requests to this site's REST API (/wp-json/rank-a-lot/v1/). Each request is signed with the site key (HMAC-SHA256), is valid for 5 minutes and cannot be replayed. The plugin does not contact any server on its own schedule and has no tracking, analytics or telemetry. "Disconnect site" in the settings removes the key and stops all access.

What data is sent to Rank A Lot, only as the answer to such a signed request:

* site name and the versions of WordPress, PHP, Elementor and this plugin, and which SEO plugin is active (connection and compatibility check);
* the list of pages (ID, title, slug, status, address, editor) and of published posts (ID, title, address, internal links), when the service prepares page changes or internal links;
* the list of images in the Media Library (address, file name, size, dimensions), when the service checks image weight;
* the result of each change (what was saved, warnings), and the current SEO title and description of a page it changes.

What the plugin receives from Rank A Lot: post content, SEO titles and descriptions, page text changes, images (inside the request, or as an image address that the plugin downloads into your Media Library with the standard WordPress function), smaller versions of existing image files (the original file is kept), and the IndexNow key, which the plugin serves as a text file at /KEY.txt so that search engines can verify the site. IndexNow notifications are sent by the Rank A Lot server, not by this plugin.

Rank A Lot terms of service: https://rankalot.pl/regulamin
Rank A Lot privacy policy: https://rankalot.pl/polityka-prywatnosci

== Installation ==

1. In WordPress go to Plugins, Add New, search for "Rank A Lot", then Install and Activate. You can also upload the ZIP file in Plugins, Add New, Upload Plugin.
2. Go to Settings, Rank A Lot and click "Create connection code".
3. Give the code to Rank A Lot. The code works once and expires after 30 minutes.
4. Open Settings, Rank A Lot again: the Connection field shows "Connected with site key".

Requirements: a Rank A Lot account, a site served over HTTPS, WordPress 5.8 or newer, PHP 7.4 or newer.

== Frequently Asked Questions ==

= Do I need a Rank A Lot account? =

Yes. The plugin only carries out changes ordered by the Rank A Lot service. Without an account it does nothing.

= Can it break my layout? =

No. It changes only the text of posts and pages and the SEO title and description. On Elementor pages it changes only the text inside widgets, never sections, columns, styles or templates. Before every change it saves a copy that can be restored.

= Which SEO plugins are supported? =

Yoast SEO, Rank Math, All in One SEO and SEOPress. With Rank Math, finish or skip its setup wizard first; until then Rank Math does not print any title or description.

= My site uses Cloudflare or a security plugin. =

The firewall must allow requests to /wp-json/rank-a-lot/v1/. Behind a proxy, tell the plugin which header carries the visitor address by adding define( 'RANK_A_LOT_IP_NAGLOWEK', 'HTTP_CF_CONNECTING_IP' ); to wp-config.php, so that the limit of failed attempts counts real addresses.

= I used the earlier connector distributed by Rank A Lot. =

Activate this plugin and deactivate the old one. The site key, settings and the marks on posts created by the service are copied automatically, and the old REST address keeps working, so the connection is not lost.

= How do I disconnect? =

Settings, Rank A Lot, "Disconnect site". You can also simply deactivate the plugin.

== Changelog ==

= 2.2.0 =
* First release on WordPress.org.
* Settings screen translatable (Polish translation available).
* Automatic copy of settings and post marks from the earlier connector, old REST address kept as an alias.

== Upgrade Notice ==

= 2.2.0 =
First WordPress.org release. Sites that used the earlier connector keep their connection.
