Calendario de Discourse (y evento)

[Discourse]

	Resumen	Discourse Calendar and Event agrega funciones de calendario y eventos dinámicas e interactivas a tu sitio de Discourse.
	Guía de instalación	Este plugin está incluido en el núcleo de Discourse. No es necesario instalar el plugin por separado.

Dado que este es un plugin #oficial mantenido por el equipo de Discourse, las solicitudes de #soporte, #bugs, ux y #funcionalidades pueden realizarse en las categorías correspondientes aquí en Meta, y etiquetarse con la etiqueta del plugin adecuada. Haz clic en un enlace a continuación para iniciar uno.

 Soporte  Error  UX  Funcionalidad

Habilitar el calendario (y eventos)

El plugin Calendario se puede habilitar mediante el interruptor o desde su configuración, ambos accesibles desde tu página admin/plugins:

Características

No es sorprendente que Discourse Calendar (y Eventos) agregue tanto las funciones de calendario como de eventos a tu sitio de Discourse. Con estas, puedes crear calendarios de temas individuales para rastrear ocasiones o cronologías importantes, mostrar calendarios en categorías, agregar un calendario de vacaciones para marcar vacaciones, ausencias o días de enfermedad, crear temas de eventos interactivos, así como mostrar un resumen de calendario de fácil acceso de todos tus próximos eventos.

Calendarios

Se pueden crear calendarios personalizados en múltiples temas, y aquellos que desees dar mayor visibilidad se pueden mostrar encima de la lista de temas de una categoría.

Puedes encontrar información más detallada sobre cómo crear y usar calendarios en:

Creating and managing calendars

This guide explains how to create and manage calendars in Discourse using the Calendar (and Event) plugin. Required user level: All users Calendars are a powerful feature in Discourse that allow you to organize and display events within your community. This guide will walk you through the process of creating calendars, adding events, and managing them effectively. Summary Enable the Calendar plugin Create a calendar in a topic or category Add events to you…

Eventos

La función de Eventos permite insertar elementos interactivos en los temas que tus miembros pueden usar para registrarse y asistir o participar en las actividades de tu comunidad. Todos estos se resumen en un calendario dedicado a todo el sitio, con la opción de agregar un enlace de fácil acceso a tu menú de navegación. Puedes encontrar más información sobre cómo crear y usar esta función en:

Creating and managing events

This guide explains how to create and manage events using the Calendar (and Event) plugin in Discourse. It covers how to create events, set event options, interact with events, and view the upcoming events calendar. Required user level: All users (with appropriate permissions) Enabling events Events are a feature of the Calendar (and Event) plugin. To use this feature: Enable the Calendar (and Event) plugin Configure related settings For detailed instruct…

Esto no debe confundirse con el plugin Eventos de Pavilion (nota el plural)

Configuración del calendario

Nombre	Descripción
calendar enabled	Habilita el plugin discourse-calendar. Esto agregará soporte para una etiqueta [calendar][/calendar] en la primera publicación de un tema.
holiday calendar topic id	ID del tema del calendario de vacaciones/ausencias del personal.
holiday status emoji	Define el emoji utilizado para el estado de vacaciones.
delete expired event posts after	Las publicaciones con eventos caducados se eliminarán automáticamente después de (n) horas. Establece en -1 para deshabilitar la eliminación.
all day event start time	Los eventos que no tienen una hora de inicio especificada comenzarán a esta hora. El formato es HH:mm. Para las 6:00 a. m., ingresa 06:00.
all day event end time	Los eventos que no tienen una hora de finalización especificada finalizarán a esta hora. El formato es HH:mm. Para las 6:00 p. m., ingresa 18:00.
calendar categories	Muestra un calendario en la parte superior de una categoría. Los ajustes obligatorios son categoryId y postId. ej: categoryId=6;postId=453[1] Otros ajustes válidos: tzPicker[2], weekends[3] y defaultView[4].
calendar categories outlet	Permite cambiar qué outlet debe mostrar el calendario de la categoría.
working days	Establece los días laborables. Puedes mostrar la disponibilidad de un grupo usando la etiqueta timezones en una publicación, ej: [timezones group=admins][timezones]
working day start hour	Hora de inicio de las horas laborables.
working day end hour	Hora de finalización de las horas laborables.
close to working day hours extension	Establece el tiempo de extensión en las horas laborables para resaltar las zonas horarias.
calendar automatic holidays enabled	Establece automáticamente el estado de vacaciones según la región de un usuario (nota: puedes deshabilitar vacaciones automáticas específicas en la configuración del plugin).
map events title	Asigna el título del calendario de la barra lateral basado en la categoría. Por defecto es “Próximos eventos”.

Configuración de eventos

