Changeset 52942 for trunk/src/wp-includes/class-wp-block-editor-context.php

Timestamp:

03/17/2022 03:35:13 AM (3 years ago)

Author:

noisysocks

Message:

Add WP_Block_Editor_Context::$name

Adds a new WP_Block_Editor_Context::$name and field. This allows plugin
developers to tell which block editor is being loaded when using filters such as
allowed_block_types_all and block_editor_rest_api_preload_paths.

Fixes #55301.
Props talldanwp, gziolo, andraganescu.

File:

• trunk/src/wp-includes/class-wp-block-editor-context.php (modified) (3 diffs)

trunk/src/wp-includes/class-wp-block-editor-context.php

@@ -8 +8 @@
 
 /**
- * Class representing a current block editor context.
- *
- * The expectation is that block editor can have a different set
- * of requirements on every screen where it is used. This class
- * allows to define supporting settings that can be used with filters.
+ * Contains information about a block editor being rendered.
  *
  * @since 5.8.0
@@ -18 +14 @@
 final class WP_Block_Editor_Context {
     /**
-     * Post being edited. Optional.
+     * String that identifies the block editor being rendered. Can be one of:
+     *
+     * - `'core/edit-post'`         - The post editor at `/wp-admin/edit.php`.
+     * - `'core/edit-widgets'`      - The widgets editor at `/wp-admin/widgets.php`.
+     * - `'core/customize-widgets'` - The widgets editor at `/wp-admin/customize.php`.
+     * - `'core/edit-site'`         - The site editor at `/wp-admin/site-editor.php`.
+     *
+     * Defaults to 'core/edit-post'.
+     *
+     * @since 6.0.0
+     *
+     * @var string
+     */
+    public $name = 'core/edit-post';
+
+    /**
+     * The post being edited by the block editor. Optional.
      *
      * @since 5.8.0
@@ -36 +48 @@
      */
     public function __construct( array $settings = array() ) {
+        if ( isset( $settings['name'] ) ) {
+            $this->name = $settings['name'];
+        }
         if ( isset( $settings['post'] ) ) {
             $this->post = $settings['post'];