Calendário e Eventos do Discourse

[Discourse]

	Resumo	Discourse Calendar and Events adiciona recursos de calendário e eventos dinâmicos e interativos ao seu site Discourse.
	Guia de Instalação	Este plugin já vem incluído no núcleo do Discourse. Não há necessidade de instalá-lo separadamente.

Como este é um plugin #oficial mantido pela equipe do Discourse, solicitações de #suporte, bug, ux e #recursos podem ser feitas nas respectivas categorias aqui no Meta, marcadas com a tag apropriada do plugin. Clique em um dos links abaixo para iniciar uma nova discussão.

 Suporte  Bug  UX  Recurso

Ativando Calendário e Eventos

O plugin Calendário e Eventos pode ser ativado tanto pelo interruptor quanto por suas configurações, ambos acessíveis na sua página admin/plugins:

Recursos

Não surpreendentemente, o Discourse Calendar and Events adiciona tanto os recursos de calendário quanto de eventos ao seu site Discourse. Com eles, você pode criar calendários individuais por tópico para acompanhar datas importantes ou cronogramas, exibir calendários em categorias, adicionar um calendário de feriados para marcar férias, ausências ou dias de doença, criar tópicos de eventos interativos, além de mostrar um resumo de fácil acesso de todos os seus próximos eventos.

Calendários

Calendários personalizados podem ser criados em múltiplos tópicos, e aqueles que você deseja dar maior visibilidade podem ser exibidos acima da lista de tópicos de uma categoria.

Você pode encontrar informações mais detalhadas sobre como criar e usar calendários em:

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

O recurso de Eventos permite inserir elementos interativos em tópicos, que seus membros podem usar para se inscreverem para participar das atividades da sua comunidade. Todos esses eventos são resumidos em um calendário dedicado em todo o site, com a opção de adicionar um link de fácil acesso ao seu menu de navegação. Você pode encontrar mais informações sobre como criar e usar este recurso em:

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 Events plugin. To use this feature: Enable the Calendar and Events plugin Configure related settings For detailed instructions…

Isso não deve ser confundido com o plugin Events do Pavilion (observe o plural)

Configurações do Calendário

Nome	Descrição
calendar enabled	Ativa o plugin discourse-calendar. Isso adicionará suporte à tag [calendar][/calendar] no primeiro post de um tópico.
holiday calendar topic id	ID do tópico do calendário de férias/ausência da equipe.
holiday status emoji	Define o emoji usado para o status de feriado.
delete expired event posts after	Posts com eventos expirados serão automaticamente excluídos após (n) horas. Defina como -1 para desativar a exclusão.
all day event start time	Eventos que não têm um horário de início especificado começarão neste horário. O formato é HH:mm. Para 6:00 da manhã, digite 06:00
all day event end time	Eventos que não têm um horário de término especificado terminarão neste horário. O formato é HH:mm. Para 18:00, digite 18:00
calendar categories	Exibe um calendário no topo de uma categoria. Configurações obrigatórias são categoryId e postId. Ex: categoryId=6;postId=453[1] Outras configurações válidas: tzPicker[2], weekends[3] e defaultView[4].
calendar categories outlet	Permite alterar qual outlet deve exibir o calendário da categoria.
working days	Define os dias úteis. Você pode exibir a disponibilidade de um grupo usando a tag timezones em um post, ex: [timezones group=admins][timezones]
working day start hour	Horário de início das horas do dia útil.
working day end hour	Horário de término das horas do dia útil.
close to working day hours extension	Define o tempo de extensão nas horas do dia útil para destacar os fusos horários.
calendar automatic holidays enabled	Define automaticamente o status de feriado com base na região do usuário (nota: você pode desativar feriados automáticos específicos nas configurações do plugin)
map events title	Mapeia o título do calendário da barra lateral com base na categoria. O padrão é “Próximos eventos”

Configurações de Eventos

