=== Alt Goblin ===
Contributors: jimlaroche
Tags: accessibility, images, alt text, ai
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.2
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 media library 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.

Whether you're managing a small blog or a media-heavy site, Alt Goblin helps you stay consistent without slowing you down.

You can:

* Generate or re-generate alt text directly inside the Media modal
* Optionally guide output with comma-separated keywords
* Automatically generate alt text on upload
* Bulk process older images missing alt text
* Track your free and paid credits from a simple dashboard

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 cleanup mode:** Quickly process older images with missing alt text
* **Keyword guidance (optional):** Add context when needed
* **Simple credit dashboard:** See free, paid, and total credits at a glance
* **Clear feedback & error handling:** Helpful messages if something needs attention
* **Localization-ready:** Uses WordPress i18n functions and text domain `alt-goblin`

== 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.

That’s it. You’re ready to go.

== Usage ==

= Generate alt text for a single image =

1. Open an image in the Media Library attachment details/modal.
2. Click **Generate Alt Text** (or **Re-generate Alt Text**).
3. Optionally enable **Add keywords** and provide comma-separated keywords.
4. Save/update the attachment if needed.

= Bulk generation =

1. Go to **Settings > Alt Goblin > Bulk Generation**.
2. Click **Start Bulk Generation**.
3. Monitor progress in real time.
4. Use **Stop Processing** if you want to pause after the current image finishes.

Perfect for cleaning up older sites in just a few clicks.

= Credits =

1. Go to **Settings > Alt Goblin > Credits**.
2. View free monthly, paid, and total remaining credits.
3. Purchase one-time credit packs if needed.
4. Add your API key under the **Settings** tab to activate paid credits.

Free monthly credits are always used before 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.2 =

* Update support links

= 1.0.0 =

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