函数文档

xmlrpc_pingback_error()

💡 云策文档标注

概述

xmlrpc_pingback_error() 是 WordPress 中一个默认附加到 xmlrpc_pingback_error 钩子的过滤器函数。它处理 Pingback 错误,通常返回通用错误代码,但针对特定错误码 48(表示 Pingback 已注册)会保留原错误。

关键要点

  • 这是一个过滤器函数,用于处理 XML-RPC Pingback 错误。
  • 当错误码为 48 时,返回原 IXR_Error 对象;否则返回一个代码为 0、消息为空的 IXR_Error 对象。
  • 函数在 WordPress 3.5.1 版本中引入。

代码示例

function xmlrpc_pingback_error( $ixr_error ) {
    if ( 48 === $ixr_error->code ) {
        return $ixr_error;
    }
    return new IXR_Error( 0, '' );
}

注意事项

  • 参数 $ixr_error 是必需的 IXR_Error 对象。
  • 返回类型为 IXR_Error。
  • 相关类:IXR_Error::__construct() 在 wp-includes/IXR/class-IXR-error.php 中定义。

📄 原文内容

Default filter attached to xmlrpc_pingback_error.

Description

Returns a generic pingback error code unless the error code is 48, which reports that the pingback is already registered.

Parameters

$ixr_errorIXR_Errorrequired

Return

IXR_Error

Source

function xmlrpc_pingback_error( $ixr_error ) {
	if ( 48 === $ixr_error->code ) {
		return $ixr_error;
	}
	return new IXR_Error( 0, '' );
}

Changelog

Version Description
3.5.1 Introduced.