]> scripts.mit.edu Git - autoinstalls/wordpress.git/blobdiff - wp-admin/edit-tags.php
Wordpress 3.0.1
[autoinstalls/wordpress.git] / wp-admin / edit-tags.php
index 44b7a8b82d5a98dce163f78455931a402519434b..057aa489d23fba9ab5f07fbef92e38e57487c7e0 100644 (file)
@@ -7,20 +7,33 @@
  */
 
 /** WordPress Administration Bootstrap */
-require_once('admin.php');
+require_once('./admin.php');
 
-$title = __('Tags');
-
-wp_reset_vars( array('action', 'tag', 'taxonomy') );
+wp_reset_vars( array('action', 'tag', 'taxonomy', 'post_type') );
 
 if ( empty($taxonomy) )
        $taxonomy = 'post_tag';
 
-if ( !is_taxonomy($taxonomy) )
+if ( !taxonomy_exists($taxonomy) )
        wp_die(__('Invalid taxonomy'));
 
-$parent_file = 'edit.php';
-$submenu_file = "edit-tags.php?taxonomy=$taxonomy";
+$tax = get_taxonomy($taxonomy);
+
+if ( ! current_user_can($tax->cap->manage_terms) )
+       wp_die(__('Cheatin’ uh?'));
+
+$title = $tax->labels->name;
+
+if ( empty($post_type) || !in_array( $post_type, get_post_types( array('public' => true) ) ) )
+       $post_type = 'post';
+
+if ( 'post' != $post_type ) {
+       $parent_file = "edit.php?post_type=$post_type";
+       $submenu_file = "edit-tags.php?taxonomy=$taxonomy&post_type=$post_type";
+} else {
+       $parent_file = 'edit.php';
+       $submenu_file = "edit-tags.php?taxonomy=$taxonomy";
+}
 
 if ( isset( $_GET['action'] ) && isset($_GET['delete_tags']) && ( 'delete' == $_GET['action'] || 'delete' == $_GET['action2'] ) )
        $action = 'bulk-delete';
@@ -31,38 +44,49 @@ case 'add-tag':
 
        check_admin_referer('add-tag');
 
-       if ( !current_user_can('manage_categories') )
+       if ( !current_user_can($tax->cap->edit_terms) )
                wp_die(__('Cheatin’ uh?'));
 
        $ret = wp_insert_term($_POST['tag-name'], $taxonomy, $_POST);
-       if ( $ret && !is_wp_error( $ret ) ) {
-               wp_redirect('edit-tags.php?message=1#addtag');
-       } else {
-               wp_redirect('edit-tags.php?message=4#addtag');
+       $location = 'edit-tags.php?taxonomy=' . $taxonomy;
+       if ( 'post' != $post_type )
+               $location .= '&post_type=' . $post_type;
+
+       if ( $referer = wp_get_original_referer() ) {
+               if ( false !== strpos($referer, 'edit-tags.php') )
+                       $location = $referer;
        }
+
+       if ( $ret && !is_wp_error( $ret ) )
+               $location = add_query_arg('message', 1, $location);
+       else
+               $location = add_query_arg('message', 4, $location);
+       wp_redirect($location);
        exit;
 break;
 
 case 'delete':
+       $location = 'edit-tags.php?taxonomy=' . $taxonomy;
+       if ( 'post' != $post_type )
+               $location .= '&post_type=' . $post_type;
+       if ( $referer = wp_get_referer() ) {
+               if ( false !== strpos($referer, 'edit-tags.php') )
+                       $location = $referer;
+       }
+
        if ( !isset( $_GET['tag_ID'] ) ) {
-               wp_redirect("edit-tags.php?taxonomy=$taxonomy");
+               wp_redirect($location);
                exit;
        }
 
        $tag_ID = (int) $_GET['tag_ID'];
        check_admin_referer('delete-tag_' .  $tag_ID);
 
-       if ( !current_user_can('manage_categories') )
+       if ( !current_user_can($tax->cap->delete_terms) )
                wp_die(__('Cheatin’ uh?'));
 
        wp_delete_term( $tag_ID, $taxonomy);
 
-       $location = 'edit-tags.php';
-       if ( $referer = wp_get_referer() ) {
-               if ( false !== strpos($referer, 'edit-tags.php') )
-                       $location = $referer;
-       }
-
        $location = add_query_arg('message', 2, $location);
        wp_redirect($location);
        exit;
@@ -72,7 +96,7 @@ break;
 case 'bulk-delete':
        check_admin_referer('bulk-tags');
 
-       if ( !current_user_can('manage_categories') )
+       if ( !current_user_can($tax->cap->delete_terms) )
                wp_die(__('Cheatin’ uh?'));
 
        $tags = (array) $_GET['delete_tags'];
@@ -80,7 +104,9 @@ case 'bulk-delete':
                wp_delete_term( $tag_ID, $taxonomy);
        }
 
