WordPress 禁用密码找回邮件或修改该邮件内容

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 两个参数来添加限制条件：

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 专门用于修改找回密码邮件的消息

所以，你可以根据实际需要，选择对应的钩子。