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