Calendario Discourse - ¿Cómo hacerlo?

Hello All,
First time Discourse installer / maintainer. Long time user.
I"m feeling a bit lost with some of the plug ins and apparent lack of documentation. My focus at the moment is the Discourse Calendar plugin.
I have found 2 threads.
The actual plug in - Discourse Calendar
A request for help How to use the calendar plugin?

Neither really explain how to use the plugin other than creating the main calendar in a first post, and how to add events to that main calendar in replies to the same post.
The screen shots show multiple colors which makes me think there may be a way for a calendar to draw from multiple categories?

In the plugin settings, there is also calendar categories setting, but I’m unclear on how to use this. I was able to get a calendar to appear at the top of a Category display page, but it is empty.
I’m currently using categoryId=7;postId=19 where catagory 7 is the catagory I want the calendar to appear at the top of. Then I wasn’t clear on postID. I tried a post that as an event in it. A post that has a calendar as the first post and dates as replies. The calendar appears at the top of the Catagory (in a misshaped non scrollable box), but no events appear on it, regardless of what postID I use.

The helper text also offers Other valid settings: tzPicker, weekends and defaultView.
but no explanation of how or what those do or how to use them.

So in short, I’m looking for any pointers, or links to something that explains the plugin with a bit more detail.

Ultimately what I’m hoping for is some way to have a calendar that is able to read into multiple posts in a Category. What I’m doing now is instructing users to create 2 posts. Create a new topic and add an Event. Include the description of the event etc… This is the thread for discussion about the event.
Then I tell them to copy the link to that topic, and go to the pinned “Master Event Calendar” topic and reply to that inserting a date, and then pasting the link to the Event. That way the Master Event Calendar topic calendar has all of the events, but there are separate topics to allow for discussion about the events.

It feels like there has to be a better way, but I don’t know what it is.

Thanks very much for any insight.

6 Me gusta

Hi!
Postid is to be found in the json and is the Id of the post where the calendar is declared (not the topic Id)

About the color coded events, I believe those come (for now :sweat_smile: ) from the plugin events (but I might have missed a commit!)

And maybe this can answer some of your questions:

Thanks very much. PostID vs TopicID is where I was going wrong. That has cleared that up. I still wish there as a “man page” or something equivalent for all possible variables and inputs on the plugin, but I’ll keep playing with it.

Also thanks for the link to the Event Plugin. As the post your link lead to, it is confusing how Calendar vs Date vs event are linked and not linked considering that the Event Plugin is part the Calendar Plug.

4 Me gusta

@ben_t, tu caso de uso describe exactamente el tipo de funcionalidad que esperaba… varios grupos podrían tener hilos de discusión sobre sus eventos, pero mediante la creación de su evento en sus temas, se llenaría el Calendario Maestro de Eventos, que contendría todos los eventos de todos los grupos. Luego, los lectores del calendario principal de eventos podrían hacer clic en cualquier elemento del calendario y ser llevados al hilo del evento.

No me malinterpretes; tal como está, aprecio la idea de un evento en un hilo que no llegue al calendario principal de eventos (por ejemplo, un grupo pequeño que celebre reuniones de planificación antes del gran evento en el calendario principal),

Sin embargo, creo que nuestro caso de uso sería una gran función para tener, ya que puedo ver varias implementaciones (calendarios deportivos escolares, tablones de anuncios comunitarios…).

De paso, descubrí una forma alternativa de crear el tema donde tienes el calendario en el primer mensaje y luego respondes al calendario con fechas que se agregan al mensaje principal… sin entrar en la configuración y contar los números de los hilos…
En algún lugar del primer mensaje, coloca:

[calendar]
[/calendar]

Lo encontré en la [página de GitHub|Discourse Calendar (and Event)].
Creo que podría haberse añadido después de que publicaste esto.

… Me voy a averiguar lo de los colores! :smiley:

¿Alguien puede compartir los pasos para encontrar el Postid para declarar el calendario? Estoy atascado en este paso y agradecería mucho la ayuda.

Editar: ¡lo encontré! En caso de que alguien tenga problemas, puede seguir los siguientes pasos para encontrar el postId. Tomemos este tema como ejemplo:

