get_home_url()

Извлекает URL-адрес для заданного сайта, на котором доступен внешний интерфейс
Функция WordPress
INT 3.0.0
WordPress Icon

Описание функции

Функция get_home_url() возвращает URL для указанного сайта, где доступен фронтэнд.

Она используется для получения URL главной страницы сайта или для получения URL определенного сайта в многосайтовой установке WordPress.

Функция принимает несколько параметров, таких как идентификатор сайта, путь относительно главного URL и схема, которая дает контекст для главного URL.

Она возвращает строку с URL главной страницы, к которой может быть добавлен необязательный путь.

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

get_home_url( int|null $blog_id = null, string $path = '', string|null $scheme = null ): string

Эта функция принимает три необязательных параметра: $blog_id, $path и $scheme.

$blog_id — необязательный параметр, который указывает идентификатор сайта. По умолчанию равен null, что означает текущий сайт.

$path — необязательный параметр, который указывает путь относительно главного URL. По умолчанию равен пустой строке.

$scheme — необязательный параметр, который указывает схему, которая дает контекст для главного URL. Принимает значения ‘http’, ‘https’, ‘relative’, ‘rest’ или null. По умолчанию равен null.

Функция возвращает строку с URL главной страницы, к которой может быть добавлен необязательный путь.

<?php
/**
 * Пример использования функции get_home_url()
 */
// Получение URL главной страницы текущего сайта
$home_url = get_home_url();
echo $home_url;
// Получение URL главной страницы сайта с ID 2
$home_url_2 = get_home_url(2);
echo $home_url_2;
// Получение URL главной страницы текущего сайта с добавлением пути
$home_url_path = get_home_url(null, '/about');
echo $home_url_path;
// Получение URL главной страницы текущего сайта с указанием схемы
$home_url_scheme = get_home_url(null, '', 'https');
echo $home_url_scheme;
?>

В этом примере мы используем функцию get_home_url() для получения URL главной страницы.

Первый вызов функции возвращает URL главной страницы текущего сайта.

Второй вызов функции возвращает URL главной страницы сайта с ID 2.

Третий вызов функции возвращает URL главной страницы текущего сайта с добавлением пути «/about».

Четвертый вызов функции возвращает URL главной страницы текущего сайта с указанием схемы «https».

Примеры использования

Получение домашней ссылки с помощью get_home_url()


/**
 * Получение домашней ссылки текущего сайта
 */
$home_url = get_home_url();
echo $home_url;

В данном примере мы используем функцию get_home_url() без указания дополнительных параметров. Функция возвращает домашнюю ссылку текущего сайта. Результатом выполнения кода будет вывод домашней ссылки.

Создание ссылки на главную страницу сайта


/**
 * Создание ссылки на главную страницу сайта
 */
$home_url = get_home_url();
$home_link = '<a href="' . esc_url( $home_url ) . '">Home</a>';
echo $home_link;

В данном примере мы используем функцию get_home_url() для получения домашней ссылки текущего сайта. Затем мы создаем HTML-ссылку на главную страницу сайта, используя полученную домашнюю ссылку. Функция esc_url() используется для безопасного экранирования URL. Результатом выполнения кода будет вывод HTML-ссылки на главную страницу сайта.

Редирект на домашнюю страницу с использованием get_home_url()


/**
 * Редирект на домашнюю страницу
 */
$home_url = get_home_url();
wp_redirect( $home_url );
exit;

В данном примере мы используем функцию get_home_url() для получения домашней ссылки текущего сайта. Затем мы используем функцию wp_redirect() для выполнения редиректа на полученную домашнюю ссылку. Функция exit используется для прекращения выполнения скрипта после редиректа. Результатом выполнения кода будет редирект на домашнюю страницу сайта.

Использование get_home_url() для формирования ссылки на страницу администратора


/**
 * Формирование ссылки на страницу администратора
 */
$admin_url = get_home_url( null, '/wp-admin/' );
$admin_link = '<a href="' . esc_url( $admin_url ) . '">Admin</a>';
echo $admin_link;

