钩子文档

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.