=== Get RankBloom ===
Contributors: lumorabuild
Tags: seo, content, publishing, automation, blog
Requires at least: 5.6
Tested up to: 7.0
Requires PHP: 7.4
Text domain: get-rankbloom
Stable tag: 1.3.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

The official RankBloom plugin. Publishes SEO content from your RankBloom workspace straight into this site.

== Description ==

RankBloom generates SEO blog content for the sites you connect to it. This plugin brings that
content into your WordPress site — title, body, excerpt, categories, tags, meta description,
schema markup, featured image, and the audio version when you have narration enabled.

The plugin checks RankBloom on a schedule and imports whatever is waiting. Nothing needs to
reach your server from the outside: every request is made **outbound** by your site. That means
it works behind firewalls, on managed hosts, and on setups where the REST API or the
Authorization header is blocked.

= How it works =

1. Open RankBloom in your WordPress menu and click Connect.
2. Sign in to RankBloom — or create an account — and approve the connection.
3. You land back in WordPress, connected. Nothing to copy or paste.
4. New posts appear automatically.

If the site you are connecting from is not in your RankBloom workspace yet, the connect screen
offers to add it for you and starts analysing it, so you do not have to set it up separately.

Posts are matched by their RankBloom ID, so a post is never imported twice — even if a check is
interrupted and retried.

= Official plugin =

This is the **official** RankBloom plugin. RankBloom (getrankbloom.com) is a service built and
operated by Lumora (lumorabuild.com), the author of this plugin — it is not a third-party
integration with somebody else's product.

= External service =

The plugin is a client for the RankBloom service. The plugin itself is free; a RankBloom account
is required for it to do anything, because the content it imports is generated and stored on the
service.

The plugin communicates only with `https://app.getrankbloom.com`, and only once you have connected
your site. It sends:

* your connection token, to authenticate the request;
* the result of each import (success or failure, the resulting post URL and ID), so RankBloom
  knows the post is live and stops offering it again;
* during the one-time connect step only: the address of this site, so RankBloom can match it to
  your workspace (and offer to add it if it is new).

It receives the posts your own workspace generated. No visitor data, no personal data, and no
site content other than the import results listed above is ever transmitted.

* Service: https://www.getrankbloom.com/
* Terms of Service: https://www.getrankbloom.com/terms
* Privacy Policy: https://www.getrankbloom.com/privacy

== Installation ==

1. Upload the `get-rankbloom` folder to `/wp-content/plugins/`, or install the ZIP through
   Plugins → Add New → Upload Plugin.
2. Activate the plugin.
3. Open **RankBloom** in your admin menu and click **Connect to RankBloom**.
4. Sign in (or sign up), pick the site, approve — you are returned here connected.

== Frequently Asked Questions ==

= Do I need a RankBloom account? =

Yes. The plugin imports content generated by the RankBloom service; without an account there is
nothing to import.

= Will it import my whole archive when I connect? =

No. A new connection only receives posts created after it was made, so connecting a site with
hundreds of existing posts will not flood your blog. If you do want the older content, use the
"Import older posts" button.

= Can it publish without me reviewing first? =

Only if you choose that. The default is to import everything as a draft.

= Will it create duplicates? =

No. Every imported post records its RankBloom ID, and that ID is checked before anything is
created. A retried or interrupted sync will skip posts that already exist — including ones you
have moved to the trash.

= What happens if I deactivate it? =

Nothing is deleted. Your imported posts, media and settings stay exactly as they are. Uninstalling
removes the plugin's own settings but never touches your posts.

= Does it work if my host blocks the REST API? =

Yes. The plugin never accepts inbound requests. It only makes outbound calls to RankBloom, so a
blocked REST API, a firewall, or a stripped Authorization header does not affect it.

= Do I have to paste an API key? =

No. You click Connect, sign in to RankBloom, and approve. The credential is exchanged behind the
scenes and never shown to you or placed in a URL.

== Screenshots ==

1. Overview — connection status, how many posts have been imported, and when the next check runs.
2. Connecting — one button; you approve on RankBloom and come straight back.
3. Imported posts — everything pulled in, with quick links to edit or view.
4. Settings — draft or publish, category, author, images and how often to check.

== Changelog ==

= 1.3.1 =
* Changed: documentation now states clearly that this is the official plugin for RankBloom, a
  service operated by the plugin author, rather than a third-party integration.

= 1.3.0 =
* Added: narrated posts now show a "Listen to this article" player, with AudioObject structured
  data so search engines know the article has a spoken version. Can be turned off in Settings.

= 1.2.0 =
* Changed: the plugin is now named "Get RankBloom", matching the getrankbloom.com service it
  connects to. The text domain moved to `get-rankbloom` to match the new slug.

= 1.1.2 =
* Fixed: normalised line endings across all plugin files.

= 1.1.1 =
* Changed: each admin action now verifies its security nonce inline, so the check is visible to
  automated review tooling as well as to a human reader.
* Changed: declared compatibility with WordPress 7.0.

= 1.1.0 =
* Added: "More from Lumora" tab listing the other Lumora Build products.
* Added: the connect screen now recognises the site you are connecting from, and offers to add it
  to your workspace (and start analysing it) if it is not there yet.
* Added: a welcome panel and direct links into your workspace after connecting.
* Fixed: the connect link carried HTML-encoded ampersands, so the security check on the way back
  never matched and the connection could not complete.
* Fixed: the per-site author byline was missing from imported posts.

= 1.0.0 =
* First release: one-click connect (no API keys), scheduled import of RankBloom posts, featured
  image sideloading, categories and tags, meta description (including Yoast and Rank Math), schema
  markup, audio narration URL, duplicate-safe imports, and manual sync.

== Upgrade Notice ==

= 1.2.0 =
Renamed to "Get RankBloom" to match the service. No action needed; your connection is preserved.

= 1.1.0 =
Fixes a bug that prevented connecting. Update if you could not complete the connect step.

= 1.0.0 =
First release.
