钩子文档

network_site_users_created_user

💡 云策文档标注

概述

network_site_users_created_user 是一个 WordPress Hook,在网络站点用户管理页面创建用户后触发,主要用于开发者处理新用户创建后的相关操作。

关键要点

  • 触发时机:当用户通过 network site-users.php 页面成功创建后立即执行
  • 参数:$user_id(整数类型),表示新创建用户的 ID
  • 版本:从 WordPress 4.4.0 版本开始引入
  • 用途:常用于自定义用户创建后的逻辑,如发送通知、更新元数据等

代码示例

add_action( 'network_site_users_created_user', 'my_custom_user_created_function' );
function my_custom_user_created_function( $user_id ) {
    // 在这里添加自定义代码,例如发送邮件或记录日志
    wp_mail( 'admin@example.com', '新用户创建', '用户 ID: ' . $user_id );
}

注意事项

  • 此 Hook 仅适用于多站点网络环境,单站点中可能不适用
  • 确保回调函数正确处理 $user_id 参数,避免安全风险
  • 在添加自定义逻辑时,考虑性能影响,避免阻塞用户创建流程

📄 原文内容

Fires after a user has been created via the network site-users.php page.

Parameters

$user_idint
ID of the newly created user.

Source

do_action( 'network_site_users_created_user', $user_id );

Changelog

Version Description
4.4.0 Introduced.