Esta guía explica cómo crear y administrar calendarios en Discourse usando el plugin Calendar (and Event).
Nivel de usuario requerido: Todos los usuarios
Los calendarios son una característica potente en Discourse que te permite organizar y mostrar eventos dentro de tu comunidad. Esta guía te guiará a través del proceso de creación de calendarios, adición de eventos y su gestión efectiva.
Resumen
- Habilitar el plugin Calendar
- Crear un calendario en un tema o categoría
- Añadir eventos a tu calendario
- Administrar opciones y configuraciones del calendario
- Usar la función de calendario de días festivos
Habilitación del plugin Calendar
Antes de poder crear calendarios, asegúrate de que el plugin “Calendar (and Event)” esté habilitado en tu instancia de Discourse. Para más detalles sobre cómo habilitar el plugin y su configuración relacionada, consulta la documentación del plugin Discourse Calendar and Event.
Creación de un calendario
Calendario de tema
Para incrustar un calendario en un tema:
-
Crea un nuevo tema o edita la primera publicación de un tema existente
-
Agrega el siguiente código en líneas separadas:
[calendar] [/calendar] -
Publica o actualiza la publicación
El primer día de la semana por defecto es el lunes, pero se puede configurar usando la configuración del sitio “calendar first day of week” (opciones: Sábado, Domingo o Lunes).
Calendario de categoría
Para crear un calendario a nivel de categoría:
-
Ve a
/admin/site_settings/category/discourse_calendar?filter=plugin=discourse-calendar -
En la configuración “calendar categories”, añade una entrada con el siguiente formato:
categoryId=123;tzPicker;defaultView=month- Reemplaza
123con el ID de tu categoría (que se encuentra en la URL al ver la categoría)
- Reemplaza
-
Añade el ID de la categoría a la configuración “events calendar categories”
-
Opcionalmente, configura “discourse post event allowed on groups” para controlar qué grupos pueden añadir eventos
Adición de elementos a un calendario
Calendario de tema
Para añadir un evento a un calendario de tema:
- Responde al tema que contiene el calendario
- Abre el menú de opciones ⊕ en la barra de herramientas del compositor y usa la función “Insertar fecha / hora” para añadir una fecha o un rango de fechas
- Añade una descripción encima de la fecha
- Envía la respuesta
El evento aparecerá en el calendario después de recargar el tema.
Calendario de categoría
Para añadir un evento a un calendario de categoría:
- Crea un nuevo tema en la categoría
- Abre el menú de opciones ⊕ en la barra de herramientas del compositor y selecciona “Crear evento”
- Rellena los detalles del evento y publica
El evento aparecerá en el calendario de la categoría.
Opciones del calendario
Puedes personalizar tu calendario usando varias opciones:
| Opción | Ejemplo | Descripción |
|---|---|---|
| Ocultar fines de semana | weekends="false" |
Oculta sábado y domingo |
| Ocultar días específicos | hiddenDays="1,2" |
Oculta lunes y martes (usa 0-6 para domingo-sábado) |
| Establecer vista predeterminada | defaultView="month" |
Opciones: month, week, listNextYear |
| Ignorar zonas horarias | fullDay="true" |
Trata todos los eventos como eventos de día completo |
Ejemplo de uso:
[calendar weekends="false" hiddenDays="1,2" defaultView="week" fullDay="true"]
[/calendar]
Eliminación de elementos del calendario
Los elementos del calendario se pueden eliminar de las siguientes maneras:
- Los elementos de calendario caducados se pueden eliminar automáticamente usando la configuración “delete expired event posts after”
- Usa temporizadores de temas para eliminar publicaciones automáticamente
- Elimina publicaciones manualmente según sea necesario
Calendario de días festivos
El calendario de días festivos es una característica especial para gestionar las vacaciones del personal del sitio:
- Crea un tema con un calendario en la primera publicación
- Establece “holiday calendar topic id” al ID de este tema
- Las respuestas a este tema se tratarán como tiempo de vacaciones para el usuario que publica
- Cada respuesta debe contener una marca de fecha/hora añadida a través de la función “Insertar fecha / hora” en el menú de opciones ⊕ del compositor para que aparezca en el calendario
- Las entradas de vacaciones se colorean automática y aleatoriamente
- Aparece un emoji (predeterminado:
) junto a los nombres de los usuarios de vacaciones en las tarjetas de usuario y @menciones - Opcionalmente, incluye días festivos específicos de la localización para los usuarios habilitando “calendar automatic holidays enabled”
Preguntas frecuentes
P: ¿Por qué algunos eventos parecen abarcar varios días?
R: El calendario siempre está en UTC. Usa las configuraciones “all day event start time” y “all day event end time” para ajustar las diferencias de zona horaria.
P: ¿Puedo controlar los colores de las entradas del calendario?
R: Para los calendarios de categoría y los eventos próximos, puedes asignar colores por etiqueta o categoría usando la configuración del sitio “map events to color”. Las entradas del calendario de días festivos se colorean automática y aleatoriamente y no se pueden personalizar.
P: ¿Cómo muestro los eventos pasados en una vista de lista?
R: Actualmente hay un error al usar defaultView=listNextYear que hace que la vista inicial esté vacía. Como solución alternativa, los usuarios deben cambiar a la vista mensual, retroceder un mes y luego volver a la vista de lista para ver los eventos pasados.