FluffAlt — Auto Alt Text for Images
| 开发者 | avsalexandra |
|---|---|
| 更新时间 | 2026年9月24日 00:11 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
alt attribute) for your images using a vision AI model, so every picture on your WordPress site has a meaningful text description. Better image SEO, better accessibility (WCAG), and you never have to write alt text by hand again.
It can fill in alt text the moment you publish a post, right after you upload an image, or in bulk for hundreds of images you uploaded before. It also adds a one-click "Generate alt text" button to the Media Library and the Gutenberg Image block.
You bring your own API key. The plugin talks to any OpenAI-compatible chat API, so you can pick the option that fits your budget:
- OpenAI —
gpt-4o-miniand other vision models. The most reliable quality; pay-as-you-go. - OpenRouter — a single key for many models, including free vision models. Set the model to
auto-freeand the plugin picks a working free one. - Cloudflare Workers AI — a free tier with the open LLaVA model. Simpler alt text, no card needed to start.
- Custom URL — any other OpenAI-compatible endpoint (self-hosted models, regional proxies, and so on).
- One-click generation — a "Generate alt text" button in the Media Library and in the Gutenberg Image block, right under the alt field.
- On publish — when a post goes from draft to published, the plugin scans the content and orders alt text only for the images that actually ended up in the article. You pay only for what you use.
- On upload (optional) — generate as soon as an image is added to a post.
- Bulk generation — a settings-page tool for sites that already have hundreds of images: choose a post type, category or tag, see how many images have no alt text, and run the job in the background (Action Scheduler or WP-Cron). You can close the tab, come back later, watch progress, or stop it.
- Error log with retry — failed images are listed on the settings page with "Retry" and "Dismiss" buttons.
- Fill attachment fields (optional) — put the same text into the attachment title, caption and description.
- Language setting — pick the output language from a dropdown (English, Russian, German, French, Spanish and more; defaults to the site language). Works regardless of the prompt language.
- Skip decorative images — by minimum size, or by filename fragment (
icon-,logo,sprite, and so on). - Delay for auto-generation — authors add and remove images while writing; the plugin waits a configurable number of minutes before generating.
- Clean uninstall (optional) — a checkbox to remove all plugin settings and internal data when the plugin is deleted. The alt text on your images is standard WordPress data and always stays.
- Translation-ready — English by default, with a Russian translation bundled (
ru_RU).
安装:
- Install the plugin from Plugins → Add New (search for "FluffAlt"), or upload the plugin folder to
/wp-content/plugins/. - Activate the plugin through the Plugins menu.
- Go to Settings → FluffAlt, choose a provider and paste your API key.
- Generate alt text from the Media Library, from the Gutenberg Image block, on publish, or with the bulk tool on the settings page.
屏幕截图:
常见问题:
How do I automatically add alt text to images in WordPress?
Install the plugin, add your API key on the settings page, and choose when auto-generation runs (on publish or on upload). From then on new images get alt text automatically. For images you already have, use the bulk tool.
Can I generate alt text for all my existing images at once?
Yes. On the settings page, open "Bulk alt text generation", pick a post type (and optionally a category or tag), and start the job. It runs in the background in batches, so you can close the tab and come back later to see progress.
Do I need my own API key?
Yes. The plugin does not include an API key. Create one with your chosen provider (OpenAI, OpenRouter, ProxyAPI or Cloudflare) and paste it into the settings.
How much does it cost?
You pay your own provider per request. Check the real spend in your provider's dashboard. With gpt-4o-mini it is usually a fraction of a cent per image. OpenRouter has free vision models and Cloudflare Workers AI has a free tier.
It says "Access denied by security policy" or a 403 error.
Your provider is blocking requests from your server's region. Try a different provider, or enter a custom endpoint that is reachable from your host.
Will it overwrite alt text I wrote myself?
No. Existing non-empty alt text is never overwritten by automatic generation.
Can I generate alt text in another language?
Yes. Pick the language in Settings → FluffAlt. It defaults to the site language and works regardless of the prompt language.
Does deleting the plugin remove the alt text from my images?
No. The alt text is stored in _wp_attachment_image_alt, a standard WordPress field, and is never touched. Only the plugin's own settings and internal data are removed, and only if you tick "delete all plugin data" in the settings before deleting the plugin.
更新日志:
- Generate alt text on demand (Media Library button and Gutenberg Image block).
- Auto-generation on publish: scans the published content and generates alt text only for images that actually ended up in the article.
- Auto-generation on upload (optional), with a configurable delay.
- Bulk generation as a background job (Action Scheduler / WP-Cron): close the tab and it keeps going; reopen to see progress or stop it.
- Two-step scope picker for bulk and a searchable category/tag picker for auto-generation.
- Providers: OpenAI, OpenRouter, Cloudflare Workers AI, ProxyAPI, or a custom OpenAI-compatible URL.
- Output language dropdown, independent of the prompt language.
- Skip decorative images by minimum size or filename fragment.
- Optionally fill the attachment title, caption and description.
- Error log with one-click retry.
- Optional "delete all plugin data on uninstall" — the image alt text itself is never removed.
- Fully translation-ready; English source strings with a bundled Russian (ru_RU) translation.