Changeset 61661

Timestamp:

02/17/2026 01:20:36 PM (6 weeks ago)

Author:

wildworks

Message:

Block Supports: Add autoRegister support for PHP-only block registration.

Introduces block support for PHP-only block registration, enabling developers to register blocks in PHP without requiring JavaScript registration code.

When a block declares 'supports' => array( 'autoRegister' => true ) along with a render callback, it is exposed to the client-side via a JavaScript global variable and registered automatically.

Example usage:

register_block_type(
	'my-plugin/example',
	array(
		'title'           => 'My Example Block',
		'attributes'      => array(
			'title' => array(
				'type'    => 'string',
				'default' => 'Hello World',
			),
			'count' => array(
				'type'    => 'integer',
				'default' => 5,
			),
		),
		'render_callback' => function ( $attributes ) {
			return sprintf(
				'<div %1$s>%2$s: %3$d items</div>',
				get_block_wrapper_attributes(),
				esc_html( $attributes['title'] ),
				$attributes['count']
			);
		},
		'supports'        => array(
			'autoRegister' => true,
		),
	)
);

Props mcsf, oandregal, ramonopoly, westonruter, wildworks.
Fixes #64639.

Location:

trunk

Files:

• src/wp-includes/block-supports/auto-register.php (added)
• src/wp-includes/blocks.php (modified) (1 diff)
• src/wp-includes/default-filters.php (modified) (1 diff)
• src/wp-settings.php (modified) (1 diff)
• tests/phpunit/tests/block-supports/auto-register.php (added)

trunk/src/wp-includes/blocks.php

@@ -3132 +3132 @@
     return $arg;
 }
+
+/**
+ * Exposes blocks with autoRegister flag for ServerSideRender in the editor.
+ *
+ * Detects blocks that have the autoRegister flag set in their supports
+ * and passes them to JavaScript for auto-registration with ServerSideRender.
+ *
+ * @access private
+ * @since 7.0.0
+ */
+function _wp_enqueue_auto_register_blocks() {
+    $auto_register_blocks = array();
+    $registered_blocks    = WP_Block_Type_Registry::get_instance()->get_all_registered();
+
+    foreach ( $registered_blocks as $block_name => $block_type ) {
+        if ( ! empty( $block_type->supports['autoRegister'] ) && ! empty( $block_type->render_callback ) ) {
+            $auto_register_blocks[] = $block_name;
+        }
+    }
+
+    if ( ! empty( $auto_register_blocks ) ) {
+        wp_add_inline_script(
+            'wp-block-library',
+            sprintf( 'window.__unstableAutoRegisterBlocks = %s;', wp_json_encode( $auto_register_blocks ) ),
+            'before'
+        );
+    }
+}

trunk/src/wp-includes/default-filters.php

@@ -624 +624 @@
 add_action( 'enqueue_block_editor_assets', 'wp_enqueue_block_editor_script_modules' );
 add_action( 'enqueue_block_editor_assets', 'wp_enqueue_global_styles_css_custom_properties' );
+add_action( 'enqueue_block_editor_assets', '_wp_enqueue_auto_register_blocks' );
 add_action( 'wp_print_scripts', 'wp_just_in_time_script_localization' );
 add_filter( 'print_scripts_array', 'wp_prototype_before_jquery' );

trunk/src/wp-settings.php

@@ -395 +395 @@
 require ABSPATH . WPINC . '/block-supports/utils.php';
 require ABSPATH . WPINC . '/block-supports/align.php';
+require ABSPATH . WPINC . '/block-supports/auto-register.php';
 require ABSPATH . WPINC . '/block-supports/custom-classname.php';
 require ABSPATH . WPINC . '/block-supports/generated-classname.php';