云策 WordPress 开发者社区

钩子文档

wpmu_new_user

查看官方原文 ↗
💡 云策文档标注

概述

wpmu_new_user 是一个 WordPress 动作钩子，在 Multisite 环境中新用户创建后立即触发。它适用于处理所有新用户的全局事件，区别于单站点场景下的 'user_register' 钩子。

关键要点

  • 触发时机：在 Multisite 中，无论是用户自助注册还是超级管理员创建新用户后立即触发。
  • 参数：$user_id（整数类型），表示新创建用户的 ID。
  • 用途：专门用于 Multisite 环境下影响所有新用户的操作，如发送通知或初始化设置。
  • 相关函数：wpmu_create_user() 用于创建用户。
  • 版本历史：自 WordPress MU 3.0.0 版本引入。
📄 原文内容

Fires immediately after a new user is created.

Parameters

$user_idint
User ID.

More Information

This hook will get triggered when either a user self-registers or a Super Admin creates a new user on a Multisite. Use this hook for events that should affect all new users on a Multisite; otherwise, use ‘<a href="https://developer.wordpress.org/reference/hooks/user_register/">user_register</a>‘.

Source

do_action( 'wpmu_new_user', $user_id );

View all references View on Trac View on GitHub

Used by Description
wpmu_create_user()wp-includes/ms-functions.php

Creates a user.

Changelog

Version Description
MU (3.0.0) Introduced.