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.
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. |