Ticket #26092: 26092.patch

wp-admin/includes/meta-boxes.php

@@ -42 +42 @@
         $preview_button = __( 'Preview Changes' );
 } else {
         $preview_link = set_url_scheme( get_permalink( $post->ID ) );
+        /**
+         * Filter the URI of a post preview in the post submit box.
+         *
+         * @since 2.0.11
+         *
+         * @param string $preview_link The URI the user will be directed to.
+         */
         $preview_link = esc_url( apply_filters( 'preview_post_link', add_query_arg( 'preview', 'true', $preview_link ) ) );
         $preview_button = __( 'Preview' );
 }
@@ -198 +205 @@
 </div><?php // /misc-pub-section ?>
 <?php endif; ?>
 
-<?php do_action('post_submitbox_misc_actions'); ?>
+<?php 
+/**
+ * Fires after post miscellaneous actions.
+ *
+ * @since 2.9
+ */
+do_action('post_submitbox_misc_actions'); 
+?>
 </div>
 <div class="clear"></div>
 </div>
 
 <div id="major-publishing-actions">
-<?php do_action('post_submitbox_start'); ?>
+<?php 
+/**
+ * Fires before the post submit actions.
+ *
+ * @since 2.7
+ */
+do_action('post_submitbox_start'); 
+?>
 <div id="delete-action">
 <?php
 if ( current_user_can( "delete_post", $post->ID ) ) {
@@ -282 +303 @@
                 <span id="timestamp"><?php printf($stamp, $date); ?></span>
         </div><!-- .misc-pub-section -->
 
-        <?php do_action('attachment_submitbox_misc_actions'); ?>
+        <?php 
+        /**
+         * Fires after attachment miscellaneous actions.
+         *
+         * @since 3.5
+         */
+        do_action('attachment_submitbox_misc_actions'); 
+        ?>
 </div><!-- #misc-publishing-actions -->
 <div class="clear"></div>
 </div><!-- #minor-publishing -->
@@ -525 +553 @@
 <p class="meta-options">
         <label for="comment_status" class="selectit"><input name="comment_status" type="checkbox" id="comment_status" value="open" <?php checked($post->comment_status, 'open'); ?> /> <?php _e( 'Allow comments.' ) ?></label><br />
         <label for="ping_status" class="selectit"><input name="ping_status" type="checkbox" id="ping_status" value="open" <?php checked($post->ping_status, 'open'); ?> /> <?php printf( __( 'Allow <a href="%s" target="_blank">trackbacks and pingbacks</a> on this page.' ), __( 'http://codex.wordpress.org/Introduction_to_Blogging#Managing_Comments' ) ); ?></label>
-        <?php do_action('post_comment_status_meta_box-options', $post); ?>
+        <?php 
+        /**
+         * Fires after attachment miscellaneous actions.
+         *
+         * @since 3.1
+         *
+         * @param object $post The current post being edited.
+         */
+        do_action('post_comment_status_meta_box-options', $post); 
+        ?>
 </p>
 <?php
 }
@@ -588 +625 @@
  * @param object $post
  */
 function post_slug_meta_box($post) {
+/**
+ * Filter the editable slug value in the slug form field.
+ *
+ * @since 2.6
+ *
+ * @param string $post->post_name The post name.
+ */
 ?>
 <label class="screen-reader-text" for="post_name"><?php _e('Slug') ?></label><input name="post_name" type="text" size="13" id="post_name" value="<?php echo esc_attr( apply_filters('editable_slug', $post->post_name) ); ?>" />
 <?php
@@ -646 +690 @@
                         'echo'             => 0,
                 );
 
+                /**
+                 * Filter the arguments for Pages dropdown when assigning a page parent.
+                 *
+                 * @since 3.3
+                 *
+                 * @param array $dropdown_args {
+                 *     Optional. Override default arguments.
+                 *
+                 *     @type string $post_type The type of post to retreive. Must be hierarchical.
+                 *     @type int $exclude_tree Define a parent Page ID to be excluded. Use this parameter to exclude a parent and all of that parent's child Pages.
+                 *     @type int $selected Page ID of the page to be 'selected' or presented in the display box.
+                 *     @type string $name Name assigned to the dropdown form.
+                 *     @type string $show_option_none Causes the HTML for the dropdown to allow you to select NONE of the pages. If not empty, this string will be used as the option text.
+                 *     @type string $sort_column Which column(s) to sort the results by. Comma separated.
+                 *     @type int $echo Toggles the display of the generated list of links or return the list as an HTML text string to be used in PHP.
+                 * }
+                 * @param object $post The current post object.
+                 */
                 $dropdown_args = apply_filters( 'page_attributes_dropdown_pages_args', $dropdown_args, $post );
                 $pages = wp_dropdown_pages( $dropdown_args );
                 if ( ! empty($pages) ) {
@@ -710 +772 @@
 </div>
 
 <div id="major-publishing-actions">
-<?php do_action('post_submitbox_start'); ?>
+<?php 
+/** This action is documented in wp-admin/includes/meta-boxes.php */
+do_action('post_submitbox_start'); 
+?>
 <div id="delete-action">
 <?php
 if ( !empty($_GET['action']) && 'edit' == $_GET['action'] && current_user_can('manage_links') ) { ?>
@@ -727 +792 @@
 </div>
 <div class="clear"></div>
 </div>
-<?php do_action('submitlink_box'); ?>
+<?php 
+/**
+ * Fires after major publishing actions when adding a link.
+ *
+ * @since 2.5
+ */
+do_action('submitlink_box'); 
+?>
 <div class="clear"></div>
 </div>
 <?php