Описание block_categories
— Filter
Хук block_categories позволяет изменять и добавлять категории блоков в редакторе Gutenberg. Он срабатывает при загрузке редактора и позволяет настраивать, какие категории доступны для блоков, что в свою очередь влияет на удобство использования редактора и организацию блоков для пользователя
Примеры использования
Пример добавления новой категории блоков:
add_filter('block_categories', function($categories) {
$categories[] = array(
'slug' => 'my_custom_category',
'title' => 'Мои кастомные блоки',
'icon' => 'star'
);
return $categories;
});
В этом примере мы добавляем новую категорию ‘Мои кастомные блоки’ с иконкой ‘star’
Пример изменения существующей категории:
add_filter('block_categories', function($categories) {
foreach ($categories as &$category) {
if ($category['slug'] === 'common') {
$category['title'] = 'Общие блоки';
}
}
return $categories;
});
Здесь мы изменяем название категории ‘common’ на ‘Общие блоки’
Пример удаления категории:
add_filter('block_categories', function($categories) {
return array_filter($categories, function($category) {
return $category['slug'] !== 'widgets';
});
});
В этом примере мы удаляем категорию ‘widgets’ из списка категорий блоков
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо организовать категории блоков для удобства пользователей редактора Gutenberg
– Производительность
Этот хук не должен существенно влиять на производительность, так как изменения касаются только структуры категорий
– Предупреждения
Убедитесь, что изменения не вызывают путаницы у пользователей, особенно если они привыкли к стандартным категориям
Альтернативы
Тип: filter
Этот хук позволяет изменять все категории блоков, включая те, которые предоставляются плагинами и темами
Используйте его, если нужно глобально изменить категорию блоков, доступные в редакторе