Nombre	Descripción
discourse post event enabled	Habilita las funciones de Eventos. Nota: también se requiere que calendar enabled esté habilitado.
discourse post event allowed on groups	Grupos que tienen permiso para crear eventos.
displayed invitees limit	Limita el número de invitados mostrados en un evento.
display post event date on topic title	Muestra la fecha del evento después del título del tema.
use local event date	Usa la fecha local después del título del tema en lugar del tiempo relativo.
discourse post event edit notifications time extension	Extiende (en minutos) el período después del final de un evento cuando los invitados going aún reciben notificaciones de edición en la publicación original.
discourse post event allowed custom fields	Permite que cada evento establezca el valor de campos personalizados.
events calendar categories	Muestra un calendario de eventos en la parte superior de una categoría.
sort categories by event start date enabled	Habilita la ordenación de temas de categoría por fecha de inicio del evento.
disable resorting on categories enabled	Permite que las categorías deshabiliten la capacidad de los usuarios para ordenar en la categoría de eventos.
sidebar show upcoming events	Muestra el enlace de próximos eventos en la barra lateral bajo ‘Más’. Requiere post event enabled.
map events to color	Asigna un color de evento a una etiqueta o categoría específica

El endpoint discourse-post-event/events.json ahora tiene un parámetro agregado para cambiar entre respuestas simples y detalladas. Para obtener la respuesta detallada, puedes agregar ?include_details=true:

/discourse-post-event/events.json?include_details=true

Integraciones con otros plugins

Puedes usar un componente de este plugin con Right Sidebar Blocks. Deberás asegurarte de que la ruta deseada esté habilitada en el componente de Right Sidebar Blocks. El nombre del bloque será upcoming-events-list. Históricamente, se requerían configuraciones adicionales en el propio plugin Calendario, pero esto se ha simplificado.

Así es como aparecerá el calendario de la barra lateral por defecto.

Si no quieres la hora, puedes agregar un valor timeFormat vacío en la configuración del bloque del componente.

¿Alojado por nosotros? Este plugin está disponible en nuestros niveles Business y Enterprise Calendar | Discourse - Civilized Discussion

---

1. categoryId es la categoría sobre la cual se mostrará el calendario.
   postId es la publicación en la que colocaste el calendario con [calendar][/calendar]. ↩︎

2. puede mostrar un selector de zona horaria en la parte superior derecha del calendario. Por defecto es Falso, puedes habilitarlo con tzPicker=true. ↩︎

3. puede ocultar los sábados y domingos del calendario. Por defecto es Verdadero. Puedes establecerlo en Falso con weekends=false. ↩︎

4. defaultView establecerá la vista del calendario (día, semana, etc.). Se puede establecer como:
   
   defaultView=agendaDay
defaultView=agendaWeek
defaultView=month (por defecto)
   defaultView=listNextYear ↩︎

[martyn_thomas]

Este plugin es prometedor, pero faltan algunas funciones que nos impiden cambiar desde el plugin de Pavilion.

• Mostrar eventos no de día completo con la hora de inicio en el calendario; actualmente, todos los eventos parecen de día completo.

• Botón “Añadir evento” en el compositor, junto al selector de etiquetas (no oculto en el engranaje).

• Limitar qué categorías pueden tener eventos y si los eventos son obligatorios en una categoría.

Agradable de tener:

