| [ Index ] |
PHP Cross Reference of WordPress |
[Summary view] [Print] [Text view]
1 <?php 2 /** 3 * Edit Tags Administration Screen. 4 * 5 * @package WordPress 6 * @subpackage Administration 7 */ 8 9 /** WordPress Administration Bootstrap */ 10 require_once ('./admin.php'); 11 12 if ( ! $taxnow ) 13 wp_die( __( 'Invalid taxonomy' ) ); 14 15 $tax = get_taxonomy( $taxnow ); 16 17 if ( ! $tax ) 18 wp_die( __( 'Invalid taxonomy' ) ); 19 20 if ( ! current_user_can( $tax->cap->manage_terms ) ) 21 wp_die( __( 'Cheatin’ uh?' ) ); 22 23 $wp_list_table = _get_list_table('WP_Terms_List_Table'); 24 $pagenum = $wp_list_table->get_pagenum(); 25 26 $title = $tax->labels->name; 27 28 if ( 'post' != $post_type ) { 29 $parent_file = "edit.php?post_type=$post_type"; 30 $submenu_file = "edit-tags.php?taxonomy=$taxonomy&post_type=$post_type"; 31 } else if ( 'link_category' == $tax->name ) { 32 $parent_file = 'link-manager.php'; 33 $submenu_file = 'edit-tags.php?taxonomy=link_category'; 34 } else { 35 $parent_file = 'edit.php'; 36 $submenu_file = "edit-tags.php?taxonomy=$taxonomy"; 37 } 38 39 add_screen_option( 'per_page', array('label' => $title, 'default' => 20, 'option' => 'edit_' . $tax->name . '_per_page') ); 40 41 switch ( $wp_list_table->current_action() ) { 42 43 case 'add-tag': 44 45 check_admin_referer( 'add-tag', '_wpnonce_add-tag' ); 46 47 if ( !current_user_can( $tax->cap->edit_terms ) ) 48 wp_die( __( 'Cheatin’ 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( $_REQUEST['tag_ID'] ) ) { 78 wp_redirect( $location ); 79 exit; 80 } 81 82 $tag_ID = (int) $_REQUEST['tag_ID']; 83 check_admin_referer( 'delete-tag_' . $tag_ID ); 84 85 if ( !current_user_can( $tax->cap->delete_terms ) ) 86 wp_die( __( 'Cheatin’ 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’ uh?' ) ); 101 102 $tags = (array) $_REQUEST['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 $tag_ID = (int) $_REQUEST['tag_ID']; 125 126 $tag = get_term( $tag_ID, $taxonomy, OBJECT, 'edit' ); 127 if ( ! $tag ) 128 wp_die( __( 'You attempted to edit an item that doesn’t exist. Perhaps it was deleted?' ) ); 129 require_once ( 'admin-header.php' ); 130 include ( './edit-tag-form.php' ); 131 132 break; 133 134 case 'editedtag': 135 $tag_ID = (int) $_POST['tag_ID']; 136 check_admin_referer( 'update-tag_' . $tag_ID ); 137 138 if ( !current_user_can( $tax->cap->edit_terms ) ) 139 wp_die( __( 'Cheatin’ uh?' ) ); 140 141 $tag = get_term( $tag_ID, $taxonomy ); 142 if ( ! $tag ) 143 wp_die( __( 'You attempted to edit an item that doesn’t exist. Perhaps it was deleted?' ) ); 144 145 $ret = wp_update_term( $tag_ID, $taxonomy, $_POST ); 146 147 $location = 'edit-tags.php?taxonomy=' . $taxonomy; 148 if ( 'post' != $post_type ) 149 $location .= '&post_type=' . $post_type; 150 151 if ( $referer = wp_get_original_referer() ) { 152 if ( false !== strpos( $referer, 'edit-tags.php' ) ) 153 $location = $referer; 154 } 155 156 if ( $ret && !is_wp_error( $ret ) ) 157 $location = add_query_arg( 'message', 3, $location ); 158 else 159 $location = add_query_arg( 'message', 5, $location ); 160 161 wp_redirect( $location ); 162 exit; 163 break; 164 165 default: 166 if ( ! empty($_REQUEST['_wp_http_referer']) ) { 167 $location = remove_query_arg( array('_wp_http_referer', '_wpnonce'), stripslashes($_SERVER['REQUEST_URI']) ); 168 169 if ( ! empty( $_REQUEST['paged'] ) ) 170 $location = add_query_arg( 'paged', (int) $_REQUEST['paged'] ); 171 172 wp_redirect( $location ); 173 exit; 174 } 175 176 $wp_list_table->prepare_items(); 177 $total_pages = $wp_list_table->get_pagination_arg( 'total_pages' ); 178 179 if ( $pagenum > $total_pages && $total_pages > 0 ) { 180 wp_redirect( add_query_arg( 'paged', $total_pages ) ); 181 exit; 182 } 183 184 wp_enqueue_script('admin-tags'); 185 if ( current_user_can($tax->cap->edit_terms) ) 186 wp_enqueue_script('inline-edit-tax'); 187 188 if ( 'category' == $taxonomy || 'link_category' == $taxonomy || 'post_tag' == $taxonomy ) { 189 $help =''; 190 if ( 'category' == $taxonomy ) 191 $help = '<p>' . sprintf(__( 'You can use categories to define sections of your site and group related posts. The default category is “Uncategorized” until you change it in your <a href="%s">writing settings</a>.' ) , 'options-writing.php' ) . '</p>'; 192 elseif ( 'link_category' == $taxonomy ) 193 $help = '<p>' . __( 'You can create groups of links by using Link Categories. Link Category names must be unique and Link Categories are separate from the categories you use for posts.' ) . '</p>'; 194 else 195 $help = '<p>' . __( 'You can assign keywords to your posts using <strong>tags</strong>. Unlike categories, tags have no hierarchy, meaning there’s no relationship from one tag to another.' ) . '</p>'; 196 197 if ( 'link_category' == $taxonomy ) 198 $help .= '<p>' . __( 'You can delete Link Categories in the Bulk Action pulldown, but that action does not delete the links within the category. Instead, it moves them to the default Link Category.' ) . '</p>'; 199 else 200 $help .='<p>' . __( 'What’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>'; 201 202 get_current_screen()->add_help_tab( array( 203 'id' => 'overview', 204 'title' => __('Overview'), 205 'content' => $help, 206 ) ); 207 208 if ( 'category' == $taxonomy || 'post_tag' == $taxonomy ) { 209 if ( 'category' == $taxonomy ) 210 $help = '<p>' . __( 'When adding a new category on this screen, you’ll fill in the following fields:' ) . '</p>'; 211 else 212 $help = '<p>' . __( 'When adding a new tag on this screen, you’ll fill in the following fields:' ) . '</p>'; 213 214 $help .= '<ul>' . 215 '<li>' . __( '<strong>Name</strong> - The name is how it appears on your site.' ) . '</li>'; 216 217 if ( ! global_terms_enabled() ) 218 $help .= '<li>' . __( '<strong>Slug</strong> - The “slug” is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens.' ) . '</li>'; 219 220 if ( 'category' == $taxonomy ) 221 $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>'; 222 223 $help .= '<li>' . __( '<strong>Description</strong> - The description is not prominent by default; however, some themes may display it.' ) . '</li>' . 224 '</ul>' . 225 '<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>'; 226 227 get_current_screen()->add_help_tab( array( 228 'id' => 'adding-terms', 229 'title' => 'category' == $taxonomy ? __( 'Adding Categories' ) : __( 'Adding Tags' ), 230 'content' => $help, 231 ) ); 232 } 233 234 $help = '<p><strong>' . __( 'For more information:' ) . '</strong></p>'; 235 236 if ( 'category' == $taxonomy ) 237 $help .= '<p>' . __( '<a href="http://codex.wordpress.org/Posts_Categories_Screen" target="_blank">Documentation on Categories</a>' ) . '</p>'; 238 elseif ( 'link_category' == $taxonomy ) 239 $help .= '<p>' . __( '<a href="http://codex.wordpress.org/Links_Link_Categories_Screen" target="_blank">Documentation on Link Categories</a>' ) . '</p>'; 240 else 241 $help .= '<p>' . __( '<a href="http://codex.wordpress.org/Posts_Tags_Screen" target="_blank">Documentation on Tags</a>' ) . '</p>'; 242 243 $help .= '<p>' . __('<a href="http://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>'; 244 245 get_current_screen()->set_help_sidebar( $help ); 246 247 unset( $help ); 248 } 249 250 require_once ('admin-header.php'); 251 252 if ( !current_user_can($tax->cap->edit_terms) ) 253 wp_die( __('You are not allowed to edit this item.') ); 254 255 $messages[1] = __('Item added.'); 256 $messages[2] = __('Item deleted.'); 257 $messages[3] = __('Item updated.'); 258 $messages[4] = __('Item not added.'); 259 $messages[5] = __('Item not updated.'); 260 $messages[6] = __('Items deleted.'); 261 262 ?> 263 264 <div class="wrap nosubsub"> 265 <?php screen_icon(); ?> 266 <h2><?php echo esc_html( $title ); 267 if ( !empty($_REQUEST['s']) ) 268 printf( '<span class="subtitle">' . __('Search results for “%s”') . '</span>', esc_html( stripslashes($_REQUEST['s']) ) ); ?> 269 </h2> 270 271 <?php if ( isset($_REQUEST['message']) && ( $msg = (int) $_REQUEST['message'] ) ) : ?> 272 <div id="message" class="updated"><p><?php echo $messages[$msg]; ?></p></div> 273 <?php $_SERVER['REQUEST_URI'] = remove_query_arg(array('message'), $_SERVER['REQUEST_URI']); 274 endif; ?> 275 <div id="ajax-response"></div> 276 277 <form class="search-form" action="" method="get"> 278 <input type="hidden" name="taxonomy" value="<?php echo esc_attr($taxonomy); ?>" /> 279 <input type="hidden" name="post_type" value="<?php echo esc_attr($post_type); ?>" /> 280 281 <?php $wp_list_table->search_box( $tax->labels->search_items, 'tag' ); ?> 282 283 </form> 284 <br class="clear" /> 285 286 <div id="col-container"> 287 288 <div id="col-right"> 289 <div class="col-wrap"> 290 <form id="posts-filter" action="" method="post"> 291 <input type="hidden" name="taxonomy" value="<?php echo esc_attr($taxonomy); ?>" /> 292 <input type="hidden" name="post_type" value="<?php echo esc_attr($post_type); ?>" /> 293 294 <?php $wp_list_table->display(); ?> 295 296 <br class="clear" /> 297 </form> 298 299 <?php if ( 'category' == $taxonomy ) : ?> 300 <div class="form-wrap"> 301 <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> 302 <?php if ( current_user_can( 'import' ) ) : ?> 303 <p><?php printf(__('Categories can be selectively converted to tags using the <a href="%s">category to tag converter</a>.'), 'import.php') ?></p> 304 <?php endif; ?> 305 </div> 306 <?php elseif ( 'post_tag' == $taxonomy && current_user_can( 'import' ) ) : ?> 307 <div class="form-wrap"> 308 <p><?php printf(__('Tags can be selectively converted to categories using the <a href="%s">tag to category converter</a>'), 'import.php') ;?>.</p> 309 </div> 310 <?php endif; 311 do_action('after-' . $taxonomy . '-table', $taxonomy); 312 ?> 313 314 </div> 315 </div><!-- /col-right --> 316 317 <div id="col-left"> 318 <div class="col-wrap"> 319 320 <?php 321 322 if ( !is_null( $tax->labels->popular_items ) ) { 323 if ( current_user_can( $tax->cap->edit_terms ) ) 324 $tag_cloud = wp_tag_cloud( array( 'taxonomy' => $taxonomy, 'echo' => false, 'link' => 'edit' ) ); 325 else 326 $tag_cloud = wp_tag_cloud( array( 'taxonomy' => $taxonomy, 'echo' => false ) ); 327 328 if ( $tag_cloud ) : 329 ?> 330 <div class="tagcloud"> 331 <h3><?php echo $tax->labels->popular_items; ?></h3> 332 <?php echo $tag_cloud; unset( $tag_cloud ); ?> 333 </div> 334 <?php 335 endif; 336 } 337 338 if ( current_user_can($tax->cap->edit_terms) ) { 339 // Back compat hooks. Deprecated in preference to {$taxonomy}_pre_add_form 340 if ( 'category' == $taxonomy ) 341 do_action('add_category_form_pre', (object)array('parent' => 0) ); 342 elseif ( 'link_category' == $taxonomy ) 343 do_action('add_link_category_form_pre', (object)array('parent' => 0) ); 344 else 345 do_action('add_tag_form_pre', $taxonomy); 346 347 do_action($taxonomy . '_pre_add_form', $taxonomy); 348 ?> 349 350 <div class="form-wrap"> 351 <h3><?php echo $tax->labels->add_new_item; ?></h3> 352 <form id="addtag" method="post" action="edit-tags.php" class="validate"> 353 <input type="hidden" name="action" value="add-tag" /> 354 <input type="hidden" name="screen" value="<?php echo esc_attr($current_screen->id); ?>" /> 355 <input type="hidden" name="taxonomy" value="<?php echo esc_attr($taxonomy); ?>" /> 356 <input type="hidden" name="post_type" value="<?php echo esc_attr($post_type); ?>" /> 357 <?php wp_nonce_field('add-tag', '_wpnonce_add-tag'); ?> 358 359 <div class="form-field form-required"> 360 <label for="tag-name"><?php _ex('Name', 'Taxonomy Name'); ?></label> 361 <input name="tag-name" id="tag-name" type="text" value="" size="40" aria-required="true" /> 362 <p><?php _e('The name is how it appears on your site.'); ?></p> 363 </div> 364 <?php if ( ! global_terms_enabled() ) : ?> 365 <div class="form-field"> 366 <label for="tag-slug"><?php _ex('Slug', 'Taxonomy Slug'); ?></label> 367 <input name="slug" id="tag-slug" type="text" value="" size="40" /> 368 <p><?php _e('The “slug” is the URL-friendly version of the name. It is usually all lowercase and contains only letters, numbers, and hyphens.'); ?></p> 369 </div> 370 <?php endif; // global_terms_enabled() ?> 371 <?php if ( is_taxonomy_hierarchical($taxonomy) ) : ?> 372 <div class="form-field"> 373 <label for="parent"><?php _ex('Parent', 'Taxonomy Parent'); ?></label> 374 <?php wp_dropdown_categories(array('hide_empty' => 0, 'hide_if_empty' => false, 'taxonomy' => $taxonomy, 'name' => 'parent', 'orderby' => 'name', 'hierarchical' => true, 'show_option_none' => __('None'))); ?> 375 <?php if ( 'category' == $taxonomy ) : // @todo: Generic text for hierarchical taxonomies ?> 376 <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> 377 <?php endif; ?> 378 </div> 379 <?php endif; // is_taxonomy_hierarchical() ?> 380 <div class="form-field"> 381 <label for="tag-description"><?php _ex('Description', 'Taxonomy Description'); ?></label> 382 <textarea name="description" id="tag-description" rows="5" cols="40"></textarea> 383 <p><?php _e('The description is not prominent by default; however, some themes may show it.'); ?></p> 384 </div> 385 386 <?php 387 if ( ! is_taxonomy_hierarchical($taxonomy) ) 388 do_action('add_tag_form_fields', $taxonomy); 389 do_action($taxonomy . '_add_form_fields', $taxonomy); 390 391 submit_button( $tax->labels->add_new_item, 'button' ); 392 393 // Back compat hooks. Deprecated in preference to {$taxonomy}_add_form 394 if ( 'category' == $taxonomy ) 395 do_action('edit_category_form', (object)array('parent' => 0) ); 396 elseif ( 'link_category' == $taxonomy ) 397 do_action('edit_link_category_form', (object)array('parent' => 0) ); 398 else 399 do_action('add_tag_form', $taxonomy); 400 401 do_action($taxonomy . '_add_form', $taxonomy); 402 ?> 403 </form></div> 404 <?php } ?> 405 406 </div> 407 </div><!-- /col-left --> 408 409 </div><!-- /col-container --> 410 </div><!-- /wrap --> 411 412 <?php $wp_list_table->inline_edit(); ?> 413 414 <?php 415 break; 416 } 417 418 include ('./admin-footer.php');
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
| Generated: Fri May 25 03:56:23 2012 | Hosted by follow the white rabbit. |