Guía Interactiva de Configuración de Moodle

Hardware:

Las especificaciones varían según la escala. Mínimo 200MB de espacio en disco para el código base, más espacio para contenido (realista: 5GB+). Procesador mínimo 1 GHz (recomendado: dual core 2 GHz+). RAM mínima 512MB (recomendado: 1GB+, producción grande: 8GB+). Para instalaciones grandes, considerar servidores separados para web y base de datos.

Escalabilidad: Planificar para crecimiento futuro, escalando horizontal (más servidores) y verticalmente (más RAM, CPU, SSDs).

Software:

Principalmente Linux (pila LAMP: Linux, Apache, PostgreSQL/MySQL/MariaDB, PHP). Compatible con Windows, Mac OS X, Netware 6. Servidor web recomendado: Apache. Otros: Nginx, OpenLiteSpeed, IIS. Base de datos recomendada: MySQL, MariaDB, PostgreSQL (NO SQL Server 2005 u Oracle). Versión de PHP compatible con la versión de Moodle (ej. Moodle 5.0 requiere PHP 8.2-8.4).

Configuraciones PHP importantes (php.ini): memory_limit (mín. 96M, rec. 128M+), session.save_handler (FILES), file_uploads (ON), session.auto_start (OFF), carpeta temp escribible. post_max_size y upload_max_filesize son críticos para el tamaño de subida.

Consideración clave: Priorizar estabilidad y compatibilidad probada sobre familiaridad personal.

Base de Datos:

Información requerida: dbhost (ej. `localhost`), dbname (ej. `moodle`), dbuser (ej. `moodleuser`, no root), dbpass.

Configuración UTF-8: Esencial. Recomendado: utf8mb4 y utf8mb4_unicode_ci para MySQL/MariaDB *antes* de la instalación. Editar my.cnf o my.ini. Hacer copia de seguridad antes.

Comando SQL con soporte UTF-8 completo:

CREATE DATABASE moodle DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

Sin soporte completo (alternativa):

CREATE DATABASE moodle DEFAULT CHARACTER SET utf8 COLLATE utf8_unicode_ci;

Crear usuario de base de datos (evitar GRANT ALL):

CREATE USER 'moodleuser'@'localhost' IDENTIFIED BY 'yourpassword';
GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,CREATE TEMPORARY TABLES,DROP,INDEX,ALTER ON moodle.* TO 'moodleuser'@'localhost';

Consideración clave: Una configuración UTF-8 incorrecta al inicio puede causar problemas de codificación difíciles de solucionar después.

Directorio de Datos (moodledata):

Almacena archivos subidos, datos temporales, caché, sesiones. No debe ser accesible directamente vía web. El servidor web necesita permisos de escritura en él.

Consideración clave: La separación y seguridad de `moodledata` (fuera del raíz web, no accesible por URL pero escribible por el servidor) es una medida de seguridad fundamental.

Descarga: Desde download.moodle.org (versión estándar recomendada).

Copia y Descompresión: Crea carpeta "moodle". Ubicar en directorio de documentos del servidor (ej. yourwebserver.com/moodle) o copiar contenido a raíz (yourwebserver.com).

Configuración de `config.php`: No incluido en descarga, se crea durante instalación (web o CLI). Alternativa: copiar config-dist.php a config.php y editar. $CFG->wwwroot debe ser URL fija.

Ejecución del Instalador:

• Web: Acceder a URL de Moodle (ej. www.yourdomain.com/moodle). Sigue asistente (idioma, rutas, BD, cuenta admin).
• CLI: /usr/bin/php /path/to/moodle/admin/cli/install.php. Útil para automatización, no se ejecuta si config.php existe.

Consideración clave: La CLI es preferible para administradores experimentados y despliegues a gran escala.

Directorio de código Moodle (`moodle/`): Archivos no escribibles por el usuario del servidor web. Propietario: `root`. Grupo: `root` o grupo del servidor web.

• Directorios: `755` (rwx r-x r-x)
• Archivos: `644` (rw- r-- r--)

Directorio de datos (`moodledata/`): Servidor web necesita permisos de escritura. Debe estar fuera del raíz web y no accesible por URL. Propietario: usuario del servidor web (ej. `www-data`). Grupo: grupo del servidor web.

