钩子文档

wp_set_password

💡 云策文档标注

概述

wp_set_password 是一个 WordPress Hook,在用户密码设置后触发,允许开发者执行自定义操作。它提供了密码、用户ID和更新前的用户数据作为参数。

关键要点

  • 这是一个 Action Hook,在用户密码被设置后立即触发。
  • 参数包括:$password(明文密码)、$user_id(用户ID)和 $old_user_data(更新前的 WP_User 对象)。
  • 首次引入于 WordPress 6.2.0,$old_user_data 参数在 6.7.0 版本中添加。
  • 相关函数包括 wp_set_password()、wp_update_user() 和 wp_insert_user()。

代码示例

do_action( 'wp_set_password', $password, $user_id, $old_user_data );

📄 原文内容

Fires after the user password is set.

Parameters

$passwordstring
The plaintext password just set.
$user_idint
The ID of the user whose password was just set.
$old_user_dataWP_User
Object containing user’s data prior to update.

Source

do_action( 'wp_set_password', $password, $user_id, $old_user_data );

Changelog

Version Description
6.7.0 The $old_user_data parameter was added.
6.2.0 Introduced.