WordPress 6.0 新增了两个和密码找回邮件相关的钩子:
send_retrieve_password_email
可用于过滤是否发送找回密码邮件retrieve_password_notification_email
可用于过滤发送给用户的重置密码通知邮件的内容。
为了与一些类似的过滤器(如send_password_change_email
或 send_email_change_email
)保持一致,并获得更大的灵活性,请将$user_login
和$user_data
参数直接传递给新的send_retrieve_password_email
和retrieve_password_notification_email
过滤器。
apply_filters( 'send_retrieve_password_email', true, $user_login, $user_data );
apply_filters( 'retrieve_password_notification_email', $defaults, $key, $user_login, $user_data );
禁用密码找回邮件
以下代码可以全局禁用发送密码找回邮件,也可以按照提示通过 $user_login, $user_data 两个参数来添加限制条件:
代码语言:javascript复制function wpdax_disable_retrieve_password_email( $user_login, $user_data ){
// 如果你希望符合某类条件的才禁止发送,那你可以通过 $user_login, $user_data 这两个参数来做判断
return false;
}
add_filter( 'send_retrieve_password_email', 'wpdax_disable_retrieve_password_email', 10, 2 );
修改密码找回邮件的内容
retrieve_password_notification_email
承接的 $defaults 内容包括邮件的收件人、标题、信息和Headers头部信息:
$defaults = array(
'to' => $user_email,
'subject' => $title,
'message' => $message,
'headers' => '',
);
所以,retrieve_password_notification_email
是可以直接修改以上四项内容的。代码范例如下
function wpdx_filter_retrieve_password_notification_email( $defaults, $key, $user_login, $user_data ){
// 可以通过 $key, $user_login, $user_data 三个参数来获取和传递一些用户信息值
// 收件人邮箱 to 不能修改,否则他会收不到
// $defaults['title'] = '自定义标题';
// $defaults['message'] = '自定义消息';
// $defaults['headers'] = '自定义headers'; //一般情况下不需要修改
return $defaults;
}
add_filter( 'retrieve_password_notification_email', 'wpdx_filter_retrieve_password_notification_email', 10, 4 );
在下面的函数代码中,我们可以看到还有两个钩子:
retrieve_password_title
专门用于修改找回密码邮件的标题retrieve_password_message
专门用于修改找回密码邮件的消息
所以,你可以根据实际需要,选择对应的钩子。