Ticket #25448: edit-tag-form.2.diff

wp-admin/edit-tag-form.php

@@ -16 +16 @@
         return;
 }
 
-// Back compat hooks
 if ( 'category' == $taxonomy ) {
+        /**
+         * Fires before the Edit Category form.
+         *
+         * @since 2.1.0
+         * @deprecated 3.0.0 Use {$taxonomy}_pre_edit_form instead.
+         *
+         * @param object $tag Current category object.
+         */
         do_action( 'edit_category_form_pre', $tag );
 } elseif ( 'link_category' == $taxonomy ) {
+        /**
+         * Fires before the Edit Link Category form.
+         *
+         * @since 2.3.0
+         * @deprecated 3.0.0 Use {$taxonomy}_pre_edit_form instead.
+         *
+         * @param object $tag Current link category object.
+         */
         do_action( 'edit_link_category_form_pre', $tag );
 } else {
+        /**
+         * Fires before the Edit Tag form.
+         *
+         * @since 2.5.0
+         * @deprecated 3.0.0 Use {$taxonomy}_pre_edit_form instead.
+         *
+         * @param object $tag Current tag object.
+         */
         do_action( 'edit_tag_form_pre', $tag );
 }
+/**
+ * Fires before the Edit Term form for all taxonomies.
+ *
+ * The dynamic portion of the hook name, $taxonomy, refers to the taxonomy slug.
+ *
+ * @since 3.0.0
+ *
+ * @param object $tag Current taxonomy term object.
+ * @param object $taxonomy Current $taxonomy object.
+ */
 do_action( "{$taxonomy}_pre_edit_form", $tag, $taxonomy ); ?>
 
 <div class="wrap">
 <h2><?php echo $tax->labels->edit_item; ?></h2>
 <div id="ajax-response"></div>
+<?php
+/**
+ * Fires before the Edit Tag form is displayed.
+ *
+ * The dynamic portion of the hook name, $taxonomy, refers to the taxonomy slug.
+ *
+ * @since 3.7.0
+ */
+?>
 <form name="edittag" id="edittag" method="post" action="edit-tags.php" class="validate"<?php do_action( $taxonomy . '_term_edit_form_tag' ); ?>>
 <input type="hidden" name="action" value="editedtag" />
 <input type="hidden" name="tag_ID" value="<?php echo esc_attr($tag->term_id) ?>" />
@@ -43 +85 @@
 <?php if ( !global_terms_enabled() ) { ?>
                 <tr class="form-field">
                         <th scope="row" valign="top"><label for="slug"><?php _ex('Slug', 'Taxonomy Slug'); ?></label></th>
-                        <td><input name="slug" id="slug" type="text" value="<?php if ( isset( $tag->slug ) ) echo esc_attr(apply_filters('editable_slug', $tag->slug)); ?>" size="40" />
+                        <?php
+                        /**
+                         * Filter the editable slug.
+                         *
+                         * @since 2.6.0
+                         *
+                         * @param string $slug The current tag's slug.
+                         */
+                        ?>
+                        <td><input name="slug" id="slug" type="text" value="<?php if ( isset( $tag->slug ) ) echo esc_attr( apply_filters( 'editable_slug', $tag->slug ) ); ?>" size="40" />
                         <p class="description"><?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></td>
                 </tr>
 <?php } ?>
@@ -64 +115 @@
                         <span class="description"><?php _e('The description is not prominent by default; however, some themes may show it.'); ?></span></td>
                 </tr>
                 <?php
-                // Back compat hooks
-                if ( 'category' == $taxonomy )
-                        do_action('edit_category_form_fields', $tag);
-                elseif ( 'link_category' == $taxonomy )
-                        do_action('edit_link_category_form_fields', $tag);
-                else
-                        do_action('edit_tag_form_fields', $tag);
-
-                do_action($taxonomy . '_edit_form_fields', $tag, $taxonomy);
+                if ( 'category' == $taxonomy ) {
+                        /**
+                         * Fires after the Edit Category form fields are displayed.
+                         *
+                         * @since 2.9.0
+                         * @deprecated 3.0.0 Use {$taxonomy}_edit_form_fields instead.
+                         *
+                         * @param object $tag Current taxonomy object.
+                         */
+                        do_action( 'edit_category_form_fields', $tag );
+                } elseif ( 'link_category' == $taxonomy ) {
+                        /**
+                         * Fires after the Edit Link Category form fields are displayed.
+                         *
+                         * @since 2.9.0
+                         * @deprecated 3.0.0 Use {$taxonomy}_edit_form_fields instead.
+                         *
+                         * @param object $tag Current taxonomy object.
+                         */
+                        do_action( 'edit_link_category_form_fields', $tag );
+                } else {
+                        /**
+                         * Fires after the Edit Tag form fields are displayed.
+                         *
+                         * @since 2.9.0
+                         * @deprecated 3.0.0 Use {$taxonomy}_edit_form_fields instead.
+                         *
+                         * @param object $tag Current taxonomy object.
+                         */
+                        do_action( 'edit_tag_form_fields', $tag );
+                }
+                /**
+                 * Fires after the Taxonomy Edit form fields are displayed.
+                 *
+                 * The dynamic portion of the hook name, $taxonomy, refers to the taxonomy slug.
+                 *
+                 * @since 3.0.0
+                 *
+                 * @param object $tag Current taxonomy term object.
+                 * @param object $taxonomy Current taxonomy object.
+                 */
+                do_action( $taxonomy . '_edit_form_fields', $tag, $taxonomy );
                 ?>
         </table>
 <?php
 // Back compat hooks
-if ( 'category' == $taxonomy )
-        do_action('edit_category_form', $tag);
-elseif ( 'link_category' == $taxonomy )
-        do_action('edit_link_category_form', $tag);
-else
-        do_action('edit_tag_form', $tag);
+if ( 'category' == $taxonomy ) {
+        /** This action is documented in wp-admin/edit-tags.php */
+        do_action( 'edit_category_form', $tag );
+} elseif ( 'link_category' == $taxonomy ) {
+        /** This action is documented in wp-admin/edit-tags.php */
+        do_action( 'edit_link_category_form', $tag );
+} else {
+        /**
+         * Fires after the Edit Tag form table is displayed.
+         *
+         * @since 2.5.0
+         * @deprecated 3.0.0 Use {$taxonomy}_edit_form instead.
+         *
+         * @param object $tag Current taxonomy object.
+         */
+        do_action( 'edit_tag_form', $tag );
+}
+/**
+ * Fires after the taxonomy edit form table is displayed.
+ *
+ * The dynamic portion of the hook name, $taxonomy, refers to the taxonomy slug.
+ *
+ * @since 3.0.0
+ *
+ * @param object $tag Current taxonomy term object.
+ * @param object $taxonomy Current taxonomy object.
+ */
+do_action( $taxonomy . '_edit_form', $tag, $taxonomy );
 
-do_action($taxonomy . '_edit_form', $tag, $taxonomy);
-
 submit_button( __('Update') );
 ?>
 </form>
 </div>
 <script type="text/javascript">
 try{document.forms.edittag.name.focus();}catch(e){}
-</script>
+</script>
+ No newline at end of file