WP_Comments_List_Table::prepare_items()

Hooks fired · 1

One hook fires while WP_Comments_List_Table::prepare_items() runs, in this order:

1. 1
   apply_filters( comments_list_table_query_args )filterline 172 (+82 into the body)

   Filters the arguments for the comment query in the comments list table.

Uses · 11

• set_user_setting()Adds or updates user interface setting.
• get_user_setting()Retrieves user interface setting value based on setting name.
• sanitize_key()Sanitizes a string key.
• wp_doing_ajax()Determines whether the current request is a WordPress Ajax request.
• apply_filters()Calls the callback functions that have been added to a filter hook.
• get_comments()Retrieves a list of comments.
• wp_list_pluck()Plucks a certain field out of each object or array in an array.
• get_pending_comments_num()Gets the number of pending comments on a post or posts.
• WP_Comments_List_Table::get_per_page()Gets the number of comments to display per page.
• WP_Comments_List_Table::get_pagenum()
• WP_Comments_List_Table::set_pagination_args()

Source

View on Trac ↗View on GitHub ↗

90	public function prepare_items() {91		global $mode, $post_id, $comment_status, $comment_type, $search;92 93		if ( ! empty( $_REQUEST['mode'] ) ) {94			$mode = 'excerpt' === $_REQUEST['mode'] ? 'excerpt' : 'list';95			set_user_setting( 'posts_list_mode', $mode );96		} else {97			$mode = get_user_setting( 'posts_list_mode', 'list' );98		}99 100		$comment_status = $_REQUEST['comment_status'] ?? 'all';101 102		if ( ! in_array( $comment_status, array( 'all', 'mine', 'moderated', 'approved', 'spam', 'trash' ), true ) ) {103			$comment_status = 'all';104		}105 106		$comment_type = '';107 108		if ( ! empty( $_REQUEST['comment_type'] ) && 'note' !== $_REQUEST['comment_type'] ) {109			$comment_type = $_REQUEST['comment_type'];110		}111 112		$search = $_REQUEST['s'] ?? '';113 114		$post_type = ( isset( $_REQUEST['post_type'] ) ) ? sanitize_key( $_REQUEST['post_type'] ) : '';115 116		$user_id = $_REQUEST['user_id'] ?? '';117 118		$orderby = $_REQUEST['orderby'] ?? '';119		$order   = $_REQUEST['order'] ?? '';120 121		$comments_per_page = $this->get_per_page( $comment_status );122 123		$doing_ajax = wp_doing_ajax();124 125		if ( isset( $_REQUEST['number'] ) ) {126			$number = (int) $_REQUEST['number'];127		} else {128			$number = $comments_per_page + min( 8, $comments_per_page ); // Grab a few extra.129		}130 131		$page = $this->get_pagenum();132 133		if ( isset( $_REQUEST['start'] ) ) {134			$start = $_REQUEST['start'];135		} else {136			$start = ( $page - 1 ) * $comments_per_page;137		}138 139		if ( $doing_ajax && isset( $_REQUEST['offset'] ) ) {140			$start += $_REQUEST['offset'];141		}142 143		$status_map = array(144			'mine'      => '',145			'moderated' => 'hold',146			'approved'  => 'approve',147			'all'       => '',148		);149 150		$args = array(151			'status'                    => $status_map[ $comment_status ] ?? $comment_status,152			'search'                    => $search,153			'user_id'                   => $user_id,154			'offset'                    => $start,155			'number'                    => $number,156			'post_id'                   => $post_id,157			'type'                      => $comment_type,158			'type__not_in'              => array( 'note' ),159			'orderby'                   => $orderby,160			'order'                     => $order,161			'post_type'                 => $post_type,162			'update_comment_post_cache' => true,163		);164 165		/**166		 * Filters the arguments for the comment query in the comments list table.167		 *168		 * @since 5.1.0169		 *

History

Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 7.1.0 tag, from src/wp-admin/includes/class-wp-comments-list-table.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.