Функция plugin_dir_url() в WordPress: описание, примеры использования, исходный код

## Функция plugin_dir_url()

Функция plugin_dir_url() в WordPress используется для получения URL-адреса директории плагина, переданной в качестве параметра. Эта функция была введена в версии WordPress 2.8.0.

### Возвращаемое значение

Функция возвращает строку — URL-адрес директории, в которой находится плагин.

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

Чтобы использовать функцию, можно вызвать её следующим образом:

```php
plugin_dir_url( $file );

• $file (string) (обязательный) — имя файла плагина (например, __FILE__).

Примеры

Пример 1: Получение URL-адреса директории плагина

Предположим, что у нас есть главный файл плагина в папке /wp-content/plugins/my_plugin. Мы можем вызвать функцию так:

echo plugin_dir_url( __FILE__ );

Это выведет на экран:

http://example.com/wp-content/plugins/my_plugin/

Пример 2: Регистрация CSS-файла плагина

Мы можем использовать plugin_dir_url() для подключения CSS-стилей к нашему плагину. Например:

add_action( 'wp_enqueue_scripts', 'myplugin_scripts' );

/**
 * Подключение CSS-файла для MyPlugin.
 */
function myplugin_scripts() {
    wp_register_style( 'foo-styles', plugin_dir_url( __FILE__ ) . 'assets/foo-styles.css' );
    wp_enqueue_style( 'foo-styles' );
}

Здесь мы регистрируем стиль foo-styles, который будет загружаться из папки assets, находящейся в директории плагина.

Обновления

• Версия 2.8.0 — функция была введена.

Исходный код функции

Ниже представлен код функции plugin_dir_url() в WordPress:

function plugin_dir_url( $file ) {
return trailingslashit( plugins_url( '', $file ) );
}

Связанные функции

Вот некоторые функции, которые могут быть полезны в работе с URL в WordPress:

• admin_url()
• attachment_url_to_postid()
• build_query()
• content_url()
• home_url()
• plugins_url()

Эти функции позволяют работать с различными URL-адресами, связанными с вашим сайтом и его контентом.

Заключение

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