Este tutorial te guiará a través de los pasos básicos para crear tu primer plugin funcional para WordPress.
Requisitos Previos
Antes de empezar, asegúrate de tener lo siguiente:
- Una instalación local o remota de WordPress (como XAMPP, MAMP o un entorno de desarrollo).
- Acceso a los archivos de tu instalación de WordPress.
- Conocimientos básicos de PHP, HTML y CSS.
- Un editor de código (como VS Code, Sublime Text, o Atom).
1. Estructura Básica del Plugin
Todos los plugins de WordPress residen en la carpeta wp-content/plugins/ de tu instalación.
1.1 Crear la Carpeta del Plugin
Navega a wp-content/plugins/ y crea una nueva carpeta para tu plugin. El nombre de la carpeta debe ser único y descriptivo, usando solo letras minúsculas y guiones.
Por ejemplo: mi-plugin-personalizado
1.2 Crear el Archivo Principal del Plugin
Dentro de la nueva carpeta (mi-plugin-personalizado), crea un archivo PHP que tendrá el mismo nombre que la carpeta. Este archivo contendrá los metadatos necesarios y el código principal de tu plugin.
Por ejemplo: mi-plugin-personalizado.php
2. Definición de los Metadatos del Plugin
El archivo PHP principal (mi-plugin-personalizado.php) debe comenzar con un bloque de comentarios que WordPress utiliza para identificar tu plugin.
Añade el siguiente código a tu archivo mi-plugin-personalizado.php:<?php
/**
* Plugin Name: Mi Primer Plugin Personalizado
* Plugin URI: <span type=»placeholder» placeholder-type=»location»></span>
* Description: Este es un plugin de ejemplo para demostrar cómo crear uno.
* Version: 1.0.0
* Author: <span type=»placeholder» placeholder-type=»person»></span>
* Author URI: <span type=»placeholder» placeholder-type=»location»></span>
* License: GPL2
*/
// Evitar acceso directo al archivo
if ( ! defined( ‘ABSPATH’ ) ) {
exit;
}
// Aquí comenzará el código de tu plugin
Explicación de las Etiquetas:
| Etiqueta | Propósito |
|---|---|
| Plugin Name | Nombre visible en el área de administración de WordPress. |
| Description | Breve descripción de lo que hace el plugin. |
| Version | Número de versión actual del plugin. |
| Author | Tu nombre o el nombre de tu empresa. |
| Plugin URI, Author URI | Enlaces a la página del plugin y a la página del autor, respectivamente. |
3. Activación del Plugin y Pruebas
- Guarda el archivo mi-plugin-personalizado.php.
- Ve al área de administración de WordPress (/wp-admin).
- Haz clic en Plugins > Plugins instalados.
- Busca «Mi Primer Plugin Personalizado» en la lista.
- Haz clic en el enlace Activar.
Si no hay errores, ¡tu plugin está activo!
4. Agregando Funcionalidad (Ejemplo Práctico)
Vamos a crear una función sencilla que agregue texto al final de cada publicación usando los Hooks de WordPress. Los Hooks son la forma en que tu plugin interactúa con el núcleo de WordPress.
4.1 Uso del Filtro the_content
Añade el siguiente código a tu archivo mi-plugin-personalizado.php, debajo del bloque de metadatos:function agregar_contenido_al_final( $content ) {
// Solo agregar si estamos en una vista de publicación individual
if ( is_single() ) {
$contenido_extra = ‘<p><strong>¡Este texto fue agregado por Mi Primer Plugin!</strong></p>’;
$content .= $contenido_extra;
}
return $content;
}
// Enganchar nuestra función al filtro ‘the_content’
add_filter( ‘the_content’, ‘agregar_contenido_al_final’ );
4.2 Explicación de las Funciones
- agregar_contenido_al_final(): Esta es la función que ejecuta la lógica. Recibe el contenido de la publicación ($content) y le añade una cadena de texto adicional.
- add_filter(): Esta función de WordPress toma dos argumentos principales:
- the_content: El nombre del Hook de filtro que queremos modificar. Este filtro se ejecuta justo antes de que el contenido de una publicación se muestre en la página.
- agregar_contenido_al_final: El nombre de nuestra función de devolución de llamada.
5. Próximos Pasos
Para seguir desarrollando tu plugin, considera los siguientes temas avanzados:
- Crear un Menú de Administración: Utiliza la acción admin_menu para agregar una página de configuración.
- Archivos de Estilos y Scripts: Usa las acciones wp_enqueue_scripts (para el frontend) o admin_enqueue_scripts (para el backend) para cargar CSS y JavaScript.
- Funciones de Activación y Desactivación: Define funciones para ejecutar código solo al activar o desactivar el plugin. Por ejemplo, puedes crear una tabla de base de datos al activar y limpiarla al desactivar.
Consulta la Referencia del Desarrollador de WordPress para obtener más información detallada. Puedes encontrar la documentación completa en el siguiente archivo: File.