sites_pre_query

在进行get_sites查询之前过滤网站数据。

返回一个非空值以绕过WordPress的默认站点查询。

这个过滤器的预期返回类型取决于请求查询变量中传递的值：

• 当 $this->query_vars['count'] 被设置时，该过滤器应该返回网站计数为整数。
• 当 'ids' === $this->query_vars['fields'] 时，过滤器应该返回一个网站ID的数组。
• 否则，过滤器应该返回一个WP_Site对象的数组。

注意，如果过滤器返回一个网站数据数组，它将被分配到当前WP_Site_Query实例的 sites 属性。

我们鼓励需要分页信息的过滤函数设置WP_Site_Query对象的 found_sites 和 max_num_pages 属性，通过引用传递给过滤器。如果WP_Site_Query不执行数据库查询，它将没有足够的信息来自行生成这些值。

$site_data = apply_filters_ref_array( 'sites_pre_query', array( $site_data, &$this ) );