Documentation: Consolidate editor filters and actions

docs/manifest.json

@@ -462,19 +462,19 @@
 		"parent": "reference-guides"
 	},
 	{
-		"title": "Filter Reference",
+		"title": "Hooks Reference",
 		"slug": "filters",
 		"markdown_source": "../docs/reference-guides/filters/README.md",
 		"parent": "reference-guides"
 	},
 	{
-		"title": "Block Filters",
+		"title": "Block Hooks",
 		"slug": "block-filters",
 		"markdown_source": "../docs/reference-guides/filters/block-filters.md",
 		"parent": "filters"
 	},
 	{
-		"title": "Editor Filters",
+		"title": "Editor Hooks",
 		"slug": "editor-filters",
 		"markdown_source": "../docs/reference-guides/filters/editor-filters.md",
 		"parent": "filters"

docs/reference-guides/README.md

@@ -16,11 +16,12 @@
 -   [Metadata](/docs/reference-guides/block-api/block-metadata.md)
 -   [Variations](/docs/reference-guides/block-api/block-variations.md)
 
-## [Filter Reference](/docs/reference-guides/filters/README.md)
+## [Hooks Reference](/docs/reference-guides/filters/README.md)
 
--   [Block Filters](/docs/reference-guides/filters/block-filters.md)
--   [Editor Filters (Experimental)](/docs/reference-guides/filters/editor-filters.md)
--   [Parser Filters](/docs/reference-guides/filters/parser-filters.md)
+-   [Block Hooks](/docs/reference-guides/filters/block-filters.md)
+-   [Editor Hooks](/docs/reference-guides/filters/editor-filters.md)
+-   [i18n Hooks](/docs/reference-guides/filters/i18n-filters.md)
+-   [Parser Hooks](/docs/reference-guides/filters/parser-filters.md)
 -   [Autocomplete](/docs/reference-guides/filters/autocomplete-filters.md)
 
 ## [SlotFills Reference](/docs/reference-guides/slotfills/README.md)

docs/reference-guides/filters/README.md

@@ -1,4 +1,4 @@
-# Filter Reference
+# Hooks Reference
 
 [Hooks](https://developer.wordpress.org/plugins/hooks/) are a way for one piece of code to interact/modify another piece of code. They provide one way for plugins and themes to interact with the editor, but they’re also used extensively by WordPress Core itself.
 

docs/reference-guides/filters/block-filters.md

@@ -1,6 +1,6 @@
-# Block Filters
+# Block Hooks
 
-To modify the behavior of existing blocks, WordPress exposes several APIs:
+To modify the behavior of existing blocks, WordPress exposes several APIs.
 
 ## Registration
 
@@ -92,23 +92,19 @@ _Example:_
 Wraps a cover block into an outer container.
 
 ```js
-function wrapCoverBlockInContainer(element, blockType, attributes) {
+function wrapCoverBlockInContainer( element, blockType, attributes ) {
 	// skip if element is undefined
-	if (!element) {
+	if ( ! element ) {
 		return;
 	}
 
 	// only apply to cover blocks
-	if ( (blockType.name !== 'core/cover') ) {
+	if ( blockType.name !== 'core/cover' ) {
 		return element;
 	}
 
 	// return the element wrapped in a div
-	return (
-		<div className="cover-block-wrapper">
-			{ element }
-		</div>
-	);
+	return <div className="cover-block-wrapper">{ element }</div>;
 }
 
 wp.hooks.addFilter(

docs/reference-guides/filters/editor-filters.md

@@ -1,6 +1,10 @@
-# Editor Filters
+# Editor Hooks
 
-To modify the behavior of the editor experience, the following Filters are exposed:
+To modify the behavior of the editor experience, WordPress exposes several APIs.
+
+## Editor features
+
+The following filters are available to extend the editor features.
 
 ### `editor.PostFeaturedImage.imageSize`
 
@@ -124,7 +128,32 @@ Default `true`. Indicates whether the user can access the code editor **in addit
 
 If set to false the user will not be able to switch between visual and code editor. The option in the settings menu will not be available and the keyboard shortcut for switching editor types will not fire.
 
-### Block Directory
+## Logging errors
+
+_**Note:** Since WordPress 6.1._
+
+A JavaScript error in a part of the UI shouldn’t break the whole app. To solve this problem for users, React library uses a concept of an [“error boundary”](https://reactjs.org/docs/error-boundaries.html). Error boundaries are React components that catch JavaScript errors anywhere in their child component tree, and display a fallback UI instead of the component tree that crashed.
+
+### `editor.ErrorBoundary.errorLogged`
+
+Allows you to hook into the [Error Boundaries](https://reactjs.org/docs/error-boundaries.html) and gives you access to the error object.
+
+You can use this action if you want to get hold of the error object that's handled by the boundaries, i.e to send them to an external error tracking tool.
+
+_Example_:
+
+```js
+addAction(
+	'editor.ErrorBoundary.errorLogged',
+	'mu-plugin/error-capture-setup',
+	( error ) => {
+		// error is the exception's error object
+		ErrorCaptureTool.captureError( error );
+	}
+);
+```
+
+## Block Directory
 
 The Block Directory enables installing new block plugins from [WordPress.org.](https://wordpress.org/plugins/browse/block/) It can be disabled by removing the actions that enqueue it. In WordPress core, the function is `wp_enqueue_editor_block_directory_assets`. To remove the feature, use [`remove_action`,](https://developer.wordpress.org/reference/functions/remove_action/) like this:
 
@@ -135,9 +164,9 @@ The Block Directory enables installing new block plugins from [WordPress.org.](h
 remove_action( 'enqueue_block_editor_assets', 'wp_enqueue_editor_block_directory_assets' );
 ```
 
-### Block Patterns
+## Block Patterns
 
-#### `should_load_remote_block_patterns`
+### `should_load_remote_block_patterns`
 
 Default `true`. The filter is checked when registering remote block patterns, set to false to disable.