Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/semtio/alt-from-headlines/archive/refs/heads/master.zipВерсия 2.0.1
🚀 Быстрый старт (новая панель Gutenberg)
- Откройте страницу/пост в редакторе Gutenberg
- В правой боковой панели найдите иконку 🖼️ (images-alt2) или меню (⋮) → "ALT из заголовков"
- Выберите нужные уровни заголовков (H2, H3 включены по умолчанию)
- Нажмите "Проставить ALT"
- Готово! ALT автоматически заполнится из текста заголовков
Основной функционал (сохранён без изменений)
- Автоматическое заполнение ALT при загрузке - новые изображения получают ALT из имени файла
- Массовое заполнение ALT - инструмент в админке для заполнения пустых ALT в медиатеке
- Автоматическая подстановка ALT на рендере - гарантирует наличие ALT даже если он пустой в базе
- Исправление ALT в контенте - инструмент для добавления ALT в HTML постов/страниц
Новый функционал: Панель Gutenberg
Описание
Добавлена панель в боковой sidebar редактора Gutenberg для автоматического проставления ALT изображениям из текста заголовков.
Где найти
В редакторе Gutenberg найдите в правой боковой панели иконку с изображением 🖼️ (images-alt2) или откройте меню три точки (⋮) → выберите "ALT из заголовков". Панель откроется как отдельная вкладка в sidebar.
Настройки панели
Чекбоксы уровней заголовков (H1-H6):
- ☑ H1 - использовать заголовки первого уровня
- ☑ H2 - использовать заголовки второго уровня (включено по умолчанию)
- ☑ H3 - использовать заголовки третьего уровня (включено по умолчанию)
- ☐ H4 - использовать заголовки четвёртого уровня
- ☐ H5 - использовать заголовки пятого уровня
- ☐ H6 - использовать заголовки шестого уровня
Перезаписывать существующие ALT:
- ☐ Выключено (по умолчанию) - ALT будет заполнен только у изображений без ALT
- ☑ Включено - ALT будет заменён у всех обработанных изображений
Как работает
- Выберите нужные уровни заголовков (H1-H6)
- При необходимости включите "Перезаписывать существующие ALT"
- Нажмите кнопку "Проставить ALT"
- Плагин обработает страницу по следующему алгоритму:
- Проходит по всем блокам сверху вниз
- Находит выбранный заголовок (H1-H6) и запоминает его текст
- Ищет первое изображение (core/image) после этого заголовка
- Устанавливает для изображения ALT = текст заголовка
- Сбрасывает текущий заголовок и продолжает поиск
- После обработки отображается количество обработанных изображений
Важные особенности
✅ Что обрабатывается:
- Только блоки 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