Функция register_block_pattern_category() в WordPress позволяет создавать настраиваемые категории для шаблонов блоков, что упрощает организацию шаблонов в редакторе блоков.
register_block_pattern_category( string $category_name, array $category_properties ): boolФункция register_block_pattern_category() регистрирует новую категорию шаблонов блоков, к которой затем можно будет привязать конкретные шаблоны. Каждая категория имеет уникальное имя и свой набор свойств, таких как метка, которая отображается в интерфейсе редактора блоков.
Параметры:
- $category_name (string) — Уникальное имя категории, включая пространство имен.
- $category_properties (array) — Массив свойств для категории. Основной параметр —
label, задающий название категории, которое будет видно в редакторе блоков.
Возвращает true, если категория была успешно зарегистрирована, и false в случае ошибки.
Пример 1: Регистрация Категории «Отзывы Клиентов»
Предположим, что вы хотите создать категорию шаблонов блоков для секций с отзывами клиентов.
add_action( 'init', function () {
register_block_pattern_category(
'customers-testimonials',
array(
'label' => __( 'Отзывы Клиентов', 'my-text-domain' ),
)
);
});
Категория для Шаблонов «Промо Баннеры»
Теперь рассмотрим пример создания категории для промо-баннеров. Этот пример может подойти для интернет-магазинов, которым важно иметь отдельные шаблоны баннеров для акций и скидок.
add_action( 'init', function () {
register_block_pattern_category(
'promo-banners',
array(
'label' => __( 'Промо Баннеры', 'my-shop' ),
)
);
});
Дополнительные советы по использованию
- Имена категорий: Имя категории должно быть уникальным и желательно включать пространство имен (например,
my-plugin-name/my-category), чтобы избежать конфликтов с существующими категориями. - Использование
label: Полеlabelдолжно быть локализовано с помощью функции__()для поддержки перевода. - Список существующих категорий: Чтобы увидеть зарегистрированные категории, используйте следующий JavaScript-код в консоли браузера:
wp.data.select('core').getBlockPatternCategories();
- Подключение через хук
init: Функциюregister_block_pattern_category()следует вызывать в обработчике, подключенном к хукуinit, чтобы обеспечить ее выполнение в нужное время.
Заключение
Функция register_block_pattern_category() предоставляет мощный инструмент для создания пользовательских категорий шаблонов блоков в WordPress. С ее помощью разработчики могут эффективно организовывать шаблоны, обеспечивая более удобное управление контентом в редакторе блоков.