wp_robots │ хук-фильтр │ WP 5.7.0

Позволяет добавить или удалить директивы мета-тега robots.

Мета-тег robots выводится в HEAD части страницы. Пример:

<meta name='robots' content='директива, директива'>

<!-- например -->
<meta name='robots' content='noindex, follow, max-image-preview:large' />

Если в результате работы фильтра будет получен пустой массив (функция вернет пустой массив), то мета-тег robots не будет выведен.

Использование

add_filter( 'wp_robots', 'wp_kama_robots_filter' );

/**
 * Function for `wp_robots` filter-hook.
 * 
 * @param array $robots Associative array of directives. Every key must be the name of the directive, and the corresponding value must either be a string to provide as value for the directive or a boolean `true` if it is a boolean directive, i.e. without a value.
 *
 * @return array
 */
function wp_kama_robots_filter( $robots ){

	// filter...
	return $robots;
}

$robots(массив)

Ассоциативный массив с парами [ директива => значение ]. В ключе указывается называние директивы. Значение может быть строкой, если это директива со значением или true если это логическая директива (не имеющая значение).

Примеры

add_filter( 'wp_robots', 'wp_kama_robots_tag' );

function wp_kama_robots_tag( $robots ){

	// закроем страницы вложений, пагинации и архивов записей
	if(
		is_attachment() ||
		is_paged() ||
		is_post_type_archive()
	){
		$robots['noindex'] = true;
	}

	// закроем таксономии, если для терминов не указано описание
	if(
		( is_category() || is_tag() || is_tax() )
		&& ! trim( get_queried_object()->description )
	){
		$robots['noindex'] = true;
	}

	// закроем страницы с параметром запроса ?filter
	if( isset( $_GET['filter'] ) )
		$robots['none'] = true;

	return $robots;
}

add_filter( 'wp_robots', 'wp_kama_robots_tag' );

function wp_kama_robots_tag( $robots ){

	// удалим нежелательную директиву
	unset( $robots['noindex'] );

	return $robots;
}

Добавить свой пример