wp_internal_hosts
Позволяет расширить список внутренних хостов (доменов).
Повлияет на работу фукнции 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.
Примеры
#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-includes/link-template.php 4874-4879
$internal_hosts = apply_filters( 'wp_internal_hosts', array( wp_parse_url( home_url(), PHP_URL_HOST ), ) );