Registers a new pattern category.
Parameters
$category_name
stringrequired- Pattern category name including namespace.
$category_properties
arrayrequired- List of properties for the block pattern.
See WP_Block_Pattern_Categories_Registry::register() for accepted arguments.
Source
function register_block_pattern_category( $category_name, $category_properties ) {
return WP_Block_Pattern_Categories_Registry::get_instance()->register( $category_name, $category_properties );
}
Changelog
Version | Description |
---|---|
5.5.0 | Introduced. |
To get the list of all registered categories, paste into the js inspector:
Example from Block Editor Handbook:
These categories already exist in core as of 5.5.1:
Another way to register custom block category with init hook
From Block editor handbook:
register_block_pattern_category()
should be called from a handler attached to the init hook.