Blocks: Ensure theme category is only added when not provided (#30089)

docs/getting-started/tutorials/create-block/submitting-to-block-directory.md

@@ -60,6 +60,7 @@ The Block Editor allows you to indicate the category your block belongs in, maki
 -   media
 -   design
 -   widgets
+-   theme
 -   embed
 
 [Read more about categories.](/docs/reference-guides/block-api/block-metadata.md#category)

docs/reference-guides/block-api/block-metadata.md

@@ -128,6 +128,7 @@ The core provided categories are:
 -   media
 -   design
 -   widgets
+-   theme
 -   embed
 
 Plugins and Themes can also register [custom block categories](/docs/reference-guides/filters/block-filters.md#managing-block-categories).

docs/reference-guides/block-api/block-registration.md

@@ -60,6 +60,7 @@ The core provided categories are:
 -   media
 -   design
 -   widgets
+-   theme
 -   embed
 
 ```js
@@ -226,8 +227,6 @@ example: {
 
 Similarly to how the block's style variations can be declared, a block type can define block variations that the user can pick from. The difference is that, rather than changing only the visual appearance, this field provides a way to apply initial custom attributes and inner blocks at the time when a block is inserted. See the [Block Variations API](/docs/reference-guides/block-api/block-variations.md) for more details.
 
-
-
 #### supports (optional)
 
 -   **_Type:_** `Object`

lib/blocks.php

@@ -347,11 +347,26 @@ function gutenberg_register_legacy_social_link_blocks() {
 
 /**
  * Filters the default block categories array to add a new one for themes.
- * Should be removed and turned into a core.trac ticket for merge.
  *
- * @param array $categories The list of default block categories.
+ * This can be removed when plugin support requires WordPress 5.8.0+.
+ *
+ * @see https://core.trac.wordpress.org/ticket/52883
+ *
+ * @param array[] $categories The list of default block categories.
+ *
+ * @return array[] Filtered block categories.
  */
 function gutenberg_register_theme_block_category( $categories ) {
+	foreach ( $categories as $category ) {
+		// Skip when the category is already set in WordPress core.
+		if (
+			isset( $category['slug'] ) &&
+			'theme' === $category['slug']
+		) {
+			return $categories;
+		}
+	}
+
 	$categories[] = array(
 		'slug'  => 'theme',
 		'title' => _x( 'Theme', 'block category', 'gutenberg' ),

packages/create-block/CHANGELOG.md

@@ -6,6 +6,10 @@
 
 -   Scaffolded plugin requires WordPress 5.7 now ([#29757](https://github.com/WordPress/gutenberg/pull/29757)).
 
+### New Features
+
+-   Add new `theme` category to select for the block type ([#30089](https://github.com/WordPress/gutenberg/pull/30089)).
+
 ## 2.1.0 (2021-03-17)
 
 ### New Features

packages/create-block/README.md

@@ -177,7 +177,7 @@ The following configurable variables are used with the template files. Template
 -   `title` (no default) - a display title for your block.
 -   `description` (no default) - a short description for your block.
 -   `dashicon` (no default) - an icon property thats makes it easier to identify a block, see https://developer.wordpress.org/resource/dashicons/.
--   `category` (default: `'widgets'`) - blocks are grouped into categories to help users browse and discover them. The categories provided by core are `text`, `media`, `design`, `widgets`, and `embed`.
+-   `category` (default: `'widgets'`) - blocks are grouped into categories to help users browse and discover them. The categories provided by core are `text`, `media`, `design`, `widgets`, `theme`, and `embed`.
 -   `attributes` (no default) - see https://developer.wordpress.org/block-editor/developers/block-api/block-attributes/.
 -   `supports` (no default) - optional block extended support features, see https://developer.wordpress.org/block-editor/developers/block-api/block-supports/.
 -   `author` (default: `'The WordPress Contributors'`)

packages/create-block/lib/prompts.js

@@ -70,7 +70,7 @@ const category = {
 	type: 'list',
 	name: 'category',
 	message: 'The category name to help users browse and discover your block:',
-	choices: [ 'text', 'media', 'design', 'widgets', 'embed' ],
+	choices: [ 'text', 'media', 'design', 'widgets', 'theme', 'embed' ],
 };
 
 const author = {