content_url() – возвращает абсолютный URL папки wp-content на сайте

Прежде всего — что такое wp-content?

Это такая папка (директория), которая находится прямо в директории установки WordPress:

директория wp-content и её содержимое в WordPress

Как видно по скриншоту, в wp-content содержатся некоторые другие папки, а именно:

  • plugins — папка с установленными на сайте плагинами,
  • themes — с темами соответственно,
  • upgrade — нужна при обновлении движка, плагинов и тем,
  • uploads — папка с медиафайлами сайта, в некоторых случаях может быть переназначена.

С wp-content разобрались, теперь переходим собственно к функции WordPress content_url().

Она возвращает абсолютный URL к wp-content на сайте.

Протокол соединения (то есть http:// или https://) определяется функцией is_ssl().

content_url( $path = '' )
$path
(строка) (параметр не обязателен) Какой-нибудь дополнительный путь относительно директории wp-content, например к папке тем (/themes/) или плагинов plugins.
Относительно слэшей можете не беспокоиться, функция автоматически удаляет левый слэш (если такой имеется, php-функцией ltrim()) и затем добавляет его сама.

Если в качестве параметра передано не строковое значение (массив, объект и так далее), то он просто будет проигнорирован.

Примеры использования функции content_url()

Несколько нехитрых примеров:

// в качестве примера возьму свой сайт https://misha.blog
echo content_url(); // https://misha.blog/wp-content/
$additional_path = '/themes/'; // путь к папке с темами
$url = content_url( $additional_path );
echo $url; // https://misha.blog/wp-content/themes/
$additional_path = 'themes/'; // тоже путь к папке с темами, но только без слэша в начале
$url = content_url( $additional_path );
echo $url; // https://misha.blog/wp-content/themes/ - результат тот же

Вкратце про фильтр content_url

При помощи этого фильтра вы можете изменить возвращаемые значения всех функций content_url() на сайте. Для этого в functions.php вставляем код примерно следующего содержимого:

function true_change_wp_content_url( $url, $path ) {
    // как видите фильтр позволяет оперировать параметрами $url (результат действия функции) и $path (описано выше)
    // есть люди, которые полностью скрывают следы использования WordPress, в том числе переименовывают папку wp-content
    return str_replace('wp-content', 'misha-content', $url);
}
 
add_filter( 'content_url', 'true_change_wp_content_url', 10, 2);

Источник: misha.blog

Миша Рудрастых

Путешествует по миру и рассказывает всем о WordPress лично, у себя в блогах и на курсах в Санкт-Петербурге. Умеет просто объяснять сложные вещи, делает это красиво. Организовывает неплохие WordCamp's, но совсем не умеет слушать чужие доклады.

Добавить комментарий

%d такие блоггеры, как: