
WordPress钩子详解:如何使用动作、过滤器和自定义钩子
apply_filters_ref_array( 'sites_pre_query', array( $site_data, &$this )
在进行get_sites查询之前过滤网站数据。
返回一个非空值以绕过WordPress的默认站点查询。
这个过滤器的预期返回类型取决于请求查询变量中传递的值:
$this->query_vars['count']
被设置时,该过滤器应该返回网站计数为整数。'ids' === $this->query_vars['fields']
时,过滤器应该返回一个网站ID的数组。注意,如果过滤器返回一个网站数据数组,它将被分配到当前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 ) );