钩子文档

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.