Curso de Moodle para Desarrolladores para equipos técnicos en empresas

Requisitos PHP 8.2+, MySQL 8.4+ o PostgreSQL 14+

Preparar entorno local con Docker o XAMPP

Activar modo desarrollador

Configurar `config.php` para desarrollo

Activar debugging avanzado

Limpiar caché de desarrollo

Uso de CLI de Moodle (`admin/cli/`)

Usar VS Code con PHP Intelephense

Práctica: entorno local con Docker y debugging habilitado

BONUS: entorno de staging con Git + CI

Tipos de plugins en Moodle: mod, block, local, theme, auth…

Dónde se ubica cada uno

Plugins recomendados como referencia

Estructura mínima de un plugin

Archivos obligatorios y convenciones

Hooks disponibles en cada tipo

Plugins en el repositorio oficial

Práctica: revisión de plugin instalado desde GitHub

BONUS: catálogo visual de tipos de plugin

Crear carpeta `local_customplugin`

Crear archivo `version.php`

Crear `db/access.php` y `db/install.xml`

Crear páginas internas (`index.php`, `settings.php`)

Usar parámetros `get_config()` y `set_config()`

Añadir lógica backend en `lib.php`

Crear enlaces en el menú de admin

Práctica: plugin que muestra config editable en admin

BONUS: botón de ejecución con lógica propia

¿Qué es un bloque (`block_`) y para qué se usa?

Crear bloque básico con clase extendida de `block_base`

Método `get_content()`

Controlar visibilidad por rol o curso

Configuración del bloque

Usar JS, CSS y templates

Cargar datos de la base de datos

Práctica: bloque con información del usuario activo

BONUS: mostrar contenido condicional por grupo

¿Qué es un theme en Moodle?

Crear carpeta `theme_customtheme`

Heredar de Boost (base Mustache + Bootstrap)

Estructura de templates y layouts

Personalizar CSS y JS

Añadir `settings.php` para ajustes del tema

Sobrescribir `core_renderer`

Práctica: tema con logotipo, colores y pie personalizado

BONUS: personalización por rol de usuario

¿Qué es Mustache y por qué se usa?

Sintaxis de Mustache

Crear archivos `.mustache` y asociarlos a renderers

Usar `render_from_template()`

Pasar datos desde PHP al template

Incluir JS y CSS condicionalmente

Práctica: crear plantilla con condicionales y bucles

BONUS: mostrar datos dinámicos con JS inyectado

API de base de datos: `$DB`

Métodos principales: `get_record`, `insert_record`, `update_record`

Acceso seguro con parámetros

Crear tablas con `install.xml` (XMLDB)

Foreign keys, índices y relaciones

Actualizaciones de estructura con `upgrade.php`

Práctica: insertar datos y leerlos desde un bloque

BONUS: plugin con tabla personalizada + admin view

Uso de `moodleform` para crear formularios

Métodos: `definition()`, `validation()`

Campos comunes: text, textarea, select, file

Validación personalizada

Guardado de datos

Recoger datos desde plugin local

Subida de archivos y `file_save_draft_area_files`

Práctica: formulario con validación + guardado en tabla

BONUS: reutilizar formularios en varios contextos

Crear archivo `access.php`

Definir `capabilities` y `contextlevel`

Asignar permisos por rol

Comprobar permisos con `has_capability()`

Crear páginas con acceso restringido

Práctica: crear plugin visible solo a administradores

BONUS: menú lateral solo visible con permiso

Crear rutas propias con `index.php`, `edit.php`, etc.

Añadir navegación en `settings.php`

Añadir páginas al menú de administración

Crear enlaces condicionales

Parámetros URL y seguridad con `require_sesskey()`

Práctica: flujo de 3 páginas con control de navegación

BONUS: botón “Acción rápida” en bloques

Crear tareas automáticas para cron

`db/tasks.php`

Crear archivo `classes/task/`

Métodos `execute()` y registro de logs

Frecuencia y planificación

Ver tareas pendientes desde panel

Práctica: tarea que actualiza datos semanalmente

BONUS: envío de email automático con resumen

Sistema de eventos en Moodle

Crear `db/events.php`

Escuchar eventos: login, curso completado, envío de tarea

Crear listeners (observadores)

Registrar en logs personalizados

Práctica: observador que registra el login diario

BONUS: evento que lanza un proceso de análisis

Activar web services

Crear tokens

Métodos estándar vs personalizados

Crear funciones externas (`external_function_parameters`)

Control de permisos y seguridad

Conexión desde apps externas

Práctica: exponer datos de usuarios vía JSON

BONUS: prueba desde Postman con autenticación por token

Llamadas AJAX desde JS

Crear `externallib.php`

Seguridad con sesskey y token

Control de acceso por contexto

Práctica: botón en bloque que lanza AJAX

BONUS: loading spinner y mensajes personalizados

Archivos `lang/en/pluginname.php`

Usar `get_string()`

Variables dinámicas en cadenas

Traducir elementos del frontend

Cadenas por idioma + fallback

Práctica: plugin multilingüe

BONUS: personalizar texto visible desde admin

Tipos: Unit tests, Behat, PHPUnit

Crear tests para funciones propias

Estructura de tests en `tests/`

Crear fixtures y datos falsos

Ejecutar tests desde CLI

Práctica: test para función PHP propia

BONUS: integración con GitHub Actions

Evitar SQL innecesarias

Uso correcto de caché

Reducción de carga con `get_fast_modinfo()`

Lazy loading de datos

Minimizar JS/CSS con AMD

Práctica: refactorización de bloque lento

BONUS: uso de cron optimizado para grandes volúmenes

Cumplir estándares de codificación de Moodle

Usar `MOODLE_INTERNAL`

Comentarios PHPDoc

Separación lógica y visual

Seguridad: input/output, sesskey, capabilities

Control de versiones en `version.php`

Práctica: revisión y validación de plugin antes de publicar

BONUS: checklist para pasar revisión en moodle.org

Crear plugin `local_reports` desde cero

Tabla en BD para guardar registros

Página de configuración en admin

Bloque que muestra estadísticas al usuario

Tarea cron que actualiza datos

Evento al finalizar curso

Formulario de feedback

Exportación a Excel o CSV

Documentación técnica del plugin

BONUS: preparación para su publicación oficial