¿Qué es la función is_plugin_active de WordPress y cómo usarla?

is_plugin_active es una función de WordPress que verifica si un plugin específico está activo. Determinar si un plugin está activo te puede ayudar a crear funciones personalizadas que solo se ejecuten cuando un plugin determinado o un conjunto de plugins están activos.

Exploremos cómo funciona is_plugin_active y cómo usarlo en tu sitio de WordPress.

Puntos Clave

• is_plugin_active es una función que devuelve true cuando el plugin está activo y false cuando está inactivo.
• Dependiendo de si el plugin está activo, podés ejecutar funciones condicionales que enriquezcan tu sitio web.

¿Qué es la Función is_plugin_active en WordPress?

is_plugin_active es una utilidad incorporada para comprobar si un plugin específico está actualmente activo en tu sitio.

Esta función puede ser útil cuando estás desarrollando temas o plugins personalizados y necesitás asegurarte de que ciertos plugins estén activos antes de ejecutar un código específico. Esencialmente, te ayuda a evitar conflictos o errores verificando el estado del plugin, permitiendo que tu código se adapte de manera acorde.

is_plugin_active funciona tomando como parámetro el directorio del plugin y su archivo principal .php, comparándolos con los plugins activos en la instalación de WordPress. Si el plugin está activo, la función devuelve true; de lo contrario, devuelve false.

Esta función no funciona para plugins obligatorios, ya que no pueden activarse por medios tradicionales. Como resultado, los plugins obligatorios siempre devolverán false cuando se prueben con esta función.

¿Cómo Usar la Función is_plugin_active en WordPress?

La función is_plugin_active funciona de la siguiente manera:

is_plugin_active( string $plugin ): bool

Hay un solo argumento: la cadena de texto $plugin. $plugin es la ruta al archivo principal .php de tu plugin, relativa a la carpeta plugins.

Por ejemplo, si querés comprobar si el plugin Contact Form 7 está activo, necesitás conocer la ruta a su carpeta y el nombre de su archivo principal .php. En este caso, tu código se vería así:

is_plugin_active('contact-form-7/contact-form-7.php');

Para conocer el nombre de la carpeta del plugin y el archivo principal .php, es posible que necesites acceder a la ruta de tu sitio a través de cPanel o FTP. 

Ahora que sabemos lo que hace is_plugin_active, pasemos a un ejemplo.

Ejemplo de Uso de is_plugin_active en WordPress

Exploremos un ejemplo sencillo de cómo utilizar is_plugin_active para programar comportamiento condicional en tu sitio de WordPress.

En este caso, usaremos la función para mostrar un cuadro de texto solo si el plugin Contact Form 7 está activo. Si Contact Form 7 está activo, el cuadro de texto aparecerá y declarará que está activo. Si Contact Form 7 está inactivo, el cuadro de texto declarará que está inactivo.

Acá está el código, que deberías agregar a functions.php:

if ( ! function_exists( 'check_plugin_state' ) ) :
	function check_plugin_state () {
		/* Verifica si Contact Form 7 está activo */
		if ( is_plugin_active ( 'contact-form-7/wp-contact-form-7.php' ) ) {
			// Si está activo, muestra un cuadro de texto declarando que está activo
			echo '<p style="position: absolute;
			font-size: 25px;
			top: 180px;
			right: 100px;
			padding: 10px;
			background-color: #000000;
			color: #FFFFFF;">Contact Form 7 está activo. ¡No entres en pánico!</p>';
		} else {
			// Si está inactivo, muestra un cuadro de texto declarando que está inactivo
			echo '<p style="position: absolute;
			font-size: 25px;
			top: 180px;
			right: 100px;
			padding: 10px;
			background-color: #000000;
			color: #FFFFFF;">Contact Form 7 está inactivo.</p>';
		}
	}
endif;

add_filter( 'wp_footer', 'check_plugin_state' );

// Asegúrate de que la función is_plugin_active esté disponible
if ( ! function_exists('is_plugin_active')) {
    require_once(ABSPATH . 'wp-admin/includes/plugin.php');
}

Así es como se ve una publicación de blog cuando Contact Form 7 está activo:

Y así es como se ve cuando está inactivo:

Hemos agregado con éxito comportamiento condicional a nuestro sitio de WordPress usando is_plugin_active.

Usá is_plugin_active en Tu Sitio de WordPress

La función is_plugin_active te permite verificar si un plugin está activo. Podés usar esta función para programar comportamientos condicionales en tu sitio web, como mostrar contenido específico solo cuando un plugin determinado esté activo.

Con suerte, podés empezar a usar is_plugin_active para tener más control sobre tu sitio de WordPress en adelante.

Si encontraste útil esta publicación, leé nuestro blog y recursos para más ideas y guías.