=== GenerateBot ===
Contributors: generatebot
Tags: publishing, content, ai, blog, automation
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Publish articles directly from GenerateBot to your WordPress site with one click.

== Description ==

GenerateBot is a companion plugin that connects your WordPress site to the [GenerateBot](https://generatebot.com) content platform. Once connected, you can publish articles created in GenerateBot directly to WordPress without leaving the GenerateBot editor.

= Features =

* **Secure token-based authentication** - A unique integration token is generated on activation. All communication between GenerateBot and your site is authenticated.
* **Publish or draft** - Choose whether articles land as drafts for review or publish immediately. Set a site-wide default or override per article.
* **Featured images** - Automatically downloads and attaches featured images from external URLs.
* **Categories and tags** - Assign categories and tags during publishing. Missing categories are created automatically.
* **Author mapping** - Map articles to any WordPress user who can edit posts.
* **Health-check endpoint** - Verify the connection is working from your GenerateBot dashboard at any time.

= How it works =

1. Install and activate this plugin on your WordPress site.
2. Go to **Settings > GenerateBot** to find your Integration Token.
3. In your GenerateBot dashboard, go to **Integrations > Connect WordPress**.
4. Enter your WordPress site URL and paste the Integration Token.
5. Articles you publish from GenerateBot will appear in your WordPress Posts.

= REST API Endpoints =

The plugin registers four endpoints under the `generatebot/v1` namespace. All endpoints require a valid Bearer token in the Authorization header.

* `GET /wp-json/generatebot/v1/status` - Connection health-check
* `POST /wp-json/generatebot/v1/publish` - Create a post
* `GET /wp-json/generatebot/v1/authors` - List available authors
* `GET /wp-json/generatebot/v1/categories` - List categories

= Requirements =

* WordPress 5.8 or higher
* PHP 7.4 or higher
* A GenerateBot account ([sign up at generatebot.com](https://generatebot.com))

== Installation ==

= From the WordPress Plugin Directory =

1. Go to **Plugins > Add New** in your WordPress admin.
2. Search for "GenerateBot".
3. Click **Install Now**, then **Activate**.
4. Go to **Settings > GenerateBot** to view your Integration Token.

= Manual Installation =

1. Download the plugin zip file.
2. Go to **Plugins > Add New > Upload Plugin**.
3. Upload the zip file and click **Install Now**.
4. Activate the plugin.
5. Go to **Settings > GenerateBot** to view your Integration Token.

= Via FTP =

1. Extract the `generatebot` folder from the zip file.
2. Upload it to `/wp-content/plugins/` on your server.
3. Activate the plugin through the **Plugins** menu in WordPress.
4. Go to **Settings > GenerateBot** to view your Integration Token.

== Frequently Asked Questions ==

= How do I connect GenerateBot to my WordPress site? =

After activating the plugin, go to **Settings > GenerateBot**. Copy the Integration Token shown there and paste it into the GenerateBot Integrations page along with your site URL.

= Can I choose whether articles are published as drafts? =

Yes. You can set the default publish status in the plugin settings (draft or publish immediately), and you can also override it per article from the GenerateBot editor.

= Does the plugin support featured images? =

Yes. If you include a featured image URL when publishing from GenerateBot, the plugin will automatically download the image and set it as the post's featured image.

= What happens if a category does not exist? =

The plugin will create the category automatically when it receives an article with a category name that does not exist on your site.

= Is my data secure? =

All API communication is authenticated with a unique token generated per site. The plugin uses WordPress's built-in `hash_equals` for constant-time token comparison. We recommend using HTTPS on your WordPress site for encrypted communication.

= Can multiple GenerateBot accounts connect to the same site? =

Currently, the plugin supports a single integration token per site. All GenerateBot accounts that need to publish to the same site should share the same token.

= Where can I get support? =

Visit [generatebot.com/support](https://generatebot.com/support) or email support@generatebot.com.

== Screenshots ==

1. The GenerateBot settings page showing the Integration Token and publishing defaults.
2. Connecting your WordPress site from the GenerateBot dashboard.

== Changelog ==

= 1.0.0 =
* Initial release.
* REST API endpoints for publishing, status check, authors, and categories.
* Token-based authentication.
* Admin settings page with default author, category, and publish status.
* Automatic featured image import from external URLs.
* Auto-creation of missing categories.

== Upgrade Notice ==

= 1.0.0 =
Initial release of GenerateBot. Install to start publishing articles from GenerateBot to your WordPress site.
