wp_ajax_update_welcome_panel()
云策文档标注
概述
wp_ajax_update_welcome_panel() 是一个 WordPress AJAX 处理函数,用于更新用户是否显示欢迎面板的设置。它通过 AJAX 请求接收用户偏好,并更新用户元数据。
关键要点
- 函数通过 AJAX 处理欢迎面板的显示状态更新。
- 使用 check_ajax_referer() 验证 AJAX 请求的安全性。
- 检查当前用户是否具有 edit_theme_options 权限,否则终止执行。
- 调用 update_user_meta() 更新当前用户的 show_welcome_panel 元数据。
- 函数在 WordPress 3.1.0 版本中引入。
代码示例
function wp_ajax_update_welcome_panel() {
check_ajax_referer( 'welcome-panel-nonce', 'welcomepanelnonce' );
if ( ! current_user_can( 'edit_theme_options' ) ) {
wp_die( -1 );
}
update_user_meta( get_current_user_id(), 'show_welcome_panel', empty( $_POST['visible'] ) ? 0 : 1 );
wp_die( 1 );
}注意事项
- 确保 AJAX 请求包含正确的 nonce 值 'welcome-panel-nonce' 以通过安全检查。
- 仅允许具有 edit_theme_options 权限的用户执行此操作,防止未授权访问。
- 函数使用 wp_die() 终止执行,返回 -1 表示错误,1 表示成功。
原文内容
Handles updating whether to display the welcome panel via AJAX.
Source
function wp_ajax_update_welcome_panel() {
check_ajax_referer( 'welcome-panel-nonce', 'welcomepanelnonce' );
if ( ! current_user_can( 'edit_theme_options' ) ) {
wp_die( -1 );
}
update_user_meta( get_current_user_id(), 'show_welcome_panel', empty( $_POST['visible'] ) ? 0 : 1 );
wp_die( 1 );
}
Changelog
| Version | Description |
|---|---|
| 3.1.0 | Introduced. |