• Directorios: `700` (rwx --- ---)
• Archivos: `600` (rw- --- ---)

(Verificar documentación para casos de hosting compartido).

Consideración clave: Permisos incorrectos son una causa común de sitios hackeados. Auditoría regular es importante.

Tabla: Permisos de Archivos Recomendados (Unix/Linux)

Gestionar en Administración del sitio > General > Ajustes de portada.

• Nombre completo y corto del sitio: Identidad principal y abreviada.
• Contenido de la página principal: Noticias, listas de cursos, categorías. Diferente para usuarios logueados/no logueados.
• Forzar inicio de sesión: Si la página principal no debe mostrar contenido general (Administración del sitio > General > Seguridad > Ajustes de seguridad del sitio).

Consideración clave: La página principal es la primera impresión; su configuración afecta la usabilidad.

• Instalación de paquetes de idioma: Administración del sitio > Idioma > Paquetes de idioma.
• Idioma predeterminado del sitio: Administración del sitio > Idioma > Ajustes de idioma. No afecta a usuarios existentes.
• Autodetectar idioma: Por defecto, basado en navegador. Puede deshabilitarse.
• Gestión de visualización: Ocultar menú de idioma, limitar idiomas disponibles (lista de códigos, ej. en_us,es_mx).
• Locale del sitio: Anula formato de fechas. Recomendado dejar en blanco (usa locale del servidor).
• Fuentes PDF: Habilitar para idiomas como chino, japonés, etc. ($CFG->pdfexportfont en config.php).
• Mensajes de error localizados (BD): Añadir $CFG->lang="yourlangcode"; a config.php.
• Personalización de cadenas de idioma: Administración del sitio > Idioma > Personalización de idioma (ej. "Course" a "Unit"). Activar modo depuración para identificar cadenas. Guardadas en moodledata/lang/xx_local/, no se sobrescriben en actualizaciones.

Consideración clave: Una gestión de idioma deficiente puede generar inconsistencias y mala experiencia de usuario.

• Nivel de sitio: Administración del sitio > Ubicación > Ajustes de ubicación (zona horaria y país predeterminados). Ejecutar actualización de zonas horarias.
• Servidor: Zona horaria local del servidor correcta en php.ini.
• Usuario: Puede ajustar su zona horaria en Preferencias > Editar perfil > Zona horaria.

Consideración clave: Esencial para precisión de eventos, entregas y registros. Configuración incorrecta causa confusión.

• Servidor SMTP y autenticación: Administración del sitio > Servidor > Correo electrónico > Configuración de correo saliente.
• Dirección "no responder": En la misma página, para comunicaciones automáticas.
• Contacto de soporte: Administración del sitio > Servidor > Servidor > Contacto de soporte.

Consideración clave: Fiabilidad del correo es vital para notificaciones, restablecimiento de contraseñas y otras funciones clave.

Configurar en Administración del sitio > Plugins > Autenticación > Gestionar autenticación.

Tabla: Métodos de Autenticación Estándar en Moodle

Configuraciones Comunes:

• Permitir inicio de sesión por correo electrónico: Usar email o nombre de usuario.
• Botón de inicio de sesión de invitado: Ocultar/mostrar. Ocultarlo deshabilita acceso de invitado al sitio.
• Limitar inicios de sesión concurrentes: Especifica cuántos. No compatible con SSO.
• URL de inicio de sesión alternativa: Usar con precaución, riesgo de bloqueo.

Consideración clave: Seleccionar métodos alineados con políticas de seguridad y infraestructura. Implementación de SSO requiere configuración precisa.

Configurar en Administración del sitio > Usuarios > Permisos > Definir roles.

Capacidad: Aspecto configurable del comportamiento (ej. mod/forum:rate). Cientos de capacidades.

Permiso: "Permitir", "Prevenir", "Prohibir", "No establecido/Heredar".

Roles estándar: Administrador, Creador de cursos, Profesor (con/sin edición), Estudiante, Invitado, Usuario autenticado.

Gestión de Roles:

• Edición: Modificar permisos de un rol.
• Restablecimiento: Revertir a permisos predeterminados (elimina permisos a nivel curso/actividad).
• Localización del Nombre: Cadenas de idioma o sintaxis multilingüe para roles personalizados.

