钩子文档

pre_user_email

💡 云策文档标注

概述

pre_user_email 是一个 WordPress 过滤器钩子,用于在用户创建或更新前修改用户的电子邮件地址。它允许开发者在电子邮件被处理前进行自定义操作。

关键要点

  • pre_user_email 是一个过滤器钩子,应用于用户电子邮件地址。
  • 它在用户创建或更新前触发,参数为原始电子邮件字符串。
  • 常用于验证、清理或修改电子邮件地址,例如添加域名后缀或过滤无效格式。

代码示例

$user_email = apply_filters( 'pre_user_email', $raw_user_email );

注意事项

  • 确保修改后的电子邮件地址符合有效格式,以避免用户数据错误。
  • 此钩子可能影响用户注册、登录和通知功能,需谨慎使用。

📄 原文内容

Filters a user’s email before the user is created or updated.

Parameters

$raw_user_emailstring
The user’s email.

Source

$user_email = apply_filters( 'pre_user_email', $raw_user_email );

Changelog

Version Description
2.0.3 Introduced.