From 2320588aedd174c1ed8e03223482968117b7098a Mon Sep 17 00:00:00 2001 From: James Koster Date: Wed, 27 Oct 2021 14:12:26 +0100 Subject: [PATCH 1/7] Update and align template descriptions --- .../default-template-types.php | 32 +++++++++---------- 1 file changed, 16 insertions(+), 16 deletions(-) diff --git a/lib/full-site-editing/default-template-types.php b/lib/full-site-editing/default-template-types.php index 1a9c2b023dbe8..27bd665c0304d 100644 --- a/lib/full-site-editing/default-template-types.php +++ b/lib/full-site-editing/default-template-types.php @@ -15,67 +15,67 @@ function gutenberg_get_default_template_types() { $default_template_types = array( 'index' => array( 'title' => _x( 'Index', 'Template name', 'gutenberg' ), - 'description' => __( 'The default template used when no other template is available. This is a required template in WordPress.', 'gutenberg' ), + 'description' => __( 'Displays latest posts.', 'gutenberg' ), ), 'home' => array( 'title' => _x( 'Home', 'Template name', 'gutenberg' ), - 'description' => __( 'Template used for the main page that displays blog posts. This is the front page by default in WordPress. If a static front page is set, this is the template used for the page that contains the latest blog posts.', 'gutenberg' ), + 'description' => __( 'Displays latest posts when the homepage is set to display latest posts.', 'gutenberg' ), ), 'front-page' => array( 'title' => _x( 'Front Page', 'Template name', 'gutenberg' ), - 'description' => __( 'Template used to render the front page of the site, whether it displays blog posts or a static page. The front page template takes precedence over the "Home" template.', 'gutenberg' ), + 'description' => __( 'Displays when a user visits the site home page.', 'gutenberg' ), ), 'singular' => array( 'title' => _x( 'Singular', 'Template name', 'gutenberg' ), - 'description' => __( 'Template used for displaying single views of the content. This template is a fallback for the Single, Post, and Page templates, which take precedence when they exist.', 'gutenberg' ), + 'description' => __( 'Displays a single post or page.', 'gutenberg' ), ), 'single' => array( 'title' => _x( 'Single Post', 'Template name', 'gutenberg' ), - 'description' => __( 'Template used to display a single blog post.', 'gutenberg' ), + 'description' => __( 'Displays a single post.', 'gutenberg' ), ), 'page' => array( 'title' => _x( 'Page', 'Template name', 'gutenberg' ), - 'description' => __( 'Template used to display individual pages.', 'gutenberg' ), + 'description' => __( 'Displays individual pages.', 'gutenberg' ), ), 'archive' => array( 'title' => _x( 'Archive', 'Template name', 'gutenberg' ), - 'description' => __( 'The archive template displays multiple entries at once. It is used as a fallback for the Category, Author, and Date templates, which take precedence when they are available.', 'gutenberg' ), + 'description' => __( 'Displays post categories, tags, and other archives.', 'gutenberg' ), ), 'author' => array( 'title' => _x( 'Author', 'Template name', 'gutenberg' ), - 'description' => __( 'Archive template used to display a list of posts from a single author.', 'gutenberg' ), + 'description' => __( 'Displays latest posts written by a single author.', 'gutenberg' ), ), 'category' => array( 'title' => _x( 'Category', 'Template name', 'gutenberg' ), - 'description' => __( 'Archive template used to display a list of posts from the same category.', 'gutenberg' ), + 'description' => __( 'Displays latest posts from a single post category.', 'gutenberg' ), ), 'taxonomy' => array( 'title' => _x( 'Taxonomy', 'Template name', 'gutenberg' ), - 'description' => __( 'Archive template used to display a list of posts from the same taxonomy.', 'gutenberg' ), + 'description' => __( 'Displays latest posts from a single post taxonomy.', 'gutenberg' ), ), 'date' => array( 'title' => _x( 'Date', 'Template name', 'gutenberg' ), - 'description' => __( 'Archive template used to display a list of posts from a specific date.', 'gutenberg' ), + 'description' => __( 'Displays posts from a specific date.', 'gutenberg' ), ), 'tag' => array( 'title' => _x( 'Tag', 'Template name', 'gutenberg' ), - 'description' => __( 'Archive template used to display a list of posts with a given tag.', 'gutenberg' ), + 'description' => __( 'Displays latest posts from a single post tag.', 'gutenberg' ), ), 'attachment' => array( 'title' => __( 'Media', 'gutenberg' ), - 'description' => __( 'Template used to display individual media items or attachments.', 'gutenberg' ), + 'description' => __( 'Displays individual media items or attachments.', 'gutenberg' ), ), 'search' => array( 'title' => _x( 'Search', 'Template name', 'gutenberg' ), - 'description' => __( 'Template used to display search results.', 'gutenberg' ), + 'description' => __( 'Displays search results.', 'gutenberg' ), ), 'privacy-policy' => array( 'title' => __( 'Privacy Policy', 'gutenberg' ), - 'description' => '', + 'description' => 'Displays the privacy policy page.', ), '404' => array( 'title' => _x( '404', 'Template name', 'gutenberg' ), - 'description' => __( 'Template shown when no content is found.', 'gutenberg' ), + 'description' => __( 'Displays when no content is found.', 'gutenberg' ), ), ); From 5e28d08a4a7a2758ec23a5c2d93c2bab0a218e51 Mon Sep 17 00:00:00 2001 From: James Koster Date: Wed, 27 Oct 2021 14:29:33 +0100 Subject: [PATCH 2/7] More refinements --- lib/full-site-editing/default-template-types.php | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/lib/full-site-editing/default-template-types.php b/lib/full-site-editing/default-template-types.php index 27bd665c0304d..9577876bd1d63 100644 --- a/lib/full-site-editing/default-template-types.php +++ b/lib/full-site-editing/default-template-types.php @@ -19,7 +19,7 @@ function gutenberg_get_default_template_types() { ), 'home' => array( 'title' => _x( 'Home', 'Template name', 'gutenberg' ), - 'description' => __( 'Displays latest posts when the homepage is set to display latest posts.', 'gutenberg' ), + 'description' => __( 'Displays latest posts. Used by the site home page when it is configured to display latest posts, or by the posts page when it is configured to display a static page.', 'gutenberg' ), ), 'front-page' => array( 'title' => _x( 'Front Page', 'Template name', 'gutenberg' ), @@ -35,7 +35,7 @@ function gutenberg_get_default_template_types() { ), 'page' => array( 'title' => _x( 'Page', 'Template name', 'gutenberg' ), - 'description' => __( 'Displays individual pages.', 'gutenberg' ), + 'description' => __( 'Displays a single page.', 'gutenberg' ), ), 'archive' => array( 'title' => _x( 'Archive', 'Template name', 'gutenberg' ), From 5b622d390d753b92fc64838934221fb5fbd2df11 Mon Sep 17 00:00:00 2001 From: James Koster Date: Tue, 2 Nov 2021 11:03:01 +0000 Subject: [PATCH 3/7] Update descriptions --- lib/full-site-editing/default-template-types.php | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/lib/full-site-editing/default-template-types.php b/lib/full-site-editing/default-template-types.php index 9577876bd1d63..73cd72df309d1 100644 --- a/lib/full-site-editing/default-template-types.php +++ b/lib/full-site-editing/default-template-types.php @@ -23,7 +23,7 @@ function gutenberg_get_default_template_types() { ), 'front-page' => array( 'title' => _x( 'Front Page', 'Template name', 'gutenberg' ), - 'description' => __( 'Displays when a user visits the site home page.', 'gutenberg' ), + 'description' => __( 'Displays as the site\'s home page.', 'gutenberg' ), ), 'singular' => array( 'title' => _x( 'Singular', 'Template name', 'gutenberg' ), @@ -47,7 +47,7 @@ function gutenberg_get_default_template_types() { ), 'category' => array( 'title' => _x( 'Category', 'Template name', 'gutenberg' ), - 'description' => __( 'Displays latest posts from a single post category.', 'gutenberg' ), + 'description' => __( 'Displays latest posts in single post category.', 'gutenberg' ), ), 'taxonomy' => array( 'title' => _x( 'Taxonomy', 'Template name', 'gutenberg' ), @@ -59,7 +59,7 @@ function gutenberg_get_default_template_types() { ), 'tag' => array( 'title' => _x( 'Tag', 'Template name', 'gutenberg' ), - 'description' => __( 'Displays latest posts from a single post tag.', 'gutenberg' ), + 'description' => __( 'Displays latest posts with single post tag.', 'gutenberg' ), ), 'attachment' => array( 'title' => __( 'Media', 'gutenberg' ), From aa84ff2dd11340063a956e4787ed6e5a2b81dd6f Mon Sep 17 00:00:00 2001 From: James Koster Date: Tue, 2 Nov 2021 17:46:25 +0000 Subject: [PATCH 4/7] More updates --- lib/full-site-editing/default-template-types.php | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/lib/full-site-editing/default-template-types.php b/lib/full-site-editing/default-template-types.php index 73cd72df309d1..cb5b795f69755 100644 --- a/lib/full-site-editing/default-template-types.php +++ b/lib/full-site-editing/default-template-types.php @@ -14,12 +14,12 @@ function gutenberg_get_default_template_types() { $default_template_types = array( 'index' => array( - 'title' => _x( 'Index', 'Template name', 'gutenberg' ), - 'description' => __( 'Displays latest posts.', 'gutenberg' ), + 'title' => _x( 'Posts', 'Template name', 'gutenberg' ), + 'description' => __( 'Displays posts.', 'gutenberg' ), ), 'home' => array( - 'title' => _x( 'Home', 'Template name', 'gutenberg' ), - 'description' => __( 'Displays latest posts. Used by the site home page when it is configured to display latest posts, or by the posts page when it is configured to display a static page.', 'gutenberg' ), + 'title' => _x( 'Latest posts', 'Template name', 'gutenberg' ), + 'description' => __( 'Displays as the site\'s home page when configured to display latest posts, or as the Posts page when a static home page it set.', 'gutenberg' ), ), 'front-page' => array( 'title' => _x( 'Front Page', 'Template name', 'gutenberg' ), From 3321dc0763b0bc4aba21b56768251b9d794ef80e Mon Sep 17 00:00:00 2001 From: James Koster Date: Tue, 2 Nov 2021 17:54:12 +0000 Subject: [PATCH 5/7] Optimise! --- lib/full-site-editing/default-template-types.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/lib/full-site-editing/default-template-types.php b/lib/full-site-editing/default-template-types.php index cb5b795f69755..e292877b27975 100644 --- a/lib/full-site-editing/default-template-types.php +++ b/lib/full-site-editing/default-template-types.php @@ -19,7 +19,7 @@ function gutenberg_get_default_template_types() { ), 'home' => array( 'title' => _x( 'Latest posts', 'Template name', 'gutenberg' ), - 'description' => __( 'Displays as the site\'s home page when configured to display latest posts, or as the Posts page when a static home page it set.', 'gutenberg' ), + 'description' => __( 'Displays as the site\'s home page, or as the Posts page when a static home page it set.', 'gutenberg' ), ), 'front-page' => array( 'title' => _x( 'Front Page', 'Template name', 'gutenberg' ), From 2166bf58b361d52ade56eb729c7aac4b1327d20f Mon Sep 17 00:00:00 2001 From: James Koster Date: Fri, 5 Nov 2021 11:11:31 +0000 Subject: [PATCH 6/7] Localize privacy policy description Co-authored-by: Carolina Nymark --- lib/full-site-editing/default-template-types.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/lib/full-site-editing/default-template-types.php b/lib/full-site-editing/default-template-types.php index e292877b27975..02cadfdce5d5e 100644 --- a/lib/full-site-editing/default-template-types.php +++ b/lib/full-site-editing/default-template-types.php @@ -71,7 +71,7 @@ function gutenberg_get_default_template_types() { ), 'privacy-policy' => array( 'title' => __( 'Privacy Policy', 'gutenberg' ), - 'description' => 'Displays the privacy policy page.', + 'description' => __( 'Displays the privacy policy page.', 'gutenberg' ), ), '404' => array( 'title' => _x( '404', 'Template name', 'gutenberg' ), From b4d539bba62b5883307b75e77a625aeb33ef7f65 Mon Sep 17 00:00:00 2001 From: James Koster Date: Mon, 29 Nov 2021 14:31:32 +0000 Subject: [PATCH 7/7] Descriptions --- .../wordpress-5.9/block-template-utils.php | 30 +++++++++---------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/lib/compat/wordpress-5.9/block-template-utils.php b/lib/compat/wordpress-5.9/block-template-utils.php index b8725bdfa1da7..499c5dcadcd04 100644 --- a/lib/compat/wordpress-5.9/block-template-utils.php +++ b/lib/compat/wordpress-5.9/block-template-utils.php @@ -111,55 +111,55 @@ function get_default_block_template_types() { $default_template_types = array( 'index' => array( 'title' => _x( 'Index', 'Template name', 'gutenberg' ), - 'description' => __( 'The default template used when no other template is available. This is a required template in WordPress.', 'gutenberg' ), + 'description' => __( 'Displays posts.', 'gutenberg' ), ), 'home' => array( 'title' => _x( 'Home', 'Template name', 'gutenberg' ), - 'description' => __( 'Template used for the main page that displays blog posts. This is the front page by default in WordPress. If a static front page is set, this is the template used for the page that contains the latest blog posts.', 'gutenberg' ), + 'description' => __( 'Displays as the site\'s home page, or as the Posts page when a static home page it set.', 'gutenberg' ), ), 'front-page' => array( 'title' => _x( 'Front Page', 'Template name', 'gutenberg' ), - 'description' => __( 'Template used to render the front page of the site, whether it displays blog posts or a static page. The front page template takes precedence over the "Home" template.', 'gutenberg' ), + 'description' => __( 'Displays as the site\'s home page.', 'gutenberg' ), ), 'singular' => array( 'title' => _x( 'Singular', 'Template name', 'gutenberg' ), - 'description' => __( 'Template used for displaying single views of the content. This template is a fallback for the Single, Post, and Page templates, which take precedence when they exist.', 'gutenberg' ), + 'description' => __( 'Displays a single post or page.', 'gutenberg' ), ), 'single' => array( 'title' => _x( 'Single Post', 'Template name', 'gutenberg' ), - 'description' => __( 'Template used to display a single blog post.', 'gutenberg' ), + 'description' => __( 'Displays a single post.', 'gutenberg' ), ), 'page' => array( 'title' => _x( 'Page', 'Template name', 'gutenberg' ), - 'description' => __( 'Template used to display individual pages.', 'gutenberg' ), + 'description' => __( 'Displays a single page.', 'gutenberg' ), ), 'archive' => array( 'title' => _x( 'Archive', 'Template name', 'gutenberg' ), - 'description' => __( 'The archive template displays multiple entries at once. It is used as a fallback for the Category, Author, and Date templates, which take precedence when they are available.', 'gutenberg' ), + 'description' => __( 'Displays post categories, tags, and other archives.', 'gutenberg' ), ), 'author' => array( 'title' => _x( 'Author', 'Template name', 'gutenberg' ), - 'description' => __( 'Archive template used to display a list of posts from a single author.', 'gutenberg' ), + 'description' => __( 'Displays latest posts written by a single author.', 'gutenberg' ), ), 'category' => array( 'title' => _x( 'Category', 'Template name', 'gutenberg' ), - 'description' => __( 'Archive template used to display a list of posts from the same category.', 'gutenberg' ), + 'description' => __( 'Displays latest posts in single post category.', 'gutenberg' ), ), 'taxonomy' => array( 'title' => _x( 'Taxonomy', 'Template name', 'gutenberg' ), - 'description' => __( 'Archive template used to display a list of posts from the same taxonomy.', 'gutenberg' ), + 'description' => __( 'Displays latest posts from a single post taxonomy.', 'gutenberg' ), ), 'date' => array( 'title' => _x( 'Date', 'Template name', 'gutenberg' ), - 'description' => __( 'Archive template used to display a list of posts from a specific date.', 'gutenberg' ), + 'description' => __( 'Displays posts from a specific date.', 'gutenberg' ), ), 'tag' => array( 'title' => _x( 'Tag', 'Template name', 'gutenberg' ), - 'description' => __( 'Archive template used to display a list of posts with a given tag.', 'gutenberg' ), + 'description' => __( 'Displays latest posts with single post tag.', 'gutenberg' ), ), 'attachment' => array( 'title' => __( 'Media', 'gutenberg' ), - 'description' => __( 'Template used to display individual media items or attachments.', 'gutenberg' ), + 'description' => __( 'Displays individual media items or attachments.', 'gutenberg' ), ), 'search' => array( 'title' => _x( 'Search', 'Template name', 'gutenberg' ), @@ -167,11 +167,11 @@ function get_default_block_template_types() { ), 'privacy-policy' => array( 'title' => __( 'Privacy Policy', 'gutenberg' ), - 'description' => '', + 'description' => __( 'Displays the privacy policy page.', 'gutenberg' ), ), '404' => array( 'title' => _x( '404', 'Template name', 'gutenberg' ), - 'description' => __( 'Template shown when no content is found.', 'gutenberg' ), + 'description' => __( 'Displays when no content is found.', 'gutenberg' ), ), );