post_search_columns │ хук-фильтр │ WP 6.2.0

// Добавляем фильтр на поиск по произвольному полю "my_custom_field"
add_filter( 'post_search_columns', 'wp_kama_custom_search_fields' );

function wp_kama_custom_search_fields( $search_columns ) {
	$search_columns[] = 'my_custom_field';

	return $search_columns;
}

$args = array(
	's'              => 'some search query', // поисковый запрос
	'post_type'      => 'post', // тип постов
	'meta_key'       => 'my_custom_field', // ключ произвольного поля
	'meta_value'     => 'some custom value', // значение произвольного поля
	'post_status'    => 'publish', // статус постов
	'posts_per_page' => 10, // количество постов на странице
);

$query = new WP_Query( $args );

Этот код добавляет произвольное поле my_custom_field в список колонок, в которых будет производиться поиск при использовании WP_Query с параметром s (поиск по словам). Также этот код включает условие meta_query для поиска записей, которые имеют значение some custom value в поле my_custom_field.

Таким образом, фильтр post_search_columns позволяет изменить стандартное поведение поиска в WordPress и настроить его под нужды вашего проекта.

Внутри колбэка для хука вы можете изменять список столбцов для поиска по своему усмотрению и возвращать измененный список. Например, вы можете исключить столбец post_excerpt из списка для ускорения поискаю:

// Исключаем поле post_excerpt из поиска
add_filter( 'post_search_columns', 'wp_kama_post_search_columns_filter', 10, 3 );

/**
 * Функция-обработчик фильтра `post_search_columns`.
 *
 * @param string[] $search_columns Массив имен столбцов, в которых искать.
 * @param string   $search         Строка, по которой осуществляется поиск.
 * @param WP_Query $query          Текущий экземпляр WP_Query.
 *
 * @return string[] $search_columns Массив имен столбцов, в которых искать.
 */
function wp_kama_post_search_columns_filter( $search_columns, $search, $query ){

	$search_columns = array_diff( $search_columns, [ 'post_excerpt' ] );

	return $search_columns;
}

В этом примере функция обратного вызова удаляет столбец post_excerpt из списка столбцов для поиска, если он там есть.

В целом, с помощью фильтра post_search_columns можно добавлять или удалять столбцы для поиска постов. Это может быть полезно, например, если вы хотите выполнить поиск только по заголовку статей или только по содержимому дополнительных полей.

add_filter( 'post_search_columns', 'wp_kama_post_search_example', 10, 3 );

function wp_kama_post_search_example( $search_columns, $search, $query ){

	print_r( $search_columns );
	/*
	Array (
		[0] => post_title
		[1] => post_excerpt
		[2] => post_content
	)
	*/

	var_dump( $search ); // string(15) "search for text"

	print_r( $query ); // WP_Query Object
}

get_posts( [ 's'=>'search for text'] );