https://meta.discourse.org/t/discourse-calendar-how-to/165536/5

  1. Elimina el slug del tema para que se vea así: https://meta.discourse.org/t/165536/5
  2. Elimina el número de la publicación al final (/5) y reemplázalo con /posts.json, para que la URL se vea así;
    https://meta.discourse.org/t/165536/posts.json
  3. Abre la URL y encontrarás el postId requerido en la primera línea:
  4. Pega la URL en la configuración del plugin del calendario, por lo que en nuestro ejemplo se vería algo así:
  5. Tu calendario en la categoría ahora debería mostrar todas las entradas [date] de ese tema.
5 Me gusta

¿Alguien puede responder qué son estas configuraciones? No he podido encontrar ninguna referencia a ellas excepto en esta publicación y no hay explicación. :sadpanda:

1 me gusta
[calendar weekends="false"]
[/calendar]

ocultaría los fines de semana.

[calendar defaultView="listNextYear"]
[/calendar]

mostraría la vista de lista por defecto (otras opciones son month o basicWeek).

[calendar tzPicker="true"]
[/calendar]

permitiría al usuario elegir la zona horaria en la esquina superior derecha del calendario.

4 Me gusta

Útil, pero ¿significa eso que esta información para la configuración no es aplicable, o simplemente establece la configuración predeterminada para el calendario en la publicación especificada?

:thinking: Lo siento, no estoy seguro de entender la pregunta :sweat_smile:
Diría que la configuración se establece por elemento, es decir, para un calendario (que está en la publicación especificada)

Mis disculpas por la confusión.
En la configuración del calendario de Discourse, ves la imagen que publiqué anteriormente.
Requiere categoryId y postID y luego indica la configuración válida, pero no qué hacen en esa instancia.

Me pregunto si este es un caso de texto de ayuda deficiente o de mala comprensión de cómo funcionan estas configuraciones en relación con la configuración de “categorías de calendario”.

Por mis pruebas, no veo que suceda nada, pero podría estar equivocado. :smiley:

1 me gusta

Oh, no te preocupes, mi inglés es como un queso suizo, mayormente agujeros, de ahí la duda.

Creo que debería funcionar sin las comillas dobles, por ejemplo:
categoryId=31;postId=4867;tzPicker=true;weekends=false

2 Me gusta

Descubrí que cambiarías
meta.discourse.org/t/discourse-calendar-how-to/165536/6
a
meta.discourse.org/t/discourse-calendar-how-to/165536.json

1 me gusta

De acuerdo. Creo que a veces las instrucciones están escritas desde la perspectiva de un desarrollador y necesitan más información paso a paso e imágenes para un lego. El calendario podría usar un Theme component para hacer la configuración más clara dentro de un tema o algo así.

2 Me gusta

No terminé usando el calendario de Temas Principales, porque la forma fácil de crear un evento es siempre la primera publicación de un tema y de todos modos lo usarías para el calendario, no para eventos.

Pude editar la primera publicación de temas existentes en subcategorías, luego el color de las subcategorías se mostró en el calendario mostrado de la categoría principal.

Además, mencionaste un componente temático, lo que sugiere ajustabilidad; el calendario del que estoy hablando, el implementado por la configuración de administrador de Calendario de Eventos por Categorías, me gustaría poder ajustarlo:

  • El tamaño del calendario en el sitio de escritorio, el sitio móvil se ve bien
  • El día en que comienza la semana

No estoy enumerando demasiadas cosas aquí porque no quiero disuadir a la gente, imagino que hubo problemas de desarrollo que significaron que se necesitaban diferentes formas para que un superusuario implementara discourse-calendar.

1 me gusta

Hasta donde he observado, no he visto un TC compañero del calendario. Sin embargo, podrías crear un Theme component personalizado usando el elemento de inspección en tu navegador para identificar y ajustar el tamaño del calendario en el escritorio. Solo asegúrate de ponerlo en el encabezado CSS del escritorio.

El equipo lanzó recientemente un plugin compañero para transmisiones en vivo. Eso podría ser de interés. Utiliza chat y calendario.

1 me gusta

Me gusta ese plugin, no es algo que haga con frecuencia :sweat_smile: Soy más de foros privados. Quizás algún día tenga suficiente dinero para transmitir en vivo revisiones de física.

Tanto para el calendario por categoría principal, sería bueno que Uncategorized (¿potencialmente?) mostrara un calendario en la página de inicio (o en la categoría General), y que fusionara los eventos de todas las demás categorías.

1 me gusta