]> scripts.mit.edu Git - autoinstalls/wordpress.git/blobdiff - wp-admin/includes/class-wp-posts-list-table.php
WordPress 3.9.1-scripts
[autoinstalls/wordpress.git] / wp-admin / includes / class-wp-posts-list-table.php
index a798a2c2b9ae866978308cd85361528a2462723d..1e763f2ff33ef32790b4d5262b43ff5c19be43af 100644 (file)
@@ -57,9 +57,10 @@ class WP_Posts_List_Table extends WP_List_Table {
                $post_type_object = get_post_type_object( $post_type );
 
                if ( !current_user_can( $post_type_object->cap->edit_others_posts ) ) {
+                       $exclude_states = get_post_stati( array( 'show_in_admin_all_list' => false ) );
                        $this->user_posts_count = $wpdb->get_var( $wpdb->prepare( "
                                SELECT COUNT( 1 ) FROM $wpdb->posts
-                               WHERE post_type = %s AND post_status NOT IN ( 'trash', 'auto-draft' )
+                               WHERE post_type = %s AND post_status NOT IN ( '" . implode( "','", $exclude_states ) . "' )
                                AND post_author = %d
                        ", $post_type, get_current_user_id() ) );
 
@@ -69,7 +70,7 @@ class WP_Posts_List_Table extends WP_List_Table {
 
                if ( 'post' == $post_type && $sticky_posts = get_option( 'sticky_posts' ) ) {
                        $sticky_posts = implode( ', ', array_map( 'absint', (array) $sticky_posts ) );
-                       $this->sticky_posts_count = $wpdb->get_var( $wpdb->prepare( "SELECT COUNT( 1 ) FROM $wpdb->posts WHERE post_type = %s AND post_status != 'trash' AND ID IN ($sticky_posts)", $post_type ) );
+                       $this->sticky_posts_count = $wpdb->get_var( $wpdb->prepare( "SELECT COUNT( 1 ) FROM $wpdb->posts WHERE post_type = %s AND post_status NOT IN ('trash', 'auto-draft') AND ID IN ($sticky_posts)", $post_type ) );
                }
        }
 
@@ -88,6 +89,8 @@ class WP_Posts_List_Table extends WP_List_Table {
 
                $post_type = $this->screen->post_type;
                $per_page = $this->get_items_per_page( 'edit_' . $post_type . '_per_page' );
+
+               /** This filter is documented in wp-admin/includes/post.php */
                $per_page = apply_filters( 'edit_posts_per_page', $per_page, $post_type );
 
                if ( $this->hierarchical_display )
@@ -214,7 +217,17 @@ class WP_Posts_List_Table extends WP_List_Table {
                                );
                                wp_dropdown_categories( $dropdown_options );
                        }
+
+                       /**
+                        * Fires before the Filter button on the Posts and Pages list tables.
+                        *
+                        * The Filter button allows sorting by date and/or category on the
+                        * Posts list table, and sorting by date on the Pages list table.
+                        *
+                        * @since 2.1.0
+                        */
                        do_action( 'restrict_manage_posts' );
+
                        submit_button( __( 'Filter' ), 'button', false, false, array( 'id' => 'post-query-submit' ) );
                }
 
@@ -264,6 +277,17 @@ class WP_Posts_List_Table extends WP_List_Table {
                $taxonomies = get_object_taxonomies( $post_type, 'objects' );
                $taxonomies = wp_filter_object_list( $taxonomies, array( 'show_admin_column' => true ), 'and', 'name' );
 
+               /**
+                * Filter the taxonomy columns in the Posts list table.
+                *
+                * The dynamic portion of the hook name, $post_type, refers to the post
+                * type slug.
+                *
+                * @since 3.5.0
+                *
+                * @param array  $taxonomies Array of taxonomies to show columns for.
+                * @param string $post_type  The post type.
+                */
                $taxonomies = apply_filters( "manage_taxonomies_for_{$post_type}_columns", $taxonomies, $post_type );
                $taxonomies = array_filter( $taxonomies, 'taxonomy_exists' );
 
@@ -280,14 +304,42 @@ class WP_Posts_List_Table extends WP_List_Table {
 
                $post_status = !empty( $_REQUEST['post_status'] ) ? $_REQUEST['post_status'] : 'all';
                if ( post_type_supports( $post_type, 'comments' ) && !in_array( $post_status, array( 'pending', 'draft', 'future' ) ) )
-                       $posts_columns['comments'] = '<span class="vers"><div title="' . esc_attr__( 'Comments' ) . '" class="comment-grey-bubble"></div></span>';
+                       $posts_columns['comments'] = '<span class="vers"><span title="' . esc_attr__( 'Comments' ) . '" class="comment-grey-bubble"></span></span>';
 
                $posts_columns['date'] = __( 'Date' );
 
-               if ( 'page' == $post_type )
+               if ( 'page' == $post_type ) {
+
+                       /**
+                        * Filter the columns displayed in the Pages list table.
+                        *
+                        * @since 2.5.0
+                        *
+                        * @param array $post_columns An array of column names.
+                        */
                        $posts_columns = apply_filters( 'manage_pages_columns', $posts_columns );
-               else
+               } else {
+
+                       /**
+                        * Filter the columns displayed in the Posts list table.
+                        *
+                        * @since 1.5.0
+                        *
+                        * @param array  $posts_columns An array of column names.
+                        * @param string $post_type     The post type slug.
+                        */
                        $posts_columns = apply_filters( 'manage_posts_columns', $posts_columns, $post_type );
+               }
+
+               /**
+                * Filter the columns displayed in the Posts list table for a specific post type.
+                *
+                * The dynamic portion of the hook name, $post_type, refers to the post type slug.
+                *
+                * @since 3.0.0
+                *
+                * @param array $post_columns An array of column names.
+                */
                $posts_columns = apply_filters( "manage_{$post_type}_posts_columns", $posts_columns );
 
                return $posts_columns;
@@ -345,7 +397,7 @@ class WP_Posts_List_Table extends WP_List_Table {
                }
 
                /*
-                * arrange pages into two parts: top level pages and children_pages
+                * Arrange pages into two parts: top level pages and children_pages
                 * children_pages is two dimensional array, eg.
                 * children_pages[10][] contains all sub-pages whose parent is 10.
                 * It only takes O( N ) to arrange this and it takes O( 1 ) for subsequent lookup operations
@@ -417,12 +469,12 @@ class WP_Posts_List_Table extends WP_List_Table {
         *
         * @since 3.1.0 (Standalone function exists since 2.6.0)
         *
-        * @param unknown_type $children_pages
-        * @param unknown_type $count
-        * @param unknown_type $parent
-        * @param unknown_type $level
-        * @param unknown_type $pagenum
-        * @param unknown_type $per_page
+        * @param array $children_pages
+        * @param int $count
+        * @param int $parent
+        * @param int $level
+        * @param int $pagenum
+        * @param int $per_page
         */
        function _page_rows( &$children_pages, &$count, $parent, $level, $pagenum, $per_page ) {
 
@@ -490,8 +542,15 @@ class WP_Posts_List_Table extends WP_List_Table {
                        $classes .= ' wp-locked';
                        $lock_holder = get_userdata( $lock_holder );
                }
+
+               if ( $post->post_parent ) {
+                   $count = count( get_post_ancestors( $post->ID ) );
+                   $classes .= ' level-'. $count;
+               } else {
+                   $classes .= ' level-0';
+               }
        ?>
-               <tr id="post-<?php echo $post->ID; ?>" class="<?php echo implode( ' ', get_post_class( $classes, $post->ID ) ); ?>" valign="top">
+               <tr id="post-<?php echo $post->ID; ?>" class="<?php echo implode( ' ', get_post_class( $classes, $post->ID ) ); ?>">
        <?php
 
                list( $columns, $hidden ) = $this->get_column_info();
@@ -539,8 +598,10 @@ class WP_Posts_List_Table extends WP_List_Table {
                                                        $level++;
                                                        $find_main_page = (int) $parent->post_parent;
 
-                                                       if ( !isset( $parent_name ) )
+                                                       if ( !isset( $parent_name ) ) {
+                                                               /** This filter is documented in wp-includes/post-template.php */
                                                                $parent_name = apply_filters( 'the_title', $parent->post_title, $parent->ID );
+                                                       }
                                                }
                                        }
                                }
@@ -595,14 +656,48 @@ class WP_Posts_List_Table extends WP_List_Table {
                                }
                                if ( $post_type_object->public ) {
                                        if ( in_array( $post->post_status, array( 'pending', 'draft', 'future' ) ) ) {
-                                               if ( $can_edit_post )
+                                               if ( $can_edit_post ) {
+
+                                                       /** This filter is documented in wp-admin/includes/meta-boxes.php */
                                                        $actions['view'] = '<a href="' . esc_url( apply_filters( 'preview_post_link', set_url_scheme( add_query_arg( 'preview', 'true', get_permalink( $post->ID ) ) ) ) ) . '" title="' . esc_attr( sprintf( __( 'Preview &#8220;%s&#8221;' ), $title ) ) . '" rel="permalink">' . __( 'Preview' ) . '</a>';
+                                               }
                                        } elseif ( 'trash' != $post->post_status ) {
                                                $actions['view'] = '<a href="' . get_permalink( $post->ID ) . '" title="' . esc_attr( sprintf( __( 'View &#8220;%s&#8221;' ), $title ) ) . '" rel="permalink">' . __( 'View' ) . '</a>';
                                        }
                                }
 
-                               $actions = apply_filters( is_post_type_hierarchical( $post->post_type ) ? 'page_row_actions' : 'post_row_actions', $actions, $post );
+                               if ( is_post_type_hierarchical( $post->post_type ) ) {
+
+                                       /**
+                                        * Filter the array of row action links on the Pages list table.
+                                        *
+                                        * The filter is evaluated only for hierarchical post types.
+                                        *
+                                        * @since 2.8.0
+                                        *
+                                        * @param array   $actions An array of row action links. Defaults are
+                                        *                         'Edit', 'Quick Edit', 'Restore, 'Trash',
+                                        *                         'Delete Permanently', 'Preview', and 'View'.
+                                        * @param WP_Post $post    The post object.
+                                        */
+                                       $actions = apply_filters( 'page_row_actions', $actions, $post );
+                               } else {
+
+                                       /**
+                                        * Filter the array of row action links on the Posts list table.
+                                        *
+                                        * The filter is evaluated only for non-hierarchical post types.
+                                        *
+                                        * @since 2.8.0
+                                        *
+                                        * @param array   $actions An array of row action links. Defaults are
+                                        *                         'Edit', 'Quick Edit', 'Restore, 'Trash',
+                                        *                         'Delete Permanently', 'Preview', and 'View'.
+                                        * @param WP_Post $post    The post object.
+                                        */
+                                       $actions = apply_filters( 'post_row_actions', $actions, $post );
+                               }
+
                                echo $this->row_actions( $actions );
 
                                get_inline_data( $post );
@@ -627,10 +722,28 @@ class WP_Posts_List_Table extends WP_List_Table {
                                }
 
                                echo '<td ' . $attributes . '>';
-                               if ( 'excerpt' == $mode )
+                               if ( 'excerpt' == $mode ) {
+
+                                       /**
+                                        * Filter the published time of the post.
+                                        *
+                                        * If $mode equals 'excerpt', the published time and date are both displayed.
+                                        * If $mode equals 'list' (default), the publish date is displayed, with the
+                                        * time and date together available as an abbreviation definition.
+                                        *
+                                        * @since 2.5.1
+                                        *
+                                        * @param array   $t_time      The published time.
+                                        * @param WP_Post $post        Post object.
+                                        * @param string  $column_name The column name.
+                                        * @param string  $mode        The list display mode ('excerpt' or 'list').
+                                        */
                                        echo apply_filters( 'post_date_column_time', $t_time, $post, $column_name, $mode );
-                               else
+                               } else {
+
+                                       /** This filter is documented in wp-admin/includes/class-wp-posts-list-table.php */
                                        echo '<abbr title="' . $t_time . '">' . apply_filters( 'post_date_column_time', $h_time, $post, $column_name, $mode ) . '</abbr>';
+                               }
                                echo '<br />';
                                if ( 'publish' == $post->post_status ) {
                                        _e( 'Published' );
@@ -709,10 +822,46 @@ class WP_Posts_List_Table extends WP_List_Table {
                                }
                        ?>
                        <td <?php echo $attributes ?>><?php
-                               if ( is_post_type_hierarchical( $post->post_type ) )
+                               if ( is_post_type_hierarchical( $post->post_type ) ) {
+
+                                       /**
+                                        * Fires in each custom column on the Posts list table.
+                                        *
+                                        * This hook only fires if the current post type is hierarchical,
+                                        * such as pages.
+                                        *
+                                        * @since 2.5.0
+                                        *
+                                        * @param string $column_name The name of the column to display.
+                                        * @param int    $post_id     The current post ID.
+                                        */
                                        do_action( 'manage_pages_custom_column', $column_name, $post->ID );
-                               else
+                               } else {
+
+                                       /**
+                                        * Fires in each custom column in the Posts list table.
+                                        *
+                                        * This hook only fires if the current post type is non-hierarchical,
+                                        * such as posts.
+                                        *
+                                        * @since 1.5.0
+                                        *
+                                        * @param string $column_name The name of the column to display.
+                                        * @param int    $post_id     The current post ID.
+                                        */
                                        do_action( 'manage_posts_custom_column', $column_name, $post->ID );
+                               }
+
+                               /**
+                                * Fires for each custom column of a specific post type in the Posts list table.
+                                *
+                                * The dynamic portion of the hook name, $post->post_type, refers to the post type.
+                                *
+                                * @since 3.1.0
+                                *
+                                * @param string $column_name The name of the column to display.
+                                * @param int    $post_id     The current post ID.
+                                */
                                do_action( "manage_{$post->post_type}_posts_custom_column", $column_name, $post->ID );
                        ?></td>
                        <?php
@@ -829,7 +978,7 @@ class WP_Posts_List_Table extends WP_List_Table {
        <?php if ( !$bulk ) echo $authors_dropdown;
        endif; // post_type_supports author
 
-       if ( !$bulk ) :
+       if ( !$bulk && $can_publish ) :
        ?>
 
                        <div class="inline-edit-group">
@@ -896,7 +1045,18 @@ class WP_Posts_List_Table extends WP_List_Table {
 
                if ( $bulk )
                        $dropdown_args['show_option_no_change'] =  __( '&mdash; No Change &mdash;' );
+
+               /**
+                * Filter the arguments used to generate the Quick Edit page-parent drop-down.
+                *
+                * @since 2.7.0
+                *
+                * @see wp_dropdown_pages()
+                *
+                * @param array $dropdown_args An array of arguments.
+                */
                $dropdown_args = apply_filters( 'quick_edit_dropdown_pages_args', $dropdown_args );
+
                wp_dropdown_pages( $dropdown_args );
        ?>
                        </label>
@@ -1034,6 +1194,34 @@ class WP_Posts_List_Table extends WP_List_Table {
        <?php endif; // 'post' && $can_publish && current_user_can( 'edit_others_cap' ) ?>
 
                        </div>
+
+       <?php
+
+       if ( $bulk && current_theme_supports( 'post-formats' ) && post_type_supports( $screen->post_type, 'post-formats' ) ) {
+               $post_formats = get_theme_support( 'post-formats' );
+
+               ?>
+               <label class="alignleft" for="post_format">
+               <span class="title"><?php _ex( 'Format', 'post format' ); ?></span>
+               <select name="post_format">
+                       <option value="-1"><?php _e( '&mdash; No Change &mdash;' ); ?></option>
+                       <option value="0"><?php echo get_post_format_string( 'standard' ); ?></option>
+                       <?php
+
+                       foreach ( $post_formats[0] as $format ) {
+                               ?>
+                               <option value="<?php echo esc_attr( $format ); ?>"><?php echo esc_html( get_post_format_string( $format ) ); ?></option>
+                               <?php
+                       }
+
+                       ?>
+               </select></label>
+       <?php
+
+       }
+
+       ?>
+
                </div></fieldset>
 
        <?php
@@ -1042,7 +1230,31 @@ class WP_Posts_List_Table extends WP_List_Table {
                foreach ( $columns as $column_name => $column_display_name ) {
                        if ( isset( $core_columns[$column_name] ) )
                                continue;
-                       do_action( $bulk ? 'bulk_edit_custom_box' : 'quick_edit_custom_box', $column_name, $screen->post_type );
+
+                       if ( $bulk ) {
+
+                               /**
+                                * Fires once for each column in Bulk Edit mode.
+                                *
+                                * @since 2.7.0
+                                *
+                                * @param string  $column_name Name of the column to edit.
+                                * @param WP_Post $post_type   The post type slug.
+                                */
+                               do_action( 'bulk_edit_custom_box', $column_name, $screen->post_type );
+                       } else {
+
+                               /**
+                                * Fires once for each column in Quick Edit mode.
+                                *
+                                * @since 2.7.0
+                                *
+                                * @param string  $column_name Name of the column to edit.
+                                * @param WP_Post $post_type   The post type slug.
+                                */
+                               do_action( 'quick_edit_custom_box', $column_name, $screen->post_type );
+                       }
+
                }
        ?>
                <p class="submit inline-edit-save">
@@ -1057,6 +1269,9 @@ class WP_Posts_List_Table extends WP_List_Table {
                        } ?>
                        <input type="hidden" name="post_view" value="<?php echo esc_attr( $m ); ?>" />
                        <input type="hidden" name="screen" value="<?php echo esc_attr( $screen->id ); ?>" />
+                       <?php if ( ! $bulk && ! post_type_supports( $screen->post_type, 'author' ) ) { ?>
+                               <input type="hidden" name="post_author" value="<?php echo esc_attr( $post->post_author ); ?>" />
+                       <?php } ?>
                        <span class="error" style="display:none"></span>
                        <br class="clear" />
                </p>