remove_option_update_handler()
云策文档标注
概述
remove_option_update_handler() 是一个已弃用的 WordPress 函数，用于取消注册设置选项。它已被 unregister_setting() 替代，自 WordPress 3.0.0 起不再推荐使用。
关键要点
- 此函数已弃用，应改用 unregister_setting() 函数。
- 它接受三个参数：$option_group（设置组名）、$option_name（选项名）和可选的 $sanitize_callback（已弃用的回调函数）。
- 函数内部调用 unregister_setting() 来执行取消注册操作。
注意事项
- 自 WordPress 3.0.0 版本起，此函数被标记为弃用，开发者应更新代码以避免使用。
- 相关函数包括 unregister_setting() 和 _deprecated_function()，后者用于标记弃用函数。
原文内容
Unregister a setting
Description
See also
Parameters
$option_groupstringrequired-
The settings group name used during registration.
$option_namestringrequired-
The name of the option to unregister.
$sanitize_callbackcallableoptional-
Deprecated.
Source
function remove_option_update_handler( $option_group, $option_name, $sanitize_callback = '' ) {
_deprecated_function( __FUNCTION__, '3.0.0', 'unregister_setting()' );
unregister_setting( $option_group, $option_name, $sanitize_callback );
}
Changelog
| Version | Description |
|---|---|
| 3.0.0 | Deprecated. Use unregister_setting() |
| 2.7.0 | Introduced. |