Saltar al contenido principal

Calendario restilado

Ficha técnica
  • Impacto — Tema: overrides core_calendar/month_detailed.mustache y core_calendar/month_navigation.mustache, SCSS .cdigital-cal__* en scss/preset/cdigital.scss
  • Impacto — Plugin: —
  • Estado: Implementado

Propósito​

Alinea el calendario de Moodle al lenguaje visual del campus. Afecta a dos superficies a la vez, porque ambas se renderizan con las mismas plantillas de core:

  • La página completa del calendario (/calendar/view.php).
  • El bloque de calendario mensual, allí donde esté colocado.

Cómo está implementado​

Las dos plantillas son copias verbatim de las de core (branch 501), idénticas en marcado, atributos data-*, identificadores y bloque de JavaScript. El único cambio es aditivo: se añaden clases cdigital-cal__* junto a las clases de core.

Por qué copiar la plantilla en vez de estilar las clases de core

Core documenta sus clases presentacionales como renombrables entre versiones. Estilar directamente sobre ellas haría que el diseño se rompiera en silencio en cualquier actualización menor de Moodle.

Añadiendo clases propias, el SCSS del tema no depende de nada que core pueda renombrar: si un upgrade cambia el marcado, el peor caso es que la plantilla del tema quede desactualizada respecto a la de core, algo que el checklist de actualización detecta con un diff.

Riesgo de actualización​

Al ser copias de plantillas de core, quedan congeladas en la versión desde la que se copiaron. En cada actualización de Moodle hay que comparar lib/templates/../calendar/templates/month_detailed.mustache y month_navigation.mustache con las copias del tema, y trasladar los cambios de core conservando las clases cdigital-cal__*.

Es el mismo compromiso que asumen los overrides de block_xp documentados en theme_cdigital.

Verificación​

Abrir el calendario del campus y comprobar que usa el diseño del tema. Comprobar además que la navegación entre meses funciona y que los eventos siguen siendo clicables: si el marcado copiado se desincronizara de core, lo primero que se rompe es el JavaScript de navegación, no el aspecto.