钩子文档

edit_categories_per_page

💡 云策文档标注

概述

edit_categories_per_page 是一个 WordPress 过滤器,用于控制后台分类列表页面每页显示的术语数量。它允许开发者自定义分页显示项数,默认值为 20。

关键要点

  • 过滤器名称:edit_categories_per_page
  • 参数:$tags_per_page(整数类型),表示每页显示的术语数量,默认值为 20
  • 应用场景:主要用于后台分类管理界面,影响 WP_Terms_List_Table 的分页显示
  • 相关函数:WP_Screen::render_per_page_options() 和 WP_Terms_List_Table::prepare_items() 使用此过滤器
  • 引入版本:WordPress 2.8.0

代码示例

$tags_per_page = apply_filters( 'edit_categories_per_page', $tags_per_page );

📄 原文内容

Filters the number of terms displayed per page for the Categories list table.

Parameters

$tags_per_pageint
Number of categories to be displayed. Default 20.

Source

$tags_per_page = apply_filters( 'edit_categories_per_page', $tags_per_page );

Changelog

Version Description
2.8.0 Introduced.