云策 WordPress 开发者社区

函数文档

default_password_nag_handler()

查看官方原文 ↗
💡 云策文档标注

概述

default_password_nag_handler() 是一个 WordPress 函数，用于处理默认密码提示的显示逻辑。它检查用户设置和查询参数，以决定是否隐藏密码提示，并更新相关用户元数据。

关键要点

  • 函数参数：$errors（可选，已弃用，默认值为 false）
  • 核心逻辑：通过 get_user_option('default_password_nag') 检查用户是否有默认密码提示，若无则直接返回
  • 条件判断：基于 get_user_setting('default_password_nag') 或 $_GET['default_password_nag'] 参数决定是否隐藏提示
  • 数据操作：使用 delete_user_setting() 和 update_user_meta() 更新用户设置和元数据
  • 相关函数：涉及 get_user_setting()、delete_user_setting()、update_user_meta()、get_user_option()
  • 版本历史：自 WordPress 2.8.0 引入
📄 原文内容

Parameters

$errorsfalseoptional
Deprecated.

Default:false

Source

function default_password_nag_handler( $errors = false ) {
	global $user_ID;
	// Short-circuit it.
	if ( ! get_user_option( 'default_password_nag' ) ) {
		return;
	}

	// get_user_setting() = JS-saved UI setting. Else no-js-fallback code.
	if ( 'hide' === get_user_setting( 'default_password_nag' )
		|| isset( $_GET['default_password_nag'] ) && '0' === $_GET['default_password_nag']
	) {
		delete_user_setting( 'default_password_nag' );
		update_user_meta( $user_ID, 'default_password_nag', false );
	}
}

View all references View on Trac View on GitHub

Uses Description
get_user_setting()wp-includes/option.php

Retrieves user interface setting value based on setting name.
delete_user_setting()wp-includes/option.php

Deletes user interface settings.
update_user_meta()wp-includes/user.php

Updates user meta field based on user ID.
get_user_option()wp-includes/user.php

Retrieves user option that can be either per Site or per Network.

Changelog

Version Description
2.8.0 Introduced.