Criando e gerenciando calendários

[Discourse]

Este guia explica como criar e gerenciar calendários no Discourse usando o plugin Calendar (and Event).

Nível de usuário necessário: Todos os usuários

Calendários são um recurso poderoso no Discourse que permitem organizar e exibir eventos dentro de sua comunidade. Este guia o guiará pelo processo de criação de calendários, adição de eventos e gerenciamento eficaz deles.

Resumo

• Ativar o plugin Calendar
• Criar um calendário em um tópico ou categoria
• Adicionar eventos ao seu calendário
• Gerenciar opções e configurações do calendário
• Usar o recurso de calendário de feriados

Ativando o plugin Calendar

Antes de poder criar calendários, certifique-se de que o plugin “Calendar (and Event)” esteja ativado em sua instância do Discourse. Para mais detalhes sobre como ativar o plugin e suas configurações relacionadas, consulte a documentação do plugin Discourse Calendar and Event.

Criando um calendário

Calendário de Tópico

Para incorporar um calendário em um tópico:

1. Crie um novo tópico ou edite a primeira postagem de um tópico existente

2. Adicione o seguinte código em linhas separadas:

   [calendar]
   [/calendar]
   

3. Publique ou atualize a postagem

Segunda-feira é considerado o primeiro dia da semana nos calendários do Discourse, independentemente das configurações de local do visualizador. Isso atualmente não é configurável.

Calendário de Categoria

Para criar um calendário para toda a categoria:

1. Vá para /admin/site_settings/category/discourse_calendar?filter=plugin=discourse-calendar

2. Na configuração “calendar categories”, adicione uma entrada com o seguinte formato:

   categoryId=123;postId=4949;tzPicker;defaultView=month
   

   • Substitua 123 pelo ID da sua categoria (encontrado na URL ao visualizar a categoria)
   • Substitua 4949 pelo ID da postagem da descrição da categoria (encontrado anexando .json à URL do tópico “Sobre a categoria”)

3. Adicione o ID da categoria à configuração “events calendar categories”

4. Opcionalmente, defina “discourse post event allowed on groups” para controlar quais grupos podem adicionar eventos

Adicionando itens a um calendário

Calendário de Tópico

Para adicionar um evento a um calendário de tópico:

1. Responda ao tópico que contém o calendário
2. Use a função “Inserir data / hora” no menu do compositor \u003ckbd\u003e+\u003c/kbd\u003e para adicionar uma data ou intervalo de datas
3. Adicione uma descrição acima da data
4. Envie a resposta

O evento aparecerá no calendário após recarregar o tópico.

Calendário de Categoria

Para adicionar um evento a um calendário de categoria:

1. Crie um novo tópico na categoria
2. Clique no botão de engrenagem e selecione “Criar evento”
3. Preencha os detalhes do evento e publique

O evento aparecerá no calendário da categoria.

Opções de calendário

Você pode personalizar seu calendário usando várias opções:

Opção	Exemplo	Descrição
Ocultar fins de semana	weekends="false"	Oculta sábado e domingo
Ocultar dias específicos	hiddenDays="1,2"	Oculta segunda e terça-feira (use 0-6 para domingo-sábado)
Definir visualização padrão	defaultView="basicWeek"	Opções: month, basicWeek, listNextYear
Ignorar fusos horários	fullDay="true"	Trata todos os eventos como eventos de dia inteiro

Exemplo de uso:

[calendar weekends="false" hiddenDays="1,2" defaultView="basicWeek" fullDay="true"]
[/calendar]

Removendo itens do calendário

Itens do calendário podem ser removidos destas maneiras:

• Itens de calendário expirados podem ser removidos automaticamente usando a configuração “delete expired event posts after”
• Use timers de tópico para excluir postagens automaticamente
• Exclua manualmente postagens conforme necessário

Calendário de feriados

O calendário de feriados é um recurso especial para gerenciar férias da equipe do site:

1. Crie um tópico com um calendário na primeira postagem
2. Defina “holiday calendar topic id” para o ID deste tópico
3. As respostas a este tópico serão tratadas como tempo de férias para o usuário que postar
4. As entradas de férias são coloridas automática e aleatoriamente
5. Um emoji (padrão: ) aparece ao lado dos nomes dos usuários de férias em cartões de usuário e menções @mentions
6. Opcionalmente, inclua feriados específicos do local para os usuários ativando “calendar automatic holidays enabled”

Perguntas frequentes

P: Por que alguns eventos parecem abranger vários dias?
R: O calendário está sempre em UTC. Use as configurações “all day event start time” e “all day event end time” para ajustar as diferenças de fuso horário.

P: Posso controlar as cores das entradas do calendário de feriados?
R: Atualmente, não é possível controlar as cores das entradas do calendário de feriados ou obter entradas coloridas em calendários regulares.

P: Como exibo eventos passados em uma visualização de lista?
R: Atualmente, há um bug ao usar defaultView=listNextYear que faz com que a visualização inicial fique vazia. Como solução alternativa, os usuários precisam mudar para a visualização mensal, voltar um mês e, em seguida, retornar à visualização de lista para ver eventos passados.

Recursos adicionais

• Discourse Calendar (and Event)
• Creating and managing events