Функция INCLUDES_URL() в WordPress

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

Как работает функция

Функция проверяет, используется ли HTTPS, с помощью функции is_ssl(). Если ответ положительный, к URL добавляется https, в противном случае — http.

• В WordPress с версии 2.6.0.

Производительность

• Время выполнения один раз — 0.003941 секунды (для низкой нагрузки)
• Время выполнения 50,000 раз — 2.29 секунды (для высокой нагрузки)

Функция использует константу WPINC.

Хуки функции

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

Возврат значения

Функция возвращает строку — ссылку на директорию includes, с возможным добавленным путем.

Использование функции

includes_url( $path, $scheme );

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

• $path (string) — путь, относительный к URL директории includes. По умолчанию: '' (пустая строка).
• $scheme (string|null) — схемa для формирования контекста URL. Принимает значения: http, https или relative. По умолчанию: null.

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

Простой пример

$url = includes_url();
echo $url;
// Вывод: http://ваш-сайт.com/wp-includes/

Изменения в коде

Функция была представлена в версии 2.6.0 и продолжала обновляться.

Код функции

Функция includes_url() реализована следующим образом:

function includes_url( $path = '', $scheme = null ) {
$url = site_url( '/' . WPINC . '/', $scheme );

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

return apply_filters( 'includes_url', $url, $path, $scheme );

}

Связанные функции

Вот некоторые функции, которые могут быть полезны:

• admin_url() — получает URL к админ-панели.
• content_url() — получает URL к директории с содержимым.
• plugins_url() — получает URL к директории плагинов.

Эти функции также предоставляют разные способы получения URL в WordPress и могут быть использованы в зависимости от ваших нужд.