Changeset 53058 for trunk/src/wp-includes/class-wp-taxonomy.php

Timestamp:

04/04/2022 03:48:08 AM (3 years ago)

Author:

peterwilsoncc

Message:

Posts, Post Types; Taxonomy: Translate default labels once.

Improve the translation of post type and taxonomy labels by caching the translations during runtime. To account for internationalisation plugins, the runtime cache is cleared as the post types/taxonomies are reinitiated on change_local hook.

The same property and methods are added to both WP_Post_Type and WP_Taxonomy:

• $default_labels: for storing the translated strings at runtime
• get_default_labels(): for getting the default labels, these are translated on the first run and stored in the new property.
• reset_default_labels(): to clear the runtime cache and force a re-translation of the default labels

Props Chouby, nacin, SergeyBiryukov, Rarst, chriscct7, ocean90, audrasjb, costdev.
Fixes #26746.

File:

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

trunk/src/wp-includes/class-wp-taxonomy.php

@@ -42 +42 @@
      */
     public $labels;
+
+    /**
+     * Default labels.
+     *
+     * @since 6.0.0
+     * @var (string|null)[][] $default_labels
+     */
+    protected static $default_labels = array();
 
     /**
@@ -563 +571 @@
         return $this->rest_controller;
     }
+
+    /**
+     * Returns the default labels for taxonomies.
+     *
+     * @since 6.0.0
+     *
+     * @return (string|null)[][] The default labels for taxonomies.
+     */
+    public static function get_default_labels() {
+        if ( ! empty( self::$default_labels ) ) {
+            return self::$default_labels;
+        }
+
+        $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.' );
+
+        self::$default_labels = array(
+            'name'                       => array( _x( 'Tags', 'taxonomy general name' ), _x( 'Categories', 'taxonomy general name' ) ),
+            'singular_name'              => array( _x( 'Tag', 'taxonomy singular name' ), _x( 'Category', 'taxonomy singular name' ) ),
+            'search_items'               => array( __( 'Search Tags' ), __( 'Search Categories' ) ),
+            'popular_items'              => array( __( 'Popular Tags' ), null ),
+            'all_items'                  => array( __( 'All Tags' ), __( 'All Categories' ) ),
+            'parent_item'                => array( null, __( 'Parent Category' ) ),
+            'parent_item_colon'          => array( null, __( 'Parent Category:' ) ),
+            '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' ) ),
+            'update_item'                => array( __( 'Update Tag' ), __( 'Update Category' ) ),
+            'add_new_item'               => array( __( 'Add New Tag' ), __( 'Add New Category' ) ),
+            'new_item_name'              => array( __( 'New Tag Name' ), __( 'New Category Name' ) ),
+            'separate_items_with_commas' => array( __( 'Separate tags with commas' ), null ),
+            'add_or_remove_items'        => array( __( 'Add or remove tags' ), null ),
+            'choose_from_most_used'      => array( __( 'Choose from the most used tags' ), null ),
+            'not_found'                  => array( __( 'No tags found.' ), __( 'No categories found.' ) ),
+            'no_terms'                   => array( __( 'No tags' ), __( 'No categories' ) ),
+            'filter_by_item'             => array( null, __( 'Filter by category' ) ),
+            'items_list_navigation'      => array( __( 'Tags list navigation' ), __( 'Categories list navigation' ) ),
+            'items_list'                 => array( __( 'Tags list' ), __( 'Categories list' ) ),
+            /* translators: Tab heading when selecting from the most used terms. */
+            'most_used'                  => array( _x( 'Most Used', 'tags' ), _x( 'Most Used', 'categories' ) ),
+            'back_to_items'              => array( __( '← Go to Tags' ), __( '← Go to Categories' ) ),
+            'item_link'                  => array(
+                _x( 'Tag Link', 'navigation link block title' ),
+                _x( 'Category Link', 'navigation link block title' ),
+            ),
+            'item_link_description'      => array(
+                _x( 'A link to a tag.', 'navigation link block description' ),
+                _x( 'A link to a category.', 'navigation link block description' ),
+            ),
+        );
+
+        return self::$default_labels;
+    }
+
+    /**
+     * Resets the cache for the default labels.
+     *
+     * @since 6.0.0
+     */
+    public static function reset_default_labels() {
+        self::$default_labels = array();
+    }
 }