Nome	Descrição
discourse post event enabled	Ativa os recursos de Eventos. Nota: também é necessário que calendar enabled esteja ativado.
discourse post event allowed on groups	Grupos que têm permissão para criar eventos.
displayed invitees limit	Limita o número de convidados exibidos em um evento.
display post event date on topic title	Exibe a data do evento após o título do tópico.
use local event date	Usa a data local após o título do tópico em vez do tempo relativo.
discourse post event edit notifications time extension	Estende (em minutos) o período após o fim de um evento em que os convidados com status going ainda são notificados sobre edições no post original.
discourse post event allowed custom fields	Permite que cada evento defina o valor de campos personalizados.
events calendar categories	Exibe um calendário de eventos no topo de uma categoria.
sort categories by event start date enabled	Ativa a ordenação de tópicos de categoria por data de início do evento.
disable resorting on categories enabled	Permite que categorias desabilitem a capacidade dos usuários de ordenar na categoria de eventos.
sidebar show upcoming events	Exibe o link de próximos eventos na barra lateral sob “Mais”. Requer post event enabled
map events to color	Atribui uma cor de evento a uma tag ou categoria específica

O endpoint discourse-post-event/events.json agora possui um parâmetro adicional para alternar entre respostas simples e detalhadas. Para obter a resposta detalhada, adicione ?include_details=true:

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

Integrações com Outros Plugins

Você pode usar um componente deste plugin com o Right Sidebar Blocks. Certifique-se de que a rota desejada esteja ativada no componente Right Sidebar Blocks. O nome do bloco será upcoming-events-list. Historicamente, havia configurações adicionais necessárias no próprio plugin Calendar, mas isso foi simplificado.

Assim é como o calendário da barra lateral aparecerá por padrão.

Se você não quiser o horário, pode adicionar um valor vazio timeFormat na configuração do bloco do componente.

Hospedado por nós? Este plugin está disponível em nossos planos Business e Enterprise Calendar | Discourse - Civilized Discussion

---

1. categoryId é a categoria na qual o calendário será exibido no topo.
   postId é o post no qual você inseriu o calendário com [calendar][/calendar] ↩︎

2. pode exibir um seletor de fuso horário no canto superior direito do calendário. Padrão é falso, você pode ativá-lo com tzPicker=true ↩︎

3. pode ocultar sábados e domingos do calendário. Padrão é verdadeiro. Você pode definir como falso com weekends=false. ↩︎

4. defaultView define a visualização do calendário (dia, semana, etc.). Pode ser definido como:
   
   defaultView=agendaDay
defaultView=agendaWeek
defaultView=month (padrão)
   defaultView=listNextYear ↩︎

[martyn_thomas]

Este plugin é promissor - mas faltam alguns recursos que nos impedem de migrar do plugin do Pavilion

• Exibir eventos não de dia inteiro com a hora de início no calendário, atualmente todos os eventos parecem eventos de dia inteiro.

• Botão ‘Adicionar Evento’ no composer ao lado do seletor de tags (não escondido na engrenagem)

• Limitar quais categorias podem ter eventos e se os eventos são obrigatórios em uma categoria

Desejáveis:

