Este guia explica como criar e gerenciar calendários no Discourse usando o plugin Calendar (e Evento).
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 o guiará pelo processo de criação de calendários, adição de eventos e gerenciamento eficaz deles.
Sumário
- 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:
-
Crie um novo tópico ou edite a primeira postagem de um tópico existente
-
Adicione o seguinte código em linhas separadas:
[calendar] [/calendar] -
Publique ou atualize a postagem
A segunda-feira é considerada o primeiro dia da semana nos calendários do Discourse, independentemente das configurações de localidade do visualizador. Atualmente, isso não é configurável.
Calendário de categoria
Para criar um calendário para toda a categoria:
-
Acesse
/admin/site_settings/category/discourse_calendar?filter=plugin=discourse-calendar -
Na configuração “calendar categories” (categorias de calendário), adicione uma entrada com o seguinte formato:
categoryId=123;tzPicker;defaultView=month- Substitua
123pelo seu ID de categoria (encontrado na URL ao visualizar a categoria)
- Substitua
-
Adicione o ID da categoria à configuração “events calendar categories” (categorias de calendário de eventos)
-
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:
- Responda ao tópico que contém o calendário
- Use a função “Insert date / time” (Inserir data / hora) no menu do compositor + para adicionar uma data ou intervalo de datas
- Adicione uma descrição acima da data
- 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:
- Crie um novo tópico na categoria
- Clique no botão de engrenagem e selecione “Create event” (Criar evento)
- 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 |
|---|---|---|
| Hide weekends (Ocultar fins de semana) | weekends="false" |
Oculta sábado e domingo |
| Hide specific days (Ocultar dias específicos) | hiddenDays="1,2" |
Oculta segunda e terça-feira (use 0-6 para domingo-sábado) |
| Set default view (Definir visualização padrão) | defaultView="basicWeek" |
Opções: month, basicWeek, listNextYear |
| Ignore timezones (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 das seguintes maneiras:
- Itens de calendário expirados podem ser removidos automaticamente usando a configuração “delete expired event posts after” (excluir postagens de eventos expirados após)
- Use temporizadores de tópico para excluir respostas automaticamente
- 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:
- Crie um tópico com um calendário na primeira postagem
- Defina “holiday calendar topic id” para o ID deste tópico
- As respostas a este tópico serão tratadas como tempo de férias para o usuário que postar
- As entradas de férias são coloridas automática e aleatoriamente
- Um emoji (padrão:
) aparece ao lado dos nomes dos usuários de férias nos cartões de usuário e menções @mentions - Opcionalmente, inclua feriados específicos de localidade para os usuários ativando “calendar automatic holidays enabled” (feriados automáticos do calendário ativados)
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” (hora de início do evento de dia inteiro) e “all day event end time” (hora de término do evento de dia inteiro) 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 normais.
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.
de uma resposta de tópico específica e exibe o calendário no próprio tópico, enquanto o último usa 
em qualquer tópico da categoria configurada e exibe o calendário de eventos na categoria.
(a partir do botão de engrenagem).
Ou há algo que eu possa fazer, exceto fazer tudo de novo 