calendarize_news para TYPO3

Los eventos en tx_news pertenecen a un calendario, no a una lista cronológica

La mayoría de sitios web TYPO3 utilizan tx_news de Georg Ringer para todo: noticias, artículos de blog, comunicados de prensa y eventos. Para los tres primeros tipos, la presentación de lista cronológica funciona. Para eventos no. Los visitantes esperan una vista de calendario con presentación mensual, semanal y diaria. Quieren hacer clic en una fecha y ver qué ocurre ese día. calendarize_news construye exactamente ese puente: toma registros de noticias existentes con campos de fecha y los renderiza como calendario.

La extensión ahorra el cambio a un sistema de eventos independiente. Quien ya usa tx_news mantiene su estructura de datos, sus plantillas y sus procesos editoriales. En lugar de una segunda extensión con almacenamiento de datos separado, hay una vista de calendario sobre datos existentes.

Escenarios de uso habituales

Calendarios de eventos en sitios web corporativos. Un centro de formación publica 150 seminarios al año a través de tx_news. Cada seminario tiene fecha de inicio, fecha de fin y hora. Sin calendarize_news, los visitantes ven una larga lista ordenada por fecha. Con calendarize_news ven un calendario mensual, hacen clic en el 15 de mayo y encuentran tres seminarios. La conversión desde la vista de calendario a la página de detalle fue en un cliente un 40% mayor que desde la vista de lista.

Eventos recurrentes sin duplicación de datos. Una tertulia semanal, un webinar mensual, una fiesta anual de empresa: sin funcionalidad de recurrencia, el redactor debe crear 52 registros para la tertulia. calendarize_news soporta reglas de repetición (diaria, semanal, mensual, anual) con excepciones. Un registro genera 52 entradas de calendario. Si se cancela una fecha, se marca como excepción, no se elimina.

Páginas combinadas de noticias y eventos. Muchas organizaciones muestran en la página de inicio “Actualidad”, una mezcla de noticias y eventos próximos. calendarize_news permite representar los mismos registros cronológicamente en la lista de noticias y por fecha en el calendario. Dos vistas, una fuente de datos, sin esfuerzo de sincronización.

Arquitectura técnica

calendarize_news es un complemento de la extensión de calendario calendarize, del mismo autor (Tim Lochmüller). Añade a los registros de noticias, en el campo calendarize, configuraciones de fechas: fecha de inicio, fecha de fin, flag de día completo, regla de repetición y excepciones. A partir de ellas, calendarize crea al guardar una entrada por cada cita individual en su tabla de índice.

La representación del calendario se realiza mediante plantillas Fluid que renderizan una cuadrícula mensual. Cada celda (día) contiene los eventos de ese día. Las plantillas son completamente personalizables. Por defecto, la extensión incluye plantillas para vista mensual, semanal y diaria. La navegación entre meses se realiza por AJAX o carga de página clásica, configurable mediante TypoScript.

La integración con tx_news es profunda: calendarize_news registra las noticias como tipo de evento en calendarize; las vistas de calendario las aporta el plugin de calendarize, al que calendarize_news añade un campo para la página de noticias. Las categorías, etiquetas y restricciones de acceso de tx_news se heredan. Un evento asignado a la categoría “Interno” y visible solo para usuarios autenticados también aparece en el calendario solo tras el login.

La función de exportación iCal genera archivos .ics para eventos individuales o el calendario completo. Los visitantes pueden importar eventos directamente en Outlook, Apple Calendar o Google Calendar. La exportación utiliza el formato iCalendar (RFC 5545) y tiene en cuenta las reglas de repetición.

Problemas frecuentes y soluciones

El calendario no muestra eventos aunque existan noticias. Causa más frecuente: los campos de fecha de los registros de noticias no están rellenados. tx_news tiene un campo datetime, pero las fechas están en configuraciones de calendarize que primero hay que añadir a los registros de noticias existentes en el campo calendarize. Solución: un script de migración que cree, a partir de datetime, una configuración de calendarize por noticia lleva 30 minutos de desarrollo.

Problemas de rendimiento con muchos eventos recurrentes. Cuando 50 eventos recurrentes generan cada uno 52 citas, el índice del calendario contiene 2.600 entradas que la vista mensual debe filtrar. Esto es perceptible en cada carga de página sin caché. Solución: servir la vista de lista y la mensual con caché, como hace calendarize de serie, y limitar el horizonte temporal para el que calendarize escribe citas en el índice (ajuste tillDays). Los eventos a más de 12 meses en el futuro no necesitan estar en el índice.

Presentación responsive de la cuadrícula del calendario. Una cuadrícula de 7 columnas para días de la semana funciona en escritorio, pero no en smartphones. Las plantillas estándar de calendarize_news no están optimizadas para móvil. Solución: adaptar las plantillas Fluid y renderizar en dispositivos móviles una presentación en lista en lugar de la cuadrícula. Un breakpoint CSS a 768px es suficiente para alternar entre cuadrícula y lista.

Migración y compatibilidad de versiones

calendarize_news depende de tx_news y de calendarize. La versión actual 9.0.0 requiere TYPO3 13.4, tx_news a partir de la versión 12 y calendarize 13 o 14; para TYPO3 v12 existe la versión 8.0.1.

calendarize (sin el sufijo _news) de lochmueller es una extensión de calendario independiente con su propio modelo de datos y, al mismo tiempo, la base sobre la que se apoya calendarize_news: las fechas de las noticias ya están en las tablas de calendarize. La versión actual 15 soporta TYPO3 13.4 y 14.

Para proyectos que migran a TYPO3 v13 y quieren mantener tx_news, el camino más pragmático es: usar calendarize_news en su versión 9 o construir la representación de calendario como plantilla Fluid personalizada directamente en tx_news. El esfuerzo de una plantilla personalizada es de 2-3 días, el resultado es independiente del mantenimiento de terceros. Gosign ha implementado ambos caminos y recomienda la variante adecuada según la complejidad de las reglas de repetición.