Creación de Roles Personalizados:

1. Clic en "Agregar un nuevo rol".
2. Usar plantilla o preset opcional.
3. Nombre corto (obligatorio), nombre completo, descripción.
4. Arquetipo de rol (Manager, Teacher, Student) - define predeterminados en actualizaciones/restablecimientos.
5. Contextos de asignación (ej. 'Usuario' para rol de Padre).
6. Configurar permisos y guardar.

Nuevo rol no listado en descripciones de curso automáticamente (configurar en Administración del sitio > Apariencia > Cursos > Contactos del curso).

Asignación, Anulación y Cambios de Rol:

• Permitir asignaciones de roles: Qué roles pueden asignar otros roles.
• Permitir anulaciones de roles (Overrides): Qué roles pueden anular otros (requiere capacidades moodle/role:override o moodle/role:safeoverride).
• Permitir cambios de rol (Switches): Cambiar temporalmente a otro rol (requiere capacidad moodle/role:switchroles).

Consideración clave: La granularidad es poderosa pero compleja. Una mala gestión puede llevar a brechas de seguridad o problemas de usabilidad.

Configurar en Administración del sitio > Usuarios > Permisos > Políticas de usuario.

• Rol para visitantes (no logueados): Por defecto "Invitado". Aún necesitan iniciar sesión para participar.
• Rol para invitado: Asignado a usuario invitado y temporalmente a usuarios no matriculados en cursos con acceso de invitado.
• Rol predeterminado para todos los usuarios: Recomendado "Usuario autenticado". No "estudiante".
• Rol del creador en nuevos cursos: Rol con el que se matricula al creador del curso.
• Auto-inicio de sesión de invitado: Loguea automáticamente a visitantes en cursos con acceso de invitado.
• Ocultar campos de usuario: Para privacidad (descripción, email, ciudad, etc.) en perfiles y lista de participantes.
• Mostrar identidad de usuario: Mostrar campos (ID, email, teléfono) a usuarios con capacidad moodle/site:viewuseridentity (profesores, gestores) para diferenciar usuarios.
• Habilitar Gravatar: Usar Gravatar como foto de perfil si no hay imagen personalizada.

Consideración clave: Esencial para privacidad (GDPR), confianza del usuario y equilibrio con usabilidad.

Organizan cursos lógicamente. En sitio nuevo, categoría predeterminada "Categoría 1".

• Agregar categoría: Administración del sitio > Cursos > Crear nueva categoría o desde Gestionar cursos y categorías.
• Editar/Mover: Desde Gestionar cursos y categorías, usar icono de acciones o flechas/menú para mover.
• Subcategorías: Crear desde icono de acciones de categoría principal.
• Ocultar/Mostrar: Con icono "ojo". Categorías ocultas visibles solo para admin o con capacidad "ver cursos ocultos".
• Ordenar: Por nombre o ID.

Consideración clave: Una buena estructura de categorías es crucial para la navegación y eficiencia, especialmente en sitios grandes.

Requiere derechos de Admin, Creador de Cursos o Gestor.

1. Administración del sitio > Cursos > Gestionar cursos y categorías.
2. Seleccionar categoría.
3. Clic "Crear nuevo curso".
4. Introducir ajustes del curso.
5. "Guardar y volver" o "Guardar y mostrar" (para asignar usuarios).

Ajustes Básicos del Curso:

• Nombre Completo del Curso: Principal, visible en listas, tablero, informes.
• Nombre Corto: Abreviado, para navegación, etc.
• Categoría del Curso: Asignar a categoría existente.
• Visibilidad del Curso: Ocultar de listas (solo visible para gestores, creadores, profes).
• Fecha de Inicio del Curso: Afecta logs y formato semanal.
• Fecha de Finalización del Curso: Para lista de cursos activos y retención de datos.

Consideración clave: Ajustes iniciales (visibilidad, fechas) tienen implicaciones funcionales y de gestión de datos.

Gestionar/habilitar en Administración del sitio > Plugins > Matriculaciones > Gestionar plugins de matriculación.

Tabla: Métodos de Matriculación en Moodle

Consideración clave: Comprender implicaciones de cada método (carga admin, seguridad, UX) y alinear con modelo pedagógico/operativo.

Extienden funcionalidad (actividades, preguntas, informes, etc.).

