apply_filters_deprecated( ‘block_categories’, array[] $block_categories, WP_Post $post )

User Contributed Notes

1. Skip to note 3 content

   Mahdi Yazdani 4 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

   Register a new block category for “My Plugin” if it doesn’t exist already.

   Note: You can also pass a second argument $post to generate a different category depending on the post’s content or type.

   /**
    * Creating a new (custm) block category.
    *
    * @param   array $categories     List of block categories.
    * @return  array
    */
   function wpdocs_new_block_category( $categories ) {
       // Plugin’s block category title and slug.
       $block_category = array( 'title' => esc_html__( 'My Plugin', 'text-domain' ), 'slug' => 'myplugin' );
       $category_slugs = wp_list_pluck( $categories, 'slug' );
   
       if ( ! in_array( $block_category['slug'], $category_slugs, true ) ) {
           $categories = array_merge(
               $categories,
               array(
                   array(
                       'title' => $block_category['title'], // Required
                       'slug'  => $block_category['slug'], // Required
                       'icon'  => 'wordpress', // Slug of a WordPress Dashicon or custom SVG
                   ),
               )
           );
       }
   
       return $categories;
   }
   add_filter( 'block_categories', 'wpdocs_new_block_category' );
2. Skip to note 4 content

   Cory Hughart 3 years ago

   You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

   If you’ve come here because you’re getting deprecation notices about `block_categories`, as of 5.8 this filter is deprecated. Use `block_categories_all` instead.

   If you need to apply categories based on post type or other $post data, you can do so like this:

   /**
    * Create a custom block category for posts only.
    *
    * @param   array $categories     List of block categories.
    * @return  array
    */
   function wpdocs_post_block_category( $categories, $editor_context ) {
   	if ( $editor_context->post instanceof WP_Post && 'post' === $editor_context->post->post_type ) {
   		$categories = array_merge(
   			$categories,
   			array(
   				'title' => __( 'Title' ), // Required
   				'slug'  => 'slug', // Required
   				'icon'  => 'wordpress', // Slug of a WordPress Dashicon or custom SVG
   			)
   		);
   	}
   
   	return $categories;
   }
   add_filter( 'block_categories_all', 'wpdocs_post_block_category' );