get_site_url() WP 3.0.0

Отримує URL-адресу сайту.

Функція повертає опцію siteurl: get_option('siteurl'). Також встановлює протокол сайту: https – якщо спрацьовує is_ssl() або http. Можна вказати протокол у параметрі $scheme .

Вказуючи адресу блогу, ми можемо перемістити всі файли WordPress до окремого каталогу. Робиться це для зручності, коли користувачеві заважають файли WordPress в основному каталозі та їх хотілося б прибрати у підкаталог основного каталогу. Як це зробити читайте тут .

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

Основа для:
site_url() ,
get_admin_url()
1 раз – 0.000067 сек
(дуже швидко) | 50000 разів – 2.20 сек
(швидко)

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

Повертає

Строку.

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

$ site_url = get_site_url ($ blog_id, $ path, $ scheme);
$blog_id
(число)
ID блогу.


Типово: поточний блог (null)
$path
(рядок)
Нехай до сторінки сайту, який буде додано до URL.


За замовчуванням: ”
$scheme
(рядок)

Схема відповідно до якої потрібно змінювати URL-адресу. Може бути:

http
https
relative — поверне відносну URL-адресу (без домену).
login - протокол сторінки авторизації
login_post
admin
rest
rpc
null - поточний протокол сайту is_ssl()

Детальніше дивіться set_url_scheme()

Типово: null

Приклади

1

#1 Демонстрація роботи функції:

echo get_site_url();

// поверне: http://www.example.com
0

#2 Вкажемо протокол примусово

echo get_site_url(null, '', 'https');

// Отримаємо: https://example.com

список змін

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

Код get_site_url() WP 6.0.2

function get_site_url( $blog_id = null, $path = '', $ scheme = null ) {
	if ( empty( $blog_id ) || ! is_multisite() ) {
		$url = get_option( 'siteurl');
	} else {
		switch_to_blog($blog_id);
		$url = get_option( 'siteurl');
		restore_current_blog();
	}

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

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

	/**
	 * Filters the site URL.
	 *
	 * @ Since 2.7.0
	 *
	 * @param string $url Докладний сайт URL, включаючи scheme and path.
	 * @param string $path Path relative to the site URL. Blank string if no path is specified.
	 * @param string|null $scheme Scheme to give the site URL context. Accepts 'http', 'https', 'login',
	 * 'login_post', 'admin', 'relative' або null.
	 * @param int|null $blog_id Site ID, або null for the current site.
	 */
	return apply_filters( 'site_url', $url, $path, $scheme, $blog_id );
}

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

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