Функция includes_url() в WordPress c примерами.

Функция includes_url() в WordPress позволяет получить URL-адрес каталога /wp-includes/, который содержит файлы ядра WordPress. Эта функция удобна, когда необходимо динамически ссылаться на файлы внутри каталога /wp-includes/ без жесткого указания пути, что делает ваш код более гибким и адаптируемым.

includes_url( string $path = ”, string|null $scheme = null ): string

Возвращает URL-адрес каталога /wp-includes/ для текущего сайта, учитывая протокол (HTTP или HTTPS). Функция автоматически определяет, следует ли использовать протокол HTTPS в зависимости от состояния сайта (если используется SSL).

Возвращаемое значение:

• Строка: URL-адрес каталога /wp-includes/, заканчивающийся на слеш /.

Параметры функции

Функция includes_url() принимает два необязательных параметра:

• $path (строка): Дополнительный путь, который будет добавлен к базовому URL. По умолчанию пусто.
• $scheme (строка): Позволяет указать, какой протокол использовать. Может принимать значения 'http', 'https' или 'relative'. Если параметр не задан, будет использоваться текущий протокол сайта, автоматически определяемый функцией.

Принцип работы

Функция includes_url() проверяет, используется ли SSL (протокол HTTPS) на сайте с помощью функции is_ssl(). Если SSL активен, функция вернет URL с использованием протокола HTTPS. В противном случае, URL будет с протоколом HTTP. Это позволяет функции корректно работать в различных условиях и конфигурациях серверов.

Кроме того, функция использует константу WPINC, которая указывает на базовый путь к каталогу /wp-includes/. Это гарантирует, что функция будет работать корректно, даже если ядро WordPress установлено в подкаталоге.

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

Простой вызов функции includes_url() вернет URL к каталогу /wp-includes/ с учетом текущего протокола:

<?php
$url = includes_url();
echo $url;
// Выведет: http://example.com/wp-includes/ или https://example.com/wp-includes/ в зависимости от использования SSL
?>

Пример 2: Использование с добавлением пути

Если вам нужно добавить путь к базовому URL, передайте его в параметре $path:

<?php
$url = includes_url('js/jquery/jquery.js');
echo $url;
// Выведет: http://example.com/wp-includes/js/jquery/jquery.js или https://example.com/wp-includes/js/jquery/jquery.js
?>

Пример 3: Указание протокола

Вы можете принудительно указать протокол с помощью параметра $scheme. Например, чтобы всегда использовать HTTPS:

<?php
$url = includes_url('', 'https');
echo $url;
// Выведет: https://example.com/wp-includes/
?>

Заключение

Функция includes_url() является мощным инструментом для динамического получения URL-адреса каталога /wp-includes/, с учетом протокола SSL. Это позволяет избежать жесткого кодирования путей в ваших плагинах и темах, что делает ваш код более гибким и надежным.