Comentarios al evangelio: capturar la cita al publicar, rellenar el histórico y mostrar el pasaje #199

Open
opened 2026-08-11 02:32:18 +00:00 by rafa · 1 comment
Owner

Labels: area:plugin, improvement, usabilidad, datos

Qué piden los lectores

En la página de un comentario al evangelio, poder ver de qué pasaje habla: la referencia bajo el titular, y un desplegable con el texto del evangelio concreto que se comenta.

Cómo están los datos hoy (medido en local, 2026-08-10)

  • La categoría Comentarios al evangelio (term 1647) tiene 3.839 posts publicados.
  • El texto del evangelio ya está en WordPress: posts de la categoría Lecturas bíblicas (term 1645) titulados MATEO 14, 22-33. Son 366 posts, 260 citas distintas, 258 con texto real; 204 en español, y de esos 178 con las cuatro traducciones (en/fr/it/pt) publicadas y enlazadas por Polylang.
  • El vínculo comentario → evangelio es el meta _cita_evangelio (Mt 14, 22-33). Lo escribió el importador de Joomla. El flujo de publicación actual no lo escribe, así que todo lo que se publica hoy nace sin él.
  • 304 comentarios publicados no lo tienen, 150 de ellos de 2026.
  • De los metas de comentario, solo dos tienen lector en el código: _cita_evangelio (buscador avanzado fea-search-advanced.php:164, pie del comentario e índice por libro en fea-homepage.php:1878/2048/2094) y _carta_id (pie "Carta de la semana", fea-homepage.php:2047). Libro de la biblia, Idioma, Autor y Rango de fechas son residuos del importador K2: no los lee nadie y no hay que rellenarlos.

De dónde sale la cita

La carta de la semana lleva la sección Evangelio y comentarios al Evangelio, que abre con el enlace al post del evangelio y sigue con los comentarios:

<a href="https://www.feadulta.com/mateo-13-24-42/">Mateo 13, 24-42. Las parábolas de la cizaña…</a>
<a href="https://www.feadulta.com/las-parabolas-vegetales/">Miguel A. Munárriz: Las parábolas vegetales…</a>

Regla: comentario → _carta_id → primer enlace /(mateo|marcos|lucas|juan)-N-…/ de la carta → título de ese post → cita canónica (MATEO 14, 22-33Mt 14, 22-33).

Del título y no del slug: los slugs llevan sufijo de WordPress (mateo-5-1-12-2, juan-20-19-31-2) y alguno resuelve a un post cuyo meta * Cita biblica es de otro libro (mateo-3-1-12Jos 24, 1-2).

Contrastada contra los 2.443 comentarios que ya tienen cita puesta: coincide exacto en 2.202 (90,1%). Las 241 diferencias son comentarios que citan otra lectura de la misa (Am 8, 4-7, Ex 32, 13-14, Sab 9, 13-19, Hab 2, 2-4), no fallos de la regla. Por eso nada de lo que sigue debe sobrescribir una cita existente.

Fase 1 — capturar la cita al publicar

  • Hook en transition_post_status para posts que se publican en comentarios-al-evangelio: si _cita_evangelio está vacío, resolver la carta de la semana, leer su enlace de evangelio y escribir _cita_evangelio y _carta_id.
  • Resolver la carta: usar _carta_id si ya viene; si no, la carta publicada más cercana en ±4 días.
  • No escribir nada si la carta enlaza más de un evangelio o ninguno; dejar traza en el log para revisión manual.
  • Nunca sobrescribir un _cita_evangelio que ya tenga valor.

Fase 2 — composición de la carta (guía de Mixbot)

De las 30 cartas ES de 2026, 4 no enlazan el post del evangelio: la del 29-07 ("Mesa libre"), 45018, 44997 y 44975. En "Mesa libre" la sección arranca directamente por el primer comentario, aunque el post del evangelio existía (846, MATEO 14, 13-21, con sus cuatro traducciones). Sin ese enlace la fase 1 no puede derivar nada.

  • Documentar en la guía de Mixbot, en una regla: la sección Evangelio y comentarios al Evangelio empieza siempre por el enlace al post del evangelio de esa semana (se busca por su título, MATEO 14, 22-33), y después van los comentarios. Si ese post no existe, avisar en vez de arrancar por un comentario.
  • No se pide rellenar ningún campo nuevo: el enlace ya es contenido visible de la carta, y de él se deriva todo lo demás.

