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. |