Changeset 60688

Timestamp:

08/28/2025 07:08:21 PM (7 months ago)

Author:

Bernhard Reiter

Message:

Block Hooks: Apply block hooks to plugin-registered templates.

As of WordPress 6.7.0, it is possible -- e.g. for plugins -- to register block templates via a new API, register_block_template(). Unlike block templates loaded from theme files or from the database, however, those block templates didn't have Block Hooks applied. This changeset rectifies this inconsistency.

Props iamadisingh, aljullu, bernhard-reiter.
Fixes #63808.

File:

• trunk/src/wp-includes/block-template-utils.php (modified) (3 diffs)

trunk/src/wp-includes/block-template-utils.php

@@ -1228 +1228 @@
                 }
             );
-            $query_result                  = array_merge( $query_result, $matching_registered_templates );
+
+            $matching_registered_templates = array_map(
+                function ( $template ) {
+                    $template->content = apply_block_hooks_to_content(
+                        $template->content,
+                        $template,
+                        'insert_hooked_blocks_and_set_ignored_hooked_blocks_metadata'
+                    );
+                    return $template;
+                },
+                $matching_registered_templates
+            );
+
+            $query_result = array_merge( $query_result, $matching_registered_templates );
         }
     }
@@ -1324 +1337 @@
 
 /**
- * Retrieves a unified template object based on a theme file.
+ * Retrieves a unified template object based on a theme file or plugin registration.
  *
  * This is a fallback of get_block_template(), used when no templates are found in the database.
+ * Also checks for templates registered via the Template Registration API.
  *
  * @since 5.9.0
@@ -1371 +1385 @@
 
     $block_template = WP_Block_Templates_Registry::get_instance()->get_by_slug( $slug );
+
+    if ( $block_template ) {
+        $block_template->content = apply_block_hooks_to_content(
+            $block_template->content,
+            $block_template,
+            'insert_hooked_blocks_and_set_ignored_hooked_blocks_metadata'
+        );
+    }
 
     /**