=== Lumatag Alt Text Generator ===
Contributors: Kailrain, freemius
Tags: alt text, accessibility, seo, ai, images
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI-generated alt text for your images — pay once, no subscription, no monthly credits.

== Description ==

Lumatag Alt Text Generator uses AI to write clear, accessible, SEO-friendly alt text for every image in your WordPress media library — automatically on upload, or on demand from the Media Library.

Unlike most alt text tools, Lumatag isn't a subscription. Bring your own OpenAI, Anthropic, or Google Vision API key, pay a single one-time fee to unlock bulk processing and Yoast keyword-awareness, and you're done. No recurring charges, no monthly image credits to track.

**Free features:**
* Single-image AI alt text generation on upload
* Manual "Generate" button in the Media Library
* Review-before-save — you always get final say before anything is written

**Pro features ($27 one-time):**
* Bulk-generate alt text for your entire media library
* Yoast SEO focus-keyword awareness for sharper, contextual alt text
* Priority compatibility updates

= Why Lumatag and not a subscription tool? =
Most AI alt text plugins run on managed credits or monthly billing. Lumatag is sold once, not rented — bring your own API key, pay a single upgrade fee for Pro features, and there's nothing recurring to cancel later.

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/lumatag-alt-text-generator`, or install directly through the WordPress plugins screen
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Go to Settings → Lumatag to add your AI provider API key
4. Upload an image or open an existing one in the Media Library to generate alt text

== Frequently Asked Questions ==

= Do I need my own API key? =
Yes. Lumatag connects to your chosen AI provider (OpenAI, Anthropic, or Google Vision) using an API key you supply. This keeps Lumatag free to run with no usage caps tied to our costs.

= Is the alt text saved automatically? =
No. Generated alt text is shown for review before it's saved, so you always have final say before anything is written to your media library.

= What's the difference between Free and Pro? =
Free covers single-image generation, on upload or on demand. Pro adds bulk processing across your whole media library and Yoast focus-keyword awareness for more contextually relevant results — for a single one-time payment, not a subscription.

= Does this work without Yoast SEO installed? =
Yes. Yoast keyword-awareness is an optional enhancement for Pro users who have Yoast active — the core plugin works independently of it.

== External services ==

This plugin can connect to third-party AI providers to analyze uploaded images
and generate descriptive alt text. Depending on which provider you configure in
Settings, the plugin sends the image (base64-encoded) and a text prompt to that
provider's API to generate a caption. No image data is sent unless you have
configured an API key for that provider and triggered alt text generation —
either by uploading an image with "Auto-generate on Upload" turned on, by
clicking "Generate Alt Text with AI" on an existing image, or (Pro) by running
Bulk Alt Text. None of these calls happen on a schedule or in the background
without one of those user actions; there is no cron-based or unattended
generation.

Bulk Alt Text (Pro) can generate for many images in one run, sending each
selected image to the configured provider in small batches (up to 5 at a time)
as the run progresses, rather than as a single combined request.

**OpenAI (Chat Completions API)**
Used to analyze images and generate alt text when OpenAI is selected as the
provider. Sends the image (base64) and a text prompt to OpenAI's API each time
alt text is generated.
Terms of Service: https://openai.com/policies/service-terms/
Privacy Policy: https://openai.com/policies/privacy-policy/

**Anthropic (Claude API)**
Used to analyze images and generate alt text when Anthropic Claude is selected
as the provider. Sends the image (base64) and a text prompt to Anthropic's
Messages API each time alt text is generated.
Terms of Service: https://www.anthropic.com/legal/commercial-terms
Privacy Policy: https://www.anthropic.com/legal/privacy

**Google Cloud Vision**
Used to analyze images (label and object detection) to help generate alt text
when Google Cloud Vision is selected as the provider. Sends the image (base64)
to the Cloud Vision API each time alt text is generated.
Terms of Service: https://cloud.google.com/terms
Privacy Policy: https://cloud.google.com/terms/cloud-privacy-notice

== Changelog ==

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.0.0 =
Initial release.
