=== ThumbAPI — Auto Featured Images ===
Contributors: thumbapi
Tags: featured image, og image, open graph, blog cover, thumbnail
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Generate featured images from any post title with one click. Powered by the ThumbAPI service.

== Description ==

ThumbAPI for WordPress turns your post title into a production-ready featured image with a single click. No template design, no image editing, no extra steps in your publishing flow.

The plugin adds a panel to the post editor (both the block editor and the classic editor). When you click **Generate featured image**, the current post title is sent to your ThumbAPI account, the returned image is uploaded to the Media Library, and it is set as the post's featured image automatically.

= Features =

* One-click featured image generation from the post title
* Block editor sidebar panel and classic editor meta-box integration
* Five output formats: Blog post (1200×630), YouTube (1280×720), Instagram (1080×1080), X (1200×675), LinkedIn (1200×627)
* Three image styles: faceless, with personal photo, with logo
* Generated images go through the standard WordPress Media Library — full thumbnail sizes are generated automatically
* No bundled scripts or styles loaded outside the post editor and the plugin's own settings page

= What you need =

* A ThumbAPI account and an API key from [app.thumbapi.dev](https://app.thumbapi.dev)
* For "With image" or "With logo" styles, upload your personal photo or logo once in your ThumbAPI dashboard

= External services =

This plugin sends data to **ThumbAPI** (`https://api.thumbapi.dev`), which is a paid third-party service operated by ThumbAPI. When you click **Generate featured image**, the plugin sends the post title, your selected format, and your selected image style to the ThumbAPI `POST /v1/generate` endpoint, authenticated with the API key you saved in the plugin settings. ThumbAPI returns a generated image which the plugin then stores in your WordPress Media Library.

* Service: ThumbAPI
* Endpoint: `https://api.thumbapi.dev/v1/generate`
* Data sent: post title, output format, image style, your API key (as `x-api-key` header)
* Terms of service: [https://thumbapi.dev/terms-of-service](https://thumbapi.dev/terms-of-service)
* Privacy policy: [https://thumbapi.dev/privacy-policy](https://thumbapi.dev/privacy-policy)

The plugin does not contact any other external services.

== Installation ==

1. Upload the `thumbapi` folder to `/wp-content/plugins/` or install the plugin from the WordPress plugin directory.
2. Activate the plugin from the **Plugins** screen.
3. Go to **Settings → ThumbAPI** and paste your API key from [app.thumbapi.dev](https://app.thumbapi.dev).
4. Open any post, give it a title, then click **Generate featured image** in the ThumbAPI panel.

== Frequently Asked Questions ==

= Do I need a paid ThumbAPI plan? =
You need a ThumbAPI account and an API key. Pricing is set by ThumbAPI; see [thumbapi.dev](https://thumbapi.dev) for current plans.

= What happens to the generated image? =
It is stored in your Media Library exactly like any other upload. You can edit, replace, or delete it like any other attachment.

= Does it overwrite an existing featured image? =
Yes — clicking the button always sets the new generated image as the featured image. Your previous featured image stays in the Media Library and can be reassigned.

= Can I use my own saved photo or logo? =
Yes. Upload your personal photo or logo once in the ThumbAPI dashboard, then pick the matching style ("With image" or "With logo") in the plugin panel.

= Does the plugin support the classic editor? =
Yes. A small panel is added below the standard Featured Image meta box.

== Screenshots ==

1. ThumbAPI panel in the block editor sidebar.
2. Settings screen for API key and defaults.
3. Generated featured image in the post editor.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
First public release.
