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

Прежде всего — что такое 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);