钩子文档

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.

  • domain string
    Domain for the site.
  • path string
    Path for the site. Used in subdirectory installations.
  • blogname string
    The unique site name (slug).
  • blog_title string
    Site title.
  • user string|WP_User
    By default, an empty string. A user object if provided.
  • errors WP_Error
    WP_Error containing any errors found.

Source

return apply_filters( 'wpmu_validate_blog_signup', $result );

Changelog

Version Description
MU (3.0.0) Introduced.