includes_url()
Отримує 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
(дуже повільно) | 50000 разів – 2.29 сек
(швидко) |
PHP 7.2.16, WP 5.2
Хуки з функції
Повертає
Строку. URL каталогу включаються з доданим шляхом.
Використання
$ url = includes_url ($ path, $ scheme);
- $path
(рядок) - Шлях, який потрібно додати до кінця URL.
За замовчуванням: ” - $scheme
(рядок) - Дозволяє жорстко встановити протокол https. Приймає значення:
‘http’ ,
‘https’ , або
‘relative’ .
Типово: null
Приклади
#1 Базове використання
$url = includes_url(); echo $url; // Виведе: http://wp-kama.ru/wp-includes/
список змін
| З версії 2.6.0 | Введено. |
Код includes_url() includes url WP 6.0.2
function includes_url( $path = '', $ scheme = null ) {
$url = site_url( '/' . WPINC . '/', $scheme );
if ( $path && is_string( $path ) ) {
$url .= ltrim( $path, '/' );
}
/**
* Filters the URL для includes directory.
*
* @ Since 2.8.0
* @since 5.8.0 The `$scheme` parameter was added.
*
* @param string $url Докладні URL-адреси для включення directory, включаючи scheme and path.
* @param string $path Path відносяться до URL до 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', або null. Default null.
*/
return apply_filters( 'includes_url', $url, $path, $scheme);
}