Fundamentos para crear un plugin de WordPress

Crear un plugin en WordPress es uno de los pasos más emocionantes para cualquier desarrollador que desee personalizar un sitio web o aportar nuevas funcionalidades. Si bien el desarrollo de un plugin puede parecer complejo al principio, empezar con un ejemplo sencillo es una excelente manera de aprender los fundamentos y familiarizarse con la estructura básica de un plugin. En este post, te mostraré cómo crear un plugin simple en WordPress, utilizando un enfoque de programación estructurada.

¿Qué es un Plugin de WordPress y por qué es importante?

Un plugin es esencialmente un fragmento de código que extiende la funcionalidad de un sitio WordPress sin modificar el núcleo del sistema. Este tutorial está diseñado para guiarte en la creación de un plugin funcional desde cero, utilizando un enfoque de programación estructurada.

Crear un Plugin Básico desde Cero

Para empezar, vamos a crear un plugin muy simple llamado "Mi Primer Plugin". A través de este ejercicio, aprenderás cómo estructurar un archivo de plugin básico y cómo utilizar funciones esenciales en WordPress.

Estructura del Archivo del Plugin

El primer paso para crear un plugin en WordPress es crear un archivo PHP dentro de la carpeta /wp-content/plugins/. Este archivo contendrá tanto los comentarios de encabezado, que son cruciales para que WordPress reconozca el plugin (pa' que funcione pues..), como las funciones que definirán su funcionalidad.

Pasos:

1. Navega a la carpeta /wp-content/plugins/ en tu instalación de WordPress.
2. Crea una nueva carpeta llamada mi-primer-plugin.
3. Dentro de esa carpeta, crea un archivo PHP llamado mi-primer-plugin.php.

Este archivo debe comenzar con un bloque de comentarios de encabezado que le diga a WordPress que este es un plugin. Aquí tienes un ejemplo básico del contenido que debes incluir:

<?php
/*
Plugin Name: Mi Primer Plugin
Description: Un plugin simple que imprime un mensaje.
Version: 1.0
Author: Tu Nombre
*/
?>

¿Qué es el Encabezado del Plugin?

El encabezado del plugin es una parte vital del archivo, ya que le permite a WordPress mostrar la información de tu plugin en el panel de administración. Esta información incluye el nombre del plugin, una breve descripción, la versión actual y el nombre del autor. Con esto, WordPress reconocerá tu plugin en la lista de plugins instalados, permitiéndote activarlo o desactivarlo según sea necesario.

Estructura Básica de un Plugin

Todo plugin en WordPress debe seguir una estructura básica, lo que implica tener al menos un archivo principal que contenga las funciones que realizarán la lógica del plugin. También es crucial implementar una medida de seguridad básica que prevenga el acceso directo al archivo del plugin.

Seguridad: Evitar el Acceso Directo

Para evitar que alguien acceda directamente a tu archivo PHP, es una buena práctica incluir una verificación con ABSPATH. Esto asegura que el archivo solo se ejecutará dentro del entorno de WordPress. Aquí tienes cómo hacerlo:

<?php
/*
Plugin Name: Mi Primer Plugin
Description: Un plugin simple que imprime un mensaje.
Version: 1.0
Author: Tu Nombre
*/

// Evitar acceso directo
if (!defined('ABSPATH')) {
    exit;
}

Esta simple línea de código comprueba si WordPress está corriendo el archivo. Si no lo está, detiene la ejecución, lo que previene accesos no autorizados.

Crear un Plugin que Imprima un Mensaje Sencillo

Ahora que hemos establecido la estructura básica y la seguridad, es hora de agregar funcionalidad a nuestro plugin. En este caso, vamos a crear una función simple que imprima un mensaje en el pie de página del frontend del sitio.

Función para Imprimir un Mensaje

Para imprimir un mensaje en el frontend, utilizaremos una función personalizada y la conectaremos con uno de los hooks de WordPress, específicamente el wp_footer.

<?php
/*
Plugin Name: Mi Primer Plugin
Description: Un plugin simple que imprime un mensaje.
Version: 1.0
Author: Tu Nombre
*/

// Evitar acceso directo
if (!defined('ABSPATH')) {
    exit;
}

// Función para imprimir un mensaje en el pie de página
function mi_primer_plugin_mensaje() {
    echo '<p style="text-align: center; color: blue;">¡Hola, este es mi primer plugin de WordPress!</p>';
}

// Hook para añadir la función al pie de página
add_action('wp_footer', 'mi_primer_plugin_mensaje');

Explicación del Código:

1. La función mi_primer_plugin_mensaje es la encargada de generar el HTML que se imprimirá en el frontend del sitio. En este caso, estamos creando un párrafo centrado con un mensaje y color de texto azul.
2. add_action('wp_footer', 'mi_primer_plugin_mensaje') es un hook que le dice a WordPress que ejecute la función mi_primer_plugin_mensaje justo antes de cerrar la etiqueta </body> del sitio.

Verificar el Resultado en el Frontend

Después de añadir esta función, el siguiente paso es activar el plugin en el panel de administración de WordPress y verificar que el mensaje se muestre correctamente en el pie de página del sitio.

Una vez activado, visita el frontend de tu sitio y desplázate hasta el pie de página. Deberías ver el mensaje: "¡Hola, este es mi primer plugin de WordPress!".

Video