Fase 3 — rellenar los 304 huecos

  • 106 tienen _carta_id y su carta enlaza un solo evangelio → automático.
  • 18 de 2026 sin _carta_id → carta por fecha, ya verificados uno a uno:
    • 55450, 5546255466 → carta 55521 → Mt 14, 22-33
    • 5488354886, 54903, 55041 → carta 55032 → Mt 13, 44-52
    • 5506755080 → carta 55139 → Mt 14, 13-21 (post 846; arreglar antes el enlace de esa carta)
  • 13 con carta multi-evangelio (Navidad, Triduo) → a mano.
  • 26 con carta sin enlace, más la cola histórica de 2008-2011 → revisar aparte o dejar como están.
  • Volcar primero un CSV de propuestas y aplicarlo tras revisión. Solo huecos vacíos.

Fase 4 — mostrar la referencia y el pasaje

  • Bajo el titular del comentario, la referencia (Mt 14, 22-33) de forma uniforme, desde _cita_evangelio.
  • Debajo, un <details> con el texto del evangelio, tomado del post de Lecturas bíblicas cuyo título case con la cita, en el idioma del comentario vía pll_get_post_translations().
  • Si no existe post para esa cita, mostrar solo la referencia. Con los datos de hoy el desplegable saldría en el 89,8% de los comentarios con cita (3.176 de 3.535).
  • Evitar el duplicado visual cuando el propio texto del comentario ya abre con la referencia.
  • Decisión de producto pendiente: el <details> arranca cerrado o abierto. Recomendación: cerrado con la referencia visible — abierto, quince líneas de evangelio empujan fuera de pantalla el comentario, que es a lo que viene el lector.

Notas para quien lo implemente

  • La categoría de la carta rota: 6 cartasemana22 carta-semana-pasada21 cartas-de-otras-semanas. Hay que buscar en las tres; mirando solo la 6 aparecen 5 cartas de 2026 en lugar de 30.
  • wordpress-web no tiene cliente mysql, wp db query falla. Usar wp eval-file con un docker cp previo del .php.
  • Para localizar lecturas: wp_posts.post_title REGEXP '^(MATEO|MARCOS|LUCAS|JUAN) [0-9]'.

Criterios de aceptación

  • Un comentario publicado hoy tiene _cita_evangelio sin que nadie lo toque a mano.
  • El buscador avanzado por cita bíblica encuentra los comentarios de la última semana.
  • Los 304 huecos quedan reducidos a los casos que exigen criterio humano.
  • La página de un comentario muestra la referencia y, cuando existe, el pasaje desplegable en el idioma del comentario.

Relacionado

  • #195 usabilidad (paraguas)
  • Sustituye a #198 (cerrado por desorden de retractaciones acumuladas; el contenido válido está aquí, reescrito de una vez)

Investigado y redactado por Opix (2026-08-10/11), creado por Claudix (Opix no tiene token de gitea en esta máquina).

