get_home_url() WP 3.0.0

Отримує URL-адресу головної сторінки сайту (без / на кінці). Можна вказати ID сайту мережі.

Основа функції home_url() .

Повертає опцію get_option('home')із правильним протоколом. Протокол буде:

  • https– Коли виконується умова is_ssl() .
  • http– в інших випадках.
  • В адмінці береться протокол, який вказаний в опції home.

Використовуйте цю функцію лише тоді, коли потрібно отримати URL-адресу сайту, а не URL WordPress (де лежать файли ядра) (див. Загальні налаштування WordPress). Для отримання URL WordPress використовуйте get_site_url() .

Основа для:
get_rest_url() ,
home_url()
1 раз – 0.000065 сек
(дуже швидко) | 50000 разів – 0.39 сек
(дуже швидко) |
PHP 7.1.2, WP 4.7.3

Хуки з функції

Повертає

Строку. Рядок, УРЛ на головну сторінку блогу.

Використання

get_home_url($blog_id, $path, $scheme);
$blog_id
(число)
ID блогу, УРЛ якого треба отримати.


Типово: null (поточний блог)
$path
(рядок)
Дорога до головної сторінки блогу. Рядок, який буде дописаний до УРЛу блогу (
/qwe).


За замовчуванням: ”
$scheme
(рядок)
Схема у якій треба повертати УРЛ. Можливо:
httpабо
https.


Типово: null

Приклади

0

#1 Виведемо УРЛ блогу

<?php echo get_home_url(); ?>

http://example.com

0

#2 Встановимо шлях та схему

<?php echo get_home_url( null, 'wp-admin/', 'https'); ?>

https://example.com/wp-admin/

список змін

З версії 3.0.0Введено.

Код get_home_url() WP 6.0.2

function get_home_url( $blog_id = null, $path = '', $ scheme = null ) {
	$orig_scheme = $scheme;

	if ( empty( $blog_id ) || ! is_multisite() ) {
		$url = get_option( 'home' );
	} else {
		switch_to_blog($blog_id);
		$url = get_option( 'home' );
		restore_current_blog();
	}

	if ( ! in_array( $scheme, array( 'http', 'https', 'relative' ), true ) ) {
		if ( is_ssl() ) {
			$scheme = 'https';
		} else {
			$ scheme = parse_url ($ url, PHP_URL_SCHEME);
		}
	}

	$url = set_url_scheme($url, $scheme);

	if ( $path && is_string( $path ) ) {
		$url .= '/' . ltrim($ path, '/');
	}

	/**
	 * Filters the home URL.
	 *
	 * @ Since 3.0.0
	 *
	 * @param string $url Докладні домашні URL-адреси включають scheme and path.
	 * @param string $path Path relative to the home URL. Blank string if no path is specified.
	 * @param string|null $orig_scheme Scheme to give the home URL context. Accepts 'http', 'https',
	 * 'relative', 'rest', або null.
	 * @param int|null $blog_id Site ID, або null for the current site.
	 */
	return apply_filters( 'home_url', $url, $path, $orig_scheme, $blog_id );
}

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *