Changeset 56145

Timestamp:

07/06/2023 03:02:57 AM (2 years ago)

Author:

isabel_brison

Message:

Editor: update template titles in browse mode.

Adds more meaningful titles to templates in the browse mode template list.

Props ntsekouras, audrasjb.
Fixes #58713.

Location:

trunk

Files:

• src/wp-includes/block-template-utils.php (modified) (3 diffs)
• tests/phpunit/tests/block-template-utils.php (modified) (1 diff)

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

@@ -119 +119 @@
         ),
         'home'           => array(
-            'title'       => _x( 'Home', 'Template name' ),
-            'description' => __( 'Displays the latest posts as either the site homepage or a custom page defined under reading settings. If it exists, the Front Page template overrides this template when posts are shown on the front page.' ),
+            'title'       => _x( 'Blog Home', 'Template name' ),
+            'description' => __( 'Displays the latest posts as either the site homepage or as the "Posts page" as defined under reading settings. If it exists, the Front Page template overrides this template when posts are shown on the homepage.' ),
         ),
         'front-page'     => array(
             'title'       => _x( 'Front Page', 'Template name' ),
-            'description' => __( 'Displays your site\'s front page, whether it is set to display latest posts or a static page. The Front Page template takes precedence over all templates.' ),
+            'description' => __( 'Displays your site\'s homepage, whether it is set to display latest posts or a static page. The Front Page template takes precedence over all templates.' ),
         ),
         'singular'       => array(
-            'title'       => _x( 'Singular', 'Template name' ),
+            'title'       => _x( 'Single Entries', 'Template name' ),
             'description' => __( 'Displays any single entry, such as a post or a page. This template will serve as a fallback when a more specific template (e.g., Single Post, Page, or Attachment) cannot be found.' ),
         ),
         'single'         => array(
-            'title'       => _x( 'Single', 'Template name' ),
+            'title'       => _x( 'Single Posts', 'Template name' ),
             'description' => __( 'Displays single posts on your website unless a custom template has been applied to that post or a dedicated template exists.' ),
         ),
         'page'           => array(
-            'title'       => _x( 'Page', 'Template name' ),
+            'title'       => _x( 'Pages', 'Template name' ),
             'description' => __( 'Display all static pages unless a custom template has been applied or a dedicated template exists.' ),
         ),
         'archive'        => array(
-            'title'       => _x( 'Archive', 'Template name' ),
+            'title'       => _x( 'All Archives', 'Template name' ),
             'description' => __( 'Displays any archive, including posts by a single author, category, tag, taxonomy, custom post type, and date. This template will serve as a fallback when more specific templates (e.g., Category or Tag) cannot be found.' ),
         ),
         'author'         => array(
-            'title'       => _x( 'Author', 'Template name' ),
-            'description' => __( 'Displays a single author\'s post archive. This template will serve as a fallback when a more specific template (e.g., Author: Admin) cannot be found.' ),
+            'title'       => _x( 'Author Archives', 'Template name' ),
+            'description' => __( 'Displays a single author\'s post archive. This template will serve as a fallback when a more a specific template (e.g., Author: Admin) cannot be found.' ),
         ),
         'category'       => array(
-            'title'       => _x( 'Category', 'Template name' ),
-            'description' => __( 'Displays a post category archive. This template will serve as a fallback when a more specific template (e.g., Category: Recipes) cannot be found.' ),
+            'title'       => _x( 'Category Archives', 'Template name' ),
+            'description' => __( 'Displays a post category archive. This template will serve as a fallback when more specific template (e.g., Category: Recipes) cannot be found.' ),
         ),
         'taxonomy'       => array(
@@ -155 +155 @@
         ),
         'date'           => array(
-            'title'       => _x( 'Date', 'Template name' ),
+            'title'       => _x( 'Date Archives', 'Template name' ),
             'description' => __( 'Displays a post archive when a specific date is visited (e.g., example.com/2023/).' ),
         ),
         'tag'            => array(
-            'title'       => _x( 'Tag', 'Template name' ),
-            'description' => __( 'Displays a post tag archive. This template will serve as a fallback when a more specific template (e.g., Tag: Pizza) cannot be found.' ),
+            'title'       => _x( 'Tag Archives', 'Template name' ),
+            'description' => __( 'Displays a post tag archive. This template will serve as a fallback when more specific template (e.g., Tag: Pizza) cannot be found.' ),
         ),
         'attachment'     => array(
-            'title'       => __( 'Media' ),
+            'title'       => __( 'Attachment Pages' ),
             'description' => __( 'Displays when a visitor views the dedicated page that exists for any media attachment.' ),
         ),
         'search'         => array(
-            'title'       => _x( 'Search', 'Template name' ),
+            'title'       => _x( 'Search Results', 'Template name' ),
             'description' => __( 'Displays when a visitor performs a search on your website.' ),
         ),
@@ -175 +175 @@
         ),
         '404'            => array(
-            'title'       => _x( '404', 'Template name' ),
+            'title'       => _x( 'Page: 404', 'Template name' ),
             'description' => __( 'Displays when a visitor views a non-existent page, such as a dead link or a mistyped URL.' ),
         ),

trunk/tests/phpunit/tests/block-template-utils.php

@@ -136 +136 @@
         $this->assertSame( 'publish', $template->status );
         $this->assertSame( 'theme', $template->source );
-        $this->assertSame( 'Single', $template->title );
+        $this->assertSame( 'Single Posts', $template->title );
         $this->assertSame( 'Displays single posts on your website unless a custom template has been applied to that post or a dedicated template exists.', $template->description );
         $this->assertSame( 'wp_template', $template->type );