钩子文档

wpmu_new_blog

💡 云策文档标注

概述

wpmu_new_blog 是一个 WordPress 多站点网络中的动作钩子,在新站点创建后立即触发。自 5.1.0 版本起已弃用,建议使用 wp_initialize_site 替代。

关键要点

  • wpmu_new_blog 是一个动作钩子,用于多站点网络中新博客创建后的操作。
  • 参数包括 $site_id(站点ID)、$user_id(用户ID)、$domain(站点域名)、$path(站点路径)、$network_id(网络ID,仅多网络安装相关)和 $meta(元数据,用于设置初始站点选项)。
  • 自 WordPress 5.1.0 版本起,此钩子已弃用,推荐使用 wp_initialize_site 钩子。
  • 相关函数 wp_insert_site() 用于向数据库插入新站点。

代码示例

do_action_deprecated(
    'wpmu_new_blog',
    array( $new_site->id, $user_id, $new_site->domain, $new_site->path, $new_site->network_id, $meta ),
    '5.1.0',
    'wp_initialize_site'
);

注意事项

  • 此钩子已弃用,开发者应迁移到 wp_initialize_site 以避免未来兼容性问题。
  • 在多网络安装中,$network_id 参数可能相关,需根据具体场景处理。

📄 原文内容

Fires immediately after a new site is created.

Parameters

$site_idint
Site ID.
$user_idint
User ID.
$domainstring
Site domain.
$pathstring
Site path.
$network_idint
Network ID. Only relevant on multi-network installations.
$metaarray
Meta data. Used to set initial site options.

More Information

wpmu_new_blog is an action triggered whenever a new blog is created within a multisite network.

Source

do_action_deprecated(
	'wpmu_new_blog',
	array( $new_site->id, $user_id, $new_site->domain, $new_site->path, $new_site->network_id, $meta ),
	'5.1.0',
	'wp_initialize_site'
);

Changelog

Version Description
5.1.0 Deprecated. Use ‘wp_initialize_site’ instead.
MU (3.0.0) Introduced.