Context Navigation

option.php

Timestamp:

10/21/2025 01:40:28 PM (9 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.

Props ellatrix, shailu25, ntsekouras.
Fixes #62755.

File:

-              r60978
+              r61029
+                )
         );
+        register_setting(
+                'reading',
+                'active_templates',
+                array(
+                        'type'         => 'object',
+                        // Do not set the default value to an empty array! For some reason
+                        // that will prevent the option from being set to an empty array.
+                        'show_in_rest' => array(
+                                'schema' => array(
+                                        'type'                 => 'object',
+                                        // Properties can be integers, strings, or false
+                                        // (deactivated).
+                                        'additionalProperties' => true,
+                                ),
+                        ),
+                        'label'        => 'Active Templates',
+                )
+        );
+}

Note: See TracChangeset for help on using the changeset viewer.