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 permite organizar e exibir eventos dentro da sua comunidade. Este guia irá guiá-lo pelo processo de criação de calendários, adição de eventos e gerenciamento eficaz deles.

Sumário

• Habilitar 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

Habilitando o plugin Calendar

Antes de poder criar calendários, certifique-se de que o plugin “Calendar (and Event)” esteja habilitado em sua instância do Discourse. Para mais detalhes sobre como habilitar 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

O primeiro dia da semana é Segunda-feira por padrão, mas pode ser configurado usando a configuração do site “calendar first day of week” (opções: Sábado, Domingo ou Segunda-feira).

Calendário de categoria

Para criar um calendário para toda a categoria:

1. Acesse /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;tzPicker;defaultView=month
   

   • Substitua 123 pelo ID da sua categoria (encontrado na URL ao visualizar 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. Abra o menu de opções ⊕ na barra de ferramentas do compositor e use a função “Insert date / time” 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. Abra o menu de opções ⊕ na barra de ferramentas do compositor e selecione “Create event”
3. Preencha os detalhes do evento e publique

O evento aparecerá no calendário da categoria.

Opções do 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="month"	Opções: month, week, 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="week" fullDay="true"]
[/calendar]

Removendo itens do calendário

Os itens do calendário podem ser removidos das seguintes 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 automaticamente respostas
• Exclua postagens manualmente 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. Cada resposta deve conter um carimbo de data/hora adicionado por meio da função “Insert date / time” no menu de opções ⊕ do compositor para que apareça no calendário
5. As entradas de férias são coloridas automática e aleatoriamente
6. Um emoji (padrão: ) aparece ao lado dos nomes dos usuários de férias nos cartões de usuário e em @menções
7. Opcionalmente, inclua feriados específicos de localidade para os usuários habilitando “calendar automatic holidays enabled”

FAQs

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?
R: Para calendários de categoria e eventos futuros, você pode atribuir cores por tag ou categoria usando a configuração do site “map events to color”. As entradas do calendário de feriados são coloridas automática e aleatoriamente e não podem ser personalizadas.

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