=== Blirbit – AI Blog Writer & Autoblogger ===
Contributors: blirbit
Tags: autoblogger, ai blog writer, auto blogging, ai content, seo
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI blog writer and autoblogger that publishes daily articles to your site in your own voice. No passwords shared.

== Description ==

**Your blog, in your voice, without the hours.**

You know fresh articles get you found on Google and recommended by AI assistants like ChatGPT and Gemini. You also have a business to run. Writing takes hours, and handing it off usually comes back sounding like nobody in particular.

[Blirbit](https://www.blirbit.com/) learns how you talk in one short interview, then writes and publishes articles to your site on a schedule: your opinions, your phrasing, your expertise. Got something new to promote? Send Blirbit your own notes, a PDF or a YouTube link from your dashboard and it becomes your next article.

Think of it as an autoblogger that sounds like you, not like a robot: real articles with varied paragraphs, your opinions and your offers, a featured image, categories, tags and SEO fields filled in.

This plugin is the WordPress side of that connection. Install it, copy one token into your Blirbit dashboard, and you are connected. Just blirb-it.

= Why a token instead of passwords =

* **No passwords shared.** You never give Blirbit your login or an Application Password.
* **Revocable in one click.** Settings > Blirbit > Create a new token, and the old one stops working instantly.
* **Stored safely.** The token is shown once and only a SHA-256 hash is saved. Tokens are compared in constant time.
* **Limited by design.** Blirbit posts as a user you choose and can never do more than that user is allowed to. The token works only on the routes Blirbit needs (posts, media, categories, tags and the current-user check), never on the rest of your site.
* **Works on strict hosts.** The token travels in its own `X-Blirbit-Token` header, so hosts that hide Application Passwords or strip the Authorization header are not a problem.
* **SEO fields filled in.** SEO title, meta description and focus keyword go straight into Yoast SEO or Rank Math.

= How this plugin works with Blirbit (third-party service) =

This plugin only answers requests. It makes no outbound requests, sends nothing to Blirbit on its own and runs no scheduled jobs. When Blirbit connects with your token, it reads your categories and recent posts and creates the articles, images and SEO fields for your site. That exchange is covered by Blirbit's [Terms of Service](https://www.blirbit.com/terms) and [Privacy Policy](https://www.blirbit.com/privacy).

A Blirbit account is required. Without one, the plugin does nothing.

= For developers =

REST routes under `blirbit/v1`, available only to token-authenticated requests:

* `GET /ping`: connection check (publishing user, capabilities, detected SEO plugin, upload limit, timezone).
* `POST /seo`: `post_id`, `title`, `description`, `keyword`. Written to Yoast SEO or Rank Math, otherwise to `_blirbit_seo_title`, `_blirbit_seo_description` and `_blirbit_seo_keyword` post meta.

The token is also accepted on the core `wp/v2` routes for posts, media, categories, tags and `users/me`. Send it as `X-Blirbit-Token: blb_...` or `Authorization: Bearer blb_...`.

== Installation ==

1. Install from Plugins > Add New (search "Blirbit"), or upload the ZIP, then activate.
2. Open Settings > Blirbit. Your token is created the first time you open the page. Copy it straight away: it is shown only once.
3. Choose the user Blirbit should publish as and click Save.
4. Paste the token into your Blirbit dashboard at [blirbit.com/dashboard](https://www.blirbit.com/dashboard).

== Frequently Asked Questions ==

= Do I need a Blirbit account? =

Yes. The writing and scheduling happen in Blirbit. This plugin is only the secure connection.

= What user should articles be published as? =

Any user who can publish posts. An Editor is a good choice. An Author also works but cannot create new categories.

= I lost my token. =

It cannot be shown again because only a hash is stored. Click "Create a new token" and paste the new one into Blirbit.

= Can I edit or delete what Blirbit publishes? =

Yes. Every article is a normal WordPress post.

= What happens when I delete the plugin? =

The connection ends immediately and the plugin's settings are removed. Articles already published stay on your site.

== Screenshots ==

1. Settings > Blirbit: copy your one-time connection token, choose who articles are published as, and check the connection status.

== Changelog ==

= 1.0.1 =
* Settings page styles and script now load the WordPress way, and only on Settings > Blirbit.
* A new token is shown once in the same page load and never stored in plain text, not even temporarily.

= 1.0.0 =
* First release: token connection (hashed, revocable, route-limited), Publish as user, connection check and SEO fields for Yoast SEO and Rank Math.
