WP_Posts_List_Table::prepare_items() WordPress Method

The WP_Posts_List_Table::prepare_items() method is used to prepare the data for display in the WordPress posts list table. This includes sorting the data, paginating the data, and setting the correct headers.

WP_Posts_List_Table::prepare_items() #

Source
Related
- Uses

Source

File: wp-admin/includes/class-wp-posts-list-table.php

public function prepare_items() {
    global $mode, $avail_post_stati, $wp_query, $per_page;
 
    if ( ! empty( $_REQUEST['mode'] ) ) {
        $mode = 'excerpt' === $_REQUEST['mode'] ? 'excerpt' : 'list';
        set_user_setting( 'posts_list_mode', $mode );
    } else {
        $mode = get_user_setting( 'posts_list_mode', 'list' );
    }
 
    // Is going to call wp().
    $avail_post_stati = wp_edit_posts_query();
 
    $this->set_hierarchical_display(
        is_post_type_hierarchical( $this->screen->post_type )
        && 'menu_order title' === $wp_query->query['orderby']
    );
 
    $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 ) {
        $total_items = $wp_query->post_count;
    } elseif ( $wp_query->found_posts || $this->get_pagenum() === 1 ) {
        $total_items = $wp_query->found_posts;
    } else {
        $post_counts = (array) wp_count_posts( $post_type, 'readable' );
 
        if ( isset( $_REQUEST['post_status'] ) && in_array( $_REQUEST['post_status'], $avail_post_stati, true ) ) {
            $total_items = $post_counts[ $_REQUEST['post_status'] ];
        } elseif ( isset( $_REQUEST['show_sticky'] ) && $_REQUEST['show_sticky'] ) {
            $total_items = $this->sticky_posts_count;
        } elseif ( isset( $_GET['author'] ) && get_current_user_id() === (int) $_GET['author'] ) {
            $total_items = $this->user_posts_count;
        } else {
            $total_items = array_sum( $post_counts );
 
            // Subtract post types that are not included in the admin all list.
            foreach ( get_post_stati( array( 'show_in_admin_all_list' => false ) ) as $state ) {
                $total_items -= $post_counts[ $state ];
            }
        }
    }
 
    $this->is_trash = isset( $_REQUEST['post_status'] ) && 'trash' === $_REQUEST['post_status'];
 
    $this->set_pagination_args(
        array(
            'total_items' => $total_items,
            'per_page'    => $per_page,
        )
    );
}

Expand full source code Collapse full source codeView on TracView on GitHub

Top ↑

Uses

Uses
Uses	Description
wp-admin/includes/class-wp-posts-list-table.php:WP_Posts_List_Table::set_hierarchical_display()	Sets whether the table layout should be hierarchical or not.
wp-admin/includes/post.php:wp_edit_posts_query()	Runs the query to fetch the posts for listing on the edit posts page.
wp-admin/includes/post.php:edit_posts_per_page	Filters the number of posts displayed per page when specifically listing “posts”.
wp-includes/plugin.php:apply_filters()	Calls the callback functions that have been added to a filter hook.
wp-includes/option.php:set_user_setting()	Adds or updates user interface setting.
wp-includes/option.php:get_user_setting()	Retrieves user interface setting value based on setting name.
wp-includes/user.php:get_current_user_id()	Gets the current user’s ID.
wp-includes/post.php:wp_count_posts()	Count number of posts of a post type and if user has permissions to view.
wp-includes/post.php:is_post_type_hierarchical()	Whether the post type is hierarchical.
wp-includes/post.php:get_post_stati()	Get a list of post statuses.

Show 5 more uses Hide more uses

WP_Posts_List_Table::prepare_items() WordPress Method

WP_Posts_List_Table::prepare_items() #

Contents

Source

Hook

Class

Class Method

WP_Posts_List_Table::prepare_items() WordPress Method

WP_Posts_List_Table::prepare_items() #

Contents

Source

Related

Uses

Hook

Class

Class Method