FluffAlt — Auto Alt Text for Images

Описание

FluffAlt автоматически создаёт alt-текст (атрибут alt) для изображений с помощью ИИ-модели, распознающей изображения — чтобы у каждой картинки на сайте было осмысленное текстовое описание. Лучше SEO по картинкам, лучше доступность (WCAG), и больше не нужно писать alt-текст вручную.

Плагин может заполнять alt-текст сразу при публикации записи, сразу после загрузки изображения или массово — для сотен уже загруженных изображений. Также добавляет кнопку «Сгенерировать alt-текст» в один клик в медиатеку и в блок изображения Gutenberg.

Вы используете свой API-ключ. Плагин работает с любым OpenAI-совместимым chat API, так что можно выбрать вариант под свой бюджет:

  • OpenAI — gpt-4o-mini и другие vision-модели. Самое надёжное качество; оплата по факту использования.
  • OpenRouter — один ключ для множества моделей, включая бесплатные vision-модели. Установите модель auto-free, и плагин сам подберёт рабочую бесплатную.
  • Cloudflare Workers AI — бесплатный тариф с открытой моделью LLaVA. Alt-текст попроще, карта для начала не нужна.
  • Свой адрес — любой другой OpenAI-совместимый endpoint (свои модели, региональные прокси и так далее).

Каждый запрос отправляет только уменьшенную копию изображения и короткий промпт, в режиме низкой детализации — поэтому расход токенов на изображение минимальный.

Что умеет

  • Генерация в один клик — кнопка «Сгенерировать alt-текст» в медиатеке и в блоке изображения Gutenberg, прямо под полем alt.
  • При публикации — когда запись переходит из черновика в опубликованную, плагин сканирует содержимое и заказывает alt-текст только для изображений, реально попавших в статью. Платите только за то, что используете.
  • При загрузке (опционально) — генерация сразу после добавления изображения в запись.
  • Массовая генерация — инструмент на странице настроек для сайтов, где уже есть сотни изображений: выберите тип записи, рубрику или метку, посмотрите, у скольких изображений нет alt-текста, и запустите задачу в фоне (Action Scheduler или WP-Cron). Можно закрыть вкладку, вернуться позже, посмотреть прогресс или остановить.
  • Журнал ошибок с повтором — неудавшиеся изображения показаны на странице настроек с кнопками «Повторить» и «Скрыть».
  • Заполнение полей вложения (опционально) — тот же текст в заголовок, подпись и описание вложения.
  • Выбор языка — язык alt-текста выбирается из списка (английский, русский, немецкий, французский, испанский и другие; по умолчанию — язык сайта). Работает независимо от языка промпта.
  • Пропуск декоративных изображений — по минимальному размеру или по фрагменту имени файла (icon-, logo, sprite и т. п.).
  • Задержка для автогенерации — авторы добавляют и убирают изображения во время написания; плагин ждёт настраиваемое число минут перед генерацией.
  • Чистое удаление (опционально) — галочка для удаления всех настроек плагина и служебных данных при удалении плагина. Alt-текст на изображениях — стандартные данные WordPress, они всегда остаются.
  • Translation-ready — English by default, with a Russian translation bundled (ru_RU).

Внешние сервисы

Плагин отправляет изображения стороннему ИИ-сервису для генерации alt-текста. Запрос не выполняется, пока вы не введёте API-ключ и не выберете провайдера, и происходит только при самой генерации (вручную, при загрузке, при публикации или массово).

При каждой генерации плагин отправляет: уменьшенную копию (или ссылку) изображения и короткий текстовый промпт. В ответ получает сгенерированный alt-текст. Личные данные, содержимое записей и данные пользователей не отправляются.

Провайдер — тот, что вы выбрали в настройках:

Совместимость

Проверено на PHP 7.4, 8.0, 8.1, 8.2, 8.3. Проверено на WordPress до версии 7.1.

Лицензия

Этот плагин распространяется по лицензии GPLv2 или более поздней.

Скриншоты

