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".
По умолчанию: нет
Примеры
#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:
wp-admin/includes/plugin.php
WP 5.3.1
Cвязанные функции
Из метки: plugin (плагин)
Еще из метки: Условные теги (все)
- cat_is_ancestor_of()
- comments_open()
- email_exists()
- has_category()
- has_custom_header()
- has_excerpt()
- has_nav_menu()
- has_post_thumbnail()
- has_shortcode()
- has_tag()
- has_term()
- have_comments()
- have_posts()
- in_category()
- in_the_loop()
- is_404()
- is_active_sidebar()
- is_admin()
- is_admin_bar_showing()
- is_archive()
- is_attachment()
- is_author()
- is_blog_admin()
- is_blog_installed()
- is_category()
- is_child_theme()
- is_comment_feed()
- is_customize_preview()
- is_date()
- is_day()
- is_dynamic_sidebar()
- is_embed()
- is_feed()
- is_front_page()
- is_header_video_active()
- is_home()
- is_local_attachment()
- is_main_query()
- is_month()
- is_multi_author()
- is_multisite()
- is_nav_menu()
- is_network_admin()
- is_new_day()
- is_page()
- is_page_template()
- is_paged()
- is_post_type_archive()
- is_post_type_hierarchical()
- is_preview()
- is_robots()
- is_search()
- is_single()
- is_singular()
- is_ssl()
- is_sticky()
- is_tag()
- is_tax()
- is_taxonomy_hierarchical()
- is_textdomain_loaded()
- is_time()
- is_trackback()
- is_user_admin()
- is_user_logged_in()
- is_year()
- pings_open()
- post_exists()
- post_password_required()
- shortcode_exists()
- taxonomy_exists()
- term_exists()
- term_is_ancestor_of()
- wp_attachment_is()
- wp_attachment_is_image()
- wp_doing_ajax()
- wp_doing_cron()
- wp_is_mobile()
- wp_is_post_autosave()
- wp_is_post_revision()
- wp_script_is()
Еще из раздела: Плагины, хуки
Странная штука эта, что приходится plugin.php подключать. Вставил в functions.php без этого подключения и получил ошибку, жара!
Надеюсь, если буду использовать когда-то в плагинах, то такого не будет, не люблю подключать файлы движка лишний раз (это ведь ведет у увеличению потребления ОЗУ?).
Удобно использовать такую функцию:
/** * Проверяем активен ли требуемый плагин на отдельном сайте или в 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; }совмещая с проверкой существования:
класса
class_exists( 'WooCommerce' )или функции
function_exists( 'sharing_display' )или константы
defined( 'CMB2_LOADED' )Пример. Проверим готов ли плагин CMB2:
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>'; } ); }Подробно на github How to detect if a WordPress plugin is active
В одном из плагинов видел такую проверку:
if(in_array('woocommerce/woocommerce.php', apply_filters('active_plugins', get_option('active_plugins')))){ // делаем что-либо }