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.
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. |