Guía Práctica: Cómo Crear un Plugin Básico en WordPress

Si te has preguntado cómo crear tu propio plugin de WordPress, estás en el lugar adecuado. En este artículo te explicaré, paso a paso y con un ejemplo práctico, cómo crear un plugin básico desde cero. ¡Vamos allá!

1. ¿Qué es un Plugin de WordPress?

Antes de entrar en materia, es importante entender qué es un plugin. En términos simples, un plugin es un pequeño programa que extiende la funcionalidad de WordPress. Puedes usar plugins para añadir nuevas características o modificar las existentes sin tener que cambiar el código principal de WordPress.

2. Crea la Estructura del Plugin

Lo primero que necesitas es crear una carpeta para tu plugin dentro del directorio wp-content/plugins. El nombre de esta carpeta será el nombre de tu plugin. Por ejemplo, vamos a crear un plugin llamado «MiPlugin». La estructura sería algo así:

wp-content/
    plugins/
        mipugin/
            mipugin.php

3. El Archivo Principal del Plugin

El archivo mipugin.php es el núcleo de tu plugin. Este archivo contendrá la información básica y las funciones que ejecutará. Aquí tienes el código base que necesitas para que WordPress reconozca tu plugin:

<?php
/*
Plugin Name: Mi Plugin
Plugin URI: https://www.programador-web.com
Description: Un plugin básico de ejemplo para WordPress.
Version: 1.0
Author: Jordi Morillo Sells
Author URI: https://www.programador-web.com
License: GPL2
*/

defined('ABSPATH') or die('No puedes acceder directamente a este archivo.');

// Función para mostrar un mensaje en el pie de página
function mipugin_mensaje_pie() {
    echo '<p style="text-align:center;">Gracias por visitar mi sitio web.</p>';
}

// Hook para ejecutar la función en el pie de página
add_action('wp_footer', 'mipugin_mensaje_pie');

Este código básico hace lo siguiente:

• Declara la información del plugin (nombre, versión, autor, etc.).
• Usa una función para mostrar un mensaje en el pie de página de todas las páginas del sitio.
• Implementa un «hook» que activa esa función cuando se ejecuta la acción wp_footer.

4. Instala y Activa el Plugin

Una vez creado el archivo mipugin.php, ve a tu panel de administración de WordPress, navega hasta la sección «Plugins» y verás tu nuevo plugin en la lista. Haz clic en «Activar» y ¡listo! El plugin ya estará funcionando.

5. Añadir Funcionalidad Extra

Ahora que tienes un plugin básico funcionando, puedes añadir más funcionalidades. Por ejemplo, vamos a mejorar el plugin para que permita mostrar un mensaje personalizado desde el panel de administración.

a. Crea un Campo de Configuración

Para esto, necesitas añadir una página de configuración en el panel de administración de WordPress:

// Añadir una página de opciones al menú de administración
function mipugin_crear_menu() {
    add_options_page(
        'Mi Plugin Opciones',
        'Mi Plugin',
        'manage_options',
        'mipugin-config',
        'mipugin_opciones_pagina'
    );
}
add_action('admin_menu', 'mipugin_crear_menu');

// Contenido de la página de configuración
function mipugin_opciones_pagina() {
    ?>
    <div class="wrap">
        <h1>Configuración de Mi Plugin</h1>
        <form method="post" action="options.php">
            <?php
            settings_fields('mipugin_opciones');
            do_settings_sections('mipugin-config');
            submit_button();
            ?>
        </form>
    </div>
    <?php
}

// Registrar una opción en la base de datos
function mipugin_configuraciones() {
    register_setting('mipugin_opciones', 'mipugin_mensaje');
    add_settings_section('mipugin_seccion', 'Configuraciones', null, 'mipugin-config');
    add_settings_field('mipugin_mensaje', 'Mensaje del pie de página', 'mipugin_mensaje_callback', 'mipugin-config', 'mipugin_seccion');
}
add_action('admin_init', 'mipugin_configuraciones');

// Callback para el campo de texto
function mipugin_mensaje_callback() {
    $mensaje = get_option('mipugin_mensaje', 'Gracias por visitar mi sitio web.');
    echo "<input type='text' name='mipugin_mensaje' value='$mensaje' />";
}

Este código añade una nueva página de configuración en el panel de administración de WordPress, donde el usuario puede escribir un mensaje personalizado.

b. Modificar la Función para Usar el Mensaje Personalizado

Ahora necesitamos actualizar la función que muestra el mensaje en el pie de página para que use el mensaje personalizado:

function mipugin_mensaje_pie() {
    $mensaje = get_option('mipugin_mensaje', 'Gracias por visitar mi sitio web.');
    echo '<p style="text-align:center;">' . esc_html($mensaje) . '</p>';
}

Con esto, el mensaje que se muestra en el pie de página puede ser personalizado desde la página de configuración del plugin.

6. Pruebas y Depuración

Con todo listo, es hora de probar tu plugin. Abre una página de tu sitio web y desplázate hasta el pie. Deberías ver el mensaje que ingresaste en la configuración del plugin. Si no ves el mensaje o tienes algún problema, revisa el código y los errores en el registro de depuración de WordPress.

7. Publica tu Plugin

Una vez que tu plugin esté funcionando perfectamente, puedes publicarlo en el repositorio de WordPress o simplemente instalarlo en otros sitios manualmente. Si quieres compartirlo con la comunidad, asegúrate de seguir las directrices de desarrollo de plugins de WordPress.