В данном примере мы используем функцию get_home_url() для получения домашней ссылки текущего сайта. Затем мы добавляем относительный путь к административной странице сайта, используя второй параметр функции. Затем мы создаем HTML-ссылку на страницу администратора, используя полученную ссылку. Функция esc_url() используется для безопасного экранирования URL. Результатом выполнения кода будет вывод HTML-ссылки на страницу администратора.

Вопросы и ответы

Как получить URL главной страницы сайта?

Для получения URL главной страницы сайта в WordPress можно использовать функцию get_home_url(). Она возвращает ссылку на главную страницу сайта, доступную для пользователей.

Пример использования:


$home_url = get_home_url();
echo $home_url;

Как добавить путь к URL главной страницы?

Если вам нужно добавить путь к URL главной страницы, вы можете передать его вторым параметром в функцию get_home_url().

Пример использования:


$path = '/blog';
$home_url = get_home_url(null, $path);
echo $home_url;

Как указать схему (http, https) для URL главной страницы?

Если вам нужно указать схему (http или https) для URL главной страницы, вы можете передать ее третьим параметром в функцию get_home_url().

Пример использования:


$scheme = 'https';
$home_url = get_home_url(null, '', $scheme);
echo $home_url;

Как получить URL главной страницы для определенного сайта (blog_id)?

Функция get_home_url() позволяет получить URL главной страницы для определенного сайта (blog_id).

Для этого нужно передать идентификатор сайта в качестве параметра $blog_id.

Например, если нам нужно получить URL главной страницы для сайта с идентификатором 2, мы можем использовать следующий код:


$blog_id = 2;
$url = get_home_url($blog_id);

Как получить URL главной страницы с относительным путем?

Функция get_home_url() также позволяет получить URL главной страницы с относительным путем.

Для этого нужно передать путь в качестве параметра $path.

Например, если нам нужно получить URL главной страницы с относительным путем «about», мы можем использовать следующий код:


$path = 'about';
$url = get_home_url(null, $path);

Как получить URL главной страницы для использования в REST API?

Функция get_home_url() также может быть использована для получения URL главной страницы для использования в REST API.

Для этого нужно передать параметр 'rest' в качестве значения параметра $scheme.

Например, если нам нужно получить URL главной страницы для использования в REST API, мы можем использовать следующий код:


$scheme = 'rest';
$url = get_home_url(null, '', $scheme);

Как получить URL главной страницы без указания пути?

Функция get_home_url() используется для получения URL главной страницы сайта без указания пути. Она возвращает строку с URL главной страницы, к которой можно добавить необязательный путь.

Пример использования:


$home_url = get_home_url();
echo $home_url;

Как получить URL главной страницы с указанием определенной схемы?

Функция get_home_url() также позволяет указать определенную схему для URL главной страницы. Это может быть ‘http’, ‘https’, ‘relative’, ‘rest’ или null.

Пример использования:


$home_url = get_home_url(null, '', 'https');
echo $home_url;

Как получить URL главной страницы для другого сайта (blog_id) с указанием пути и схемы?

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

Пример использования:


$home_url = get_home_url(2, '/path/to/page', 'https');
echo $home_url;

Функция get_home_url() является полезным инструментом для получения URL главной страницы сайта в WordPress. Она позволяет получить URL без указания пути, с указанием определенной схемы, а также для другого сайта с указанием пути и схемы. Это удобно при разработке и настройке сайта, когда требуется получить и использовать URL главной страницы в коде.

Связанные элементы

  • Функция get_admin_url(): Возвращает URL для административной панели сайта.
  • Функция get_bloginfo(): Возвращает информацию о текущем сайте или блоге.
  • Функция get_permalink(): Возвращает постоянную ссылку на указанный пост или страницу.
  • Функция get_template_directory_uri(): Возвращает URL каталога текущей темы.
  • Функция get_stylesheet_directory_uri(): Возвращает URL каталога текущей активной темы.
  • Функция get_theme_mod(): Возвращает значение настройки темы.
  • Функция get_theme_support(): Возвращает информацию о поддержке функций текущей темы.
  • Хук wp_enqueue_scripts: Используется для добавления стилей и скриптов на фронтенд сайта.
  • Класс WP_Query: Используется для выполнения запросов к базе данных WordPress и получения соответствующих результатов.
  • Класс WP_Customize_Manager: Используется для настройки и управления настройками темы в пользовательском интерфейсе.
Обсуждение