get_attached_media_args
云策文档标注
概述
get_attached_media_args 是一个 WordPress 过滤器钩子,用于修改检索指定文章附件媒体时使用的查询参数。它允许开发者自定义媒体查询条件,如基于 MIME 类型或文章对象。
关键要点
- 这是一个过滤器钩子,名称为 get_attached_media_args,用于过滤媒体查询参数。
- 参数包括 $args(数组,查询参数)、$type(字符串,MIME 类型)和 $post(WP_Post 对象,文章对象)。
- 在 WordPress 3.6.0 版本中引入,常用于 get_attached_media() 函数中。
代码示例
$args = apply_filters( 'get_attached_media_args', $args, $type, $post );
原文内容
Filters arguments used to retrieve media attached to the given post.
Parameters
$argsarray-
Post query arguments.
$typestring-
Mime type of the desired media.
$postWP_Post-
Post object.
Source
$args = apply_filters( 'get_attached_media_args', $args, $type, $post );
Changelog
| Version | Description |
|---|---|
| 3.6.0 | Introduced. |