函数文档

_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

Return

array

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.