{"id":1293,"date":"2024-06-11T06:24:16","date_gmt":"2024-06-11T04:24:16","guid":{"rendered":"https:\/\/wypo.io\/creer-nouvelle-categorie-blocs-gutenberg\/"},"modified":"2024-07-18T23:19:48","modified_gmt":"2024-07-18T21:19:48","slug":"create-new-category-gutenberg-blocks","status":"publish","type":"post","link":"https:\/\/wypo.io\/en\/create-new-category-gutenberg-blocks\/","title":{"rendered":"Create a new category for Gutenberg blocks"},"content":{"rendered":"\n
\n

The block category in Gutenberg is a feature that allows organizing and grouping the various blocks available in the WordPress block editor. It provides a logical and intuitive structure for users when they are searching for and selecting blocks to build their pages or posts.<\/p>\n<\/div>\n\n\n\n

\n

Why Create a New Category?<\/h2>\n\n\n\n

Creating a new category for Gutenberg blocks in WordPress can be interesting for several reasons:<\/p>\n\n\n\n

    \n
  • Organization<\/strong>: Having specific categories for your blocks helps better organize the Gutenberg editor. It makes it easier to find relevant blocks, especially if you have a large number of custom blocks.<\/li>\n\n\n\n
  • Clarity<\/strong>: By creating specific categories, you can provide clearer meaning to the purpose of each block, helping users quickly understand the usefulness of each available block.<\/li>\n\n\n\n
  • Customization<\/strong>: If you’re developing blocks for a specific theme or plugin, grouping them into a custom category makes the user interface more consistent and aligned with the theme or plugin’s functionality.<\/li>\n<\/ul>\n<\/div>\n\n\n\n
    \n

    Default Block Categories<\/h2>\n\n\n\n

    Gutenberg provides a series of default categories for organizing the available blocks. These categories offer a basic structure for classifying blocks based on their use and content type. Here are some of the most common default categories:<\/p>\n\n\n\n

      \n
    • Text<\/strong>
      The Text category blocks are used for adding and formatting textual content. It includes paragraph, heading, list, quote blocks, etc., which enable composing and styling text effectively.<\/li>\n\n\n\n
    • Media<\/strong>
      The Media category groups blocks that allow adding and manipulating media such as images, galleries, videos, and audio files. These blocks provide a simple and intuitive way to integrate different types of media into content.<\/li>\n\n\n\n
    • Design<\/strong>
      This category groups blocks that help structure the layout of a page or post. It typically includes column, group, and container blocks that facilitate creating complex layouts.<\/li>\n\n\n\n
    • Widgets<\/strong>
      Widgets category blocks are often used to add interactive or dynamic elements to a page or post. It includes blocks like buttons, contact forms, counters, icons, etc., which enrich the user experience.<\/li>\n\n\n\n
    • Theme<\/strong>
      This category groups blocks specific to a given WordPress theme. These blocks are designed to work optimally with the active theme on the WordPress site, providing visual and functional consistency in layout design.<\/li>\n\n\n\n
    • Embedded Content<\/strong>
      This category groups blocks that allow embedding content from external sources such as social networks, video platforms, and mapping services. It includes blocks for embedding tweets, YouTube videos, Google Maps, etc.<\/li>\n<\/ul>\n<\/div>\n\n\n\n
      \n

      Adding the Category in PHP<\/h2>\n\n\n\n

      To create a new Gutenberg block category, you need to use the block_categories<\/code> filter (or block_categories_all<\/code> for newer versions of WordPress) in your plugin or theme file. Here’s an example code to add a new category:<\/p>\n\n\n

      \n
      \n
      \n PHP <\/div>\n <\/header>\n function my_custom_block_categories($categories, $post) {\n return array_merge(\n $categories,\n array(\n array(\n 'slug' => 'my-custom-category',\n 'title' => __('My Custom Category', 'text-domain'),\n 'icon' => 'star-filled', \/\/ Nom de l'ic\u00f4ne Dashicon (facultatif)\n ),\n )\n );\n}\n\nif ( version_compare( get_bloginfo( 'version' ), '5.8', '>=' ) ) {\n\tadd_filter( 'block_categories_all', 'my_custom_block_categories' );\n} else {\n\tadd_filter( 'block_categories', 'my_custom_block_categories' );\n}<\/textarea>\n