**Labels:** area:plugin, improvement, usabilidad, datos ## Qué piden los lectores En la página de un comentario al evangelio, poder ver de qué pasaje habla: la referencia bajo el titular, y un desplegable con el texto del evangelio concreto que se comenta. ## Cómo están los datos hoy (medido en local, 2026-08-10) - La categoría **Comentarios al evangelio** (term 1647) tiene 3.839 posts publicados. - **El texto del evangelio ya está en WordPress**: posts de la categoría *Lecturas bíblicas* (term 1645) titulados `MATEO 14, 22-33`. Son 366 posts, 260 citas distintas, 258 con texto real; 204 en español, y de esos 178 con las cuatro traducciones (en/fr/it/pt) publicadas y enlazadas por Polylang. - El vínculo comentario → evangelio es el meta `_cita_evangelio` (`Mt 14, 22-33`). Lo escribió el importador de Joomla. **El flujo de publicación actual no lo escribe**, así que todo lo que se publica hoy nace sin él. - **304 comentarios publicados no lo tienen**, 150 de ellos de 2026. - De los metas de comentario, solo dos tienen lector en el código: `_cita_evangelio` (buscador avanzado `fea-search-advanced.php:164`, pie del comentario e índice por libro en `fea-homepage.php:1878/2048/2094`) y `_carta_id` (pie "Carta de la semana", `fea-homepage.php:2047`). `Libro de la biblia`, `Idioma`, `Autor` y `Rango de fechas` son residuos del importador K2: no los lee nadie y **no hay que rellenarlos**. ## De dónde sale la cita La carta de la semana lleva la sección *Evangelio y comentarios al Evangelio*, que abre con el enlace al post del evangelio y sigue con los comentarios: ```html <a href="https://www.feadulta.com/mateo-13-24-42/">Mateo 13, 24-42. Las parábolas de la cizaña…</a> <a href="https://www.feadulta.com/las-parabolas-vegetales/">Miguel A. Munárriz: Las parábolas vegetales…</a> ``` **Regla:** comentario → `_carta_id` → primer enlace `/(mateo|marcos|lucas|juan)-N-…/` de la carta → **título** de ese post → cita canónica (`MATEO 14, 22-33` → `Mt 14, 22-33`). Del título y no del slug: los slugs llevan sufijo de WordPress (`mateo-5-1-12-2`, `juan-20-19-31-2`) y alguno resuelve a un post cuyo meta `* Cita biblica` es de otro libro (`mateo-3-1-12` → `Jos 24, 1-2`). Contrastada contra los 2.443 comentarios que ya tienen cita puesta: **coincide exacto en 2.202 (90,1%)**. Las 241 diferencias son comentarios que citan otra lectura de la misa (`Am 8, 4-7`, `Ex 32, 13-14`, `Sab 9, 13-19`, `Hab 2, 2-4`), no fallos de la regla. Por eso nada de lo que sigue debe sobrescribir una cita existente. ## Fase 1 — capturar la cita al publicar - [ ] Hook en `transition_post_status` para posts que se publican en `comentarios-al-evangelio`: si `_cita_evangelio` está vacío, resolver la carta de la semana, leer su enlace de evangelio y escribir `_cita_evangelio` y `_carta_id`. - [ ] Resolver la carta: usar `_carta_id` si ya viene; si no, la carta publicada más cercana en ±4 días. - [ ] No escribir nada si la carta enlaza más de un evangelio o ninguno; dejar traza en el log para revisión manual. - [ ] Nunca sobrescribir un `_cita_evangelio` que ya tenga valor. ## Fase 2 — composición de la carta (guía de Mixbot) De las 30 cartas ES de 2026, **4 no enlazan el post del evangelio**: la del 29-07 ("Mesa libre"), 45018, 44997 y 44975. En "Mesa libre" la sección arranca directamente por el primer comentario, aunque el post del evangelio existía (846, `MATEO 14, 13-21`, con sus cuatro traducciones). Sin ese enlace la fase 1 no puede derivar nada. - [ ] Documentar en la guía de Mixbot, en una regla: la sección *Evangelio y comentarios al Evangelio* empieza **siempre** por el enlace al post del evangelio de esa semana (se busca por su título, `MATEO 14, 22-33`), y después van los comentarios. Si ese post no existe, avisar en vez de arrancar por un comentario. - [ ] No se pide rellenar ningún campo nuevo: el enlace ya es contenido visible de la carta, y de él se deriva todo lo demás. ## Fase 3 — rellenar los 304 huecos - [ ] **106** tienen `_carta_id` y su carta enlaza un solo evangelio → automático. - [ ] **18 de 2026** sin `_carta_id` → carta por fecha, ya verificados uno a uno: - `55450`, `55462`–`55466` → carta 55521 → `Mt 14, 22-33` - `54883`–`54886`, `54903`, `55041` → carta 55032 → `Mt 13, 44-52` - `55067`–`55080` → carta 55139 → `Mt 14, 13-21` (post 846; arreglar antes el enlace de esa carta) - [ ] **13** con carta multi-evangelio (Navidad, Triduo) → a mano. - [ ] **26** con carta sin enlace, más la cola histórica de 2008-2011 → revisar aparte o dejar como están. - [ ] Volcar primero un CSV de propuestas y aplicarlo tras revisión. Solo huecos vacíos. ## Fase 4 — mostrar la referencia y el pasaje - [ ] Bajo el titular del comentario, la referencia (`Mt 14, 22-33`) de forma uniforme, desde `_cita_evangelio`. - [ ] Debajo, un `<details>` con el texto del evangelio, tomado del post de *Lecturas bíblicas* cuyo título case con la cita, en el idioma del comentario vía `pll_get_post_translations()`. - [ ] Si no existe post para esa cita, mostrar solo la referencia. Con los datos de hoy el desplegable saldría en el **89,8%** de los comentarios con cita (3.176 de 3.535). - [ ] Evitar el duplicado visual cuando el propio texto del comentario ya abre con la referencia. - [ ] **Decisión de producto pendiente**: el `<details>` arranca cerrado o abierto. Recomendación: cerrado con la referencia visible — abierto, quince líneas de evangelio empujan fuera de pantalla el comentario, que es a lo que viene el lector. ## Notas para quien lo implemente - La categoría de la carta **rota**: `6 cartasemana` → `22 carta-semana-pasada` → `21 cartas-de-otras-semanas`. Hay que buscar en las tres; mirando solo la 6 aparecen 5 cartas de 2026 en lugar de 30. - `wordpress-web` no tiene cliente mysql, `wp db query` falla. Usar `wp eval-file` con un `docker cp` previo del `.php`. - Para localizar lecturas: `wp_posts.post_title REGEXP '^(MATEO|MARCOS|LUCAS|JUAN) [0-9]'`. ## Criterios de aceptación - [ ] Un comentario publicado hoy tiene `_cita_evangelio` sin que nadie lo toque a mano. - [ ] El buscador avanzado por cita bíblica encuentra los comentarios de la última semana. - [ ] Los 304 huecos quedan reducidos a los casos que exigen criterio humano. - [ ] La página de un comentario muestra la referencia y, cuando existe, el pasaje desplegable en el idioma del comentario. ## Relacionado - #195 usabilidad (paraguas) - Sustituye a #198 (cerrado por desorden de retractaciones acumuladas; el contenido válido está aquí, reescrito de una vez) --- Investigado y redactado por Opix (2026-08-10/11), creado por Claudix (Opix no tiene token de gitea en esta máquina).
Author
Owner

