is_plugin_active()
Проверяет, активен ли указанный плагин. Работает только в админ-панели. Условный тег.
Функция находится в файле wp-admin/includes/plugin.php, а значит работает в админ-панели.
Использовать функцию можно очень рано, но рекомендуется во время события admin_init или позже, потому что до этих событий другой код может активировать или деактивировать плагины.
Для работы функции на фронте нужно подключить файл:
require_once ABSPATH . 'wp-admin/includes/plugin.php';
1 раз — 0.000043 сек (очень быстро) | 50000 раз — 0.63 сек (очень быстро) | PHP 7.0.14, WP 4.7
Хуков нет.
Возвращает
{{return type}} true, если плагин активен и false, если не активен.
Использование
// require_once( ABSPATH . 'wp-admin/includes/plugin.php' ); // для фронта
if ( is_plugin_active( $plugin ) ){
// Плагин активен
}
- $plugin(строка) (обязательный)
- Название плагина в формате: "папка_плагина/имя_файла.php" или "имя_файла.php", если плагин состоит из одно файла, который лежит в корне папки wp-content/plugins/.
Примеры
#1 Проверка активирован ли плагин вне админ-панели (в теме)
/**
* Проверка активности плагина не на странице плагинов.
*/
include_once ABSPATH . 'wp-admin/includes/plugin.php';
if ( is_plugin_active( 'plugin-directory/plugin-file.php' ) ) {
echo 'Плагин активен'
} #2 Проверка активирован ли плагин в админ-панели
/**
* Проверка активности плагина на странице плагинов.
*/
if ( is_plugin_active( 'plugin-directory/plugin-file.php' ) ) {
echo 'Плагин активен';
}
else {
echo 'Плагин не активен';
}
Список изменений
| С версии 2.5.0 | Введена. |
Код is_plugin_active() is plugin active WP 6.1.1
function is_plugin_active( $plugin ) {
return in_array( $plugin, (array) get_option( 'active_plugins', array() ), true ) || is_plugin_active_for_network( $plugin );
} 