Doc: feature Evangelio de cada día (#101)

Evangelio-de-cada-dia.md

@@ -0,0 +1,34 @@
+# Evangelio de cada día
+
+Devocional diario en la web: muestra el contenido del día en dos formatos, a elegir por el usuario. URL: `/evangelio-de-cada-dia/`.
+
+## Qué es
+Dos series indexadas por **día del año** (origen Joomla `com_content` cat 97/98 → WP):
+
+| Serie | Formato | Categoría WP |
+|-------|---------|--------------|
+| **A la fuente cada día** (Fray Marcos) | texto (cita + comentario) | term_id **14** (`alafuentecadadia`, ~308 días) |
+| **Otro evangelio es posible** | vídeo YouTube embebido | term_id **15** (`otroevangelioesposible`, ~245 días) |
+
+Cada entrada se titula `D mes` (p.ej. `22 junio`); el slug es `D-mes`. No están los 365 días completos: los huecos se muestran con un aviso por pestaña.
+
+## Página y código (`fea-homepage.php`)
+- **Página:** post **23739**, slug `evangelio-de-cada-dia`, autor **Fray Marcos** (user 382). Su contenido es solo el shortcode `[fea_evangelio_diario]`.
+- **`[fea_evangelio_diario]`:** calcula el día de HOY con `Europe/Madrid` (el server va en UTC), localiza el post por `LOWER(TRIM(post_title))='D mes'` en cat 14 y 15, y renderiza 2 pestañas CSS (sin JS) texto/vídeo + navegación día anterior/siguiente (`?fed=M-D`). Categorías 14/15 **fijas** (devocional solo en ES).
+- **Enlace en portada:** la función `fea_eed_link_html()` se llama **desde el shortcode del hero** `fea_carta_semana_hero` → enlace "Evangelio del día · fecha" bajo "Leer la carta". Multiidioma (etiqueta + fecha). Se integra en el hero (no es un bloque suelto en la portada) para que renderice siempre y aparezca en las 5 portadas sin tocar su contenido.
+- **Pie:** el enlace "El Evangelio de cada día" (nav `26525`) apunta a `/evangelio-de-cada-dia/`.
+
+## ⚠️ Calendario litúrgico y MANTENIMIENTO ANUAL
+El contenido está indexado al **calendario litúrgico de 2024**. Cada año cambia qué día cae cada lectura, así que **hay que reajustar las fechas anualmente**.
+
+- **Ajuste 2026 (hecho):** desplazamiento **−2 días** a las entradas de **Tiempo Ordinario de junio → Adviento**, respetando las fiestas de **fecha fija**. Las **solemnidades móviles** (Corpus, Santísima Trinidad, **Cristo Rey**, Sagrado Corazón) también se desplazan −2.
+- **Script `shift_eed.php`** (en `/tmp` local y `/entrada` prod): `DRY_RUN` por defecto, `APPLY=1` para escribir. Detecta el contenido **móvil** por patrón ("X de la Nª semana" admitiendo ª/º y el typo "semama"; "DOMINGO … TIEMPO ORDINARIO"; solemnidades móviles). Desplaza texto (cat 14) y vídeo (cat 15) en paralelo y **actualiza la fecha embebida "(D mes)"** dentro del contenido de los vídeos.
+- **Pendiente:** **Cuaresma / Semana Santa / Pascua / Navidad** y el **T. Ordinario de enero-mayo** NO están ajustados. Ojo: los domingos de Cuaresma/Pascua están en **ciclo B (2024)** y 2026 es **ciclo C** → no basta un desplazamiento, faltaría contenido del ciclo correcto.
+- **Cada año:** el desplazamiento NO es constante (depende de la fecha de Pascua y del inicio de Adviento). Recalcular, o —solución definitiva— construir un mapeo litúrgico real que lo resuelva automáticamente.
+
+## Notas operativas
+- El devocional sigue casi siempre el flujo del Tiempo Ordinario (p.ej. el 1-nov usa "Viernes 30ª semana", no Todos los Santos) → muy pocas fiestas de fecha fija estorban en el desplazamiento.
+- Verificación en prod: server-side con `wp eval-file` (Cloudflare bloquea headless). El shell de prod rompe `grep`/binarios externos y `wp eval` inline con comillas anidadas.
+
+## Issues
+Gitea **#101** (cerrada). Parte de la auditoría del pie **#119**.