函数文档

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.