WP Manifestindependent plugin directory
manifest / media / alt-from-headlines

ALT Auto & Fixer

Автоматически ставит ALT у новых изображений, массово заполняет ALT в медиатеке, чинит ALT в контенте (Гутенберг и классический), и гарантирует ALT на рендере. Включает панель Gutenberg для проставления ALT из заголовков.

by 7ON · github.com/semtio/alt-from-headlines

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/semtio/alt-from-headlines/archive/refs/heads/master.zip
Readme github.com/semtio/alt-from-headlines ↗

Версия 2.0.1

🚀 Быстрый старт (новая панель Gutenberg)

  1. Откройте страницу/пост в редакторе Gutenberg
  2. В правой боковой панели найдите иконку 🖼️ (images-alt2) или меню (⋮) → "ALT из заголовков"
  3. Выберите нужные уровни заголовков (H2, H3 включены по умолчанию)
  4. Нажмите "Проставить ALT"
  5. Готово! ALT автоматически заполнится из текста заголовков

Основной функционал (сохранён без изменений)

  1. Автоматическое заполнение ALT при загрузке - новые изображения получают ALT из имени файла
  2. Массовое заполнение ALT - инструмент в админке для заполнения пустых ALT в медиатеке
  3. Автоматическая подстановка ALT на рендере - гарантирует наличие ALT даже если он пустой в базе
  4. Исправление ALT в контенте - инструмент для добавления ALT в HTML постов/страниц

Новый функционал: Панель Gutenberg

Описание

Добавлена панель в боковой sidebar редактора Gutenberg для автоматического проставления ALT изображениям из текста заголовков.

Где найти

В редакторе Gutenberg найдите в правой боковой панели иконку с изображением 🖼️ (images-alt2) или откройте меню три точки (⋮) → выберите "ALT из заголовков". Панель откроется как отдельная вкладка в sidebar.

Настройки панели

Чекбоксы уровней заголовков (H1-H6):

  • ☑ H1 - использовать заголовки первого уровня
  • ☑ H2 - использовать заголовки второго уровня (включено по умолчанию)
  • ☑ H3 - использовать заголовки третьего уровня (включено по умолчанию)
  • ☐ H4 - использовать заголовки четвёртого уровня
  • ☐ H5 - использовать заголовки пятого уровня
  • ☐ H6 - использовать заголовки шестого уровня

Перезаписывать существующие ALT:

  • ☐ Выключено (по умолчанию) - ALT будет заполнен только у изображений без ALT
  • ☑ Включено - ALT будет заменён у всех обработанных изображений

Как работает

  1. Выберите нужные уровни заголовков (H1-H6)
  2. При необходимости включите "Перезаписывать существующие ALT"
  3. Нажмите кнопку "Проставить ALT"
  4. Плагин обработает страницу по следующему алгоритму:
    • Проходит по всем блокам сверху вниз
    • Находит выбранный заголовок (H1-H6) и запоминает его текст
    • Ищет первое изображение (core/image) после этого заголовка
    • Устанавливает для изображения ALT = текст заголовка
    • Сбрасывает текущий заголовок и продолжает поиск
  5. После обработки отображается количество обработанных изображений

Важные особенности

✅ Что обрабатывается:

  • Только блоки core/heading выбранных уровней
  • Только блоки core/image (первый после каждого заголовка)
  • Работает с вложенными блоками (колонки, группы и т.д.)

❌ Что НЕ обрабатывается:

  • Изображения, у которых уже есть ALT (если выключен overwrite)
  • Изображения без предшествующего заголовка
  • Второе и последующие изображения после одного заголовка
  • Другие типы блоков между заголовком и изображением (они просто игнорируются)

Права доступа

Панель доступна только пользователям с ролями:

  • Administrator
  • Editor

Примеры использования

Пример 1: Базовое использование

[H2] Красивый закат на море
[Image] ← получит ALT: "Красивый закат на море"

[H2] Горный пейзаж
[Text] Какой-то текст
[Image] ← получит ALT: "Горный пейзаж"

Пример 2: Несколько изображений

[H2] Наш офис
[Image] ← получит ALT: "Наш офис"
[Image] ← НЕ получит ALT (второе изображение)

[H3] Команда разработчиков
[Image] ← получит ALT: "Команда разработчиков"

Пример 3: С перезаписью

Перезапись ВЫКЛЮЧЕНА:
[H2] Новый заголовок
[Image alt="Старый ALT"] ← останется "Старый ALT"

Перезапись ВКЛЮЧЕНА:
[H2] Новый заголовок
[Image alt="Старый ALT"] ← станет "Новый заголовок"

Безопасность

  • Плагин не изменяет файлы изображений
  • Не затрагивает изображения вне связки "заголовок → картинка"
  • Можно безопасно запускать многократно
  • Изменения видны сразу в редакторе
  • Можно отменить через Ctrl+Z (стандартная отмена WordPress)

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

  • WordPress 5.8+
  • Работает только с редактором Gutenberg
  • Не затрагивает классический редактор (там работают старые функции)

Поддержка

Автор: 7ON Версия: 2.0.0 Последнее обновление: 2026

Changelog

2.0.0 (2026-02-09)

  • ➕ Добавлена отдельная панель в Gutenberg редактор с собственной иконкой
  • ➕ Возможность выбора уровней заголовков (H1-H6)
  • ➕ Опция перезаписи существующих ALT
  • ➕ Счётчик обработанных изображений
  • ➕ Поддержка вложенных блоков
  • ✅ Сохранён весь предыдущий функционал
  • 🔧 Улучшена видимость панели (теперь отдельная вкладка с иконкой)

1.2.1

  • Базовая версия с автоматическим заполнением ALT