• Los metadatos de eventos en el tema solo aparecen/se introducen en la parte superior del tema (en lugar de donde esté el cursor).
• Capacidad de limitar qué grupos pueden crear eventos en una categoría (por ejemplo, solo el grupo ‘EventPlanners’ puede crear eventos en la categoría ‘Discussion’, pero todos los usuarios pueden crear temas que no sean eventos (o editar temas si el tema está configurado como Wiki).
• Cambiar la URL de /upcoming-events a /calendar.

[pokapow]

Hola,\nGracias por este trabajo.\n\nTengo 2 preguntas de UX:\n\n- ¿Es posible mostrar el botón "Agregar evento" junto al botón "Agregar ubicación" en el editor de temas? ¿Como era el caso con el plugin pavillion?\n\n\n- ¿Existe la posibilidad de agregar una entrada de menú superior de Calendario? No la encuentro en la configuración\n

[AstonJ]

¡Esto se ve genial! Algunas ideas/preguntas:

¿Tengo razón al suponer que para crear un calendario simplemente se crea un nuevo hilo/tema y se pega lo siguiente en él?

Nombre del Calendario

[calendar]
[/calendar]

Luego, para agregar entradas al calendario, simplemente se hace una nueva publicación en el mismo hilo con algo como lo siguiente (haciendo clic en el icono insertar hora/fecha en las opciones de publicación):

Nombre del Evento/Entrada

[date-range from=2024-04-18 to=2024-04-19 timezone="Europe/London"]

Esto agrega la entrada al calendario, lo cual es genial, sin embargo:

• ¿Hay alguna forma de agregar entradas a un calendario pero permitir que esas entradas tengan también un hilo/tema dedicado? (Veo que puedes agregar eventos en nuevos hilos, pero no parece haber ninguna forma de agregar esos eventos a un calendario).
• ¿Hay alguna forma de destacar los ‘Próximos Eventos’ de un calendario específico en los correos electrónicos de resumen? ¿O tal vez en la columna de la izquierda, y que cada entrada enlace al hilo dedicado para esa entrada?

Si esto no es posible actualmente, ¿tienen algún plan para agregarlo?

[haozi (耗子)]

@vinothkannans ¿Podrías ayudarme a revisar esta pr?

FEATURE: add China holidays and region

[putty (Derek Putnam)]

¿Hay planes para agregar una fuente de URL a la que los usuarios puedan suscribirse? Estoy seguro de que sería complicado para todos los eventos frente a los que han confirmado asistencia.

En segundo lugar, sería increíble una capa adicional si pudiera reconocer eventos privados (o tal vez eso es solo una fuente de URL diferente por grupo).

[jordan-violet]

@putty

¿Hay planes para agregar un feed de URL al que los usuarios puedan suscribirse? Estoy seguro de que sería complicado para todos los eventos frente a los que han confirmado asistencia.

Finding Discourse RSS feeds

A reference list of all the RSS feeds available in Discourse. Required user level: All users Here’s a list of most of the available RSS feeds in Discourse. RSS is a standardised, computer-readable format for content that allows it to be shared between sites and platforms easily. RSS links that contain an ID (categories, topics, badges, etc.) are defined by their ID. The links won’t break if the slug part of the URL changes, but the slug…

Sin embargo, no hay un feed RSS para la URL de /upcoming-events: ¡eso sería una buena adición!

[pokapow]

¿Qué pasa con la sincronización de CalDAV?

[Matthias_Schuster (Matthias)]

Esa también sería una razón para mí para cambiar, de hecho.

[Heliosurge (Dan DeMontmorency)]

Esto necesita más actualización ya que menciona una inserción de evento en el compositor y la adición de detalles del evento no como se muestra en la imagen. ¿A menos que Event fuera un complemento?

[Isambard]

He instalado el complemento y la etiqueta del calendario funciona en la primera publicación de un tema. Pero no veo ninguna opción de evento o calendario en el menú de engranaje:

¿Alguien puede explicarme qué necesito hacer para obtener la opción de evento en el menú de engranaje?

[JammyDodger]

Necesitas habilitar la parte de Eventos del plugin discourse post event enabled

[Isambard]

Gracias. De alguna manera me perdí esta configuración.

[Heliosurge (Dan DeMontmorency)]

¿Cómo hago para que el evento de creación se muestre en un tema de categoría con respuestas que son eventos?

Veo que la creación de eventos funciona para crear nuevos temas. Pero busco tener un calendario en un tema con respuestas que añadan eventos. Funciona parcialmente con la inserción de fecha, pero no es tan bueno como la creación de eventos, que tiene más opciones.

[eve (Phú)]

Actualmente, los usuarios pueden establecer la región en las preferencias de su perfil.

Me gustaría permitirles establecer su región durante el registro mostrando este campo en el formulario de registro. ¿Es factible?

[joo (slower)]

¿Seguirá apareciendo una respuesta eliminada en el calendario?

[tonninseteli (se oli tonnin seteli)]

No encuentro ninguna configuración para cambiar el primer día de la semana a lunes, ¿es trivial de implementar si falta?

Otro problema es que la entrada de hora y fecha está rota, si es un evento de todo el día debería haber una opción para seleccionarlo antes de que los campos de entrada de hora arruinen las fechas, y las fechas parecen cambiar aleatoriamente al editar.

También noté que es posible ingresar 00:00 tanto en la hora como en la fecha (lo que a veces funciona, a veces no), lo que lleva a que el calendario arroje un error que luego causará un conflicto con los borradores, lo que generará un error 422 repetido hasta que la página se revierta a una revisión anterior, luego se edite nuevamente, etc.

[joo (slower)]

@joo

Al activar esta automatización, el contenido “Última edición por” se añade automáticamente al calendario. Busco asesoramiento sobre si esto es un error o si es un problema con mi configuración. ¿Podría alguien ayudar a aclarar?

Por favor, consulta aquí

[Jagster (Jakke Flemming)]

@tonninseteli

No encuentro ninguna configuración para cambiar el primer día de la semana a lunes, ¿es trivial de implementar si falta?

No existe tal configuración y por eso no la uso. Y apuesto a que el equipo arreglaría ese error si fuera un truco trivial.