Changeset 52163 for trunk/src/wp-includes/taxonomy.php

Timestamp:

11/15/2021 04:43:29 PM (3 years ago)

Author:

SergeyBiryukov

Message:

Taxonomy: Clarify the taxonomy labels for customizing the field descriptions on Edit Tags screen:

• Update the label names to make it clear that these descriptions are not for the term name or slug itself, but for the Name, Slug, Parent, and Description fields:
  • name_field_description
  • slug_field_description
  • parent_field_description
  • desc_field_description
• Update the array structure to make it clear that the default values for these labels are the same for both hierarchical and non-hierarchical taxonomies, with the exception of parent_field_description.
• Add documentation and a @since note for the new labels.

Follow-up to [52094].

Fixes #43060.

File:

• trunk/src/wp-includes/taxonomy.php (modified) (4 diffs)

trunk/src/wp-includes/taxonomy.php

@@ -590 +590 @@
  * @since 5.7.0 Added the `filter_by_item` label.
  * @since 5.8.0 Added the `item_link` and `item_link_description` labels.
+ * @since 5.9.0 Added the `name_field_description`, `slug_field_description`,
+ *              `parent_field_description`, and `desc_field_description` labels.
  *
  * @param WP_Taxonomy $tax Taxonomy object.
@@ -606 +608 @@
  *                                              'Parent Category'.
  *     @type string $parent_item_colon          The same as `parent_item`, but with colon `:` in the end.
+ *     @type string $name_field_description     Description for the Name field on Edit Tags screen.
+ *                                              Default 'The name is how it appears on your site'.
+ *     @type string $slug_field_description     Description for the Slug field on Edit Tags screen.
+ *                                              Default 'The “slug” is the URL-friendly version
+ *                                              of the name. It is usually all lowercase and contains
+ *                                              only letters, numbers, and hyphens'.
+ *     @type string $parent_field_description   Description for the Parent field on Edit Tags screen.
+ *                                              Default 'Assign a parent term to create a hierarchy.
+ *                                              The term Jazz, for example, would be the parent
+ *                                              of Bebop and Big Band'.
+ *     @type string $desc_field_description     Description for the Description field on Edit Tags screen.
+ *                                              Default 'The description is not prominent by default;
+ *                                              however, some themes may show it'.
  *     @type string $edit_item                  Default 'Edit Tag'/'Edit Category'.
  *     @type string $view_item                  Default 'View Tag'/'View Category'.
@@ -645 +660 @@
     }
 
+    $name_field_description   = __( 'The name is how it appears on your site.' );
+    $slug_field_description   = __( 'The “slug” is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens.' );
+    $parent_field_description = __( 'Assign a parent term to create a hierarchy. The term Jazz, for example, would be the parent of Bebop and Big Band.' );
+    $desc_field_description   = __( 'The description is not prominent by default; however, some themes may show it.' );
+
     $nohier_vs_hier_defaults = array(
         'name'                       => array( _x( 'Tags', 'taxonomy general name' ), _x( 'Categories', 'taxonomy general name' ) ),
-        'name_description'           => array( __( 'The name is how it appears on your site.' ), __( 'The name is how it appears on your site.' ) ),
         'singular_name'              => array( _x( 'Tag', 'taxonomy singular name' ), _x( 'Category', 'taxonomy singular name' ) ),
         'search_items'               => array( __( 'Search Tags' ), __( 'Search Categories' ) ),
@@ -654 +673 @@
         'parent_item'                => array( null, __( 'Parent Category' ) ),
         'parent_item_colon'          => array( null, __( 'Parent Category:' ) ),
-        'parent_description'         => array( null, __( 'Assign a parent term to create a hierarchy. The term Jazz, for example, would be the parent of Bebop and Big Band.' ) ),
-        'slug_description'           => array( __( 'The “slug” is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens.' ), __( 'The “slug” is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens.' ) ),
-        'description_description'    => array( __( 'The description is not prominent by default; however, some themes may show it.' ), __( 'The description is not prominent by default; however, some themes may show it.' ) ),
+        'name_field_description'     => array( $name_field_description, $name_field_description ),
+        'slug_field_description'     => array( $slug_field_description, $slug_field_description ),
+        'parent_field_description'   => array( null, $parent_field_description ),
+        'desc_field_description'     => array( $desc_field_description, $desc_field_description ),
         'edit_item'                  => array( __( 'Edit Tag' ), __( 'Edit Category' ) ),
         'view_item'                  => array( __( 'View Tag' ), __( 'View Category' ) ),