Métodos de Instalación:

• Directorio de Plugins de Moodle: El más sencillo. Administración del sitio > Plugins > Instalar plugins. Buscar e instalar.
• Carga de Archivo ZIP: Descargar ZIP, subir en Administración del sitio > Plugins > Instalar plugins.
• Manual (Copia de Archivos): Descargar ZIP, descomprimir, copiar carpeta a ubicación correcta (ej. /mod/, /theme/, /blocks/). Visitar Notificaciones para completar.

Asegurar permisos de archivo correctos (755) para legibilidad por servidor web.

Gestión de módulos de actividad: Administración del sitio > Plugins > Módulos de actividad > Gestionar actividades (ver instancias, versión, ocultar/eliminar, ajustes predeterminados).

Consideración clave: Investigar compatibilidad, mantenimiento y seguridad de plugins. Un plugin desactualizado/mal configurado puede causar fallos o vulnerabilidades.

Personalizan diseño y apariencia.

Instalación de Temas:

1. Descargar ZIP de tema compatible desde Directorio de Plugins.
2. Descomprimir.
3. Subir carpeta a /moodle/theme/.
4. Permisos de archivo 755.
5. Seleccionar y activar en Administración del sitio > Apariencia > Temas. "Limpiar cachés de tema".

Ajustes Avanzados de Tema (Administración del sitio > Apariencia > Ajustes avanzados de tema):

• Lista de temas: Restringir temas disponibles.
• Modo diseñador de temas: Activar para diseño/pruebas (evita caché).
• Permitir Temas de Usuario/Curso/Categoría/Cohorte: Habilitar selección individual. Temas de curso tienen mayor prioridad.
• Permitir Cambios de Tema en la URL: Para resolución de problemas (?theme=theme_name).
• Jerarquía de contextos: Curso > Categoría > Sesión > Usuario > Cohorte > Sitio.

Consideración clave: Equilibrar personalización visual con impacto en rendimiento. Probar después de cambios.

Interoperabilidad con herramientas externas (contenido, calificaciones, datos de usuario). Relevante para LTI Advantage (Moodle 4.3+).

Habilitar 'Publicar como herramienta LTI':

1. Habilitar autenticación LTI: Administración del sitio > Plugins > Autenticación > Gestionar autenticación.
2. Habilitar plugin matriculación 'Publicar como herramienta LTI': Administración del sitio > Plugins > Matriculaciones > Gestionar plugins de matriculación.
3. Permitir incrustación de marcos (recomendado): Administración del sitio > Seguridad > Seguridad HTTP.

Moodle como Herramienta (Proveedor):

1. Administración del sitio > Plugins > Matriculaciones > Publicar como herramienta LTI > Registro de herramienta.
2. "Registrar una plataforma".
3. Introducir nombre de plataforma consumidora.
4. Copiar URL de registro dinámico.

Moodle como Plataforma (Consumidor):

1. En instancia consumidora: Administración del sitio > Plugins > Módulos de actividad > Herramienta externa > Gestionar herramientas.
2. Pegar URL de registro en "URL de la herramienta", clic "Añadir LTI Advantage".
3. "Activar" la herramienta.

Compartir Acceso y Aprovisionamiento de Usuarios:

Para compartir curso/actividad desde Moodle Herramienta: Navegación del curso > Publicado como herramientas LTI > LTI Advantage > Añadir. Seleccionar curso/actividad, opciones de sincronización.

Aprovisionamiento de usuarios: Controla creación/vinculación de cuentas en primer acceso LTI. Modos para estudiantes/profesores.

Consideración clave: LTI transforma Moodle en hub interoperable. Seguridad es compleja (confianza entre sistemas); requiere implementación meticulosa.

Objetivo: Maximizar uso de RAM (caché), reducir actividad de disco, evitar swap.

Hardware:

• RAM: Aumentar RAM es el cambio más efectivo (4GB+).
• Procesador: Dual/Dual-core mejor. Hyperthreading puede ayudar.
• Discos Duros: SCSI > SATA. SSDs (grado empresarial) superan a discos giratorios. SATA con NCQ. Bajo tiempo de búsqueda.
• Swap: 4x RAM física.
• RAID: Controlador hardware. SO/Swap en RAID-1. Moodle/web/BD en RAID-5. Si `moodledata` en NFS lento, usar Redis para caché.
• Red: Gigabit Ethernet vital, esp. si web y BD están separados.

