Cómo Crear un Plugin Básico en WordPress

Introducción

WordPress es una de las plataformas de gestión de contenido más populares del mundo, en gran parte debido a su extensibilidad a través de plugins. Los plugins permiten agregar funcionalidades personalizadas a un sitio de WordPress sin modificar el código base. En este artículo, aprenderás cómo crear un plugin básico en WordPress.

Requisitos Previos

Antes de comenzar, asegúrate de tener lo siguiente:

• Un sitio de WordPress instalado y en funcionamiento.
• Acceso a los archivos de WordPress (a través de FTP o un gestor de archivos).
• Conocimientos básicos de PHP y del sistema de archivos de WordPress.

Paso 1: Configurar el Entorno

Crear la Carpeta del Plugin

1. Accede a la carpeta de plugins de WordPress:

   /wp-content/plugins/

2. Crea una nueva carpeta para tu plugin. Por ejemplo:

   /wp-content/plugins/mi-plugin-basico/

Crear el Archivo Principal del Plugin

Dentro de la carpeta del plugin, crea un archivo PHP. Este será el archivo principal de tu plugin. Por ejemplo:

/wp-content/plugins/mi-plugin-basico/mi-plugin-basico.php

Paso 2: Estructura Básica del Plugin

Abre el archivo mi-plugin-basico.php en tu editor de texto favorito y añade la siguiente cabecera. Esta cabecera proporciona información sobre tu plugin a WordPress.

<?php
/*
Plugin Name: Mi Plugin Básico
Plugin URI: http://tusitio.com/
Description: Un plugin básico de ejemplo para WordPress.
Version: 1.0
Author: Tu Nombre
Author URI: http://tusitio.com/
License: GPL2
*/

Paso 3: Añadir Funcionalidad Básica

Añadir un Shortcode

Como primer paso, vamos a añadir un shortcode que mostrará un mensaje simple en una página o entrada de WordPress.

1. Dentro del archivo mi-plugin-basico.php, añade la siguiente función para registrar el shortcode:

function mpb_mostrar_mensaje() {
    return "¡Hola, este es mi primer plugin!";
}

add_shortcode('mi_mensaje', 'mpb_mostrar_mensaje');

Este código define una función mpb_mostrar_mensaje que devuelve un mensaje. Luego, se registra esta función como un shortcode llamado mi_mensaje.

Activar el Plugin

1. Ve al panel de administración de WordPress.
2. Navega a Plugins > Plugins Instalados.
3. Activa «Mi Plugin Básico».

Usar el Shortcode

1. Edita una página o entrada en WordPress.
2. Añade el shortcode [mi_mensaje].
3. Guarda y visualiza la página. Deberías ver el mensaje «¡Hola, este es mi primer plugin!».

Paso 4: Añadir una Página de Configuración

Añadir una página de configuración a tu plugin permite a los usuarios personalizar su comportamiento desde el panel de administración de WordPress.

1. Dentro de mi-plugin-basico.php, añade el siguiente código para crear un menú en el panel de administración:

function mpb_agregar_menu() {
    add_menu_page(
        'Configuración del Plugin Básico',  // Título de la página
        'Mi Plugin Básico',                 // Título del menú
        'manage_options',                   // Capacidad requerida
        'mi-plugin-basico',                 // Slug de la página
        'mpb_pagina_configuracion',         // Función de contenido
        'dashicons-admin-generic',          // Icono del menú
        20                                  // Posición del menú
    );
}

add_action('admin_menu', 'mpb_agregar_menu');

function mpb_pagina_configuracion() {
    ?>
    <div class="wrap">
        <h1>Configuración del Plugin Básico</h1>
        <form method="post" action="options.php">
            <?php
                settings_fields('mpb_opciones_grupo');
                do_settings_sections('mi-plugin-basico');
                submit_button();
            ?>
        </form>
    </div>
    <?php
}

2. Añade funciones para registrar configuraciones y campos de la página de configuración:

function mpb_configuracion_inicial() {
    register_setting('mpb_opciones_grupo', 'mpb_opcion_texto');

    add_settings_section(
        'mpb_seccion_principal',            // ID de la sección
        'Ajustes Principales',              // Título de la sección
        'mpb_seccion_principal_cb',         // Callback de la sección
        'mi-plugin-basico'                  // Página del plugin
    );

    add_settings_field(
        'mpb_opcion_texto',                 // ID del campo
        'Texto de Ejemplo',                 // Título del campo
        'mpb_campo_texto_cb',               // Callback del campo
        'mi-plugin-basico',                 // Página del plugin
        'mpb_seccion_principal'             // Sección del campo
    );
}

add_action('admin_init', 'mpb_configuracion_inicial');

function mpb_seccion_principal_cb() {
    echo '<p>Ajustes principales de Mi Plugin Básico.</p>';
}

function mpb_campo_texto_cb() {
    $valor = get_option('mpb_opcion_texto', '');
    echo '<input type="text" name="mpb_opcion_texto" value="' . esc_attr($valor) . '" />';
}

Guardar y Verificar la Configuración

1. Ve al menú Mi Plugin Básico en el panel de administración.
2. Introduce un valor en el campo de texto y guarda los cambios.
3. Puedes utilizar get_option('mpb_opcion_texto') para obtener este valor en cualquier parte de tu plugin.

Conclusión

Crear un plugin básico en WordPress implica varios pasos, desde la creación de la estructura de archivos hasta la implementación de funcionalidad y una página de configuración en el panel de administración. Este artículo te proporciona una guía inicial para desarrollar tus propios plugins y extender las capacidades de tu sitio de WordPress. Con práctica y exploración adicional, podrás crear plugins más complejos y útiles.