Como utilizar is_plugin_active() no WordPress2 min leitura

Exemplo prático de código para utilizar a função PHP is_plugin_active() do WordPress.

A função PHP is_plugin_active() verifica se um plugin localizado no diretório plugins/ está ativo ou não. Plugins instalados dentro diretório mu-plugins/ (must-use plugins) não podem ser ativados e por isto esta função sempre retornará falso para eles.

A função is_plugin_active() é bastante útil quando você precisa executar um código que personaliza o comportamento de um plugin ou altera algo em seu site se o mesmo estiver ativo. Para evitar erros fatais na execução deste código caso o plugin não estiver ativo, é preciso fazer esta verificação e é aí que a função ajuda.

Ela possui como parâmetro uma string com o caminho do arquivo principal do plugin, relativo ao diretório de plugins. Este normalmente tem o formato de: diretório do plugin/arquivo do plugin.php.

<?php // Verificando a ativação do plugin YOAST dentro da tela de administração if ( is_plugin_active( 'wordpress-seo/wp-seo.php' ) ) { echo "plugin Yoast SEO está ativo"; } else { echo "plugin Yoast SEO está INATIVO"; } ?>
Code language: PHP (php)

Caso você tente executar o código acima fora da tela de administração, será exibido o erro: Fatal error: Uncaught Error: Call to undefined function is_plugin_active(). Para corrigir este problema é necessário incluir o arquivo wp-admin/includes/plugin.php para adicionar a função de validação.

<?php // Verificando a ativação do plugin YOAST no front-end do site include_once( ABSPATH . 'wp-admin/includes/plugin.php' ); if ( is_plugin_active( 'wordpress-seo/wp-seo.php' ) ) { echo "plugin Yoast SEO está ativo"; } else { echo "plugin Yoast SEO está INATIVO"; } ?>
Code language: PHP (php)

Nem sempre é muito claro qual é o arquivo principal do plugin. Para ajudar nessa identificação procure por um cabeçalho similar a este no conteúdo do arquivo:

<?php /** * Plugin Name: Plugin Mágico * Description: Descrição da magia que o plugin faz * Plugin URI: https://www.danielkossmann.com/plugin-magico * Version: 3.3 * Author: Daniel Kossmann * Author URI: https://www.danielkossmann.com/ * Text Domain: plugin-magico * * @package Plugin Magico */ ?>
Code language: PHP (php)

Similar Posts

Você tem algo construtivo sobre este texto para dizer? Então comente abaixo