3 * Edit Tags Administration Screen.
6 * @subpackage Administration
9 /** WordPress Administration Bootstrap */
10 require_once( dirname( __FILE__ ) . '/admin.php' );
13 wp_die( __( 'Invalid taxonomy' ) );
15 $tax = get_taxonomy( $taxnow );
18 wp_die( __( 'Invalid taxonomy' ) );
20 if ( ! in_array( $tax->name, get_taxonomies( array( 'show_ui' => true ) ) ) ) {
21 wp_die( __( 'You are not allowed to manage these items.' ) );
24 if ( ! current_user_can( $tax->cap->manage_terms ) ) {
26 '<h1>' . __( 'Cheatin’ uh?' ) . '</h1>' .
27 '<p>' . __( 'You are not allowed to manage these items.' ) . '</p>',
33 * $post_type is set when the WP_Terms_List_Table instance is created
35 * @global string $post_type
39 $wp_list_table = _get_list_table('WP_Terms_List_Table');
40 $pagenum = $wp_list_table->get_pagenum();
42 $title = $tax->labels->name;
44 if ( 'post' != $post_type ) {
45 $parent_file = ( 'attachment' == $post_type ) ? 'upload.php' : "edit.php?post_type=$post_type";
46 $submenu_file = "edit-tags.php?taxonomy=$taxonomy&post_type=$post_type";
47 } elseif ( 'link_category' == $tax->name ) {
48 $parent_file = 'link-manager.php';
49 $submenu_file = 'edit-tags.php?taxonomy=link_category';
51 $parent_file = 'edit.php';
52 $submenu_file = "edit-tags.php?taxonomy=$taxonomy";
55 add_screen_option( 'per_page', array( 'default' => 20, 'option' => 'edit_' . $tax->name . '_per_page' ) );
57 get_current_screen()->set_screen_reader_content( array(
58 'heading_pagination' => $tax->labels->items_list_navigation,
59 'heading_list' => $tax->labels->items_list,
63 $referer = wp_get_referer();
65 switch ( $wp_list_table->current_action() ) {
69 check_admin_referer( 'add-tag', '_wpnonce_add-tag' );
71 if ( ! current_user_can( $tax->cap->edit_terms ) ) {
73 '<h1>' . __( 'Cheatin’ uh?' ) . '</h1>' .
74 '<p>' . __( 'You are not allowed to add this item.' ) . '</p>',
79 $ret = wp_insert_term( $_POST['tag-name'], $taxonomy, $_POST );
80 $location = 'edit-tags.php?taxonomy=' . $taxonomy;
81 if ( 'post' != $post_type )
82 $location .= '&post_type=' . $post_type;
84 if ( $referer && false !== strpos( $referer, 'edit-tags.php' ) ) {
88 if ( $ret && !is_wp_error( $ret ) )
89 $location = add_query_arg( 'message', 1, $location );
91 $location = add_query_arg( array( 'error' => true, 'message' => 4 ), $location );
96 $location = 'edit-tags.php?taxonomy=' . $taxonomy;
97 if ( 'post' != $post_type )
98 $location .= '&post_type=' . $post_type;
100 if ( $referer && false !== strpos( $referer, 'edit-tags.php' ) ) {
101 $location = $referer;
104 if ( ! isset( $_REQUEST['tag_ID'] ) ) {
108 $tag_ID = (int) $_REQUEST['tag_ID'];
109 check_admin_referer( 'delete-tag_' . $tag_ID );
111 if ( ! current_user_can( $tax->cap->delete_terms ) ) {
113 '<h1>' . __( 'Cheatin’ uh?' ) . '</h1>' .
114 '<p>' . __( 'You are not allowed to delete this item.' ) . '</p>',
119 wp_delete_term( $tag_ID, $taxonomy );
121 $location = add_query_arg( 'message', 2, $location );
126 check_admin_referer( 'bulk-tags' );
128 if ( ! current_user_can( $tax->cap->delete_terms ) ) {
130 '<h1>' . __( 'Cheatin’ uh?' ) . '</h1>' .
131 '<p>' . __( 'You are not allowed to delete these items.' ) . '</p>',
136 $tags = (array) $_REQUEST['delete_tags'];
137 foreach ( $tags as $tag_ID ) {
138 wp_delete_term( $tag_ID, $taxonomy );
141 $location = 'edit-tags.php?taxonomy=' . $taxonomy;
142 if ( 'post' != $post_type )
143 $location .= '&post_type=' . $post_type;
144 if ( $referer && false !== strpos( $referer, 'edit-tags.php' ) ) {
145 $location = $referer;
148 $location = add_query_arg( 'message', 6, $location );
153 $title = $tax->labels->edit_item;
155 $tag_ID = (int) $_REQUEST['tag_ID'];
157 $tag = get_term( $tag_ID, $taxonomy, OBJECT, 'edit' );
159 wp_die( __( 'You attempted to edit an item that doesn’t exist. Perhaps it was deleted?' ) );
160 require_once( ABSPATH . 'wp-admin/admin-header.php' );
161 include( ABSPATH . 'wp-admin/edit-tag-form.php' );
162 include( ABSPATH . 'wp-admin/admin-footer.php' );
167 $tag_ID = (int) $_POST['tag_ID'];
168 check_admin_referer( 'update-tag_' . $tag_ID );
170 if ( ! current_user_can( $tax->cap->edit_terms ) ) {
172 '<h1>' . __( 'Cheatin’ uh?' ) . '</h1>' .
173 '<p>' . __( 'You are not allowed to edit this item.' ) . '</p>',
178 $tag = get_term( $tag_ID, $taxonomy );
180 wp_die( __( 'You attempted to edit an item that doesn’t exist. Perhaps it was deleted?' ) );
182 $ret = wp_update_term( $tag_ID, $taxonomy, $_POST );
184 $location = 'edit-tags.php?taxonomy=' . $taxonomy;
185 if ( 'post' != $post_type )
186 $location .= '&post_type=' . $post_type;
188 if ( $referer && false !== strpos( $referer, 'edit-tags.php' ) ) {
189 $location = $referer;
192 if ( $ret && !is_wp_error( $ret ) )
193 $location = add_query_arg( 'message', 3, $location );
195 $location = add_query_arg( array( 'error' => true, 'message' => 5 ), $location );
199 if ( ! $location && ! empty( $_REQUEST['_wp_http_referer'] ) ) {
200 $location = remove_query_arg( array('_wp_http_referer', '_wpnonce'), wp_unslash($_SERVER['REQUEST_URI']) );
204 if ( ! empty( $_REQUEST['paged'] ) ) {
205 $location = add_query_arg( 'paged', (int) $_REQUEST['paged'], $location );
207 wp_redirect( $location );
211 $wp_list_table->prepare_items();
212 $total_pages = $wp_list_table->get_pagination_arg( 'total_pages' );
214 if ( $pagenum > $total_pages && $total_pages > 0 ) {
215 wp_redirect( add_query_arg( 'paged', $total_pages ) );
219 wp_enqueue_script('admin-tags');
220 if ( current_user_can($tax->cap->edit_terms) )
221 wp_enqueue_script('inline-edit-tax');
223 if ( 'category' == $taxonomy || 'link_category' == $taxonomy || 'post_tag' == $taxonomy ) {
225 if ( 'category' == $taxonomy )
226 $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>';
227 elseif ( 'link_category' == $taxonomy )
228 $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>';
230 $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>';
232 if ( 'link_category' == $taxonomy )
233 $help .= '<p>' . __( 'You can delete Link Categories in the Bulk Action pull-down, but that action does not delete the links within the category. Instead, it moves them to the default Link Category.' ) . '</p>';
235 $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>';
237 get_current_screen()->add_help_tab( array(
239 'title' => __('Overview'),
243 if ( 'category' == $taxonomy || 'post_tag' == $taxonomy ) {
244 if ( 'category' == $taxonomy )
245 $help = '<p>' . __( 'When adding a new category on this screen, you’ll fill in the following fields:' ) . '</p>';
247 $help = '<p>' . __( 'When adding a new tag on this screen, you’ll fill in the following fields:' ) . '</p>';
250 '<li>' . __( '<strong>Name</strong> — The name is how it appears on your site.' ) . '</li>';
252 if ( ! global_terms_enabled() )
253 $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>';
255 if ( 'category' == $taxonomy )
256 $help .= '<li>' . __( '<strong>Parent</strong> — Categories, unlike tags, can have a hierarchy. You might have a Jazz category, and under that have child categories for Bebop and Big Band. Totally optional. To create a subcategory, just choose another category from the Parent dropdown.' ) . '</li>';
258 $help .= '<li>' . __( '<strong>Description</strong> — The description is not prominent by default; however, some themes may display it.' ) . '</li>' .
260 '<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>';
262 get_current_screen()->add_help_tab( array(
263 'id' => 'adding-terms',
264 'title' => 'category' == $taxonomy ? __( 'Adding Categories' ) : __( 'Adding Tags' ),
269 $help = '<p><strong>' . __( 'For more information:' ) . '</strong></p>';
271 if ( 'category' == $taxonomy )
272 $help .= '<p>' . __( '<a href="https://codex.wordpress.org/Posts_Categories_Screen" target="_blank">Documentation on Categories</a>' ) . '</p>';
273 elseif ( 'link_category' == $taxonomy )
274 $help .= '<p>' . __( '<a href="https://codex.wordpress.org/Links_Link_Categories_Screen" target="_blank">Documentation on Link Categories</a>' ) . '</p>';
276 $help .= '<p>' . __( '<a href="https://codex.wordpress.org/Posts_Tags_Screen" target="_blank">Documentation on Tags</a>' ) . '</p>';
278 $help .= '<p>' . __('<a href="https://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>';
280 get_current_screen()->set_help_sidebar( $help );
285 require_once( ABSPATH . 'wp-admin/admin-header.php' );
287 if ( ! current_user_can( $tax->cap->edit_terms ) ) {
289 '<h1>' . __( 'Cheatin’ uh?' ) . '</h1>' .
290 '<p>' . __( 'You are not allowed to edit this item.' ) . '</p>',
295 /** Also used by the Edit Tag form */
296 require_once( ABSPATH . 'wp-admin/includes/edit-tag-messages.php' );
298 $class = ( isset( $_REQUEST['error'] ) ) ? 'error' : 'updated';
300 if ( is_plugin_active( 'wpcat2tag-importer/wpcat2tag-importer.php' ) ) {
301 $import_link = admin_url( 'admin.php?import=wpcat2tag' );
303 $import_link = admin_url( 'import.php' );
308 <div class="wrap nosubsub">
309 <h1><?php echo esc_html( $title );
310 if ( !empty($_REQUEST['s']) )
311 printf( '<span class="subtitle">' . __('Search results for “%s”') . '</span>', esc_html( wp_unslash($_REQUEST['s']) ) ); ?>
314 <?php if ( $message ) : ?>
315 <div id="message" class="<?php echo $class; ?> notice is-dismissible"><p><?php echo $message; ?></p></div>
316 <?php $_SERVER['REQUEST_URI'] = remove_query_arg( array( 'message', 'error' ), $_SERVER['REQUEST_URI'] );
318 <div id="ajax-response"></div>
320 <form class="search-form" method="get">
321 <input type="hidden" name="taxonomy" value="<?php echo esc_attr($taxonomy); ?>" />
322 <input type="hidden" name="post_type" value="<?php echo esc_attr($post_type); ?>" />
324 <?php $wp_list_table->search_box( $tax->labels->search_items, 'tag' ); ?>
329 <div id="col-container">
332 <div class="col-wrap">
333 <form id="posts-filter" method="post">
334 <input type="hidden" name="taxonomy" value="<?php echo esc_attr($taxonomy); ?>" />
335 <input type="hidden" name="post_type" value="<?php echo esc_attr($post_type); ?>" />
337 <?php $wp_list_table->display(); ?>
342 <?php if ( 'category' == $taxonomy ) : ?>
343 <div class="form-wrap">
346 echo '<strong>' . __( 'Note:' ) . '</strong><br />';
348 /* translators: %s: default category */
349 __( '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 %s.' ),
350 /** This filter is documented in wp-includes/category-template.php */
351 '<strong>' . apply_filters( 'the_category', get_cat_name( get_option( 'default_category') ) ) . '</strong>'
355 <?php if ( current_user_can( 'import' ) ) : ?>
356 <p><?php printf( __( 'Categories can be selectively converted to tags using the <a href="%s">category to tag converter</a>.' ), esc_url( $import_link ) ) ?></p>
359 <?php elseif ( 'post_tag' == $taxonomy && current_user_can( 'import' ) ) : ?>
360 <div class="form-wrap">
361 <p><?php printf( __( 'Tags can be selectively converted to categories using the <a href="%s">tag to category converter</a>.' ), esc_url( $import_link ) ) ;?></p>
366 * Fires after the taxonomy list table.
368 * The dynamic portion of the hook name, `$taxonomy`, refers to the taxonomy slug.
372 * @param string $taxonomy The taxonomy name.
374 do_action( "after-{$taxonomy}-table", $taxonomy );
378 </div><!-- /col-right -->
381 <div class="col-wrap">
385 if ( !is_null( $tax->labels->popular_items ) ) {
386 if ( current_user_can( $tax->cap->edit_terms ) )
387 $tag_cloud = wp_tag_cloud( array( 'taxonomy' => $taxonomy, 'post_type' => $post_type, 'echo' => false, 'link' => 'edit' ) );
389 $tag_cloud = wp_tag_cloud( array( 'taxonomy' => $taxonomy, 'echo' => false ) );
393 <div class="tagcloud">
394 <h2><?php echo $tax->labels->popular_items; ?></h2>
395 <?php echo $tag_cloud; unset( $tag_cloud ); ?>
401 if ( current_user_can($tax->cap->edit_terms) ) {
402 if ( 'category' == $taxonomy ) {
404 * Fires before the Add Category form.
407 * @deprecated 3.0.0 Use {$taxonomy}_pre_add_form instead.
409 * @param object $arg Optional arguments cast to an object.
411 do_action( 'add_category_form_pre', (object) array( 'parent' => 0 ) );
412 } elseif ( 'link_category' == $taxonomy ) {
414 * Fires before the link category form.
417 * @deprecated 3.0.0 Use {$taxonomy}_pre_add_form instead.
419 * @param object $arg Optional arguments cast to an object.
421 do_action( 'add_link_category_form_pre', (object) array( 'parent' => 0 ) );
424 * Fires before the Add Tag form.
427 * @deprecated 3.0.0 Use {$taxonomy}_pre_add_form instead.
429 * @param string $taxonomy The taxonomy slug.
431 do_action( 'add_tag_form_pre', $taxonomy );
435 * Fires before the Add Term form for all taxonomies.
437 * The dynamic portion of the hook name, `$taxonomy`, refers to the taxonomy slug.
441 * @param string $taxonomy The taxonomy slug.
443 do_action( "{$taxonomy}_pre_add_form", $taxonomy );
446 <div class="form-wrap">
447 <h2><?php echo $tax->labels->add_new_item; ?></h2>
448 <form id="addtag" method="post" action="edit-tags.php" class="validate"
451 * Fires at the beginning of the Add Tag form.
453 * The dynamic portion of the hook name, `$taxonomy`, refers to the taxonomy slug.
457 do_action( "{$taxonomy}_term_new_form_tag" );
459 <input type="hidden" name="action" value="add-tag" />
460 <input type="hidden" name="screen" value="<?php echo esc_attr($current_screen->id); ?>" />
461 <input type="hidden" name="taxonomy" value="<?php echo esc_attr($taxonomy); ?>" />
462 <input type="hidden" name="post_type" value="<?php echo esc_attr($post_type); ?>" />
463 <?php wp_nonce_field('add-tag', '_wpnonce_add-tag'); ?>
465 <div class="form-field form-required term-name-wrap">
466 <label for="tag-name"><?php _ex( 'Name', 'term name' ); ?></label>
467 <input name="tag-name" id="tag-name" type="text" value="" size="40" aria-required="true" />
468 <p><?php _e('The name is how it appears on your site.'); ?></p>
470 <?php if ( ! global_terms_enabled() ) : ?>
471 <div class="form-field term-slug-wrap">
472 <label for="tag-slug"><?php _e( 'Slug' ); ?></label>
473 <input name="slug" id="tag-slug" type="text" value="" size="40" />
474 <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>
476 <?php endif; // global_terms_enabled() ?>
477 <?php if ( is_taxonomy_hierarchical($taxonomy) ) : ?>
478 <div class="form-field term-parent-wrap">
479 <label for="parent"><?php _ex( 'Parent', 'term parent' ); ?></label>
481 $dropdown_args = array(
483 'hide_if_empty' => false,
484 'taxonomy' => $taxonomy,
487 'hierarchical' => true,
488 'show_option_none' => __( 'None' ),
492 * Filter the taxonomy parent drop-down on the Edit Term page.
495 * @since 4.2.0 Added `$context` parameter.
497 * @param array $dropdown_args {
498 * An array of taxonomy parent drop-down arguments.
500 * @type int|bool $hide_empty Whether to hide terms not attached to any posts. Default 0|false.
501 * @type bool $hide_if_empty Whether to hide the drop-down if no terms exist. Default false.
502 * @type string $taxonomy The taxonomy slug.
503 * @type string $name Value of the name attribute to use for the drop-down select element.
505 * @type string $orderby The field to order by. Default 'name'.
506 * @type bool $hierarchical Whether the taxonomy is hierarchical. Default true.
507 * @type string $show_option_none Label to display if there are no terms. Default 'None'.
509 * @param string $taxonomy The taxonomy slug.
510 * @param string $context Filter context. Accepts 'new' or 'edit'.
512 $dropdown_args = apply_filters( 'taxonomy_parent_dropdown_args', $dropdown_args, $taxonomy, 'new' );
514 wp_dropdown_categories( $dropdown_args );
516 <?php if ( 'category' == $taxonomy ) : // @todo: Generic text for hierarchical taxonomies ?>
517 <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>
520 <?php endif; // is_taxonomy_hierarchical() ?>
521 <div class="form-field term-description-wrap">
522 <label for="tag-description"><?php _e( 'Description' ); ?></label>
523 <textarea name="description" id="tag-description" rows="5" cols="40"></textarea>
524 <p><?php _e('The description is not prominent by default; however, some themes may show it.'); ?></p>
528 if ( ! is_taxonomy_hierarchical( $taxonomy ) ) {
530 * Fires after the Add Tag form fields for non-hierarchical taxonomies.
534 * @param string $taxonomy The taxonomy slug.
536 do_action( 'add_tag_form_fields', $taxonomy );
540 * Fires after the Add Term form fields.
542 * The dynamic portion of the hook name, `$taxonomy`, refers to the taxonomy slug.
546 * @param string $taxonomy The taxonomy slug.
548 do_action( "{$taxonomy}_add_form_fields", $taxonomy );
550 submit_button( $tax->labels->add_new_item );
552 if ( 'category' == $taxonomy ) {
554 * Fires at the end of the Edit Category form.
557 * @deprecated 3.0.0 Use {$taxonomy}_add_form instead.
559 * @param object $arg Optional arguments cast to an object.
561 do_action( 'edit_category_form', (object) array( 'parent' => 0 ) );
562 } elseif ( 'link_category' == $taxonomy ) {
564 * Fires at the end of the Edit Link form.
567 * @deprecated 3.0.0 Use {$taxonomy}_add_form instead.
569 * @param object $arg Optional arguments cast to an object.
571 do_action( 'edit_link_category_form', (object) array( 'parent' => 0 ) );
574 * Fires at the end of the Add Tag form.
577 * @deprecated 3.0.0 Use {$taxonomy}_add_form instead.
579 * @param string $taxonomy The taxonomy slug.
581 do_action( 'add_tag_form', $taxonomy );
585 * Fires at the end of the Add Term form for all taxonomies.
587 * The dynamic portion of the hook name, `$taxonomy`, refers to the taxonomy slug.
591 * @param string $taxonomy The taxonomy slug.
593 do_action( "{$taxonomy}_add_form", $taxonomy );
599 </div><!-- /col-left -->
601 </div><!-- /col-container -->
604 <?php if ( ! wp_is_mobile() ) : ?>
605 <script type="text/javascript">
606 try{document.forms.addtag['tag-name'].focus();}catch(e){}
611 $wp_list_table->inline_edit();
613 include( ABSPATH . 'wp-admin/admin-footer.php' );