is_plugin_active() | 判断WordPress插件是否处于激活状态

函数

is_plugin_active($plugin);

描述

确定插件是否处于活动状态。

is_plugin_active() 函数的作用是检查指定的 WordPress 插件是否被激活，可用于后台管理页面以及前端主题页面检查插件是否被激活启用。比如主题功能依赖某个插件，需要判断网站是否已安装并启用指定的插件，就需要用到 is_plugin_active() 函数。

参数

$plugin，(string) (必需) 插件文件相对于插件目录的路径。

返回值

(bool) 如果插件处于激活状态，为True；否则，为 false。

划重点

只有安装在 plugins/ 文件夹中的插件才能处于活动状态。

mu-plugins/ 文件夹中的插件无法“激活”，因此对于这些插件，此函数将返回 false。

有关类似主题功能的更多信息，请查看主题开发人员手册中的条件标签文章。

相关函数

is_plugin_active_for_network()

get_option()

来源

文件：wp-admin/includes/plugin.php

更新日志

2.5.0 介绍。

例子

后台管理界面，检查 akismet 插件是否被激活

if(is_plugin_active('akismet/akismet.php'){
	echo '插件已激活';
}else{
	echo '插件未激活';
}

在前端使用，如主题中

include_once( ABSPATH . 'wp-admin/includes/plugin.php' );
if(is_plugin_active('akismet/akismet.php'){
	echo '插件已激活';
}else{
	echo '插件未激活';
}

区别是要先定义 wp-admin/includes/plugin.php，否则函数在主题中无效。