-       $location = 'edit-tags.php';
+       $location = 'edit-tags.php?taxonomy=' . $taxonomy;
+       if ( 'post' != $post_type )
+               $location .= '&post_type=' . $post_type;
        if ( $referer = wp_get_referer() ) {
                if ( false !== strpos($referer, 'edit-tags.php') )
                        $location = $referer;
@@ -93,13 +119,16 @@ case 'bulk-delete':
 break;
 
 case 'edit':
-       $title = __('Edit Tag');
+       $title = $tax->labels->edit_item;
 
        require_once ('admin-header.php');
        $tag_ID = (int) $_GET['tag_ID'];
 
+       if ( !current_user_can($tax->cap->edit_terms) )
+               wp_die( __('You are not allowed to edit this item.') );
+
        $tag = get_term($tag_ID, $taxonomy, OBJECT, 'edit');
-       include('edit-tag-form.php');
+       include('./edit-tag-form.php');
 
 break;
 
@@ -107,12 +136,15 @@ case 'editedtag':
        $tag_ID = (int) $_POST['tag_ID'];
        check_admin_referer('update-tag_' . $tag_ID);
 
-       if ( !current_user_can('manage_categories') )
+       if ( !current_user_can($tax->cap->edit_terms) )
                wp_die(__('Cheatin’ uh?'));
 
        $ret = wp_update_term($tag_ID, $taxonomy, $_POST);
 
-       $location = 'edit-tags.php';
+       $location = 'edit-tags.php?taxonomy=' . $taxonomy;
+       if ( 'post' != $post_type )
+               $location .= '&post_type=' . $post_type;
+
        if ( $referer = wp_get_original_referer() ) {
                if ( false !== strpos($referer, 'edit-tags.php') )
                        $location = $referer;
@@ -129,45 +161,83 @@ break;
 
 default:
 
-if ( isset($_GET['_wp_http_referer']) && ! empty($_GET['_wp_http_referer']) ) {
+if ( ! empty($_GET['_wp_http_referer']) ) {
         wp_redirect( remove_query_arg( array('_wp_http_referer', '_wpnonce'), stripslashes($_SERVER['REQUEST_URI']) ) );
         exit;
 }
 
-$can_manage = current_user_can('manage_categories');
-
 wp_enqueue_script('admin-tags');
-if ( $can_manage )
+if ( current_user_can($tax->cap->edit_terms) )
        wp_enqueue_script('inline-edit-tax');
 
+if ( 'category' == $taxonomy || 'post_tag' == $taxonomy ) {
+       if ( 'category' == $taxonomy )
+               $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>';
+       else
+               $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>';
+
+       $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>';
+
+       if ( 'category' == $taxonomy )
+               $help .= '<p>' . __('When adding a new category on this screen, you&#8217;ll fill in the following fields:') . '</p>';
+       else
+               $help .= '<p>' . __('When adding a new tag on this screen, you&#8217;ll fill in the following fields:') . '</p>';
+
+       $help .= '<ul>' .
+               '<li>' . __('<strong>Name</strong> - The name is how it appears on your site.') . '</li>';
+       if ( ! global_terms_enabled() )
+               $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>';
+
+       if ( 'category' == $taxonomy )
+               $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>';
+
+       $help .= '<li>' . __('<strong>Description</strong> - The description is not prominent by default; however, some themes may display it.') . '</li>' .
+               '</ul>' .
+               '<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>' .
+               '<p><strong>' . __('For more information:') . '</strong></p>';
+
+       if ( 'category' == $taxonomy )
+               $help .= '<p>' . __('<a href="http://codex.wordpress.org/Manage_Categories_SubPanel" target="_blank">Categories Documentation</a>') . '</p>';
+       else
+               $help .= '<p>' . __('<a href="http://codex.wordpress.org/Post_Tags_SubPanel" target="_blank">Tags Documentation</a>') . '</p>';
+
+       $help .= '<p>' . __('<a href="http://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>';
+
+       add_contextual_help($current_screen, $help);
+       unset($help);
+}
+
 require_once ('admin-header.php');
 
-$messages[1] = __('Tag added.');
-$messages[2] = __('Tag deleted.');
-$messages[3] = __('Tag updated.');
-$messages[4] = __('Tag not added.');
-$messages[5] = __('Tag not updated.');
-$messages[6] = __('Tags deleted.'); ?>
+$messages[1] = __('Item added.');
+$messages[2] = __('Item deleted.');
+$messages[3] = __('Item updated.');
+$messages[4] = __('Item not added.');
+$messages[5] = __('Item not updated.');
+$messages[6] = __('Items deleted.');
+
+?>
 
 <div class="wrap nosubsub">
 <?php screen_icon(); ?>
 <h2><?php echo esc_html( $title );
-if ( isset($_GET['s']) && $_GET['s'] )
+if ( !empty($_GET['s']) )
        printf( '<span class="subtitle">' . __('Search results for &#8220;%s&#8221;') . '</span>', esc_html( stripslashes($_GET['s']) ) ); ?>
 </h2>
 
 <?php if ( isset($_GET['message']) && ( $msg = (int) $_GET['message'] ) ) : ?>
-<div id="message" class="updated fade"><p><?php echo $messages[$msg]; ?></p></div>
+<div id="message" class="updated"><p><?php echo $messages[$msg]; ?></p></div>
 <?php $_SERVER['REQUEST_URI'] = remove_query_arg(array('message'), $_SERVER['REQUEST_URI']);
 endif; ?>
 <div id="ajax-response"></div>
 
 <form class="search-form" action="" method="get">
 <input type="hidden" name="taxonomy" value="<?php echo esc_attr($taxonomy); ?>" />
+<input type="hidden" name="post_type" value="<?php echo esc_attr($post_type); ?>" />
 <p class="search-box">
-       <label class="screen-reader-text" for="tag-search-input"><?php _e( 'Search Tags' ); ?>:</label>
+       <label class="screen-reader-text" for="tag-search-input"><?php echo $tax->labels->search_items; ?>:</label>
        <input type="text" id="tag-search-input" name="s" value="<?php _admin_search_query(); ?>" />
-       <input type="submit" value="<?php esc_attr_e( 'Search Tags' ); ?>" class="button" />
+       <input type="submit" value="<?php echo esc_attr( $tax->labels->search_items );  ?>" class="button" />
 </p>
 </form>
 <br class="clear" />
@@ -178,24 +248,35 @@ endif; ?>
 <div class="col-wrap">
 <form id="posts-filter" action="" method="get">
 <input type="hidden" name="taxonomy" value="<?php echo esc_attr($taxonomy); ?>" />
+<input type="hidden" name="post_type" value="<?php echo esc_attr($post_type); ?>" />
 <div class="tablenav">
 <?php
 $pagenum = isset( $_GET['pagenum'] ) ? absint( $_GET['pagenum'] ) : 0;
 if ( empty($pagenum) )
        $pagenum = 1;
 
-$tags_per_page = (int) get_user_option( 'edit_tags_per_page', 0, false );
+$tags_per_page = (int) get_user_option( 'edit_' .  $taxonomy . '_per_page' );
+
 if ( empty($tags_per_page) || $tags_per_page < 1 )
        $tags_per_page = 20;
-$tags_per_page = apply_filters( 'edit_tags_per_page', $tags_per_page );
-$tags_per_page = apply_filters( 'tagsperpage', $tags_per_page ); // Old filter
+
+if ( 'post_tag' == $taxonomy ) {
+       $tags_per_page = apply_filters( 'edit_tags_per_page', $tags_per_page );
+       $tags_per_page = apply_filters( 'tagsperpage', $tags_per_page ); // Old filter
+} elseif ( 'category' == $taxonomy ) {
+       $tags_per_page = apply_filters( 'edit_categories_per_page', $tags_per_page ); // Old filter
+} else {
+       $tags_per_page = apply_filters( 'edit_' . $taxonomy . '_per_page', $tags_per_page );
+}
+
+$searchterms = !empty($_GET['s']) ? trim(stripslashes($_GET['s'])) : '';
 
 $page_links = paginate_links( array(
        'base' => add_query_arg( 'pagenum', '%#%' ),
        'format' => '',
        'prev_text' => __('&laquo;'),
        'next_text' => __('&raquo;'),
-       'total' => ceil(wp_count_terms($taxonomy) / $tags_per_page),
+       'total' => ceil(wp_count_terms($taxonomy, array('search' => $searchterms)) / $tags_per_page),
        'current' => $pagenum
 ));
 
@@ -216,27 +297,21 @@ if ( $page_links )
 </div>
 
 <div class="clear"></div>
-
 <table class="widefat tag fixed" cellspacing="0">
        <thead>
        <tr>
-<?php print_column_headers('edit-tags'); ?>
+<?php print_column_headers($current_screen); ?>
        </tr>
        </thead>
 
        <tfoot>
        <tr>
-<?php print_column_headers('edit-tags', false); ?>
+<?php print_column_headers($current_screen, false); ?>
        </tr>
        </tfoot>
 
        <tbody id="the-list" class="list:tag">
-<?php
-
-$searchterms = isset( $_GET['s'] ) ? trim( $_GET['s'] ) : '';
-
-$count = tag_rows( $pagenum, $tags_per_page, $searchterms, $taxonomy );
-?>
+<?php tag_rows( $pagenum, $tags_per_page, $searchterms, $taxonomy ); ?>
        </tbody>
 </table>
 
@@ -259,52 +334,103 @@ if ( $page_links )
 
 <br class="clear" />
 </form>
+
+<?php if ( 'category' == $taxonomy ) : ?>
+<div class="form-wrap">
+<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>
+<?php if ( current_user_can( 'import' ) ) : ?>
+<p><?php printf(__('Categories can be selectively converted to tags using the <a href="%s">category to tag converter</a>.'), 'import.php') ?></p>
+<?php endif; ?>
+</div>
+<?php elseif ( 'post_tag' == $taxonomy && current_user_can( 'import' ) ) : ?>
+<div class="form-wrap">
+<p><?php printf(__('Tags can be selectively converted to categories using the <a href="%s">tag to category converter</a>'), 'import.php') ;?>.</p>
+</div>
+<?php endif;
+do_action('after-' . $taxonomy . '-table', $taxonomy);
+?>
+
 </div>
 </div><!-- /col-right -->
 
 <div id="col-left">
 <div class="col-wrap">
 
-<div class="tagcloud">
-<h3><?php _e('Popular Tags'); ?></h3>
 <?php
-if ( $can_manage )
-       wp_tag_cloud(array('taxonomy' => $taxonomy, 'link' => 'edit'));
-else
-       wp_tag_cloud(array('taxonomy' => $taxonomy));
-?>
+
+if ( !is_taxonomy_hierarchical($taxonomy) ) {
+       if ( current_user_can( $tax->cap->edit_terms ) )
+               $tag_cloud = wp_tag_cloud( array( 'taxonomy' => $taxonomy, 'echo' => false, 'link' => 'edit' ) );
+       else
+               $tag_cloud = wp_tag_cloud( array( 'taxonomy' => $taxonomy, 'echo' => false ) );
+
+       if ( $tag_cloud ) :
+       ?>
+<div class="tagcloud">
+<h3><?php echo $tax->labels->popular_items; ?></h3>
+<?php echo $tag_cloud; unset( $tag_cloud ); ?>
 </div>
+<?php
+endif;
+}
 
-<?php if ( $can_manage ) {
-       do_action('add_tag_form_pre'); ?>
+if ( current_user_can($tax->cap->edit_terms) ) {
+       if ( 'category' == $taxonomy )
+               do_action('add_category_form_pre', (object)array('parent' => 0) );  // Back compat hook. Deprecated in preference to $taxonomy_pre_add_form
+       else
+               do_action('add_tag_form_pre', $taxonomy); // Back compat hook. Applies to all Taxonomies -not- categories
+       do_action($taxonomy . '_pre_add_form', $taxonomy);
+?>
 
 <div class="form-wrap">
-<h3><?php _e('Add a New Tag'); ?></h3>
+<h3><?php echo $tax->labels->add_new_item; ?></h3>
 <form id="addtag" method="post" action="edit-tags.php" class="validate">
 <input type="hidden" name="action" value="add-tag" />
+<input type="hidden" name="screen" value="<?php echo esc_attr($current_screen->id); ?>" />
 <input type="hidden" name="taxonomy" value="<?php echo esc_attr($taxonomy); ?>" />
+<input type="hidden" name="post_type" value="<?php echo esc_attr($post_type); ?>" />
 <?php wp_nonce_field('add-tag'); ?>
 
 <div class="form-field form-required">
-       <label for="tag-name"><?php _e('Tag name') ?></label>
+       <label for="tag-name"><?php _ex('Name', 'Taxonomy Name'); ?></label>
        <input name="tag-name" id="tag-name" type="text" value="" size="40" aria-required="true" />
-       <p><?php _e('The name is how the tag appears on your site.'); ?></p>
+       <p><?php _e('The name is how it appears on your site.'); ?></p>
 </div>
-
+<?php if ( ! global_terms_enabled() ) : ?>
 <div class="form-field">
-       <label for="slug"><?php _e('Tag slug') ?></label>
-       <input name="slug" id="slug" type="text" value="" size="40" />
+       <label for="tag-slug"><?php _ex('Slug', 'Taxonomy Slug'); ?></label>
+       <input name="slug" id="tag-slug" type="text" value="" size="40" />
        <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>
 </div>
-
+<?php endif; // is_multisite() ?>
+<?php if ( is_taxonomy_hierarchical($taxonomy) ) : ?>
 <div class="form-field">
-       <label for="description"><?php _e('Description') ?></label>
-       <textarea name="description" id="description" rows="5" cols="40"></textarea>
-    <p><?php _e('The description is not prominent by default; however, some themes may show it.'); ?></p>
+       <label for="parent"><?php _ex('Parent', 'Taxonomy Parent'); ?></label>
+       <?php wp_dropdown_categories(array('hide_empty' => 0, 'hide_if_empty' => false, 'taxonomy' => $taxonomy, 'name' => 'parent', 'orderby' => 'name', 'hierarchical' => true, 'show_option_none' => __('None'))); ?>
+       <?php if ( 'category' == $taxonomy ) : // @todo: Generic text for hierarchical taxonomies ?>
+               <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>
+       <?php endif; ?>
+</div>
+<?php endif; // is_taxonomy_hierarchical() ?>
+<div class="form-field">
+       <label for="tag-description"><?php _ex('Description', 'Taxonomy Description'); ?></label>
+       <textarea name="description" id="tag-description" rows="5" cols="40"></textarea>
+       <p><?php _e('The description is not prominent by default; however, some themes may show it.'); ?></p>
 </div>
 
-<p class="submit"><input type="submit" class="button" name="submit" id="submit" value="<?php esc_attr_e('Add Tag'); ?>" /></p>
-<?php do_action('add_tag_form'); ?>
+<?php
+if ( ! is_taxonomy_hierarchical($taxonomy) )
+       do_action('add_tag_form_fields', $taxonomy);
+do_action($taxonomy . '_add_form_fields', $taxonomy);
+?>
+<p class="submit"><input type="submit" class="button" name="submit" id="submit" value="<?php echo esc_attr( $tax->labels->add_new_item ); ?>" /></p>
+<?php
+if ( 'category' == $taxonomy )
+       do_action('edit_category_form', (object)array('parent' => 0) );  // Back compat hook. Deprecated in preference to $taxonomy_add_form
+else
+       do_action('add_tag_form', $taxonomy); // Back compat hook. Applies to all Taxonomies -not- categories
+do_action($taxonomy . '_add_form', $taxonomy);
+?>
 </form></div>
 <?php } ?>
 
@@ -314,12 +440,12 @@ else
 </div><!-- /col-container -->
 </div><!-- /wrap -->
 
-<?php inline_edit_term_row('edit-tags'); ?>
+<?php inline_edit_term_row('edit-tags', $taxonomy); ?>
 
 <?php
 break;
 }
 
-include('admin-footer.php');
+include('./admin-footer.php');
 
 ?>