includes_url() │ WP 2.6.0

Получает URL на папку wp-includes с учетом протокола https.

Функция проверяет условие is_ssl() если оно соблюдается, то URL будет получен с протоколом https, в остальных случаях протокол будет http.

Так как ядро WordPress можно помещать во вложенные папки, при написании плагинов не стоит жестко указывать путь до каталога includes где это необходимо. Когда нужно получить URL, рекомендуется использовать эту функцию, она динамически получит путь и учтет протокол ssl.

Использует константу WPINC.

1 раз — 0.003941 сек (очень медленно) | 50000 раз — 2.29 сек (быстро) | PHP 7.2.16, WP 5.2
Хуки из функции

Возвращает

Строку. URL каталога includes с добавленным путем.

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

$url = includes_url( $path, $scheme );
$path(строка)
Путь, который нужно добавить в конец URL.
По умолчанию: ''
$scheme(строка)
Позволяет жестко установить протокол https. Принимает значения: 'http', 'https', или 'relative'.
По умолчанию: null

Примеры

0

#1 Базовое использование 

$url = includes_url();
echo $url;

// Выведет: http://wp-kama.ru/wp-includes/

Список изменений

С версии 2.6.0 Введена.

Код includes_url() WP 6.5.2

wp-includes/link-template.php 
function includes_url( $path = '', $scheme = null ) {
	$url = site_url( '/' . WPINC . '/', $scheme );

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

	/**
	 * Filters the URL to the includes directory.
	 *
	 * @since 2.8.0
	 * @since 5.8.0 The `$scheme` parameter was added.
	 *
	 * @param string      $url    The complete URL to the includes directory including scheme and path.
	 * @param string      $path   Path relative to the URL to the wp-includes directory. Blank string
	 *                            if no path is specified.
	 * @param string|null $scheme Scheme to give the includes URL context. Accepts
	 *                            'http', 'https', 'relative', or null. Default null.
	 */
	return apply_filters( 'includes_url', $url, $path, $scheme );
}

URL (УРЛ Ссылка)

Админ-панель