_post_format_request()
云策文档标注
概述
_post_format_request() 是一个 WordPress 过滤器函数,用于处理请求中的 post_format 参数,将其转换为标准格式并设置相关查询变量。
关键要点
- 函数检查 $qvs 数组中是否存在 'post_format' 键,若不存在则直接返回原数组。
- 如果存在,则使用 get_post_format_slugs() 获取格式 slugs,并将 'post_format' 值转换为 'post-format-' 前缀的格式。
- 在非管理界面(通过 is_admin() 判断)中,根据 post_format 分类设置 $qvs['post_type'] 为相关对象类型。
代码示例
function _post_format_request( $qvs ) {
if ( ! isset( $qvs['post_format'] ) ) {
return $qvs;
}
$slugs = get_post_format_slugs();
if ( isset( $slugs[ $qvs['post_format'] ] ) ) {
$qvs['post_format'] = 'post-format-' . $slugs[ $qvs['post_format'] ];
}
$tax = get_taxonomy( 'post_format' );
if ( ! is_admin() ) {
$qvs['post_type'] = $tax->object_type;
}
return $qvs;
}
原文内容
Filters the request to allow for the format prefix.
Parameters
$qvsarrayrequired
Source
function _post_format_request( $qvs ) {
if ( ! isset( $qvs['post_format'] ) ) {
return $qvs;
}
$slugs = get_post_format_slugs();
if ( isset( $slugs[ $qvs['post_format'] ] ) ) {
$qvs['post_format'] = 'post-format-' . $slugs[ $qvs['post_format'] ];
}
$tax = get_taxonomy( 'post_format' );
if ( ! is_admin() ) {
$qvs['post_type'] = $tax->object_type;
}
return $qvs;
}
Changelog
| Version | Description |
|---|---|
| 3.1.0 | Introduced. |