钩子文档

edit_posts_per_page

💡 云策文档标注

概述

edit_posts_per_page 是一个 WordPress 过滤器,用于在特定列表(如编辑文章页面)中控制每页显示的文章数量。它允许开发者根据文章类型自定义每页显示的条目数。

关键要点

  • 过滤器名称:edit_posts_per_page,用于过滤每页显示的文章数量。
  • 参数:$posts_per_page(整数,默认20)和 $post_type(字符串,文章类型)。
  • 应用场景:主要用于后台编辑文章列表页面,如 WP_Screen::render_per_page_options() 和 WP_Posts_List_Table::prepare_items()。
  • 版本历史:自 WordPress 2.8.0 引入。

代码示例

$posts_per_page = apply_filters( 'edit_posts_per_page', $posts_per_page, $post_type );

📄 原文内容

Filters the number of posts displayed per page when specifically listing “posts”.

Parameters

$posts_per_pageint
Number of posts to be displayed. Default 20.
$post_typestring
The post type.

Source

$posts_per_page = apply_filters( 'edit_posts_per_page', $posts_per_page, $post_type );

Changelog

Version Description
2.8.0 Introduced.