Функция content_url() в WordPress позволяет получить URL для директории контента (по умолчанию это /wp-content). Она полезна для динамической ссылки на папки, такие как uploads, plugins и themes, избегая жестко заданных путей. В случае изменения расположения или имени папки контента функция автоматически вернет корректный путь.
content_url( string $path = '' ): string
Параметры
- $path (строка, необязательный): Путь относительно URL директории контента, который можно добавить в конце. По умолчанию
''.
Возвращаемое значение
Функция возвращает URL директории контента с учетом переданного пути $path и протокола (HTTP или HTTPS).
Пример 1: Получение URL директории контента
Чтобы получить URL директории контента, просто вызовите content_url() без параметров:
echo content_url();
// Выведет, например: https://example.com/wp-content (без завершающего слэша)
Пример 2: URL папки uploads внутри директории контента
Чтобы получить URL к папке uploads, используйте content_url('/uploads'):
echo content_url( '/uploads' );
// Выведет: https://example.com/wp-content/uploads
Пример 3: Путь к файлу внутри директории контента
Если вам нужно сослаться на конкретный файл, передайте его путь в $path:
echo content_url( '/plugins/my-plugin/assets/style.css' );
// Выведет: https://example.com/wp-content/plugins/my-plugin/assets/style.css
Пример 4: Переименованная директория контента
Если директория wp-content была переименована, например, на assets, функция будет автоматически учитывать это изменение:
// При изменении имени директории, например, на 'assets'
echo content_url();
// Выведет: https://example.com/assets
echo content_url('/plugins');
// Выведет: https://example.com/assets/plugins
Советы по использованию content_url()
- Избегайте жестко заданных путей: Используйте
content_url()вместо написания полного URL вручную. - Учет мультиязычности и мультисайтовости: Функция автоматически корректирует URL с учетом домена и подкаталога для мультисайтовых установок.
Заключение
Функция content_url() — это гибкий и безопасный способ работы с файлами и директориями внутри папки контента WordPress. Использование этой функции помогает избежать ошибок при изменении структуры сайта и обеспечивает совместимость с мультисайтовыми сетями и пользовательскими настройками.