Trabajo completado, pendiente de tu revisión y merge: PR #201.

Qué hace

  • Al publicar/editar un comentario al evangelio, captura _cita_evangelio y _carta_id a partir de la carta de la semana (enlace evangelio → título → cita canónica).
  • Muestra la cita bajo el titular y un <details> plegable con el texto del evangelio (cerrado por defecto).
  • Traducciones (Polylang): el render hereda _cita_evangelio/_carta_id del original ES y localiza la lectura, en vez de perderlos al traducir.
  • Backfill del histórico: modo seco por defecto, no sobrescribe citas existentes, marca revisión manual cuando no puede resolver.

Validación

  • php -l de los tres PHP tocados.
  • Fixture de publicación (cita/carta escritas, no sobrescribe existente).
  • Backfill sin --apply no escribe.
  • HTML ES/EN con un único <details>, cerrado, resumen localizado.
  • E2E Playwright contra no-sabemos-saborear-la-fe/ (Jn 4, 5-42): abre al clic, cuerpo con 4.056 caracteres de texto real.
  • Capturas cerrado/abierto compartidas en el canal Buzz.

Commit 908188d, rama feat/issue-199-evangelio.

Trabajo completado, pendiente de tu revisión y merge: PR #201. ## Qué hace - Al publicar/editar un comentario al evangelio, captura `_cita_evangelio` y `_carta_id` a partir de la carta de la semana (enlace evangelio → título → cita canónica). - Muestra la cita bajo el titular y un `<details>` plegable con el texto del evangelio (cerrado por defecto). - Traducciones (Polylang): el render hereda `_cita_evangelio`/`_carta_id` del original ES y localiza la lectura, en vez de perderlos al traducir. - Backfill del histórico: modo seco por defecto, no sobrescribe citas existentes, marca revisión manual cuando no puede resolver. ## Validación - `php -l` de los tres PHP tocados. - Fixture de publicación (cita/carta escritas, no sobrescribe existente). - Backfill sin `--apply` no escribe. - HTML ES/EN con un único `<details>`, cerrado, resumen localizado. - E2E Playwright contra `no-sabemos-saborear-la-fe/` (Jn 4, 5-42): abre al clic, cuerpo con 4.056 caracteres de texto real. - Capturas cerrado/abierto compartidas en el canal Buzz. Commit `908188d`, rama `feat/issue-199-evangelio`.
Sign in to join this conversation.
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: rafa/feadulta#199