钩子文档

tagsperpage

💡 云策文档标注

概述

tagsperpage 是一个已弃用的 WordPress 过滤器,用于控制标签列表表中每页显示的标签数量。自 WordPress 2.8.0 起,建议使用 edit_tags_per_page 过滤器替代。

关键要点

  • tagsperpage 过滤器用于调整标签列表的每页显示数量,默认值为 20。
  • 该过滤器在 WordPress 2.8.0 中被弃用,应改用 edit_tags_per_page 过滤器。
  • 参数 $tags_per_page 为整数类型,表示要显示的标签数量。
  • 相关函数 WP_Terms_List_Table::prepare_items() 使用了此过滤器。

代码示例

$tags_per_page = apply_filters_deprecated( 'tagsperpage', array( $tags_per_page ), '2.8.0', 'edit_tags_per_page' );

注意事项

  • 由于 tagsperpage 已被弃用,开发者在编写新代码时应避免使用,转而使用 edit_tags_per_page 过滤器。
  • 弃用版本为 2.8.0,引入版本为 2.7.0,需注意版本兼容性。

📄 原文内容

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

Parameters

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

Source

$tags_per_page = apply_filters_deprecated( 'tagsperpage', array( $tags_per_page ), '2.8.0', 'edit_tags_per_page' );

Changelog

Version Description
2.8.0 Deprecated. Use ‘edit_tags_per_page’ instead.
2.7.0 Introduced.