Changeset 58377

Timestamp:

06/10/2024 11:20:52 PM (7 months ago)

Author:

peterwilsoncc

Message:

Editor: Add labels for template name display in site editor.

Add the label template_name to post types and taxonomies for use by the site editor to display on the templates/add new template screens to allow extenders to customize the display.

For post types the template name applies to templates for a singular pages with the default value "Single item: [singular name]".

For taxonomies the template name applies to templates for term archives with the default value "[singular name] Archives".

Props aljullu, audrasjb, ntsekouras, ellatrix, oglekler, rajinsharwar.
Fixes #60881.

Location:

trunk/src/wp-includes

Files:

• post.php (modified) (2 diffs)
• taxonomy.php (modified) (3 diffs)

trunk/src/wp-includes/post.php

@@ -2084 +2084 @@
  * @since 6.4.0 Changed default values for the `add_new` label to include the type of content.
  *              This matches `add_new_item` and provides more context for better accessibility.
+ * @since 6.6.0 Added the `template_name` label.
  *
  * @access private
@@ -2096 +2097 @@
 
     $labels = _get_custom_object_labels( $post_type_object, $nohier_vs_hier_defaults );
+
+    if ( ! isset( $post_type_object->labels->template_name ) && isset( $post_type_object->labels->singular_name ) ) {
+            /* translators: %s: Post type name. */
+            $labels->template_name = sprintf( __( 'Single item: %s' ), $post_type_object->labels->singular_name );
+    }
 
     $post_type = $post_type_object->name;

trunk/src/wp-includes/taxonomy.php

@@ -646 +646 @@
  * @since 5.9.0 Added the `name_field_description`, `slug_field_description`,
  *              `parent_field_description`, and `desc_field_description` labels.
+ * @since 6.6.0 Added the `template_name` label.
  *
  * @param WP_Taxonomy $tax Taxonomy object.
@@ -680 +681 @@
  *     @type string $add_new_item               Default 'Add New Tag'/'Add New Category'.
  *     @type string $new_item_name              Default 'New Tag Name'/'New Category Name'.
+ *     @type string $template_name              Default 'Tag Archives'/'Category Archives'.
  *     @type string $separate_items_with_commas This label is only used for non-hierarchical taxonomies. Default
  *                                              'Separate tags with commas', used in the meta box.
@@ -720 +722 @@
     $labels = _get_custom_object_labels( $tax, $nohier_vs_hier_defaults );
 
+    if ( ! isset( $tax->labels->template_name ) && isset( $labels->singular_name ) ) {
+        /* translators: %s: Taxonomy name. */
+        $labels->template_name = sprintf( _x( '%s Archives', 'taxonomy template name' ), $labels->singular_name );
+    }
+
     $taxonomy = $tax->name;