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 amplía tx_news con campos de base de datos adicionales en la tabla tx_news_domain_model_news: fecha de inicio, fecha de fin, flag de día completo, regla de repetición y fechas de excepción. La lógica de repetición está implementada en la extensión y genera citas virtuales en tiempo de ejecución, sin crear un registro en la base de datos para cada cita individual.

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 se registra como plugin adicional (list type) y utiliza el patrón Repository de tx_news. 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 calendarize_news utiliza campos propios para fecha de inicio y fin. Tras la instalación, los registros de noticias existentes deben complementarse con los campos calendarize. Solución: un script de migración que copie datetime a los campos calendarize lleva 30 minutos de desarrollo.

Problemas de rendimiento con muchos eventos recurrentes. Cuando 50 eventos recurrentes generan cada uno 52 citas virtuales, la extensión debe filtrar 2.600 entradas para la vista mensual. Esto es perceptible en cada carga de página sin caché. Solución: cachear el cálculo de recurrencia y limitar el horizonte temporal. Los eventos a más de 12 meses en el futuro no necesitan calcularse en cada petición.

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 directamente de tx_news y sigue su ciclo de versiones con retraso. La versión estable actual soporta TYPO3 v11 y v12 con tx_news v10/v11. Para TYPO3 v13 existe una versión beta en GitHub.

La alternativa calendarize (sin el sufijo _news) de lochmueller es una extensión de calendario independiente que no se basa en tx_news, sino que trae su propio modelo de datos. Se mantiene más activamente y soporta oficialmente TYPO3 v12 y v13. El cambio de calendarize_news a calendarize requiere una migración de datos.

Para proyectos que migran a TYPO3 v13 y quieren mantener tx_news, el camino más pragmático es: usar la beta de calendarize_news 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.