Sistema Operativo:

Linux recomendado. Unix-based requieren menos memoria. SO optimizado (Solaris) para muchos procesadores SMP.

Consideración clave: No hay "bala de plata"; es sinergia de componentes. RAM ofrece retorno más rápido.

Moodle Universal Cache (MUC) desde 2.4. Control granular. Instalaciones grandes benefician de Memcached, MongoDB, Redis.

Tipos de Caché:

• Caché de Solicitud (Request): Dura por solicitud, no compartida.
• Caché de Sesión (Session): Dura por sesión de usuario, no compartida (mantenida para un usuario).
• Caché de Aplicación (Application): Compartida, accesible por cada solicitud, puede persistir. Debe ser compartida en sistemas multisevidor.

Backends y Almacenes de Caché:

Backends (dónde se guarda: sistema archivos, sesión PHP, Memcached, memoria). Almacenes (plugins Moodle para conectar a backends). Moodle incluye plugins para Memcached, MongoDB, APCu, Redis. Redis altamente recomendado.

Configurar almacenes: Administración del sitio > Plugins > Caché > Configuración. Añadir instancias (ej. Memcached requiere servidor Memcached y extensión PHP). Purgar caché Memcached en Moodle elimina *todas* las entradas del servidor; usar servidores dedicados.

Para balanceo de carga, usar Memcached. Configurar $CFG->localcachedir a directorio local en config.php por nodo (Moodle 2.6+) acelera caché de disco fuera de MUC.

Consideración clave: Caché distribuida (Redis/Memcached) es crucial para escalabilidad horizontal y evitar cuellos de botella de E/S.

Rendimiento PHP:

• Habilitar acelerador PHP (OpCache).
• memory_limit (php.ini): mín. 96M, rec. 128M+.
• PHP-FPM con Apache puede mejorar.
• IIS: PHP como módulo ISAPI (IIS6) o FastCGI (IIS 7+) mejor que CGI.

Rendimiento Apache:

• Ajustar MaxRequestWorkers (o MaxClients): Memoria disponible * 80% / Uso máx. memoria proceso apache. Regla conservadora: memoria (MB) / 100.
• Reducir módulos Apache cargados.
• KeepAlive Off o KeepAliveTimeout bajo (2-5s).
• Instalar/habilitar mod_deflate (compresión HTTP).
• Usar MPM event preferible a Prefork/Worker.

Otros Servidores Web:

• IIS: Ajustar ListenBackLog, MemCacheSize, etc.
• OpenLiteSpeed: LSCache, PHP OpCache.
• Lighttpd, NginX, Cherokee: Con PHP FastCGI, pueden ser superiores y actuar como balanceadores/proxies.

Configurar módulos X-Sendfile para mejorar envío de archivos grandes.

Consideración clave: Configuración del servidor web impacta concurrencia y eficiencia de entrega. Mal configurado limita usuarios.

MariaDB/MySQL:

• Innodb Buffer Pool: innodb_buffer_pool_size al 80% memoria en máquina MySQL dedicada. innodb_buffer_pool_instances = #núcleos/vCPUs.
• Query Cache: Habilitar query_cache_type = 1, ajustar query_cache_size (ej. 36M).
• Max Connections: Límite para evitar "Demasiadas conexiones". Servidor cargado puede necesitar >200.
• Optimizar Tablas: Semanalmente y tras actualizaciones/grandes borrados (OPTIMIZE TABLE mdl_tablename). Comunes: mdl_course_sections, mdl_forum_posts, mdl_log, mdl_sessions.
• MySQLTuner: Ayuda a calcular valores de config.

PostgreSQL:

• Habilitar autovacuum.
• Ajustar shared_buffers (ej. 1-2% RAM para 8.2+).
• Configurar effective_cache_size.
• Ajustar work_mem, maintenance_work_mem.

Réplicas de Lectura (gran escala): Moodle 3.9+ permite descargar 80-90% carga de lectura del primario.

Consideración clave: Base de datos no optimizada es cuello de botella principal. Réplicas de lectura para escalar.