• Metadados de evento no tópico aparecem/são inseridos apenas no topo do tópico (em vez de onde o cursor estiver)
• Capacidade de limitar quais grupos podem criar eventos em uma categoria (por exemplo, apenas o grupo ‘EventPlanners’ pode criar eventos na categoria ‘Discussion’, mas todos os usuários podem criar tópicos que não sejam eventos (ou editar tópicos se o tópico estiver definido como Wiki)
• Alterar a URL de /upcoming-events para /calendar

[pokapow]

Olá,\nObrigado por este trabalho.\n\nTenho 2 perguntas de UX:\n\n- É possível exibir o botão "Adicionar evento" ao lado do botão "Adicionar local" no editor de tópicos? Como era o caso com o plugin pavillion?\n\n\n- Existe a possibilidade de adicionar a entrada do menu superior Calendário? Não encontro nas configurações\n

[AstonJ]

Isto parece ótimo! Algumas ideias/perguntas:

Estou correto em assumir que para criar um calendário, você simplesmente cria um novo tópico/thread e cola o seguinte nele:

Nome do Calendário

[calendar]
[/calendar]

Então, para adicionar entradas ao calendário, você simplesmente faz uma nova postagem na mesma thread com algo como o seguinte (clicando no ícone inserir hora/data nas opções de postagem):

Nome do Evento/Entrada

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

Isso adiciona a entrada ao calendário, o que é ótimo, no entanto:

• Existe alguma maneira de adicionar entradas a um calendário, mas permitir que essas entradas tenham um tópico/thread dedicado também? (Vejo que você pode adicionar eventos em novas threads, mas não parece haver nenhuma maneira de adicionar esses eventos a um calendário).
• Existe alguma maneira de destacar ‘Próximos Eventos’ de um calendário específico nos e-mails de resumo? Ou talvez na coluna da esquerda, e com cada entrada vinculando ao tópico dedicado para essa entrada?

Se isso não for possível atualmente, você tem planos de adicionar?

[haozi (耗子)]

@vinothkannans Você poderia me ajudar a revisar este pr?

FEATURE: add China holidays and region

[putty]

Há planos para adicionar um feed de URL ao qual os usuários possam se inscrever? Tenho certeza de que seria complicado para todos os eventos em comparação com os que eles confirmaram presença.

Em segundo lugar, uma camada adicional seria incrível se pudesse reconhecer eventos privados (ou talvez isso seja apenas um feed de URL diferente por grupo).

[jordan-violet]

@putty

Existem planos para adicionar um feed de URL ao qual os usuários possam se inscrever? Tenho certeza de que seria complicado para todos os eventos versus os que eles confirmaram presença.

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…

No entanto, não há feed rss para a URL /upcoming-events — isso seria uma adição interessante!

[pokapow]

E quanto à sincronização CalDAV?

[Matthias_Schuster (Matthias)]

Isso também seria um motivo para eu mudar, de fato.

[Heliosurge (Dan DeMontmorency)]

Isso precisa de mais atualizações, pois menciona a inserção de um evento no composer e a adição de detalhes do evento, não como na imagem. A menos que o Evento fosse um complemento?

[Isambard]

Instalei o plug-in e a tag de calendário funciona na primeira postagem de um tópico. Mas não vejo nenhuma opção de evento ou calendário no menu de engrenagem:

Alguém pode, por favor, explicar o que preciso fazer para obter a opção de evento no menu de engrenagem?

[JammyDodger]

Você precisa habilitar a parte de Eventos do plugin discourse post event enabled

[Isambard]

Obrigado. De alguma forma, perdi essa configuração.

[Heliosurge (Dan DeMontmorency)]

Como fazer com que o evento de criação apareça em um tópico de Categoria com respostas sendo eventos?

Vejo que o evento de criação funciona na criação de novos tópicos. Mas estou procurando ter um Calendário em um tópico com respostas adicionando eventos. Funciona parcialmente com a inserção de data, mas não tão bem quanto o evento de criação, que tem mais opções.

[eve (Phú)]

Atualmente, os usuários podem definir a região nas preferências de seu perfil.

Gostaria de permitir que eles definam sua região durante o cadastro, exibindo este campo no formulário de registro. Isso é viável?

[joo (slower)]

Uma resposta excluída ainda aparecerá no calendário?

[tonninseteli (se oli tonnin seteli)]

Não consigo encontrar nenhuma configuração para alterar o primeiro dia da semana para segunda-feira, é trivial implementar se estiver faltando?

Outro problema é que a entrada de hora e data está quebrada, se for um evento de dia inteiro deve haver uma opção para selecioná-lo antes que os campos de entrada de hora baguncem as datas, e as datas parecem mudar aleatoriamente ao editar.

Também notei que é possível inserir 00:00 em hora e data, (o que às vezes funciona, às vezes não) levando o calendário a dar um erro que causará um conflito com os rascunhos, levando a um erro 422 repetido até que a página seja revertida para uma revisão anterior, então reeditada etc.

[joo (slower)]

@joo

Ao ativar esta automação, o conteúdo “Última edição por” é adicionado automaticamente ao Calendário. Estou buscando conselhos sobre se isso é um bug ou se é um problema com minhas configurações. Alguém poderia ajudar a esclarecer?

Por favor, consulte aqui

[Jagster (Jakke Flemming)]

@tonninseteli

Não consigo encontrar nenhuma configuração para alterar o primeiro dia da semana para segunda-feira, é trivial implementar se estiver faltando?

Não existe tal configuração e é por isso que não a uso. E aposto que a equipe corrigiria esse erro se fosse um truque trivial.