upload_per_page
云策文档标注
概述
upload_per_page 是一个 WordPress 过滤器,用于控制媒体库中每页显示的媒体项数量。它允许开发者自定义分页设置,默认值为 20。
关键要点
- 这是一个过滤器钩子,用于修改媒体列表的每页项目数。
- 参数 $media_per_page 是一个整数,表示要显示的媒体数量,默认值为 20。
- 源代码示例展示了如何应用此过滤器来设置 posts_per_page 参数。
代码示例
$q['posts_per_page'] = apply_filters( 'upload_per_page', $media_per_page );注意事项
- 此过滤器自 WordPress 2.9.0 版本引入。
- 相关函数 wp_edit_attachments_query_vars() 用于返回当前附件请求的查询变量。
原文内容
Filters the number of items to list per page when listing media items.
Parameters
$media_per_pageint-
Number of media to list. Default 20.
Source
$q['posts_per_page'] = apply_filters( 'upload_per_page', $media_per_page );
Changelog
| Version | Description |
|---|---|
| 2.9.0 | Introduced. |