is_plugin_active() WP 2.5.0

Проверяет, активен ли указанный плагин. Работает только в админ-панели. Условный тег.

Функция находится в файле 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

Хуков нет.

Возвращает

true/false. true, если плагин активен и false, если не активен.

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

// require_once( ABSPATH . 'wp-admin/includes/plugin.php' ); // для фронта
if ( is_plugin_active( $plugin ) ){
	// Плагин активен
}

$plugin(строка) (обязательный): Название плагина в формате: "папка_плагина/имя_файла.php" или "имя_файла.php", если плагин состоит из одно файла, который лежит в корне папки wp-content/plugins/.
По умолчанию: нет

Примеры

#1 Проверка активности плагина в админ-панели

/**
 * Проверка активности плагина на странице плагинов.
 */
if ( is_plugin_active( 'plugin-directory/plugin-file.php' ) ) {
	echo 'Плагин активен';
}
else {
	echo 'Плагин не активен';
}

#2 Проверка активности плагина вне админ-панели (в теме)

/**
 * Проверка активности плагина не на странице плагинов.
 */
include_once ABSPATH . 'wp-admin/includes/plugin.php';
if ( is_plugin_active( 'plugin-directory/plugin-file.php' ) ) {
	echo 'Плагин активен'
}

Список изменений

С версии 2.5.0

Введена.

Код `is_plugin_active() is plugin active` ^{WP 5.6}

wp-admin/includes/plugin.php

<?php
function is_plugin_active( $plugin ) {
	return in_array( $plugin, (array) get_option( 'active_plugins', array() ), true ) || is_plugin_active_for_network( $plugin );
}

Из метки: plugin (плагин)

wp_get_active_and_valid_plugins()

Еще из метки: Условные теги (все)

Еще из раздела: Плагины, хуки

/** * Проверяем активен ли требуемый плагин на отдельном сайте или в Multisite. * @param $plugin * @return bool */ function main_is_plugin_active( $plugin ) { $network_active = false; if ( is_multisite() ) { $plugins = get_site_option( 'active_sitewide_plugins' ); if ( isset( $plugins[$plugin] ) ) { $network_active = true; } } return in_array( $plugin, get_option( 'active_plugins' ) ) || $network_active; }

if ( main_is_plugin_active( 'cmb2/init.php' ) || defined( 'CMB2_LOADED' ) ) { // плагин активен, подключим файл с функциями require_once get_template_directory() . '/functions/cmb2.php'; } elseif ( is_admin() && current_user_can('manage_options') ) { // плагин не активен, покажем админу уведомление add_action( 'admin_notices', function(){ echo '<div id="message" class="error notice is-dismissible"><p>Плагин CMB2 <b>не активен!</b></p></div>'; } ); }

campusboy3725 www.youtube.com/c/wpplus

Странная штука эта, что приходится plugin.php подключать. Вставил в functions.php без этого подключения и получил ошибку, жара! Надеюсь, если буду использовать когда-то в плагинах, то такого не будет, не люблю подключать файлы движка лишний раз (это ведь ведет у увеличению потребления ОЗУ?).

Ответить4.8 года назад #

llgruff55

Если файл не подключен, то при выполнении PHP выдаст ошибку "Call to undefined function..."

Удобно использовать такую функцию:

совмещая с проверкой существования:
класса class_exists( 'WooCommerce' )
или функции function_exists( 'sharing_display' )
или константы defined( 'CMB2_LOADED' )

Пример. Проверим готов ли плагин CMB2:

Подробно на github How to detect if a WordPress plugin is active

Ответить4 года назад #

В одном из плагинов видел такую проверку:

if(in_array('woocommerce/woocommerce.php', apply_filters('active_plugins', get_option('active_plugins')))){
	// делаем что-либо
}

Ответить3.8 года назад #