wpmu_validate_blog_signup
云策文档标注
概述
wpmu_validate_blog_signup 是一个 WordPress 过滤器钩子,用于在站点注册后过滤站点详情和错误消息。它允许开发者修改或验证新站点的参数和错误信息。
关键要点
- 这是一个过滤器钩子,用于处理多站点网络(Multisite)中的新站点注册过程。
- 参数 $result 是一个数组,包含域名、路径、站点名称、站点标题、用户对象和错误消息。
- 开发者可以通过此钩子自定义验证逻辑或修改注册数据。
代码示例
add_filter('wpmu_validate_blog_signup', 'my_custom_validation');
function my_custom_validation($result) {
// 自定义验证逻辑
if (empty($result['blog_title'])) {
$result['errors']->add('blog_title', '站点标题不能为空。');
}
return $result;
}注意事项
- 此钩子仅在 WordPress 多站点环境中有效,用于处理 wpmu_validate_blog_signup() 函数的输出。
- 参数 $result 是一个数组,包含多个字段,如 domain、path、blogname、blog_title、user 和 errors,其中 errors 是 WP_Error 对象。
- 从 WordPress MU 3.0.0 版本开始引入,适用于多站点安装。
原文内容
Filters site details and error messages following registration.
Parameters
$resultarray-
Array of domain, path, site name, site title, user and error messages.
domainstringDomain for the site.pathstringPath for the site. Used in subdirectory installations.blognamestringThe unique site name (slug).blog_titlestringSite title.userstring|WP_UserBy default, an empty string. A user object if provided.errorsWP_ErrorWP_Error containing any errors found.
Source
return apply_filters( 'wpmu_validate_blog_signup', $result );
Changelog
| Version | Description |
|---|---|
| MU (3.0.0) | Introduced. |