=== Alt Goblin ===
Contributors: jimlaroche
Tags: accessibility, images, alt text, ai, SEO
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically generate alt text for WordPress media images using AI. Install it, activate it, and let Alt Goblin handle the rest.

== Description ==

Alt Goblin is the “set it and forget it” way to keep your WordPress images accessible and SEO-friendly.

Once activated, it fits right into your existing workflow: no complicated setup, no new screens to learn. Just upload images like you normally would, and let Alt Goblin generate clear, descriptive alt text for you.

Each generation uses 1 credit and 1 credit = 1 alt text. Free monthly credits are included, and additional credit packs are available if you need them.

Install it. Activate it. Let it work in the background.

== Features ==

* **True plug-and-play setup:** Activate and start generating immediately
* **Works where you already work:** Built directly into the WordPress Media workflow
* **Auto-generate on upload:** Fill alt text automatically as images are added
* **Bulk generation:** Quickly process all images with missing alt text
* **Keyword guidance (optional):** Add context when needed
* **Simple credit dashboard:** See free, paid, and total credits at a glance

== Installation ==

1. Upload the `alt-goblin` folder to `/wp-content/plugins/`, or install through the WordPress plugin installer.
2. Activate the plugin in **Plugins > Installed Plugins**.
3. Go to **Settings > Alt Goblin**.
4. (Optional) Add your Alt Goblin API key to unlock paid credits.

== Frequently Asked Questions ==

= Do I need an API key? =

No. Alt Goblin works out of the box using the free monthly plan. Add an API key only if you purchase paid credits.

= How many free credits are included? =

The free plan currently provides 25 credits per month. Resets on the first of every month.

= What images are processed in bulk mode? =

Bulk mode only processes images that are missing alt text. Images that already have alt text are skipped and no credits are used.

= Does this overwrite existing alt text? =

Single-image generation replaces the current value for that image. Bulk mode is designed to process only images without alt text.

= Is this compatible with classic and block editor workflows? =

Yes. Alt Goblin works inside WordPress admin media contexts and is independent of your theme or editor output.

== Screenshots ==

1. Alt Goblin's settings tab
2. Alt Goblin's bulk generation tab
3. Alt Goblin's credits tab
4. The WordPress attachment modal showing the generate alt text button

== External Services ==

This plugin connects to the Alt Goblin API (https://api.altgoblin.com) to generate alt text using AI. This is a third-party service operated by the plugin author. [Privacy policy](https://github.com/LarocheJ/alt-goblin-legal/blob/main/PRIVACY.md), [terms of service](https://github.com/LarocheJ/alt-goblin-legal/blob/main/TERMS.md).

If you choose to purchase additional credits beyond the free monthly credits, this plugin also links to a Stripe-hosted checkout page (https://buy.stripe.com) to collect payment. [Stripe privacy policy](https://stripe.com/en-ca/privacy).

The following data is transmitted to these services:

* **On plugin activation:** Your site URL, used to register your site and issue a unique site token.
* **On alt text generation:** A resized, base64-encoded version of the image, a prompt string, optional user-provided keywords, your site token, and your API key (if configured).
* **On credit purchase:** You are redirected to a Stripe-hosted checkout page. The checkout link includes your email address as a prefilled parameter.

== Changelog ==
= 1.0.4 =

* Updated button icon loading animation
* Updated error alert message for attachment ID issues
* Added URL change detection and automatic re-registration with the API
* Update plugin readme.txt

= 1.0.3 =

* Added screenshots

= 1.0.2 =

* Updated support links

= 1.0.0 =

* March 23, 2026: Alt Goblin's official realease!