WordPress.org
Get WordPress

Make WordPress Core

Ticket #43060: 43060.1.diff

File 43060.1.diff, 6.6 KB (added by audrasjb, 3 years ago)

Taxonomy: Add new labels to register_taxonomy() to allow developers to override the description of each field.

  • src/wp-admin/edit-tag-form.php 

    diff --git a/src/wp-admin/edit-tag-form.php b/src/wp-admin/edit-tag-form.php
index 3752b8f52c..0c6e1994b9 100644
    a b if ( isset( $tag->name ) ) { 
    146146                <tr class="form-field form-required term-name-wrap">
    147147                        <th scope="row"><label for="name"><?php _ex( 'Name', 'term name' ); ?></label></th>
    148148                        <td><input name="name" id="name" type="text" value="<?php echo $tag_name_value; ?>" size="40" aria-required="true" />
    149                         <p class="description"><?php _e( 'The name is how it appears on your site.' ); ?></p></td>
     149                        <p class="description"><?php echo $tax->labels->name_description; ?></p></td>
    150150                </tr>
    151151<?php if ( ! global_terms_enabled() ) { ?>
    152152                <tr class="form-field term-slug-wrap">
    … … if ( isset( $tag->name ) ) { 
    168168                        $slug = isset( $tag->slug ) ? apply_filters( 'editable_slug', $tag->slug, $tag ) : '';
    169169                        ?>
    170170                        <td><input name="slug" id="slug" type="text" value="<?php echo esc_attr( $slug ); ?>" size="40" />
    171                         <p class="description"><?php _e( 'The &#8220;slug&#8221; is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens.' ); ?></p></td>
     171                        <p class="description"><?php echo $tax->labels->slug_description; ?></p></td>
    172172                </tr>
    173173<?php } ?>
    174174<?php if ( is_taxonomy_hierarchical( $taxonomy ) ) : ?>
    … … if ( isset( $tag->name ) ) { 
    195195                                <?php if ( 'category' === $taxonomy ) : ?>
    196196                                        <p class="description"><?php _e( 'Categories, unlike tags, can have a hierarchy. You might have a Jazz category, and under that have children categories for Bebop and Big Band. Totally optional.' ); ?></p>
    197197                                <?php else : ?>
    198                                         <p class="description"><?php _e( 'Assign a parent term to create a hierarchy. The term Jazz, for example, would be the parent of Bebop and Big Band.' ); ?></p>
     198                                        <p class="description"><?php echo $tax->labels->parent_description; ?></p>
    199199                                <?php endif; ?>
    200200                        </td>
    201201                </tr>
    … … if ( isset( $tag->name ) ) { 
    203203                <tr class="form-field term-description-wrap">
    204204                        <th scope="row"><label for="description"><?php _e( 'Description' ); ?></label></th>
    205205                        <td><textarea name="description" id="description" rows="5" cols="50" class="large-text"><?php echo $tag->description; // textarea_escaped ?></textarea>
    206                         <p class="description"><?php _e( 'The description is not prominent by default; however, some themes may show it.' ); ?></p></td>
     206                        <p class="description"><?php echo $tax->labels->description_description; ?></p></td>
    207207                </tr>
    208208                <?php
    209209                // Back compat hooks.

  • src/wp-admin/edit-tags.php 

    diff --git a/src/wp-admin/edit-tags.php b/src/wp-admin/edit-tags.php
index f95eba68c5..dc3440043d 100644
    a b if ( $can_edit_terms ) { 
    454454<div class="form-field form-required term-name-wrap">
    455455        <label for="tag-name"><?php _ex( 'Name', 'term name' ); ?></label>
    456456        <input name="tag-name" id="tag-name" type="text" value="" size="40" aria-required="true" />
    457         <p><?php _e( 'The name is how it appears on your site.' ); ?></p>
     457        <p><?php echo $tax->labels->name_description; ?></p>
    458458</div>
    459459        <?php if ( ! global_terms_enabled() ) : ?>
    460460<div class="form-field term-slug-wrap">
    461461        <label for="tag-slug"><?php _e( 'Slug' ); ?></label>
    462462        <input name="slug" id="tag-slug" type="text" value="" size="40" />
    463         <p><?php _e( 'The &#8220;slug&#8221; is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens.' ); ?></p>
     463        <p><?php echo $tax->labels->slug_description; ?></p>
    464464</div>
    465465<?php endif; // global_terms_enabled() ?>
    466466        <?php if ( is_taxonomy_hierarchical( $taxonomy ) ) : ?>
    … … if ( $can_edit_terms ) { 
    505505                <?php if ( 'category' === $taxonomy ) : ?>
    506506                <p><?php _e( 'Categories, unlike tags, can have a hierarchy. You might have a Jazz category, and under that have children categories for Bebop and Big Band. Totally optional.' ); ?></p>
    507507        <?php else : ?>
    508                 <p><?php _e( 'Assign a parent term to create a hierarchy. The term Jazz, for example, would be the parent of Bebop and Big Band.' ); ?></p>
     508                <p><?php echo $tax->labels->parent_description; ?></p>
    509509        <?php endif; ?>
    510510</div>
    511511        <?php endif; // is_taxonomy_hierarchical() ?>
    512512<div class="form-field term-description-wrap">
    513513        <label for="tag-description"><?php _e( 'Description' ); ?></label>
    514514        <textarea name="description" id="tag-description" rows="5" cols="40"></textarea>
    515         <p><?php _e( 'The description is not prominent by default; however, some themes may show it.' ); ?></p>
     515        <p><?php echo $tax->labels->description_description; ?></p>
    516516</div>
    517517
    518518        <?php

  • src/wp-includes/taxonomy.php 

    diff --git a/src/wp-includes/taxonomy.php b/src/wp-includes/taxonomy.php
index 104da64a87..a8cd679723 100644
    a b function get_taxonomy_labels( $tax ) { 
    615615
    616616        $nohier_vs_hier_defaults = array(
    617617                'name'                       => array( _x( 'Tags', 'taxonomy general name' ), _x( 'Categories', 'taxonomy general name' ) ),
     618                'name_description'           => array( __( 'The name is how it appears on your site.' ), __( 'The name is how it appears on your site.' ) ),
    618619                'singular_name'              => array( _x( 'Tag', 'taxonomy singular name' ), _x( 'Category', 'taxonomy singular name' ) ),
    619620                'search_items'               => array( __( 'Search Tags' ), __( 'Search Categories' ) ),
    620621                'popular_items'              => array( __( 'Popular Tags' ), null ),
    621622                'all_items'                  => array( __( 'All Tags' ), __( 'All Categories' ) ),
    622623                'parent_item'                => array( null, __( 'Parent Category' ) ),
    623624                'parent_item_colon'          => array( null, __( 'Parent Category:' ) ),
     625                '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.' ) ),
     626                'slug_description'           => array( __( 'The &#8220;slug&#8221; is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens.' ), __( 'The &#8220;slug&#8221; is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens.' )),
     627                '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.' )),
    624628                'edit_item'                  => array( __( 'Edit Tag' ), __( 'Edit Category' ) ),
    625629                'view_item'                  => array( __( 'View Tag' ), __( 'View Category' ) ),
    626630                'update_item'                => array( __( 'Update Tag' ), __( 'Update Category' ) ),