=== AI Alt Text Builder ===
Contributors: rankpilotai
Tags: alt text, images, media library, accessibility, seo
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.10
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Generate SEO-friendly ALT text for your images. Free forever with your own OpenAI API key, or start with 25 free tokens.

== Description ==
AI Alt Text Builder generates concise, descriptive ALT text for images in the Media Library.
Works immediately after install: start a free trial (25 tokens, no API key needed), use your own OpenAI API key for unlimited generations, or upgrade to Pro for bulk, auto-generate, and more.

== Highlights ==

- **Works instantly** - no registration required, 25 free tokens on first use
- **BYOK mode** - use your own OpenAI API key for unlimited single image generations
- One-click “Generate with AI” button on Media Library items and the attachment edit screen
- Automatically saves to `_wp_attachment_image_alt`
- Built-in ALT-length score badge (0-100) and a sortable Media Library column
- **Pro:** Bulk generation, auto-generate on upload, all languages, all models, custom prompts
- Language selector (English, Deutsch, Francais, Espanol, Turkce, or custom)
- Model choice (GPT-4.1 Mini, GPT-4.1, GPT-4o)

== External services ==

This plugin connects to RankPilotAI’s API to generate ALT text and to fetch token status.

=== What is sent and when ===

- **Trial mode:** Site URL is sent to RankPilotAI for registration. Image URL is sent to RankPilotAI for processing.
- **BYOK mode:** Image URL is sent directly to OpenAI's API using your own API key. Nothing is sent to RankPilotAI.
- **Pro mode:** Image URL, file name, current ALT, selected model, language, site URL, domain, plugin slug, and Site Token are sent to RankPilotAI.
- On token-status checks in the settings page (Pro mode only): Site Token, site URL and domain.

=== Why it is sent ===

- To generate the requested ALT text and return it to your Media Library item
- To authorize usage and show your remaining balance (Pro mode)
- To register and track trial token usage (Trial mode)

=== Endpoints ===

- https://rankpilotai.com/wp-json/rankpilotai/v1/alt-text (Pro)
- https://rankpilotai.com/wp-json/rankpilotai/v1/alt-batch (Pro bulk)
- https://rankpilotai.com/wp-json/rankpilotai/v1/token-info (Pro)
- https://rankpilotai.com/wp-json/rankpilotai/v1/trial-register (Trial)
- https://rankpilotai.com/wp-json/rankpilotai/v1/trial-alt (Trial)
- https://api.openai.com/v1/chat/completions (BYOK - direct to OpenAI)

=== Providers ===

- RankPilotAI (Terms: https://rankpilotai.com/terms-and-conditions, Privacy: https://rankpilotai.com/privacy-policy)
- OpenAI (BYOK mode only - Terms: https://openai.com/policies/terms-of-use, Privacy: https://openai.com/policies/privacy-policy)

== Installation ==
1. Upload and activate the plugin.
2. Go to **AI Alt Text Builder** in the admin menu.
3. Choose your mode:
   - **Free Trial** - Click "Start Free Trial" for 25 free tokens (no registration needed)
   - **Own API Key** - Enter your OpenAI API key for unlimited single image generations
   - **Pro** - Enter your RankPilotAI Site Key for full features
4. Open **Media → Library** or an **attachment** and click **Generate with AI**.

== Frequently Asked Questions ==
= Do I need to register or create an account? =
No. The free trial starts instantly with one click. For BYOK mode, just paste your OpenAI API key.

= Is there a free plan? =
Yes. 25 free tokens are included. After that, use your own OpenAI API key (unlimited, free) or upgrade to Pro.

= Does it overwrite my existing ALT texts? =
Only when you click **Generate** for a given image (or run a bulk action). It writes to WordPress’ standard `_wp_attachment_image_alt` field.

= What languages are supported? =
English, German, French, Spanish, Turkish — plus **Other/Custom**. Enter any language name and we’ll pass it to the generator.

= Will it change image file names or titles? =
No. It only sets the ALT text and stores a score `_aatb_score` meta (for the badge/column).

= Does it work with other media/SEO plugins? =
Yes. ALT text is a core WordPress field, so other plugins and themes will read it normally.

== Screenshots ==
1. Media modal with **Generate with AI**
2. Attachment edit screen — button + score badge
3. Settings → **Site Key** & **Usage Overview**
4. Settings → **Alt-Text Language** & **Model**

== Changelog ==

= 1.0.10 =
* Compatibility: tested up to WordPress 7.0.
* Maintenance: minor housekeeping and copy cleanup. No functional changes.

= 1.0.9 =
* NEW: Three-mode system - Trial (25 free tokens), BYOK (your own OpenAI key), Pro (RankPilotAI).
* NEW: Plugin works immediately after install with zero-friction free trial.
* NEW: BYOK mode - unlimited single image generations using your own OpenAI API key.
* NEW: Auto-generate alt text on image upload (Pro feature).
* NEW: Redesigned settings page with mode selection, feature comparison table, and Pro feature indicators.
* Bulk generation and auto-generate are now Pro-only features.
* Score badge and column hidden in BYOK mode.
* Language and model selection locked to English/Mini in Trial and BYOK modes.

= 1.0.8 =
* Updated default AI model from GPT-4o-mini to GPT-4.1 Mini for improved quality and performance.
* Backward compatibility maintained — existing GPT-4o-mini selections are automatically migrated.

= 1.0.7 =
* UI: Redesigned settings page with modern card-based layout, gradient header, improved navigation and responsive design.
* UI: Settings header now displays the official AI Alt Text Builder logo.
* UI: Modernized admin CSS for generate button and score badges.

= 1.0.6 =
* Maintenance: minor version consistency updates and small documentation/copy cleanup. No functional changes.

= 1.0.5 =
* Maintenance: minor version consistency updates and small documentation/copy cleanup. No functional changes.

= 1.0.4 =
* Tested up to WordPress 6.9.

= 1.0.3 =
* New installs start with an empty Site Key field instead of a random generated key.

= 1.0.2 =
* Tweak: removed extra “View details” link on the Plugins screen and synced short description. No functional changes.

= 1.0.1 =
* Tweak: Updated short description and plugin listing copy. No functional changes.

= 1.0.0 =
* Initial public release: one-click ALT generation + “Alt Score” badge.
* Normalized usage overview: Remaining = Plan Limit − Global Usage (matches RankPilotAI account dashboard).
* Language selector and prompt improvements.
* New settings UI, bulk actions polish and sortable “Alt Score” column.
* Stability and compatibility tweaks on admin screens.
