Описание excerpt_allowed_wrapper_blocks
— Filter
Хук excerpt_allowed_wrapper_blocks позволяет изменить список разрешенных оберток блоков для извлечений в WordPress. Он срабатывает при формировании контента извлечения постов и позволяет настроить, какие блоки могут использоваться в данном контексте
Примеры использования
Пример добавления нового разрешенного блока в извлечение:
add_filter('excerpt_allowed_wrapper_blocks', function($allowed_blocks) {
$allowed_blocks[] = 'core/paragraph';
return $allowed_blocks;
});
В этом примере мы добавляем блок абзаца в список разрешенных блоков для извлечений
Пример удаления блока из разрешенных:
add_filter('excerpt_allowed_wrapper_blocks', function($allowed_blocks) {
$allowed_blocks = array_diff($allowed_blocks, ['core/image']);
return $allowed_blocks;
});
Здесь мы удаляем блок изображения из списка разрешенных блоков
Пример изменения списка разрешенных блоков:
add_filter('excerpt_allowed_wrapper_blocks', function($allowed_blocks) {
return ['core/heading', 'core/paragraph'];
});
В этом примере мы устанавливаем только блоки заголовка и абзаца как разрешенные
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо ограничить или изменить доступные блоки в извлечениях постов
– Производительность
Хук не должен значительно влиять на производительность, так как изменения касаются только разрешенных блоков
– Предупреждения
Проверяйте, чтобы изменения не нарушали ожидаемое поведение контента извлечений на сайте
Альтернативы
Тип: filter
Этот хук позволяет изменять вывод конкретных блоков в контенте, включая извлечения
Используйте его, если нужно изменить поведение или вывод конкретного блока вместо списка разрешенных
