Correo

Visión generalCopy Anchor Link

Todos los correos que envía la plataforma pasan por una sola clase, local_deltamodules\mailer. Las notificaciones internas de Moodle (foros, calificaciones, mensajes, avisos) no salen por correo: se quedan en la campana de la plataforma.

Evento o acción (crear colaborador, recuperar contraseña, módulo asignado, …)
        │
        ▼
mailer::queue()  ──► tabla local_deltamodules_mail (cola = registro)
        │                      │
        │ inmediato o al       │ tarea send_mail (cada minuto, contenedor moodle-cron)
        │ terminar la página   ▼
        └──────────────► mailer::deliver()
                           ├─ ¿correo configurado y sin pausa? ¿cabe en el límite?
                           ├─ bloqueo por correo (nunca se envía dos veces)
                           ├─ crea el enlace de un solo uso en este momento (si aplica)
                           ├─ ¿desvío de pruebas? → todo a MOODLE_MAIL_DIVERT_TO
                           └─ SMTP: smtp.office365.com:587 (STARTTLS, LOGIN)

Sin servidor de correo configurado la plataforma funciona igual: no envía nada y la contraseña se recupera con la cédula.

Servidor: Office 365Copy Anchor Link

Estado en producción: activo. La Academia envía correos con normalidad (confirmado el 08/10/2026).

La cuenta de envío es el buzón info@deltamontero.com de Office 365. La configuración sale de las variables de entorno en cada arranque (moodle-config.sh); no está en el respaldo.

Reglas que impone Office 365 y que la configuración respeta:

• Remitente = cuenta autenticada. Office 365 rechaza otro remitente. Por eso noreplyaddress es la misma cuenta, emailonlyfromnoreplyaddress = 1 y emailfromvia = 0. El nombre que se muestra es "Academia Deltamontero".
• Límite de envío. Office 365 acepta unos 30 correos por minuto por buzón. smtpmaxbulk = 1.
• SMTP AUTH debe estar habilitado para el buzón en Microsoft 365 (error 5.7.139 si no lo está). Lo activa el administrador de Microsoft 365 de la empresa.
• IPv4. La imagen prefiere IPv4 porque el servidor no tiene salida IPv6.

Si MOODLE_SMTP_HOST está vacío, moodle-config.sh borra smtphosts, smtpuser y smtppass: quitar la variable apaga el correo. El desvío propio de Moodle (divertallemailsto) queda siempre vacío porque el desvío lo hace la Academia sin cambiar el asunto.

Cola, límites y reintentosCopy Anchor Link

Formas de envío:

• Inmediato: la página espera el resultado (por ejemplo, para mostrar si se envió).
• Al terminar la página: se entrega la respuesta al navegador, se libera la sesión y luego se envía; la persona no espera a Office 365.
• Por la tarea: send_mail en el contenedor moodle-cron, cada minuto.

Cada envío toma un bloqueo por correo, para que dos procesos no envíen el mismo mensaje (cada envío crea un enlace nuevo y anula el anterior). Antes de enviar se comprueba que la cuenta destinataria siga existiendo y no esté suspendida. El motivo de los fallos (email_failed) queda en el registro.

Tipos de correoCopy Anchor Link

Cada tipo, salvo el de prueba, se puede apagar en Administración del sitio → Usuarios → Correos de la Academia. Además, el respaldo diario envía un correo a los super administradores y al correo de soporte cuando falla (vía backup_status.php). Los correos llevan el logo de Deltamontero incrustado y las cabeceras Auto-Submitted: auto-generated y X-Auto-Response-Suppress: All.

Enlaces de un solo usoCopy Anchor Link

Los correos de bienvenida y de recuperación llevan un enlace para crear la contraseña:

1. Al poner el correo en cola se guarda un marcador en lugar del enlace: el registro nunca contiene un enlace válido.
2. Al enviarlo se genera un código aleatorio; en la tabla local_deltamodules_pwtoken se guarda solo su hash SHA-256, con su propósito y su vencimiento.
3. La página local/deltamodules/setpassword.php guarda el código en la sesión y lo quita de la dirección al instante, pide la contraseña nueva con la política de la Academia, anula el enlace y cierra las otras sesiones de la persona. No inicia sesión por ella.
4. Los códigos vencidos se borran 30 días después de su vencimiento.

Si se restaura un respaldo anterior, los enlaces enviados después de ese respaldo dejan de servir y hay que reenviarlos (Correos de la Academia → Personal que todavía no entra).

Desvío de pruebasCopy Anchor Link

Con MOODLE_MAIL_DIVERT_TO definido, todos los correos van a esa dirección, sin cambiar el asunto. Sirve para probar en local o en una copia de recuperación sin escribir a personas reales. En pruebas locales, $CFG->noemailever hace que no salga nada.

DiagnósticoCopy Anchor Link

Correos de la Academia incluye un diagnóstico paso a paso: resolución DNS del servidor, conexión al puerto, saludo, cifrado STARTTLS e inicio de sesión. Nunca muestra la clave. El super administrador puede probar con un usuario y una clave escritos solo para la prueba, que no se guardan. En el registro del despliegue, configure-mail.php informa si el correo está configurado, sin mostrar la clave.

Otros ajustes relacionadosCopy Anchor Link

• emailchangeconfirmation = 0: el cambio de correo se guarda directamente (sin servidor de correo no se podía confirmar). apply-pending-emails.php aplica los cambios que quedaron pendientes.
• allowaccountssameemail = 0: no puede haber dos cuentas con el mismo correo.
• Soporte: nombre "Soporte Academia Deltamontero", disponible para usuarios registrados; sin enlace a la documentación de Moodle.

Procedimiento de configuración y problemas conocidos: Operación.