Por favor, documenten mejor el plugin Discourse Calendar

[mattdm (Matthew Miller)]

Continuando la discusión de Discourse Calendar — ya que mi publicación allí está a punto de ser eliminada automáticamente después de un mes.

La publicación principal que describe este plugin necesita algo de trabajo. Es realmente confusa. Específicamente:

Confusión de eventos

Parece haber tres cosas separadas, todas llamadas “evento”:

1. Lo más básico: una respuesta con [date], que se muestra en un calendario en la primera publicación del tema.
2. Una primera publicación de un tema que contiene [event], utilizada por la función opcional “estado alfa” descrita por separado aquí.
3. Un plugin completamente separado con un nombre similar: Events en lugar de Event.

Eso es… confuso.

Sintaxis poco clara para el evento básico de un solo tema

1. ¿Cómo se establece el nombre del evento? La descripción del plugin muestra texto con eventos, pero no cómo se estableció realmente.
2. ¿Cómo se crean eventos repetitivos?
3. El calendario de días festivos muestra colores. ¿Puede el calendario normal tener también colores y, en caso afirmativo, cómo?
4. La función separada de “eventos” aparentemente puede producir un feed ical. ¿Puede hacerlo un calendario “básico”?

Más preguntas sobre el calendario de días festivos

¿Utiliza la misma sintaxis que el calendario por tema o el de “evento”? ¿Se limita a “vacaciones del personal” o podría ser utilizado por cualquier persona que pueda responder a un tema determinado? ¿De dónde provienen los colores? ¿El emoji “Holiday flair” es modificable? ¿Es posible hacerlo visible para cualquier persona, o para algún grupo arbitrario, no solo para el personal?

Etc…

Algunas de estas cosas las he resuelto por mi cuenta o preguntando al soporte. Pero realmente necesita ser documentado en el tema de documentación del plugin.

Probablemente también sería bueno detallar algunas de las limitaciones, también — la fecha de inicio de la semana no sigue tu configuración regional y no es configurable, todo el asunto está confundido sobre las zonas horarias… y si hay una hoja de ruta o planes para abordar algunas de estas cosas o agregar nuevas funciones (¡o si no los hay!), por favor, dilo también.

¡Gracias! Esta es una pequeña y útil función de Discourse que podría ser muy útil para muchas personas, pero también es bastante confusa.

[nathank (Nathan Kershaw)]

Esa publicación es una wiki, por lo que puedes hacer tus propias contribuciones fácilmente. Eso sería de gran ayuda para todos.

[mattdm (Matthew Miller)]

¡Puedo, aunque algunas cosas solo serán suposiciones!

[JammyDodger]

Avisté esto en Temas Relacionados mientras actualizaba los temas de Calendario y Eventos (otra victoria para Temas Relacionados )

Acabo de reorganizarlos para que ambas funciones aparezcan ahora correctamente como un tema de plugin, lo que debería eliminar algo de confusión:

Discourse Calendar (and Event)

Summary Discourse Calendar and Event adds dynamic and interactive calendar and event features to your Discourse site. Install Guide This plugin is bundled with Discourse core. There is no need to install the plugin separately. Enabling Calendar (and Event) The Calendar plugin can be enabled either by the toggle or from its settings, both accessible from your admin/plugins page: [/admin/plugins] Features Somewhat unsurprisingly, Discourse Calendar …

También he dividido muchos de los detalles de ‘cómo hacerlo’ en un par de guías para darles un respiro:

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…

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…

El enfoque principal fue darles una estructura más consistente (aunque he añadido una rápida actualización para mejorar). Fueron un poco espinosos de suavizar, pero creo que están en mejor forma de lo que estaban. Después de haber dormido sobre ello, creo que hay algunas cosas que todavía me gustaría hacer, así que no voy a lanzar el todavía.

Pero espero que nos estemos moviendo en la dirección correcta.