Описание hooked_block
— Action
Хук hooked_block позволяет добавлять функциональность или изменять поведение блоков в редакторе блоков WordPress. Он срабатывает при рендеринге блока на странице и позволяет внедрять дополнительный код или изменять выходные данные блока
Примеры использования
Пример добавления атрибута к блоку:
add_action('hooked_block', function($block_name, $attributes) {
if ($block_name === 'core/paragraph') {
$attributes['className'] = 'custom-class';
}
});
В этом примере мы добавляем кастомный класс к блоку абзаца.
Пример изменения содержимого блока:
add_action('hooked_block', function($block_name, $attributes) {
if ($block_name === 'core/quote') {
$attributes['content'] = 'Измененное содержимое цитаты';
}
});
Здесь мы изменяем содержимое блока цитаты на новое значение.
Пример добавления кастомного HTML перед блоком:
add_action('hooked_block', function($block_name, $attributes) {
if ($block_name === 'core/image') {
echo '<div class="custom-image-wrapper">';
}
});
Мы добавляем кастомный обертку для блока изображения.
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить поведение блоков в редакторе WordPress
– Производительность
Старайтесь минимизировать количество операций внутри хуков для предотвращения замедления рендеринга
– Предупреждения
Обязательно проверяйте имя блока, чтобы избежать конфликтов с другими хуками или плагинами
Альтернативы
Тип: filter
Этот хук позволяет фильтровать содержимое блока перед его выводом
Используйте его, если нужно изменить вывод блока, не изменяя его атрибуты
