[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

title

Body

[close]

/wp-admin/ -> edit-tag-form.php (source)

   1  <?php
   2  /**
   3   * Edit tag form for inclusion in administration panels.
   4   *
   5   * @package WordPress
   6   * @subpackage Administration
   7   */
   8  
   9  // don't load directly
  10  if ( ! defined( 'ABSPATH' ) ) {
  11      die( '-1' );
  12  }
  13  
  14  // Back compat hooks
  15  if ( 'category' == $taxonomy ) {
  16      /**
  17       * Fires before the Edit Category form.
  18       *
  19       * @since 2.1.0
  20       * @deprecated 3.0.0 Use {@see '{$taxonomy}_pre_edit_form'} instead.
  21       *
  22       * @param WP_Term $tag Current category term object.
  23       */
  24      do_action_deprecated( 'edit_category_form_pre', array( $tag ), '3.0.0', '{$taxonomy}_pre_edit_form' );
  25  } elseif ( 'link_category' == $taxonomy ) {
  26      /**
  27       * Fires before the Edit Link Category form.
  28       *
  29       * @since 2.3.0
  30       * @deprecated 3.0.0 Use {@see '{$taxonomy}_pre_edit_form'} instead.
  31       *
  32       * @param WP_Term $tag Current link category term object.
  33       */
  34      do_action_deprecated( 'edit_link_category_form_pre', array( $tag ), '3.0.0', '{$taxonomy}_pre_edit_form' );
  35  } else {
  36      /**
  37       * Fires before the Edit Tag form.
  38       *
  39       * @since 2.5.0
  40       * @deprecated 3.0.0 Use {@see '{$taxonomy}_pre_edit_form'} instead.
  41       *
  42       * @param WP_Term $tag Current tag term object.
  43       */
  44      do_action_deprecated( 'edit_tag_form_pre', array( $tag ), '3.0.0', '{$taxonomy}_pre_edit_form' );
  45  }
  46  
  47  /**
  48   * Use with caution, see https://developer.wordpress.org/reference/functions/wp_reset_vars/
  49   */
  50  wp_reset_vars( array( 'wp_http_referer' ) );
  51  
  52  $wp_http_referer = remove_query_arg( array( 'action', 'message', 'tag_ID' ), $wp_http_referer );
  53  
  54  /** Also used by Edit Tags */
  55  require_once ( ABSPATH . 'wp-admin/includes/edit-tag-messages.php' );
  56  
  57  /**
  58   * Fires before the Edit Term form for all taxonomies.
  59   *
  60   * The dynamic portion of the hook name, `$taxonomy`, refers to
  61   * the taxonomy slug.
  62   *
  63   * @since 3.0.0
  64   *
  65   * @param WP_Term $tag      Current taxonomy term object.
  66   * @param string  $taxonomy Current $taxonomy slug.
  67   */
  68  do_action( "{$taxonomy}_pre_edit_form", $tag, $taxonomy ); ?>
  69  
  70  <div class="wrap">
  71  <h1><?php echo $tax->labels->edit_item; ?></h1>
  72  
  73  <?php
  74  $class = ( isset( $msg ) && 5 === $msg ) ? 'error' : 'success';
  75  
  76  if ( $message ) {
  77      ?>
  78  <div id="message" class="notice notice-<?php echo $class; ?>">
  79      <p><strong><?php echo $message; ?></strong></p>
  80      <?php if ( $wp_http_referer ) { ?>
  81      <p><a href="<?php echo esc_url( wp_validate_redirect( esc_url_raw( $wp_http_referer ), admin_url( 'term.php?taxonomy=' . $taxonomy ) ) ); ?>">
  82          <?php echo esc_html( $tax->labels->back_to_items ); ?>
  83      </a></p>
  84      <?php } ?>
  85  </div>
  86      <?php
  87  }
  88  ?>
  89  
  90  <div id="ajax-response"></div>
  91  
  92  <form name="edittag" id="edittag" method="post" action="edit-tags.php" class="validate"
  93  <?php
  94  /**
  95   * Fires inside the Edit Term form tag.
  96   *
  97   * The dynamic portion of the hook name, `$taxonomy`, refers to the taxonomy slug.
  98   *
  99   * @since 3.7.0
 100   */
 101  do_action( "{$taxonomy}_term_edit_form_tag" );
 102  ?>
 103  >
 104  <input type="hidden" name="action" value="editedtag"/>
 105  <input type="hidden" name="tag_ID" value="<?php echo esc_attr( $tag_ID ); ?>"/>
 106  <input type="hidden" name="taxonomy" value="<?php echo esc_attr( $taxonomy ); ?>"/>
 107  <?php
 108  wp_original_referer_field( true, 'previous' );
 109  wp_nonce_field( 'update-tag_' . $tag_ID );
 110  
 111  /**
 112   * Fires at the beginning of the Edit Term form.
 113   *
 114   * At this point, the required hidden fields and nonces have already been output.
 115   *
 116   * The dynamic portion of the hook name, `$taxonomy`, refers to the taxonomy slug.
 117   *
 118   * @since 4.5.0
 119   *
 120   * @param WP_Term $tag      Current taxonomy term object.
 121   * @param string  $taxonomy Current $taxonomy slug.
 122   */
 123  do_action( "{$taxonomy}_term_edit_form_top", $tag, $taxonomy );
 124  
 125  $tag_name_value = '';
 126  if ( isset( $tag->name ) ) {
 127      $tag_name_value = esc_attr( $tag->name );
 128  }
 129  ?>
 130      <table class="form-table" role="presentation">
 131          <tr class="form-field form-required term-name-wrap">
 132              <th scope="row"><label for="name"><?php _ex( 'Name', 'term name' ); ?></label></th>
 133              <td><input name="name" id="name" type="text" value="<?php echo $tag_name_value; ?>" size="40" aria-required="true" />
 134              <p class="description"><?php _e( 'The name is how it appears on your site.' ); ?></p></td>
 135          </tr>
 136  <?php if ( ! global_terms_enabled() ) { ?>
 137          <tr class="form-field term-slug-wrap">
 138              <th scope="row"><label for="slug"><?php _e( 'Slug' ); ?></label></th>
 139              <?php
 140              /**
 141               * Filters the editable slug.
 142               *
 143               * Note: This is a multi-use hook in that it is leveraged both for editable
 144               * post URIs and term slugs.
 145               *
 146               * @since 2.6.0
 147               * @since 4.4.0 The `$tag` parameter was added.
 148               *
 149               * @param string          $slug The editable slug. Will be either a term slug or post URI depending
 150               *                              upon the context in which it is evaluated.
 151               * @param WP_Term|WP_Post $tag  Term or WP_Post object.
 152               */
 153              $slug = isset( $tag->slug ) ? apply_filters( 'editable_slug', $tag->slug, $tag ) : '';
 154              ?>
 155              <td><input name="slug" id="slug" type="text" value="<?php echo esc_attr( $slug ); ?>" size="40" />
 156              <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>
 157          </tr>
 158  <?php } ?>
 159  <?php if ( is_taxonomy_hierarchical( $taxonomy ) ) : ?>
 160          <tr class="form-field term-parent-wrap">
 161              <th scope="row"><label for="parent"><?php echo esc_html( $tax->labels->parent_item ); ?></label></th>
 162              <td>
 163                  <?php
 164                  $dropdown_args = array(
 165                      'hide_empty'       => 0,
 166                      'hide_if_empty'    => false,
 167                      'taxonomy'         => $taxonomy,
 168                      'name'             => 'parent',
 169                      'orderby'          => 'name',
 170                      'selected'         => $tag->parent,
 171                      'exclude_tree'     => $tag->term_id,
 172                      'hierarchical'     => true,
 173                      'show_option_none' => __( 'None' ),
 174                  );
 175  
 176                  /** This filter is documented in wp-admin/edit-tags.php */
 177                  $dropdown_args = apply_filters( 'taxonomy_parent_dropdown_args', $dropdown_args, $taxonomy, 'edit' );
 178                  wp_dropdown_categories( $dropdown_args );
 179                  ?>
 180                  <?php if ( 'category' == $taxonomy ) : ?>
 181                      <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>
 182                  <?php else : ?>
 183                      <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>
 184                  <?php endif; ?>
 185              </td>
 186          </tr>
 187  <?php endif; // is_taxonomy_hierarchical() ?>
 188          <tr class="form-field term-description-wrap">
 189              <th scope="row"><label for="description"><?php _e( 'Description' ); ?></label></th>
 190              <td><textarea name="description" id="description" rows="5" cols="50" class="large-text"><?php echo $tag->description; // textarea_escaped ?></textarea>
 191              <p class="description"><?php _e( 'The description is not prominent by default; however, some themes may show it.' ); ?></p></td>
 192          </tr>
 193          <?php
 194          // Back compat hooks
 195          if ( 'category' == $taxonomy ) {
 196              /**
 197               * Fires after the Edit Category form fields are displayed.
 198               *
 199               * @since 2.9.0
 200               * @deprecated 3.0.0 Use {@see '{$taxonomy}_edit_form_fields'} instead.
 201               *
 202               * @param WP_Term $tag Current category term object.
 203               */
 204              do_action_deprecated( 'edit_category_form_fields', array( $tag ), '3.0.0', '{$taxonomy}_edit_form_fields' );
 205          } elseif ( 'link_category' == $taxonomy ) {
 206              /**
 207               * Fires after the Edit Link Category form fields are displayed.
 208               *
 209               * @since 2.9.0
 210               * @deprecated 3.0.0 Use {@see '{$taxonomy}_edit_form_fields'} instead.
 211               *
 212               * @param WP_Term $tag Current link category term object.
 213               */
 214              do_action_deprecated( 'edit_link_category_form_fields', array( $tag ), '3.0.0', '{$taxonomy}_edit_form_fields' );
 215          } else {
 216              /**
 217               * Fires after the Edit Tag form fields are displayed.
 218               *
 219               * @since 2.9.0
 220               * @deprecated 3.0.0 Use {@see '{$taxonomy}_edit_form_fields'} instead.
 221               *
 222               * @param WP_Term $tag Current tag term object.
 223               */
 224              do_action_deprecated( 'edit_tag_form_fields', array( $tag ), '3.0.0', '{$taxonomy}_edit_form_fields' );
 225          }
 226          /**
 227           * Fires after the Edit Term form fields are displayed.
 228           *
 229           * The dynamic portion of the hook name, `$taxonomy`, refers to
 230           * the taxonomy slug.
 231           *
 232           * @since 3.0.0
 233           *
 234           * @param WP_Term $tag      Current taxonomy term object.
 235           * @param string  $taxonomy Current taxonomy slug.
 236           */
 237          do_action( "{$taxonomy}_edit_form_fields", $tag, $taxonomy );
 238          ?>
 239      </table>
 240  <?php
 241  // Back compat hooks
 242  if ( 'category' == $taxonomy ) {
 243      /** This action is documented in wp-admin/edit-tags.php */
 244      do_action_deprecated( 'edit_category_form', array( $tag ), '3.0.0', '{$taxonomy}_add_form' );
 245  } elseif ( 'link_category' == $taxonomy ) {
 246      /** This action is documented in wp-admin/edit-tags.php */
 247      do_action_deprecated( 'edit_link_category_form', array( $tag ), '3.0.0', '{$taxonomy}_add_form' );
 248  } else {
 249      /**
 250       * Fires at the end of the Edit Term form.
 251       *
 252       * @since 2.5.0
 253       * @deprecated 3.0.0 Use {@see '{$taxonomy}_edit_form'} instead.
 254       *
 255       * @param WP_Term $tag Current taxonomy term object.
 256       */
 257      do_action_deprecated( 'edit_tag_form', array( $tag ), '3.0.0', '{$taxonomy}_edit_form' );
 258  }
 259  /**
 260   * Fires at the end of the Edit Term form for all taxonomies.
 261   *
 262   * The dynamic portion of the hook name, `$taxonomy`, refers to the taxonomy slug.
 263   *
 264   * @since 3.0.0
 265   *
 266   * @param WP_Term $tag      Current taxonomy term object.
 267   * @param string  $taxonomy Current taxonomy slug.
 268   */
 269  do_action( "{$taxonomy}_edit_form", $tag, $taxonomy );
 270  ?>
 271  
 272  <div class="edit-tag-actions">
 273  
 274      <?php submit_button( __( 'Update' ), 'primary', null, false ); ?>
 275  
 276      <?php if ( current_user_can( 'delete_term', $tag->term_id ) ) : ?>
 277          <span id="delete-link">
 278              <a class="delete" href="<?php echo admin_url( wp_nonce_url( "edit-tags.php?action=delete&taxonomy=$taxonomy&tag_ID=$tag->term_id", 'delete-tag_' . $tag->term_id ) ); ?>"><?php _e( 'Delete' ); ?></a>
 279          </span>
 280      <?php endif; ?>
 281  
 282  </div>
 283  
 284  </form>
 285  </div>
 286  
 287  <?php if ( ! wp_is_mobile() ) : ?>
 288  <script type="text/javascript">
 289  try{document.forms.edittag.name.focus();}catch(e){}
 290  </script>
 291      <?php
 292  endif;


Generated: Sat Nov 23 20:47:33 2019 Cross-referenced by PHPXref 0.7