Calendario y eventos de Discourse

[Discourse]

	Resumen	Discourse Calendar and Events añade funciones dinámicas e interactivas de calendario y eventos a tu sitio de Discourse.
	Guía de instalación	Este plugin viene incluido con el núcleo de Discourse. No es necesario instalar el plugin por separado.

Al ser un #plugin_oficial mantenido por el equipo de Discourse, las solicitudes de #soporte, #contribuir:errores, #contribuir:ux y #contribuir:funciones pueden realizarse en las categorías correspondientes aquí en Meta, y etiquetadas con la etiqueta adecuada del plugin. Haz clic en un enlace a continuación para iniciar uno.

Soporte Error UX Función

Habilitar Calendario y Eventos

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

Funciones

Como era de esperar, Discourse Calendar and Events añade tanto las funciones de calendario como de eventos a tu sitio de Discourse. Con ellas, puedes crear calendarios de temas individuales para seguir ocasiones importantes o cronologías, mostrar calendarios en categorías, añadir un calendario de días festivos 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 varios temas, y aquellos a los que desees dar mayor visibilidad se pueden mostrar encima de la lista de temas de una categoría.

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

Creación y gestión de calendarios

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…

Eventos

La función de Evento permite insertar elementos interactivos en los temas que tus miembros pueden usar para inscribirse y asistir o participar en las actividades de tu comunidad. Todo esto se resume en un calendario dedicado a todo el sitio, con la opción de añadir 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:

Crear y gestionar eventos

Esta guía explica cómo crear y gestionar eventos utilizando el plugin Calendario y Eventos en Discourse. Cubre cómo crear eventos, configurar opciones de evento, interactuar con eventos y ver el calendario de próximos eventos. Nivel de usuario requerido: Todos los usuarios (con los permisos adecuados) Habilitar eventos Los eventos son una función del plugin Calendario y Eventos. Para utilizar esta función: Habilita el plugin Calendario y Eventos Configura l…

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

Configuración del Calendario

Nombre	Descripción
calendar enabled	Habilita el plugin discourse-calendar. Esto añadirá soporte para la etiqueta [calendar][/calendar] en el primer post 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	Los posts con eventos expirados se eliminarán automáticamente después de (n) horas. Establece en -1 para desactivar 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., introduce 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., introduce 18:00
calendar categories	Muestra un calendario en la parte superior de una categoría. Las configuraciones obligatorias son categoryId y postId. ej: categoryId=6;postId=453[1] Otras configuraciones válidas: tzPicker[2], weekends[3] y defaultView[4].
calendar categories outlet	Permite cambiar qué outlet debe mostrar el calendario de la categoría.
working days	Establecer días laborables. Puedes mostrar la disponibilidad de un grupo usando la etiqueta timezones en un post, 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	Establecer tiempo de extensión en las horas laborables para resaltar las zonas horarias.
calendar automatic holidays enabled	Establecer automáticamente el estado de día festivo basado en la región de un usuario (nota: puedes desactivar días festivos automáticos específicos en la configuración del plugin)
map events title	Título del calendario de la barra lateral basado en la categoría. Predeterminado: “Próximos eventos”

Configuración de Eventos

Nombre	Descripción
discourse post event enabled	Habilita las funciones de Evento. Nota: también necesita que calendar enabled esté habilitado.
discourse post event allowed on groups	Grupos que tienen permitido 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 de 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 están siendo notificados por edición en el post original.
discourse post event allowed custom fields	Permite que cada evento establezca el valor de los 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 clasificación de los temas de categoría por fecha de inicio del evento.
disable resorting on categories enabled	Permite a las categorías deshabilitar 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 especificada

El punto final discourse-post-event/events.json ahora tiene un parámetro añadido para alternar entre respuesta simple y detallada. Para obtener la respuesta detallada puedes añadir ?include_details=true:

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

Eventos en directo

Para eventos en directo, utiliza la función de transmisión en directo para permitir que los miembros vean un evento y participen en el chat al mismo tiempo.

Un evento de transmisión en directo incluye:

• Una transmisión de vídeo (usando YouTube, por ejemplo)
• Un evento de calendario usando Discourse Calendar and Events
• Un canal de chat que se crea automáticamente para el evento

Requisitos previos para eventos en directo

Para usar eventos en directo, debes tener chat enabled, ya que la transmisión en directo crea un canal de chat para acompañar tu evento, además de discourse post event enabled y calendar enabled.

Crear un evento en directo

Para crear un evento en directo:

1. Abre un nuevo tema.
2. Selecciona el icono + en la barra de herramientas del compositor y haz clic en Create Event (si el evento no se había añadido ya a tu tema).
3. Pega el enlace al vídeo del evento (por ejemplo, una URL de YouTube) en el campo de ubicación/URL.
4. Activa el interruptor “livestream”

Luego verás que se ha creado el evento y la transmisión en directo, junto con un canal de chat acompañante en el lado derecho.

Una vez que cualquier usuario pulse Going en el evento, se unirán automáticamente al canal de chat, ¡lo que les permitirá participar en la conversación!

Integraciones con Otros Plugins

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

Así es como aparecerá el calendario de la barra lateral de forma predeterminada.

Si no quieres la hora, puedes añadir un valor vacío timeFormat 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 en la que se mostrará el calendario en la parte superior.
   postId es el post en el que colocas el calendario con [calendar][/calendar] ↩︎

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

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

4. defaultView establecerá la vista del calendario (día, semana, etc.). Puede establecerse como:
   
   defaultView=agendaDay
   defaultView=agendaWeek
   defaultView=month (predeterminado)
   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]

¿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.