Changeset 61029 for trunk/src/wp-includes/post.php

Timestamp:

10/21/2025 01:40:28 PM (5 months ago)

Author:

ellatrix

Message:

Templates: add PHP changes required for the template activation feature.

• Adds the active_templates setting, which is an object holding the template slug as a key and template post ID as the value.
• To maintain backwards compatibility, any wp_template (post type) not created through the new API will be activated.
• get_block_template and get_block_templates have been adjusted to check active_templates. These functions should never return inactive templates, just like before, to maintain backwards compatibility.
• The pre-existing /templates endpoint and sub-endpoints remain and work exactly as before.
• A new endpoint /wp_template has been added, but this is just a regular posts controller (WP_REST_Posts_Controller). We do register an additional theme field and expose the is_wp_suggestion meta.
• Another new endpoint /wp_registered_template has been added, which is read-only and lists the registered templates from themes and plugin (un-edited, without activations applied).

These changes are to be iterated on.

See ​https://github.com/WordPress/wordpress-develop/pull/8063.

Props ellatrix, shailu25, ntsekouras.
Fixes #62755.

File:

• trunk/src/wp-includes/post.php (modified) (3 diffs)

trunk/src/wp-includes/post.php

@@ -399 +399 @@
             'show_in_rest'                    => true,
             'rewrite'                         => false,
-            'rest_base'                       => 'templates',
-            'rest_controller_class'           => 'WP_REST_Templates_Controller',
-            'autosave_rest_controller_class'  => 'WP_REST_Template_Autosaves_Controller',
-            'revisions_rest_controller_class' => 'WP_REST_Template_Revisions_Controller',
+            'rest_base'                       => 'wp_template',
+            'rest_controller_class'           => 'WP_REST_Posts_Controller',
             'late_route_registration'         => true,
             'capability_type'                 => array( 'template', 'templates' ),
@@ -427 +425 @@
                 'revisions',
                 'author',
+                'custom-fields',
             ),
         )
@@ -8630 +8629 @@
         )
     );
-}
+
+    // Allow setting the is_wp_suggestion meta field, which partly determines if
+    // a template is a custom template.
+    register_post_meta(
+        'wp_template',
+        'is_wp_suggestion',
+        array(
+            'type'         => 'boolean',
+            'show_in_rest' => true,
+            'single'       => true,
+        )
+    );
+}