Установка

  1. Установите плагин через Плагины Добавить новый (найдите «FluffAlt»), либо загрузите папку плагина в /wp-content/plugins/.
  2. Активируйте плагин в меню Плагины.
  3. Перейдите в Настройки FluffAlt, выберите провайдера и вставьте свой API-ключ.
  4. Генерируйте alt-текст из медиатеки, из блока изображения Gutenberg, при публикации или инструментом массовой генерации на странице настроек.

Часто задаваемые вопросы

Как автоматически добавлять alt-текст к изображениям в WordPress?

Установите плагин, добавьте API-ключ на странице настроек и выберите, когда запускать автогенерацию (при публикации или при загрузке). После этого новые изображения будут получать alt-текст автоматически. Для уже загруженных изображений используйте инструмент массовой генерации.

Можно ли сгенерировать alt-текст сразу для всех уже загруженных изображений?

Да. На странице настроек откройте «Массовая генерация alt-текста», выберите тип записи (и, при желании, рубрику или метку) и запустите задачу. Она выполняется в фоне пакетами, так что можно закрыть вкладку и вернуться позже, чтобы посмотреть прогресс.

Нужен ли мне свой API-ключ?

Да. Плагин не включает API-ключ. Создайте его у выбранного провайдера (OpenAI, OpenRouter, ProxyAPI или Cloudflare) и вставьте в настройки.

Сколько это стоит?

Вы платите своему провайдеру за каждый запрос. Точный расход смотрите в панели провайдера. С gpt-4o-mini это обычно доли цента за изображение. У OpenRouter есть бесплатные vision-модели, у Cloudflare Workers AI — бесплатный тариф.

Показывает «Access denied by security policy» или ошибку 403.

Ваш провайдер блокирует запросы из региона вашего сервера. Попробуйте другого провайдера или укажите свой адрес API, доступный с вашего хостинга.

Перезапишет ли плагин alt-текст, который я написал сам?

Нет. Существующий непустой alt-текст автоматическая генерация никогда не перезаписывает.

Можно ли генерировать alt-текст на другом языке?

Да. Выберите язык в Настройки FluffAlt. По умолчанию — язык сайта, работает независимо от языка промпта.

Удаление плагина уберёт alt-текст с моих изображений?

Нет. Alt-текст хранится в _wp_attachment_image_alt — это стандартное поле WordPress, оно не затрагивается. Удаляются только собственные настройки и служебные данные плагина, и только если вы отметили «удалить все данные плагина» в настройках перед удалением плагина.

Отзывы

Нет отзывов об этом плагине.

Участники и разработчики

«FluffAlt — Auto Alt Text for Images» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:

Участники

«FluffAlt — Auto Alt Text for Images» переведён на 1 язык. Благодарим переводчиков за их работу.

Перевести «FluffAlt — Auto Alt Text for Images» на ваш язык.

Заинтересованы в разработке?

Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.

Журнал изменений

1.0.0

Первый публичный релиз.

  • Генерация alt-текста по запросу (кнопка в медиатеке и блок изображения Gutenberg).
  • Автогенерация при публикации: сканирует опубликованное содержимое и генерирует alt-текст только для изображений, реально попавших в статью.
  • Автогенерация при загрузке (опционально), с настраиваемой задержкой.
  • Массовая генерация как фоновая задача (Action Scheduler / WP-Cron): можно закрыть вкладку — работа продолжится; откройте снова, чтобы увидеть прогресс или остановить.
  • Двухступенчатый выбор области для массовой генерации и поиск по рубрикам/меткам для автогенерации.
  • Провайдеры: OpenAI, OpenRouter, Cloudflare Workers AI, ProxyAPI или свой OpenAI-совместимый адрес.
  • Выпадающий список языка вывода, независимого от языка промпта.
  • Пропуск декоративных изображений по минимальному размеру или фрагменту имени файла.
  • Опционально заполняет заголовок, подпись и описание вложения.
  • Журнал ошибок с повтором в один клик.
  • Опциональное «удалить все данные плагина при удалении» — сам alt-текст изображений никогда не удаляется.
  • Fully translation-ready; English source strings with a bundled Russian (ru_RU) translation.