From 230a23206d881380251b37919cd697c5ee957923 Mon Sep 17 00:00:00 2001 From: hellofromTonya Date: Thu, 9 Mar 2023 16:32:19 +0000 Subject: [PATCH] Editor: Add more details to template descriptions. The template descriptions in `get_default_block_template_types()` are updated to add more details. Why? These descriptions are now more prominent in 6.2 to provide a better UX experience with more helpful information. References: * [https://github.com/WordPress/gutenberg/pull/48934 Gutenberg PR 48934] Follow-up to [54761], [54104], [54269], [53129], [52331], [52062]. Props ntsekouras, andrewserong, bph, davidbaumwald, greenshady, glendaviesnz, hellofromTonya, jameskoster, mamaduka, peterwilsoncc, sabernhardt, SergeyBiryukov. Fixes #57892. Built from https://develop.svn.wordpress.org/trunk@55500 git-svn-id: http://core.svn.wordpress.org/trunk@55032 1a063a9b-81f0-0310-95a4-ce76da25c4cd --- wp-includes/block-template-utils.php | 36 +++++++++++++++------------- wp-includes/version.php | 2 +- 2 files changed, 21 insertions(+), 17 deletions(-) diff --git a/wp-includes/block-template-utils.php b/wp-includes/block-template-utils.php index 39961780e3..4f9990547c 100644 --- a/wp-includes/block-template-utils.php +++ b/wp-includes/block-template-utils.php @@ -115,67 +115,71 @@ function get_default_block_template_types() { $default_template_types = array( 'index' => array( 'title' => _x( 'Index', 'Template name' ), - 'description' => __( 'Displays posts.' ), + 'description' => __( 'Used as a fallback template for all pages when a more specific template is not defined.' ), ), 'home' => array( 'title' => _x( 'Home', 'Template name' ), - 'description' => __( 'Displays posts on the homepage, or on the Posts page if a static homepage is set.' ), + '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.' ), ), 'front-page' => array( 'title' => _x( 'Front Page', 'Template name' ), - 'description' => __( 'Displays the homepage.' ), + '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.' ), ), 'singular' => array( 'title' => _x( 'Singular', 'Template name' ), - 'description' => __( 'Displays a single post or page.' ), + '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' ), - 'description' => __( 'The default template for displaying any single post or attachment.' ), + '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' ), - 'description' => __( 'Displays a single page.' ), + 'description' => __( 'Display all static pages unless a custom template has been applied or a dedicated template exists.' ), ), 'archive' => array( 'title' => _x( 'Archive', 'Template name' ), - 'description' => __( 'Displays posts by a category, tag, author, or date.' ), + '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 latest posts written by a single author.' ), + '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.' ), ), 'category' => array( 'title' => _x( 'Category', 'Template name' ), - 'description' => __( 'Displays latest posts from a single post category.' ), + '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.' ), ), 'taxonomy' => array( 'title' => _x( 'Taxonomy', 'Template name' ), - 'description' => __( 'Displays latest posts from a single post taxonomy.' ), + 'description' => __( 'Displays a custom taxonomy archive. Like categories and tags, taxonomies have terms which you use to classify things. For example: a taxonomy named "Art" can have multiple terms, such as "Modern" and "18th Century." This template will serve as a fallback when a more specific template (e.g, Taxonomy: Art) cannot be found.' ), ), 'date' => array( 'title' => _x( 'Date', 'Template name' ), - 'description' => __( 'Displays posts from a specific date.' ), + /* translators: %s: Example URL. */ + 'description' => sprintf( + __( 'Displays a post archive when a specific date is visited (e.g., %s).' ), + __( 'example.com/2023/' ) + ), ), 'tag' => array( 'title' => _x( 'Tag', 'Template name' ), - 'description' => __( 'Displays latest posts with a single post tag.' ), + '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.' ), ), 'attachment' => array( 'title' => __( 'Media' ), - 'description' => __( 'Displays individual media items or attachments.' ), + 'description' => __( 'Displays when a visitor views the dedicated page that exists for any media attachment.' ), ), 'search' => array( 'title' => _x( 'Search', 'Template name' ), - 'description' => __( 'Displays search results.' ), + 'description' => __( 'Displays when a visitor performs a search on your website.' ), ), 'privacy-policy' => array( 'title' => __( 'Privacy Policy' ), - 'description' => __( 'Displays the privacy policy page.' ), + 'description' => __( 'Displays your site\'s Privacy Policy page.' ), ), '404' => array( 'title' => _x( '404', 'Template name' ), - 'description' => __( 'Displays when no content is found.' ), + 'description' => __( 'Displays when a visitor views a non-existent page, such as a dead link or a mistyped URL.' ), ), ); diff --git a/wp-includes/version.php b/wp-includes/version.php index 6dd66eb7e8..57817d63da 100644 --- a/wp-includes/version.php +++ b/wp-includes/version.php @@ -16,7 +16,7 @@ * * @global string $wp_version */ -$wp_version = '6.2-beta5-55499'; +$wp_version = '6.2-beta5-55500'; /** * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.