Por favor, documente melhor o plugin Discourse Calendar

[mattdm (Matthew Miller)]

Continuando a discussão de Discourse Calendar — já que minha postagem lá será excluída automaticamente após um mês.

A postagem principal que descreve este plugin precisa de alguns ajustes. É realmente confusa. Especificamente:

Confusão de Eventos

Parecem existir três coisas separadas chamadas “evento”:

1. O mais básico: uma resposta com [date], que é exibida em um calendário na primeira postagem do tópico.
2. Uma primeira postagem em um tópico que contém [event], usada pelo recurso opcional “estado alfa” descrito separadamente aqui.
3. Um plugin completamente separado com um nome semelhante: Events em vez de Event.

Isso é… confuso.

Sintaxe pouco clara para o evento básico de tópico único

1. Como definir o nome do evento? A descrição do plugin mostra texto com eventos, mas não como isso foi realmente definido.
2. Como criar eventos recorrentes?
3. O calendário de feriados mostra cores. O calendário regular também pode ter cores e, se sim, como?
4. O recurso “eventos” separado pode aparentemente produzir um feed ical. Um calendário “básico” pode?

Mais perguntas sobre o calendário de feriados

Ele usa a mesma sintaxe do calendário por tópico ou do “evento”? Ele se limita a “feriados da equipe” ou pode ser usado por qualquer pessoa que possa responder a um determinado tópico? De onde vêm as cores? O emoji “Flair de feriado” é mutável? É possível torná-lo visível para qualquer pessoa, ou para um grupo arbitrário, não apenas para a equipe?

Etc…

Algumas dessas coisas eu descobri sozinho ou perguntando ao suporte. Mas realmente precisa ser documentado no tópico de documentação do plugin.

Provavelmente também seria bom detalhar algumas das limitações — a data de início da semana não segue seu local e não é configurável, todo o sistema está confuso sobre fusos horários… e se há um roteiro ou planos para abordar algumas dessas coisas ou adicionar novos recursos (ou se não há!), por favor, diga isso também.

Obrigado! Este é um recurso útil do Discourse que poderia ser muito útil para muitas pessoas, mas também é bastante confuso.

[nathank (Nathan Kershaw)]

Essa postagem é uma wiki - então você pode fazer suas próprias contribuições para ela facilmente. Isso seria muito útil para todos.

[mattdm (Matthew Miller)]

Eu posso, embora algumas coisas sejam apenas suposições!

[JammyDodger]

Encontrei isto em Tópicos Relacionados enquanto fazia uma atualização dos tópicos de Calendário e Eventos (mais uma vitória para Tópicos Relacionados )

Acabei de reorganizá-los para que ambos os recursos agora apareçam corretamente como um tópico de plugin, o que espero que remova alguma confusão:

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 …

Também dividi muitos dos detalhes de ‘como fazer’ em alguns guias para lhes dar algum espaço:

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…

O foco principal foi dar-lhes uma estrutura mais consistente (embora eu tenha adicionado uma rápida atualização para garantir). Eles foram um pouco espinhosos para suavizar, mas acho que estão em melhor forma do que estavam. Tendo dormido sobre isso, acho que há algumas coisas que ainda gostaria de fazer, então ainda não vou usar o .

Mas espero que estejamos indo na direção certa.