From 6aa3721dab38651e51e59e3c3812c7cd8d3641f7 Mon Sep 17 00:00:00 2001 From: Sergey Biryukov Date: Wed, 6 Sep 2023 00:44:29 +0000 Subject: [PATCH] Docs: Add a `@since` note for `add_new` labels change in `get_post_type_labels()`. Includes removing an obsolete recommendation to use a gettext context matching the post type for disambiguation, which would be redundant with the new labels, as they already include the type of content. Follow-up [14571], [56515]. See #47125. git-svn-id: https://develop.svn.wordpress.org/trunk@56519 602fd350-edb4-49c9-b593-d223f7449a82 --- src/wp-includes/post.php | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/wp-includes/post.php b/src/wp-includes/post.php index 34caabea0a8f4..93d6ce9ade6fd 100644 --- a/src/wp-includes/post.php +++ b/src/wp-includes/post.php @@ -1931,9 +1931,7 @@ function _post_type_meta_capabilities( $capabilities = null ) { * - `name` - General name for the post type, usually plural. The same and overridden * by `$post_type_object->label`. Default is 'Posts' / 'Pages'. * - `singular_name` - Name for one object of this post type. Default is 'Post' / 'Page'. - * - `add_new` - Default is 'Add New Type' for both hierarchical and non-hierarchical types. - * When internationalizing this string, please use a {@link https://developer.wordpress.org/plugins/internationalization/how-to-internationalize-your-plugin/#disambiguation-by-context gettext context} - * matching your post type. Example: `__( 'Add New Product', 'textdomain' );`. + * - `add_new` - Label for adding a new item. Default is 'Add New Post' / 'Add New Page'. * - `add_new_item` - Label for adding a new singular item. Default is 'Add New Post' / 'Add New Page'. * - `edit_item` - Label for editing a singular item. Default is 'Edit Post' / 'Edit Page'. * - `new_item` - Label for the new item page title. Default is 'New Post' / 'New Page'. @@ -1992,6 +1990,8 @@ function _post_type_meta_capabilities( $capabilities = null ) { * @since 5.7.0 Added the `filter_by_date` label. * @since 5.8.0 Added the `item_link` and `item_link_description` labels. * @since 6.3.0 Added the `item_trashed` label. + * @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. * * @access private *