=== 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.11 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.11 = * Maintenance: internal code cleanup and stability improvements. No functional changes. * Compatibility: re-verified with WordPress 7.0. = 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.