Crucial ("latido" del sistema). Envío de correos, actualizaciones, copias de seguridad, feeds RSS. Si no se ejecuta regularmente, Moodle no funcionará bien.

Configuración: Ejecutar cada minuto. Método preferido: script CLI /path/to/moodle/admin/cli/cron.php.

Entrada cron Unix típica:

* * * * * /usr/bin/php /path/to/moodle/admin/cli/cron.php >/dev/null

Verificar versión PHP de línea de comandos (puede ser diferente a la del servidor web).

Script web (.../admin/cron.php) obsoleto, podría eliminarse. Deshabilitado por defecto por seguridad.

Consideración clave: Supervisión del cron es tan importante como configuración inicial. Fallo impacta funcionalidad y UX.

Permisos de Archivos (Linux/Unix):

• moodledata/: Directorios 700, archivos 600. Propietario/grupo: usuario/grupo del servidor web. Fuera del raíz web, no accesible por URL.
• moodle/ (código): Directorios 755, archivos 644. Propietario/grupo: `root`. No escribible por servidor web.

Políticas de Contraseña:

Ajustes > Administración del sitio > Seguridad > Políticas del sitio. Forzar complejidad (longitud, dígitos, mayús/minús, no alfanuméricos). Equilibrar con usabilidad.

Actualizaciones Regulares:

Moodle, PHP, Apache actualizados. Auto-actualización SO (apt-get, yum). Considerar automatización actualizaciones Moodle vía cron.

Endurecimiento General del Sistema:

• Copias de seguridad: Estrategia robusta, practicar restauración.
• Minimización de software: Instalar solo lo necesario.
• HTTPS: Proteger todo el tráfico. $CFG->httpslogin=yes; en config.php.
• Deshabilitar register_globals: Prevenir XSS.
• Contraseñas fuertes: Para admin/profesor.
• Separación de sistemas: Contraseñas diferentes, máquinas separadas.
• Firewalls: Doble firewall, deshabilitar servicios no usados.
• Alertas de seguridad: Registrar sitio en Moodle.org, revisar página de alertas.
• Misceláneas: Deshabilitar acceso invitado si no es necesario, usar claves de matriculación, deshabilitar pista de clave.

Copias de Seguridad de Cursos:

Guardar curso con todas/algunas partes. Admin configuran programa automatizado, profes pueden crear/descargar. Navegación del curso > Más > Reutilización del curso > Backup. Seleccionar elementos (usuarios, anonimizar, roles, grupos, etc.). Archivos .mbz.

Copias de Seguridad de Sitio Completo:

Respaldar código Moodle, moodledata/filedir/, base de datos. Asume copia de seguridad completa del servidor ya existe. Verificar espacio disco (df -h).

• DB Dump (MySQL/MariaDB): mysqldump --default-character-set=utf8mb4 -u [usuario] -p[contraseña] [nombre_db] > moodle-[version]-$(date +%Y%m%d%-H%M).sql
• Código Moodle: tar -cvf moodle-code-backup-$(date +%Y%m%d).tar /path/to/moodle/
• Directorio `moodledata`: tar -cvf moodledata-backup-$(date +%Y%m%d).tar /path/to/moodledata/

Guardar en unidad externa. "Copias de seguridad de cursos automatizadas" no reemplazan "copia de seguridad de recuperación ante desastres".

Modo Mantenimiento:

Prevenir acceso no admin. Administración del sitio > Servidor > Modo de mantenimiento. Mensaje personalizado opcional. Modo CLI bloquea todo acceso web (útil para actualizaciones CLI).

Actualizaciones:

Verificar requisitos (Administración del sitio > Servidor > Entorno). Copias de seguridad (software Moodle, `moodledata`, BD). Verificar actualizaciones de plugins. Poner sitio en modo mantenimiento.

Depuración:

Administración del sitio > Desarrollo > Depuración. Opciones: NONE, MINIMAL, NORMAL, ALL, DEVELOPER. Registrar errores en logs del servidor (no mostrar en navegador en producción). Mostrar info de rendimiento en pie de página.

Mantenimiento BD:

Limitar tamaño tablas (Administración del sitio > Servidor > Limpieza). Eliminar usuarios no configurados, gestionar historial calificaciones. Mantenimiento regular (índices, claves foráneas). Usar MySQLTuner.