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.

Crear un plugin tipo módulo en Moodle puede sonar complicado al principio, pero si sigues un proceso paso a paso, pronto verás que es muy manejable. En este artículo te guiaré por la creación de un plugin básico, con un ejemplo práctico y código para que puedas entenderlo fácilment

1. Crea la estructura del plugin

Lo primero que tienes que hacer es crear la carpeta de tu plugin en mod/. Vamos a llamarlo «mimodulo». La estructura básica debería verse así:

mod/
    mimodulo/
        db/
        lang/
        version.php
        lib.php
        mod_form.php
        index.php
        view.php

2. version.php: Define la versión del plugin

Este archivo es esencial, ya que define la versión de tu plugin y otras dependencias. Aquí tienes un ejemplo de cómo podría verse el archivo version.php:

<?php

defined('MOODLE_INTERNAL') || die();

$plugin->component = 'mod_mimodulo';
$plugin->version = 2023091900;
$plugin->requires = 2022041900; // Versión mínima de Moodle requerida
$plugin->maturity = MATURITY_STABLE;
$plugin->release = 'v1.0';

3. install.xml: Estructura de la base de datos

En la carpeta db/, crea el archivo install.xml para definir las tablas que necesitará tu plugin. Vamos a crear una tabla sencilla llamada mimodulo:

<?xml version="1.0" encoding="UTF-8"?>
<database>
    <TABLES>
        <TABLE NAME="mimodulo">
            <FIELDS>
                <FIELD NAME="id" TYPE="int" LENGTH="10" NOTNULL="true" SEQUENCE="true"/>
                <FIELD NAME="name" TYPE="char" LENGTH="255" NOTNULL="true"/>
                <FIELD NAME="intro" TYPE="text" NOTNULL="false"/>
                <FIELD NAME="timecreated" TYPE="int" LENGTH="10" NOTNULL="true"/>
            </FIELDS>
            <KEYS>
                <KEY NAME="primary" TYPE="primary" FIELDS="id"/>
            </KEYS>
        </TABLE>
    </TABLES>
</database>

Esta tabla almacenará los nombres de las instancias de tu módulo y una introducción básica.

4. lib.php: Funciones del módulo

El archivo lib.php contiene las funciones principales para crear, actualizar y eliminar instancias del módulo. Aquí tienes algunas de las funciones esenciales que tendrás que implementar:

<?php

defined('MOODLE_INTERNAL') || die();

// Función para añadir una instancia del módulo
function mimodulo_add_instance($mimodulo) {
    global $DB;
    $mimodulo->timecreated = time();
    return $DB->insert_record('mimodulo', $mimodulo);
}

// Función para actualizar una instancia del módulo
function mimodulo_update_instance($mimodulo) {
    global $DB;
    $mimodulo->timemodified = time();
    $mimodulo->id = $mimodulo->instance;
    return $DB->update_record('mimodulo', $mimodulo);
}

// Función para eliminar una instancia del módulo
function mimodulo_delete_instance($id) {
    global $DB;
    return $DB->delete_records('mimodulo', ['id' => $id]);
}

Estas funciones se encargarán de la gestión de las instancias de tu módulo, desde su creación hasta su eliminación.

5. mod_form.php: Formulario de configuración

El archivo mod_form.php es donde defines el formulario que se mostrará al crear o editar una instancia de tu módulo en Moodle. Aquí tienes un ejemplo básico:

<?php

defined('MOODLE_INTERNAL') || die();

require_once($CFG->dirroot.'/course/moodleform_mod.php');

class mod_mimodulo_mod_form extends moodleform_mod {
    function definition() {
        $mform = $this->_form;

        // Campo de texto para el nombre
        $mform->addElement('text', 'name', get_string('name', 'mod_mimodulo'), array('size' => '64'));
        $mform->setType('name', PARAM_TEXT);
        $mform->addRule('name', null, 'required', null, 'client');

        // Campo de texto para la introducción
        $mform->addElement('editor', 'introeditor', get_string('intro', 'mod_mimodulo'));
        $mform->setType('introeditor', PARAM_RAW);

        // Elementos estándar de Moodle
        $this->standard_coursemodule_elements();

        // Botón de acción
        $this->add_action_buttons();
    }
}

Esto generará un formulario donde el usuario puede ingresar el nombre y la introducción para la instancia del módulo.

6. index.php: Página principal del módulo

El archivo index.php será el punto de entrada principal de tu módulo. Aquí puedes mostrar una lista de todas las instancias creadas del módulo:

<?php

require_once('../../config.php');
require_login();

$PAGE->set_url('/mod/mimodulo/index.php');
$PAGE->set_title(get_string('modulename', 'mod_mimodulo'));
$PAGE->set_heading(get_string('modulename', 'mod_mimodulo'));

echo $OUTPUT->header();
echo $OUTPUT->heading('Mi Módulo');

if (!$instances = $DB->get_records('mimodulo')) {
    echo $OUTPUT->notification('No hay instancias disponibles.');
} else {
    foreach ($instances as $instance) {
        echo html_writer::div($instance->name);
    }
}

echo $OUTPUT->footer();

Este archivo muestra todas las instancias creadas del módulo en la base de datos, mostrando sus nombres en pantalla.

7. view.php: Visualización de una instancia

El archivo view.php se utiliza para mostrar una instancia específica de tu módulo. Aquí tienes un ejemplo básico:

<?php

require_once('../../config.php');
$id = required_param('id', PARAM_INT); // ID de la instancia

if (!$instance = $DB->get_record('mimodulo', ['id' => $id])) {
    print_error('Instancia no válida');
}

$PAGE->set_url('/mod/mimodulo/view.php', ['id' => $id]);
$PAGE->set_title($instance->name);
$PAGE->set_heading($instance->name);

echo $OUTPUT->header();
echo $OUTPUT->heading($instance->name);
echo format_text($instance->intro);
echo $OUTPUT->footer();

Este archivo recupera una instancia concreta del módulo y muestra su nombre e introducción.

8. Pruebas y depuración

Con todo listo, es el momento de probar tu plugin en un entorno de desarrollo. Instálalo en tu Moodle local, crea una instancia en un curso y asegúrate de que todo funciona correctamente. Recuerda que los errores suelen surgir al principio, pero con la práctica, este proceso será cada vez más fluido.

Este ejemplo básico te proporciona los pasos iniciales para crear un módulo funcional en Moodle. Desde aquí, puedes ir añadiendo más funcionalidades y complejidad según tus necesidades. ¡Espero que esta guía te sea útil y te anime a seguir explorando el desarrollo en Moodle!