Функция PLUGINS_URL() в WordPress

Функция plugins_url() используется для получения URL-адреса, который находится в каталоге плагинов или mu-плагинов. Если вы не укажете дополнительные параметры, она вернет URL адрес каталога плагинов по умолчанию.

Основная информ��ция о функции

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

plugins_url( $path, $plugin );

• $path (строка): Дополнительный путь, который будет добавлен к концу URL. Укажите относительный путь к директории, если вы передаете параметр $plugin.

  • По умолчанию: пустая строка ''

• $plugin (строка): Полный путь к файлу внутри плагина или mu-плагины. URL будет относительным к его директории. Обычно передается __FILE__ в качестве аргумента.

  • По умолчанию: пустая строка ''

Пример использования

Функция может вернуть URL в зависимости от того, где она вызывается и какие параметры передаются. Например:

echo plugins_url(); // Вернет: http://example.com/wp-content/plugins

Если вы укажете путь к файлу в своем плагине:

echo plugins_url( 'plugin-name/style.css' ); // Вернет: http://example.com/wp-content/plugins/plugin-name/style.css

Если вы вызываете функцию из корня плагина:

echo plugins_url( 'style.css', __FILE__ ); // Вернет: http://example.com/wp-content/plugins/plugin-name/style.css

Примеры

Пример 1: URL к файлу в подкаталоге

Если вы вызвали plugins_url() из файла, который находится в подкаталоге плагина, и вам нужно получить URL к директории на уровень выше, используйте __DIR__ как второй параметр:

$img_url = plugins_url( 'images/img.png', __DIR__ );

Либо:

$parent_url = dirname( plugins_url( '', __FILE__ ) );
$img_url = "$parent_url/images/img.png";

Пример 2: Динамический путь к файлу плагина

Чтобы избежать поломки ссылки, если вы переименуете папку плагина, передайте __FILE__ в качестве второго параметра:

$plugins_url = plugins_url( 'style.css', __FILE__ );
echo $plugins_url; // Вернет: http://example.com/wp-content/plugins/plugin-name/style.css

Пример 3: Получение изображения

Если у вас есть каталог изображений и вы хотите получить URL к изображению, используйте следующий код:

echo '';

Это вернет .

Хранение URL

Функция возвращает строку, которая содержит полный URL-адрес, при этом возможно добавление дополнительных путей. Она позволяет более гибко работать с адресами в плагинах WordPress.

Резюме

Функция plugins_url() очень полезна для получения корректных URL-адресов файлов и ресурсов в ваших плагинах. Учитывайте, что правильная передача параметров поможет избежать ошибок при изменении структуры каталогов.

Примечания

• Убедитесь, что вызываете функцию из правильного места и используете необходимые параметры.
• Использование __FILE__ ускорит процесс получения правильного URL и предотвратит ошибки, если вы решите изменить имя папки вашего плагина.