Style Book: Exclude blocks that are not allowed to insert (#47461)

* Style Book: Exclude blocks that are not allowed to insert or have parent * Update changelog * Ignore blocks with `ancestor prop` * Revert some conditions * Update description * Fix changelog comment
WordPress · Feb 3, 2023 · a93f4f8 · a93f4f8 · github-actions · Feb 3, 2023
1 parent e88baef
commit a93f4f8
Show file tree

Hide file tree

Showing 4 changed files with 11 additions and 6 deletions.
diff --git a/docs/reference-guides/block-api/block-supports.md b/docs/reference-guides/block-api/block-supports.md
@@ -485,7 +485,7 @@ supports: {
 -   Type: `boolean`
 -   Default value: `true`
 
-By default, all blocks will appear in the inserter. To hide a block so that it can only be inserted programmatically, set `inserter` to `false`.
+By default, all blocks will appear in the inserter, block transforms menu, Style Book, etc. To hide a block from all parts of the user interface so that it can only be inserted programatically, set `inserter` to `false`.
 
 ```js
 supports: {

diff --git a/packages/edit-site/CHANGELOG.md b/packages/edit-site/CHANGELOG.md
@@ -7,6 +7,7 @@
 ### Bug Fix
 
 -   Force visual editor in browse mode ([#47329](https://github.com/WordPress/gutenberg/pull/47329)).
+-   Style Book: Exclude blocks that are not allowed to insert ([#47461](https://github.com/WordPress/gutenberg/pull/47461)).
 
 ## 5.2.0 (2023-01-11)
 

diff --git a/packages/edit-site/src/components/style-book/index.js b/packages/edit-site/src/components/style-book/index.js
@@ -70,10 +70,14 @@ function getExamples() {
 	};
 
 	const otherExamples = getBlockTypes()
-		.filter(
-			( blockType ) =>
-				blockType.name !== 'core/heading' && !! blockType.example
-		)
+		.filter( ( blockType ) => {
+			const { name, example, supports } = blockType;
+			return (
+				name !== 'core/heading' &&
+				!! example &&
+				supports.inserter !== false
+			);
+		} )
 		.map( ( blockType ) => ( {
 			name: blockType.name,
 			title: blockType.title,

diff --git a/schemas/json/block.json b/schemas/json/block.json
@@ -311,7 +311,7 @@
 				},
 				"inserter": {
 					"type": "boolean",
-					"description": "By default, all blocks will appear in the inserter. To hide a block so that it can only be inserted programmatically, set inserter to false.",
+					"description": "By default, all blocks will appear in the inserter, block transforms menu, Style Book, etc. To hide a block from all parts of the user interface so that it can only be inserted programatically, set inserter to false.",
 					"default": true
 				},
 				"multiple": {