函数文档

wp_explain_nonce()

💡 云策文档标注

概述

wp_explain_nonce() 是一个已弃用的 WordPress 函数,用于检索 nonce 操作的“Are you sure”确认消息。它已被 wp_nonce_ays() 替代,开发者应避免使用。

关键要点

  • 函数 wp_explain_nonce() 在 WordPress 3.4.1 和 3.5.0 中已弃用,并向后移植到 3.3.3。
  • 它接受一个必需的字符串参数 $action(nonce 操作),并返回一个“Are you sure”消息字符串。
  • 函数内部调用 _deprecated_function() 标记为弃用,并返回一个固定的翻译消息。
  • 建议开发者使用 wp_nonce_ays() 作为替代函数。

代码示例

function wp_explain_nonce( $action ) {
    _deprecated_function( __FUNCTION__, '3.4.1', 'wp_nonce_ays()' );
    return __( 'Are you sure you want to do this?' );
}

注意事项

  • 此函数已弃用,不应在新代码中使用,以避免兼容性问题。
  • 相关函数包括 __() 用于翻译和 _deprecated_function() 用于标记弃用。
  • 函数在 WordPress 2.0.4 版本中引入。

📄 原文内容

Retrieve nonce action “Are you sure” message.

Description

Deprecated in 3.4.1 and 3.5.0. Backported to 3.3.3.

See also

Parameters

$actionstringrequired
Nonce action.

Return

string Are you sure message.

Source

function wp_explain_nonce( $action ) {
	_deprecated_function( __FUNCTION__, '3.4.1', 'wp_nonce_ays()' );
	return __( 'Are you sure you want to do this?' );
}

Changelog

Version Description
2.0.4 Introduced.