Presswell Alt Text Generator
| 开发者 |
presswell
benplum |
|---|---|
| 更新时间 | 2026年11月4日 23:42 |
| PHP版本: | 8.2 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Supports OpenAI, Anthropic Claude, and Google Gemini through WordPress AI Connectors (recommended, WordPress 7.0+) or, deprecated, with API keys stored by the plugin
- On WordPress 7.0+, can send requests through the WordPress AI Client, so the plugin stores no key
- Generates alt text for individual images in the Media Library, the media modal, and the Image block
- Generates alt text for new uploads automatically (optional)
- Processes missing-alt backlogs in batches with a dedicated bulk queue
- Writes alt text in your site's language
- Keeps the previous alt text when regenerating, so you can restore it with one click if you prefer it
- Handles provider rate limits and quota errors with automatic pauses
- Provides a customizable prompt seed for output consistency
pwatg_available_services— Modify the available AI providerspwatg_available_models— Modify the available models for a provider (receives the models and the provider slug; the first model is the default; providers added withpwatg_provider_registryhave no models until you list them here)pwatg_provider_registry— Map provider slugs to custom service classes (each slug is listed in the settings, with its own API key field)pwatg_generate_on_upload— Return false to skip generating alt text for a new upload (receives the attachment ID)pwatg_debug_log_max_bytes— Size at which the debug log rotates (default 5 MB)pwatg_image_max_dimension— Long edge, in pixels, of the image copy sent to the provider (default 1024, minimum 256)pwatg_alt_text_language— Language the alt text is written in (defaults to the site language; return an empty string to leave it to the model)pwatg_include_filename_in_prompt— Return false to leave the image's filename out of the prompt (receives the attachment ID)pwatg_use_wp_ai_client— Return false to call the provider directly instead of through the WordPress AI Client in Core mode (receives the provider ID)pwatg_core_connector_service_map— Map WordPress AI Connector IDs to this plugin's provider slugspwatg_service_connector_candidates— Connector IDs checked for each provider's API keypwatg_debug_log_filename— Filename of the private debug logpwatg_status_rows— Rows of the Debug tab's status table (each an array with stringlabelandvalue, andstatusofok,warning, or an empty string; rows without a string label and value are dropped)pwatg_should_generate— Return false to skip an image on every path: uploads, the Media Library and Image block, bulk runs, WP-CLI, andpwatg_generate_alt_text()(receives the attachment ID and the context:upload,single,bulk,cli, orapi)pwatg_prompt— The full prompt sent to the provider (receives the attachment ID, the provider slug, and the context; an empty or non-string value keeps the original)pwatg_alt_text— Generated alt text before it's saved (receives the attachment ID, the current alt text, and the context; returning an empty string fails the generation and saves nothing)
pwatg_alt_text_generated— After generated alt text is saved (receives the attachment ID, the new alt text, the alt text it replaced, and the context)pwatg_generation_failed— When generation fails, not when it's skipped (receives the attachment ID, theWP_Error, and the context)
pwatg_generate_alt_text( $attachment_id, $args = [] )— Generate and save alt text for an image with the saved settings. Pass[ 'force' => true ]to replace existing alt text. Returns true when saved, false when skipped, or aWP_Error. It doesn't check the current user's capabilities.
wp pwatg generate <attachment-id>wp pwatg bulk-generatewp pwatg count-missingwp pwatg network-bulk-generate
wp pwatg generate <attachment-id> --forcewp pwatg bulk-generate --force— reports how many images would be overwritten; add--dry-run=falseto generatewp pwatg bulk-generate --dry-runwp pwatg bulk-generate --limit=<int>wp pwatg bulk-generate --missing-onlywp pwatg network-bulk-generate --force— a dry run unless--dry-run=falseis givenwp pwatg network-bulk-generate --limit=<int>wp pwatg network-bulk-generate --missing-onlywp pwatg network-bulk-generate --sites=<id,id,...>
安装:
wp-content/plugins/.
Configuration
- Activate the plugin.
- Visit Settings -> Alt Text Generator. Choose Core to use a provider set up in Settings -> Connectors (WordPress 7.0+), or Plugin to enter an API key and choose a model.
- Use Test Connection on the Debug tab to confirm the provider responds.
- (Optional) Turn Generate on Upload on or off.
- Use the bulk tool under Media -> Alt Text Generator, or the Media Library and Image block actions.
屏幕截图:
常见问题:
Which providers are supported?
OpenAI (GPT-4.1 and GPT-4o, including the mini models), Anthropic Claude (Haiku 4.5, Sonnet 5, Opus 5.5), and Google Gemini (2.5 Flash, Flash-Lite, and Pro). In Core mode on WordPress 7.0+, the OpenAI, Anthropic, and Google connectors in Settings -> Connectors can be used; other connectors are offered only once the pwatg_core_connector_service_map filter maps them to one of the plugin's providers. The pwatg_available_models filter changes the model list, and the pwatg_provider_registry filter adds provider classes.
Where are API keys stored?
In Core mode (recommended), keys are managed by WordPress in Settings -> Connectors. In the deprecated Plugin mode, keys are stored in the site's options (the network's, when the plugin is network-activated on Multisite) and sent only to the selected provider, from your server. Saved keys are never printed in the settings page, and they are removed when the plugin is deleted. Plugin mode will be removed in a future release, so switch to WordPress AI Connectors when you can.
Can I regenerate specific images without affecting others?
Yes. Use the inline "Regenerate Alt Text" link in the Media Library or media modal to update a single attachment without affecting the rest of the queue, or run wp pwatg generate <attachment-id> --force.
Can I run generation from WP-CLI?
Yes. Use wp pwatg generate <attachment-id> for one image, wp pwatg bulk-generate for a batch run, and wp pwatg count-missing to check remaining backlog.
How does it work on Multisite?
It depends on how the plugin is activated.
- Network-activated (recommended for managing settings once): the AI provider, API keys, model, and prompt are set once for the whole network, in Network Admin -> Settings -> Alt Text Generator, so only Super Admins manage keys and costs. Each site can choose whether new uploads get alt text automatically (or follow the network's choice), and has its own Bulk screen and Debug tab. Test Connection on a site's Debug tab is available to Super Admins. Settings saved on the main site by earlier versions move to the network automatically.
- Activated on individual sites: each site has its own settings page, API keys, and Test Connection, just like a single-site install.
Can I run bulk generation network-wide on Multisite?
Yes. Use wp pwatg network-bulk-generate to process all sites in the network, or pass --sites=<id,id,...> to target specific site IDs.
What is removed when I delete the plugin?
Deleting the plugin (not deactivating it) always removes saved API keys, debug logs, rate-limit pauses, and bulk run state. With Remove Data on, it also removes the settings and generation history (when each image was last generated, and the alt text kept for Restore previous alt text). Alt text itself is never removed.
How does rate limiting work?
When a provider reports a rate limit, the plugin pauses requests to that provider for the time it asks for, between 1 and 30 minutes (5 minutes when it doesn't say). An out-of-credit or quota error pauses it for an hour. Bulk runs stop and say why, and the image that hit the limit is retried when you continue.
更新日志:
- Now requires WordPress 6.9 and PHP 8.2.
- Added public helpers and developer hooks.
- Fixed custom providers display.
- Fixed issue in admin scripts.
- Added Multisite network settings managed by Super Admins, with a per-site Generate on Upload choice.
- Added a status table and Test Connection to the Debug tab.
- Changed the default connection to WordPress AI Connectors. API keys stored by this plugin are deprecated and will be removed in a future release.
- Fixed Gemini rate limits pausing generation for an hour.
- Fixed image conversion, bulk generation, and various security and reliability issues.
- Fixed various performance and security issues.
- Added site language support and filter.
- Added debug functionality and improved logging.
- Added WordPress 7.0 Core AI Connector support with connector mode setting.
- First public release with provider integrations, Media Library tools, and bulk generator.