钩子文档

site_search_columns

💡 云策文档标注

概述

site_search_columns 是一个 WordPress 过滤器,用于自定义 WP_Site_Query 搜索中要查询的列。默认搜索列包括 'domain' 和 'path'。

关键要点

  • 过滤器名称:site_search_columns
  • 用途:修改 WP_Site_Query 搜索时检查的列数组
  • 参数:$search_columns(字符串数组,要搜索的列名)、$search(搜索文本)、$query(WP_Site_Query 实例)
  • 默认列:'domain' 和 'path'
  • 引入版本:WordPress 4.6.0
  • 相关函数:在 WP_Site_Query::get_site_ids() 内部使用

📄 原文内容

Filters the columns to search in a WP_Site_Query search.

Description

The default columns include ‘domain’ and ‘path.

Parameters

$search_columnsstring[]
Array of column names to be searched.
$searchstring
Text being searched.
$queryWP_Site_Query
The current WP_Site_Query instance.

Source

$search_columns = apply_filters( 'site_search_columns', $search_columns, $this->query_vars['search'], $this );

Changelog

Version Description
4.6.0 Introduced.