[ Root ] [ Search ] [ Index ]

PHP Cross Reference of WordPress 3.0.1

Provided by Yoast

title

Body

[close]

/wp-admin/ -> edit-tags.php (source)

   1  <?php
   2  /**
   3   * Edit Tags Administration Panel.
   4   *
   5   * @package WordPress
   6   * @subpackage Administration
   7   */
   8  
   9  /** WordPress Administration Bootstrap */
  10  require_once ('./admin.php');
  11  
  12  wp_reset_vars( array('action', 'tag', 'taxonomy', 'post_type') );
  13  
  14  if ( empty($taxonomy) )
  15      $taxonomy = 'post_tag';
  16  
  17  if ( !taxonomy_exists($taxonomy) )
  18      wp_die(__('Invalid taxonomy'));
  19  
  20  $tax = get_taxonomy($taxonomy);
  21  
  22  if ( ! current_user_can($tax->cap->manage_terms) )
  23      wp_die(__('Cheatin&#8217; uh?'));
  24  
  25  $title = $tax->labels->name;
  26  
  27  if ( empty($post_type) || !in_array( $post_type, get_post_types( array('public' => true) ) ) )
  28      $post_type = 'post';
  29  
  30  if ( 'post' != $post_type ) {
  31      $parent_file = "edit.php?post_type=$post_type";
  32      $submenu_file = "edit-tags.php?taxonomy=$taxonomy&amp;post_type=$post_type";
  33  } else {
  34      $parent_file = 'edit.php';
  35      $submenu_file = "edit-tags.php?taxonomy=$taxonomy";
  36  }
  37  
  38  if ( isset( $_GET['action'] ) && isset($_GET['delete_tags']) && ( 'delete' == $_GET['action'] || 'delete' == $_GET['action2'] ) )
  39      $action = 'bulk-delete';
  40  
  41  switch($action) {
  42  
  43  case 'add-tag':
  44  
  45      check_admin_referer('add-tag');
  46  
  47      if ( !current_user_can($tax->cap->edit_terms) )
  48          wp_die(__('Cheatin&#8217; uh?'));
  49  
  50      $ret = wp_insert_term($_POST['tag-name'], $taxonomy, $_POST);
  51      $location = 'edit-tags.php?taxonomy=' . $taxonomy;
  52      if ( 'post' != $post_type )
  53          $location .= '&post_type=' . $post_type;
  54  
  55      if ( $referer = wp_get_original_referer() ) {
  56          if ( false !== strpos($referer, 'edit-tags.php') )
  57              $location = $referer;
  58      }
  59  
  60      if ( $ret && !is_wp_error( $ret ) )
  61          $location = add_query_arg('message', 1, $location);
  62      else
  63          $location = add_query_arg('message', 4, $location);
  64      wp_redirect($location);
  65      exit;
  66  break;
  67  
  68  case 'delete':
  69      $location = 'edit-tags.php?taxonomy=' . $taxonomy;
  70      if ( 'post' != $post_type )
  71          $location .= '&post_type=' . $post_type;
  72      if ( $referer = wp_get_referer() ) {
  73          if ( false !== strpos($referer, 'edit-tags.php') )
  74              $location = $referer;
  75      }
  76  
  77      if ( !isset( $_GET['tag_ID'] ) ) {
  78          wp_redirect($location);
  79          exit;
  80      }
  81  
  82      $tag_ID = (int) $_GET['tag_ID'];
  83      check_admin_referer('delete-tag_' .  $tag_ID);
  84  
  85      if ( !current_user_can($tax->cap->delete_terms) )
  86          wp_die(__('Cheatin&#8217; uh?'));
  87  
  88      wp_delete_term( $tag_ID, $taxonomy);
  89  
  90      $location = add_query_arg('message', 2, $location);
  91      wp_redirect($location);
  92      exit;
  93  
  94  break;
  95  
  96  case 'bulk-delete':
  97      check_admin_referer('bulk-tags');
  98  
  99      if ( !current_user_can($tax->cap->delete_terms) )
 100          wp_die(__('Cheatin&#8217; uh?'));
 101  
 102      $tags = (array) $_GET['delete_tags'];
 103      foreach( $tags as $tag_ID ) {
 104          wp_delete_term( $tag_ID, $taxonomy);
 105      }
 106  
 107      $location = 'edit-tags.php?taxonomy=' . $taxonomy;
 108      if ( 'post' != $post_type )
 109          $location .= '&post_type=' . $post_type;
 110      if ( $referer = wp_get_referer() ) {
 111          if ( false !== strpos($referer, 'edit-tags.php') )
 112              $location = $referer;
 113      }
 114  
 115      $location = add_query_arg('message', 6, $location);
 116      wp_redirect($location);
 117      exit;
 118  
 119  break;
 120  
 121  case 'edit':
 122      $title = $tax->labels->edit_item;
 123  
 124      require_once  ('admin-header.php');
 125      $tag_ID = (int) $_GET['tag_ID'];
 126  
 127      if ( !current_user_can($tax->cap->edit_terms) )
 128          wp_die( __('You are not allowed to edit this item.') );
 129  
 130      $tag = get_term($tag_ID, $taxonomy, OBJECT, 'edit');
 131      include ('./edit-tag-form.php');
 132  
 133  break;
 134  
 135  case 'editedtag':
 136      $tag_ID = (int) $_POST['tag_ID'];
 137      check_admin_referer('update-tag_' . $tag_ID);
 138  
 139      if ( !current_user_can($tax->cap->edit_terms) )
 140          wp_die(__('Cheatin&#8217; uh?'));
 141  
 142      $ret = wp_update_term($tag_ID, $taxonomy, $_POST);
 143  
 144      $location = 'edit-tags.php?taxonomy=' . $taxonomy;
 145      if ( 'post' != $post_type )
 146          $location .= '&post_type=' . $post_type;
 147  
 148      if ( $referer = wp_get_original_referer() ) {
 149          if ( false !== strpos($referer, 'edit-tags.php') )
 150              $location = $referer;
 151      }
 152  
 153      if ( $ret && !is_wp_error( $ret ) )
 154          $location = add_query_arg('message', 3, $location);
 155      else
 156          $location = add_query_arg('message', 5, $location);
 157  
 158      wp_redirect($location);
 159      exit;
 160  break;
 161  
 162  default:
 163  
 164  if ( ! empty($_GET['_wp_http_referer']) ) {
 165       wp_redirect( remove_query_arg( array('_wp_http_referer', '_wpnonce'), stripslashes($_SERVER['REQUEST_URI']) ) );
 166       exit;
 167  }
 168  
 169  wp_enqueue_script('admin-tags');
 170  if ( current_user_can($tax->cap->edit_terms) )
 171      wp_enqueue_script('inline-edit-tax');
 172  
 173  if ( 'category' == $taxonomy || 'post_tag' == $taxonomy ) {
 174      if ( 'category' == $taxonomy )
 175          $help = '<p>' . sprintf(__('You can use categories to define sections of your site and group related posts. The default category is &#8220;Uncategorized&#8221; until you change it in your <a href="%s">writing settings</a>.'), 'options-writing.php') . '</p>';
 176      else
 177          $help = '<p>' . __('You can assign keywords to your posts using Post Tags. Unlike categories, tags have no hierarchy, meaning there&#8217;s no relationship from one tag to another.') . '</p>';
 178  
 179      $help .='<p>' . __('What&#8217;s the difference between categories and tags? Normally, tags are ad-hoc keywords that identify important information in your post (names, subjects, etc) that may or may not recur in other posts, while categories are pre-determined sections. If you think of your site like a book, the categories are like the Table of Contents and the tags are like the terms in the index.') . '</p>';
 180  
 181      if ( 'category' == $taxonomy )
 182          $help .= '<p>' . __('When adding a new category on this screen, you&#8217;ll fill in the following fields:') . '</p>';
 183      else
 184          $help .= '<p>' . __('When adding a new tag on this screen, you&#8217;ll fill in the following fields:') . '</p>';
 185  
 186      $help .= '<ul>' .
 187          '<li>' . __('<strong>Name</strong> - The name is how it appears on your site.') . '</li>';
 188      if ( ! global_terms_enabled() )
 189          $help .= '<li>' . __('<strong>Slug</strong> - The &#8220;slug&#8221; is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens.') . '</li>';
 190  
 191      if ( 'category' == $taxonomy )
 192          $help .= '<li>' . __('<strong>Parent</strong> - 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. To create a subcategory, just choose another category from the Parent dropdown.') . '</li>';
 193  
 194      $help .= '<li>' . __('<strong>Description</strong> - The description is not prominent by default; however, some themes may display it.') . '</li>' .
 195          '</ul>' .
 196          '<p>' . __('You can change the display of this screen using the Screen Options tab to set how many items are displayed per screen and to display/hide columns in the table.') . '</p>' .
 197          '<p><strong>' . __('For more information:') . '</strong></p>';
 198  
 199      if ( 'category' == $taxonomy )
 200          $help .= '<p>' . __('<a href="http://codex.wordpress.org/Manage_Categories_SubPanel" target="_blank">Categories Documentation</a>') . '</p>';
 201      else
 202          $help .= '<p>' . __('<a href="http://codex.wordpress.org/Post_Tags_SubPanel" target="_blank">Tags Documentation</a>') . '</p>';
 203  
 204      $help .= '<p>' . __('<a href="http://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>';
 205  
 206      add_contextual_help($current_screen, $help);
 207      unset($help);
 208  }
 209  
 210  require_once  ('admin-header.php');
 211  
 212  $messages[1] = __('Item added.');
 213  $messages[2] = __('Item deleted.');
 214  $messages[3] = __('Item updated.');
 215  $messages[4] = __('Item not added.');
 216  $messages[5] = __('Item not updated.');
 217  $messages[6] = __('Items deleted.');
 218  
 219  ?>
 220  
 221  <div class="wrap nosubsub">
 222  <?php screen_icon(); ?>
 223  <h2><?php echo esc_html( $title );
 224  if ( !empty($_GET['s']) )
 225      printf( '<span class="subtitle">' . __('Search results for &#8220;%s&#8221;') . '</span>', esc_html( stripslashes($_GET['s']) ) ); ?>
 226  </h2>
 227  
 228  <?php if ( isset($_GET['message']) && ( $msg = (int) $_GET['message'] ) ) : ?>
 229  <div id="message" class="updated"><p><?php echo $messages[$msg]; ?></p></div>
 230  <?php $_SERVER['REQUEST_URI'] = remove_query_arg(array('message'), $_SERVER['REQUEST_URI']);
 231  endif; ?>
 232  <div id="ajax-response"></div>
 233  
 234  <form class="search-form" action="" method="get">
 235  <input type="hidden" name="taxonomy" value="<?php echo esc_attr($taxonomy); ?>" />
 236  <input type="hidden" name="post_type" value="<?php echo esc_attr($post_type); ?>" />
 237  <p class="search-box">
 238      <label class="screen-reader-text" for="tag-search-input"><?php echo $tax->labels->search_items; ?>:</label>
 239      <input type="text" id="tag-search-input" name="s" value="<?php _admin_search_query(); ?>" />
 240      <input type="submit" value="<?php echo esc_attr( $tax->labels->search_items );  ?>" class="button" />
 241  </p>
 242  </form>
 243  <br class="clear" />
 244  
 245  <div id="col-container">
 246  
 247  <div id="col-right">
 248  <div class="col-wrap">
 249  <form id="posts-filter" action="" method="get">
 250  <input type="hidden" name="taxonomy" value="<?php echo esc_attr($taxonomy); ?>" />
 251  <input type="hidden" name="post_type" value="<?php echo esc_attr($post_type); ?>" />
 252  <div class="tablenav">
 253  <?php
 254  $pagenum = isset( $_GET['pagenum'] ) ? absint( $_GET['pagenum'] ) : 0;
 255  if ( empty($pagenum) )
 256      $pagenum = 1;
 257  
 258  $tags_per_page = (int) get_user_option( 'edit_' .  $taxonomy . '_per_page' );
 259  
 260  if ( empty($tags_per_page) || $tags_per_page < 1 )
 261      $tags_per_page = 20;
 262  
 263  if ( 'post_tag' == $taxonomy ) {
 264      $tags_per_page = apply_filters( 'edit_tags_per_page', $tags_per_page );
 265      $tags_per_page = apply_filters( 'tagsperpage', $tags_per_page ); // Old filter
 266  } elseif ( 'category' == $taxonomy ) {
 267      $tags_per_page = apply_filters( 'edit_categories_per_page', $tags_per_page ); // Old filter
 268  } else {
 269      $tags_per_page = apply_filters( 'edit_' . $taxonomy . '_per_page', $tags_per_page );
 270  }
 271  
 272  $searchterms = !empty($_GET['s']) ? trim(stripslashes($_GET['s'])) : '';
 273  
 274  $page_links = paginate_links( array(
 275      'base' => add_query_arg( 'pagenum', '%#%' ),
 276      'format' => '',
 277      'prev_text' => __('&laquo;'),
 278      'next_text' => __('&raquo;'),
 279      'total' => ceil(wp_count_terms($taxonomy, array('search' => $searchterms)) / $tags_per_page),
 280      'current' => $pagenum
 281  ));
 282  
 283  if ( $page_links )
 284      echo "<div class='tablenav-pages'>$page_links</div>";
 285  ?>
 286  
 287  <div class="alignleft actions">
 288  <select name="action">
 289  <option value="" selected="selected"><?php _e('Bulk Actions'); ?></option>
 290  <option value="delete"><?php _e('Delete'); ?></option>
 291  </select>
 292  <input type="submit" value="<?php esc_attr_e('Apply'); ?>" name="doaction" id="doaction" class="button-secondary action" />
 293  <?php wp_nonce_field('bulk-tags'); ?>
 294  </div>
 295  
 296  <br class="clear" />
 297  </div>
 298  
 299  <div class="clear"></div>
 300  <table class="widefat tag fixed" cellspacing="0">
 301      <thead>
 302      <tr>
 303  <?php print_column_headers($current_screen); ?>
 304      </tr>
 305      </thead>
 306  
 307      <tfoot>
 308      <tr>
 309  <?php print_column_headers($current_screen, false); ?>
 310      </tr>
 311      </tfoot>
 312  
 313      <tbody id="the-list" class="list:tag">
 314  <?php tag_rows( $pagenum, $tags_per_page, $searchterms, $taxonomy ); ?>
 315      </tbody>
 316  </table>
 317  
 318  <div class="tablenav">
 319  <?php
 320  if ( $page_links )
 321      echo "<div class='tablenav-pages'>$page_links</div>";
 322  ?>
 323  
 324  <div class="alignleft actions">
 325  <select name="action2">
 326  <option value="" selected="selected"><?php _e('Bulk Actions'); ?></option>
 327  <option value="delete"><?php _e('Delete'); ?></option>
 328  </select>
 329  <input type="submit" value="<?php esc_attr_e('Apply'); ?>" name="doaction2" id="doaction2" class="button-secondary action" />
 330  </div>
 331  
 332  <br class="clear" />
 333  </div>
 334  
 335  <br class="clear" />
 336  </form>
 337  
 338  <?php if ( 'category' == $taxonomy ) : ?>
 339  <div class="form-wrap">
 340  <p><?php printf(__('<strong>Note:</strong><br />Deleting a category does not delete the posts in that category. Instead, posts that were only assigned to the deleted category are set to the category <strong>%s</strong>.'), apply_filters('the_category', get_cat_name(get_option('default_category')))) ?></p>
 341  <?php if ( current_user_can( 'import' ) ) : ?>
 342  <p><?php printf(__('Categories can be selectively converted to tags using the <a href="%s">category to tag converter</a>.'), 'import.php') ?></p>
 343  <?php endif; ?>
 344  </div>
 345  <?php elseif ( 'post_tag' == $taxonomy && current_user_can( 'import' ) ) : ?>
 346  <div class="form-wrap">
 347  <p><?php printf(__('Tags can be selectively converted to categories using the <a href="%s">tag to category converter</a>'), 'import.php') ;?>.</p>
 348  </div>
 349  <?php endif;
 350  do_action('after-' . $taxonomy . '-table', $taxonomy);
 351  ?>
 352  
 353  </div>
 354  </div><!-- /col-right -->
 355  
 356  <div id="col-left">
 357  <div class="col-wrap">
 358  
 359  <?php
 360  
 361  if ( !is_taxonomy_hierarchical($taxonomy) ) {
 362      if ( current_user_can( $tax->cap->edit_terms ) )
 363          $tag_cloud = wp_tag_cloud( array( 'taxonomy' => $taxonomy, 'echo' => false, 'link' => 'edit' ) );
 364      else
 365          $tag_cloud = wp_tag_cloud( array( 'taxonomy' => $taxonomy, 'echo' => false ) );
 366  
 367      if ( $tag_cloud ) :
 368      ?>
 369  <div class="tagcloud">
 370  <h3><?php echo $tax->labels->popular_items; ?></h3>
 371  <?php echo $tag_cloud; unset( $tag_cloud ); ?>
 372  </div>
 373  <?php
 374  endif;
 375  }
 376  
 377  if ( current_user_can($tax->cap->edit_terms) ) {
 378      if ( 'category' == $taxonomy )
 379          do_action('add_category_form_pre', (object)array('parent' => 0) );  // Back compat hook. Deprecated in preference to $taxonomy_pre_add_form
 380      else
 381          do_action('add_tag_form_pre', $taxonomy); // Back compat hook. Applies to all Taxonomies -not- categories
 382      do_action($taxonomy . '_pre_add_form', $taxonomy);
 383  ?>
 384  
 385  <div class="form-wrap">
 386  <h3><?php echo $tax->labels->add_new_item; ?></h3>
 387  <form id="addtag" method="post" action="edit-tags.php" class="validate">
 388  <input type="hidden" name="action" value="add-tag" />
 389  <input type="hidden" name="screen" value="<?php echo esc_attr($current_screen->id); ?>" />
 390  <input type="hidden" name="taxonomy" value="<?php echo esc_attr($taxonomy); ?>" />
 391  <input type="hidden" name="post_type" value="<?php echo esc_attr($post_type); ?>" />
 392  <?php wp_nonce_field('add-tag'); ?>
 393  
 394  <div class="form-field form-required">
 395      <label for="tag-name"><?php _ex('Name', 'Taxonomy Name'); ?></label>
 396      <input name="tag-name" id="tag-name" type="text" value="" size="40" aria-required="true" />
 397      <p><?php _e('The name is how it appears on your site.'); ?></p>
 398  </div>
 399  <?php if ( ! global_terms_enabled() ) : ?>
 400  <div class="form-field">
 401      <label for="tag-slug"><?php _ex('Slug', 'Taxonomy Slug'); ?></label>
 402      <input name="slug" id="tag-slug" type="text" value="" size="40" />
 403      <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>
 404  </div>
 405  <?php endif; // is_multisite() ?>
 406  <?php if ( is_taxonomy_hierarchical($taxonomy) ) : ?>
 407  <div class="form-field">
 408      <label for="parent"><?php _ex('Parent', 'Taxonomy Parent'); ?></label>
 409      <?php wp_dropdown_categories(array('hide_empty' => 0, 'hide_if_empty' => false, 'taxonomy' => $taxonomy, 'name' => 'parent', 'orderby' => 'name', 'hierarchical' => true, 'show_option_none' => __('None'))); ?>
 410      <?php if ( 'category' == $taxonomy ) : // @todo: Generic text for hierarchical taxonomies ?>
 411          <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>
 412      <?php endif; ?>
 413  </div>
 414  <?php endif; // is_taxonomy_hierarchical() ?>
 415  <div class="form-field">
 416      <label for="tag-description"><?php _ex('Description', 'Taxonomy Description'); ?></label>
 417      <textarea name="description" id="tag-description" rows="5" cols="40"></textarea>
 418      <p><?php _e('The description is not prominent by default; however, some themes may show it.'); ?></p>
 419  </div>
 420  
 421  <?php
 422  if ( ! is_taxonomy_hierarchical($taxonomy) )
 423      do_action('add_tag_form_fields', $taxonomy);
 424  do_action($taxonomy . '_add_form_fields', $taxonomy);
 425  ?>
 426  <p class="submit"><input type="submit" class="button" name="submit" id="submit" value="<?php echo esc_attr( $tax->labels->add_new_item ); ?>" /></p>
 427  <?php
 428  if ( 'category' == $taxonomy )
 429      do_action('edit_category_form',    (object)array('parent' => 0) );  // Back compat hook. Deprecated in preference to $taxonomy_add_form
 430  else
 431      do_action('add_tag_form', $taxonomy); // Back compat hook. Applies to all Taxonomies -not- categories
 432  do_action($taxonomy . '_add_form', $taxonomy);
 433  ?>
 434  </form></div>
 435  <?php } ?>
 436  
 437  </div>
 438  </div><!-- /col-left -->
 439  
 440  </div><!-- /col-container -->
 441  </div><!-- /wrap -->
 442  
 443  <?php inline_edit_term_row('edit-tags', $taxonomy); ?>
 444  
 445  <?php
 446  break;
 447  }
 448  
 449  include ('./admin-footer.php');
 450  
 451  ?>


Generated: Thu Oct 14 05:12:05 2010 Cross-referenced by PHPXref 0.7