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

Позволяет расширить список внутренних хостов (доменов).

Повлияет на работу фукнции wp_is_internal_link().

Этот хук может пригодиться, когда например, у нас изменился домен, но какая-то часть кода все еще работает для старого домена и нам нужно добавить старый домен в список внутренних доменов (хостов) сайта.

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

add_filter( 'wp_internal_hosts', 'wp_kama_internal_hosts_filter' );

/**
 * Function for `wp_internal_hosts` filter-hook.
 * 
 * @param string[] $internal_hosts An array of internal URL hostnames.
 *
 * @return string[]
 */
function wp_kama_internal_hosts_filter( $internal_hosts ){

	// filter...
	return $internal_hosts;
}
$internal_hosts(массив)
Массив внутренних имен хостов URL.

Примеры

0

#1 Возвращаем отфильтрованный массив внутренних имен хостов

add_filter( 'wp_internal_hosts', 'air_internal_hosts_filter' );

/**
 * Изменяет список внутренних хостов (доменов).
 *
 * Коллбэк для фильтра 'wp_internal_hosts'.
 *
 * @param array $internal_hosts Массив внутренних имен хостов URL.
 *
 * @return array
 */
function air_internal_hosts_filter( $internal_hosts ) {

	$internal_hosts[] = 'dev.example.com';

	$key = array_search( 'old.example.host', $internal_hosts );
	if ( false !== $key ) {
		unset( $internal_hosts[ $key ] );
	}

	return $internal_hosts;
}

Список изменений

С версии 6.2.0 Введена.

Где вызывается хук

wp_internal_hosts()
wp_internal_hosts
wp-includes/link-template.php 4793-4798
$internal_hosts = apply_filters(
	'wp_internal_hosts',
	array(
		wp_parse_url( home_url(), PHP_URL_HOST ),
	)
);

Где используется хук в WordPress

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