(option) filter-hookWP 2.9.0

Filters the number of items to be displayed on each page of the list table.

The dynamic hook name, $option, refers to the per_page option depending on the type of list table in use. Possible filter names include:

  • edit_comments_per_page
  • sites_network_per_page
  • site_themes_network_per_page
  • themes_network_per_page'
  • users_network_per_page
  • edit_post_per_page
  • edit_page_per_page
  • edit_{$post_type}_per_page
  • edit_post_tag_per_page
  • edit_category_per_page
  • edit_{$taxonomy}_per_page
  • site_users_network_per_page
  • users_per_page

Usage

add_filter( '(option)', 'wp_kama_option_filter' );

/**
 * Function for `(option)` filter-hook.
 * 
 * @param int $per_page Number of items to be displayed.
 *
 * @return int
 */
function wp_kama_option_filter( $per_page ){

	// filter...
	return $per_page;
}
$per_page(int)
Number of items to be displayed.
Default: 20

Changelog

Since 2.9.0 Introduced.

Where the hook is called

WP_List_Table::get_items_per_page()
(option)
WP_Screen::render_per_page_options()
(option)
wp-admin/includes/class-wp-list-table.php 860
return (int) apply_filters( "{$option}", $per_page );
wp-admin/includes/class-wp-screen.php 1260
$per_page = apply_filters( "{$option}", $per_page );

Where the hook is used in WordPress

Usage not found.