xmlrpc_default_revision_fields
云策文档标注
概述
xmlrpc_default_revision_fields 是一个 WordPress 过滤器,用于修改给定 XML-RPC 方法中默认的修订查询字段。它允许开发者自定义在调用特定 XML-RPC 方法时返回的修订字段数组。
关键要点
- 这是一个过滤器 Hook,名称为 xmlrpc_default_revision_fields,用于调整修订查询的默认字段。
- 默认包含 'post_date' 和 'post_date_gmt' 字段,但可以通过过滤器添加或移除其他字段。
- 主要应用于 wp.getRevisions 等 XML-RPC 方法,以控制返回的修订数据内容。
- 自 WordPress 3.5.0 版本引入,是处理 XML-RPC 修订查询的核心工具之一。
代码示例
$fields = apply_filters( 'xmlrpc_default_revision_fields', array( 'post_date', 'post_date_gmt' ), 'wp.getRevisions' );注意事项
- 参数 $fieldarray 是一个数组,指定要检索的修订字段,默认包含 'post_date' 和 'post_date_gmt'。
- 参数 $method 是字符串,表示 XML-RPC 方法名,例如 'wp.getRevisions'。
- 开发者应确保自定义的字段数组符合 WordPress 修订数据结构和 XML-RPC 协议要求。
原文内容
Filters the default revision query fields used by the given XML-RPC method.
Parameters
$fieldarray-
An array of revision fields to retrieve. By default, contains
'post_date'and'post_date_gmt'. $methodstring-
The method name.
Source
$fields = apply_filters( 'xmlrpc_default_revision_fields', array( 'post_date', 'post_date_gmt' ), 'wp.getRevisions' );
Changelog
| Version | Description |
|---|---|
| 3.5.0 | Introduced. |