WordPress 4.0
[autoinstalls/wordpress.git] / wp-admin / edit-tags.php
index 0a046370b3587696c818403415c125d4aafdaf9d..953f6f430c5dee63897c481002d74796ca6ba216 100644 (file)
@@ -63,7 +63,6 @@ case 'add-tag':
                $location = add_query_arg( 'message', 4, $location );
        wp_redirect( $location );
        exit;
-break;
 
 case 'delete':
        $location = 'edit-tags.php?taxonomy=' . $taxonomy;
@@ -91,8 +90,6 @@ case 'delete':
        wp_redirect( $location );
        exit;
 
-break;
-
 case 'bulk-delete':
        check_admin_referer( 'bulk-tags' );
 
@@ -116,8 +113,6 @@ case 'bulk-delete':
        wp_redirect( $location );
        exit;
 
-break;
-
 case 'edit':
        $title = $tax->labels->edit_item;
 
@@ -160,7 +155,6 @@ case 'editedtag':
 
        wp_redirect( $location );
        exit;
-break;
 
 default:
 if ( ! empty($_REQUEST['_wp_http_referer']) ) {
@@ -240,7 +234,7 @@ if ( 'category' == $taxonomy || 'link_category' == $taxonomy || 'post_tag' == $t
        else
                $help .= '<p>' . __( '<a href="http://codex.wordpress.org/Posts_Tags_Screen" target="_blank">Documentation on Tags</a>' ) . '</p>';
 
-       $help .= '<p>' . __('<a href="http://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>';
+       $help .= '<p>' . __('<a href="https://wordpress.org/support/" target="_blank">Support Forums</a>') . '</p>';
 
        get_current_screen()->set_help_sidebar( $help );
 
@@ -281,6 +275,13 @@ $messages['post_tag'] = array(
        6 => __( 'Tags deleted.' )
 );
 
+/**
+ * Filter the messages displayed when a tag is updated.
+ *
+ * @since 3.7.0
+ *
+ * @param array $messages The messages to be displayed.
+ */
 $messages = apply_filters( 'term_updated_messages', $messages );
 
 $message = false;
@@ -294,7 +295,6 @@ if ( isset( $_REQUEST['message'] ) && ( $msg = (int) $_REQUEST['message'] ) ) {
 ?>
 
 <div class="wrap nosubsub">
-<?php screen_icon(); ?>
 <h2><?php echo esc_html( $title );
 if ( !empty($_REQUEST['s']) )
        printf( '<span class="subtitle">' . __('Search results for &#8220;%s&#8221;') . '</span>', esc_html( wp_unslash($_REQUEST['s']) ) ); ?>
@@ -330,7 +330,12 @@ endif; ?>
 
 <?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>
+<p>
+       <?php
+       /** This filter is documented in wp-includes/category-template.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; ?>
@@ -340,7 +345,17 @@ endif; ?>
 <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);
+
+/**
+ * Fires after the taxonomy list table.
+ *
+ * The dynamic portion of the hook name, $taxonomy, refers to the taxonomy slug.
+ *
+ * @since 3.0.0
+ *
+ * @param string $taxonomy The taxonomy name.
+ */
+do_action( "after-{$taxonomy}-table", $taxonomy );
 ?>
 
 </div>
@@ -353,7 +368,7 @@ do_action('after-' . $taxonomy . '-table', $taxonomy);
 
 if ( !is_null( $tax->labels->popular_items ) ) {
        if ( current_user_can( $tax->cap->edit_terms ) )
-               $tag_cloud = wp_tag_cloud( array( 'taxonomy' => $taxonomy, 'echo' => false, 'link' => 'edit' ) );
+               $tag_cloud = wp_tag_cloud( array( 'taxonomy' => $taxonomy, 'post_type' => $post_type, 'echo' => false, 'link' => 'edit' ) );
        else
                $tag_cloud = wp_tag_cloud( array( 'taxonomy' => $taxonomy, 'echo' => false ) );
 
@@ -368,20 +383,62 @@ endif;
 }
 
 if ( current_user_can($tax->cap->edit_terms) ) {
-       // Back compat hooks. Deprecated in preference to {$taxonomy}_pre_add_form
-       if ( 'category' == $taxonomy )
-               do_action('add_category_form_pre', (object)array('parent' => 0) );
-       elseif ( 'link_category' == $taxonomy )
-               do_action('add_link_category_form_pre', (object)array('parent' => 0) );
-       else
-               do_action('add_tag_form_pre', $taxonomy);
+       if ( 'category' == $taxonomy ) {
+               /**
+                * Fires before the Add Category form.
+                *
+                * @since 2.1.0
+                * @deprecated 3.0.0 Use {$taxonomy}_pre_add_form instead.
+                *
+                * @param object $arg Optional arguments cast to an object.
+                */
+               do_action( 'add_category_form_pre', (object) array( 'parent' => 0 ) );
+       } elseif ( 'link_category' == $taxonomy ) {
+               /**
+                * Fires before the link category form.
+                *
+                * @since 2.3.0
+                * @deprecated 3.0.0 Use {$taxonomy}_pre_add_form instead.
+                *
+                * @param object $arg Optional arguments cast to an object.
+                */
+               do_action( 'add_link_category_form_pre', (object) array( 'parent' => 0 ) );
+       } else {
+               /**
+                * Fires before the Add Tag form.
+                *
+                * @since 2.5.0
+                * @deprecated 3.0.0 Use {$taxonomy}_pre_add_form instead.
+                *
+                * @param string $taxonomy The taxonomy slug.
+                */
+               do_action( 'add_tag_form_pre', $taxonomy );
+       }
 
-       do_action($taxonomy . '_pre_add_form', $taxonomy);
+       /**
+        * Fires before the Add Term form for all taxonomies.
+        *
+        * The dynamic portion of the hook name, $taxonomy, refers to the taxonomy slug.
+        *
+        * @since 3.0.0
+        *
+        * @param string $taxonomy The taxonomy slug.
+        */
+       do_action( "{$taxonomy}_pre_add_form", $taxonomy );
 ?>
 
 <div class="form-wrap">
 <h3><?php echo $tax->labels->add_new_item; ?></h3>
-<form id="addtag" method="post" action="edit-tags.php" class="validate"<?php do_action( $taxonomy . '_term_new_form_tag' ); ?>>
+<?php
+/**
+ * Fires at the beginning of the Add Tag form.
+ *
+ * The dynamic portion of the hook name, $taxonomy, refers to the taxonomy slug.
+ *
+ * @since 3.7.0
+ */
+?>
+<form id="addtag" method="post" action="edit-tags.php" class="validate"<?php do_action( "{$taxonomy}_term_new_form_tag" ); ?>>
 <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); ?>" />
@@ -414,6 +471,25 @@ if ( current_user_can($tax->cap->edit_terms) ) {
                'show_option_none' => __( 'None' ),
        );
 
+       /**
+        * Filter the taxonomy parent drop-down on the Edit Term page.
+        *
+        * @since 3.7.0
+        *
+        * @param array  $dropdown_args {
+        *     An array of taxonomy parent drop-down arguments.
+        *
+        *     @type int|bool $hide_empty       Whether to hide terms not attached to any posts. Default 0|false.
+        *     @type bool     $hide_if_empty    Whether to hide the drop-down if no terms exist. Default false.
+        *     @type string   $taxonomy         The taxonomy slug.
+        *     @type string   $name             Value of the name attribute to use for the drop-down select element.
+        *                                      Default 'parent'.
+        *     @type string   $orderby          The field to order by. Default 'name'.
+        *     @type bool     $hierarchical     Whether the taxonomy is hierarchical. Default true.
+        *     @type string   $show_option_none Label to display if there are no terms. Default 'None'.
+        * }
+        * @param string $taxonomy The taxonomy slug.
+        */
        $dropdown_args = apply_filters( 'taxonomy_parent_dropdown_args', $dropdown_args, $taxonomy );
        wp_dropdown_categories( $dropdown_args );
        ?>
@@ -429,21 +505,72 @@ if ( current_user_can($tax->cap->edit_terms) ) {
 </div>
 
 <?php
-if ( ! is_taxonomy_hierarchical($taxonomy) )
-       do_action('add_tag_form_fields', $taxonomy);
-do_action($taxonomy . '_add_form_fields', $taxonomy);
+if ( ! is_taxonomy_hierarchical( $taxonomy ) ) {
+       /**
+        * Fires after the Add Tag form fields for non-hierarchical taxonomies.
+        *
+        * @since 3.0.0
+        *
+        * @param string $taxonomy The taxonomy slug.
+        */
+       do_action( 'add_tag_form_fields', $taxonomy );
+}
+
+/**
+ * Fires after the Add Term form fields for hierarchical taxonomies.
+ *
+ * The dynamic portion of the hook name, $taxonomy, refers to the taxonomy slug.
+ *
+ * @since 3.0.0
+ *
+ * @param string $taxonomy The taxonomy slug.
+ */
+do_action( "{$taxonomy}_add_form_fields", $taxonomy );
 
 submit_button( $tax->labels->add_new_item );
 
-// Back compat hooks. Deprecated in preference to {$taxonomy}_add_form
-if ( 'category' == $taxonomy )
-       do_action('edit_category_form', (object)array('parent' => 0) );
-elseif ( 'link_category' == $taxonomy )
-       do_action('edit_link_category_form', (object)array('parent' => 0) );
-else
-       do_action('add_tag_form', $taxonomy);
+if ( 'category' == $taxonomy ) {
+       /**
+        * Fires at the end of the Edit Category form.
+        *
+        * @since 2.1.0
+        * @deprecated 3.0.0 Use {$taxonomy}_add_form instead.
+        *
+        * @param object $arg Optional arguments cast to an object.
+        */
+       do_action( 'edit_category_form', (object) array( 'parent' => 0 ) );
+} elseif ( 'link_category' == $taxonomy ) {
+       /**
+        * Fires at the end of the Edit Link form.
+        *
+        * @since 2.3.0
+        * @deprecated 3.0.0 Use {$taxonomy}_add_form instead.
+        *
+        * @param object $arg Optional arguments cast to an object.
+        */
+       do_action( 'edit_link_category_form', (object) array( 'parent' => 0 ) );
+} else {
+       /**
+        * Fires at the end of the Add Tag form.
+        *
+        * @since 2.7.0
+        * @deprecated 3.0.0 Use {$taxonomy}_add_form instead.
+        *
+        * @param string $taxonomy The taxonomy slug.
+        */
+       do_action( 'add_tag_form', $taxonomy );
+}
 
-do_action($taxonomy . '_add_form', $taxonomy);
+/**
+ * Fires at the end of the Add Term form for all taxonomies.
+ *
+ * The dynamic portion of the hook name, $taxonomy, refers to the taxonomy slug.
+ *
+ * @since 3.0.0
+ *
+ * @param string $taxonomy The taxonomy slug.
+ */
+do_action( "{$taxonomy}_add_form", $taxonomy );
 ?>
 </form></div>
 <?php } ?>