 |
Resumo | Discourse Calendar and Event adiciona recursos de calendário e eventos dinâmicos e interativos ao seu site Discourse. |
 |
Guia de Instalação | Este plugin está incluído no núcleo do Discourse. Não há necessidade de instalá-lo separadamente. |
Habilitando o Calendário (e Eventos)
O plugin Calendário pode ser habilitado tanto pelo alternador quanto por meio de suas configurações, ambos acessíveis na sua página admin/plugins:
Recursos
Não surpreendentemente, o Discourse Calendar (and Event) adiciona os recursos de calendário e eventos ao seu site Discourse. Com eles, você pode criar calendários de tópicos individuais para acompanhar ocasiões 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, bem como 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:
Eventos
O recurso de Eventos permite que elementos interativos sejam inseridos em tópicos, que seus membros podem usar para se inscrever para participar ou participar das atividades da sua comunidade. Todos eles são resumidos em um calendário dedicado de 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:
Isso não deve ser confundido com o plugin Events do Pavilion (note o plural)
Configurações do Calendário
| Nome | Descrição |
|---|---|
| calendar enabled | Habilita o plugin discourse-calendar. Isso adicionará suporte a uma 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 (6:00 da tarde), digite 18:00. |
| calendar categories | Exibe um calendário no topo de uma categoria. As 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 saída deve mostrar 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 | Defina 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 | Habilita os recursos de Eventos. Nota: também é necessário que calendar enabled esteja habilitado. |
| 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 de 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 | Habilita a classificação de tópicos de categoria por data de início do evento. |
| disable resorting on categories enabled | Permite que as categorias desabilitem a capacidade dos usuários de classificar 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.jsonagora possui um parâmetro adicional para alternar entre respostas simples e detalhadas. Para obter a resposta detalhada, você pode adicionar?include_details=true:
/discourse-post-event/events.json?include_details=true
Integrações com Outros Plugins
Você pode usar um componente deste plugin com Right Sidebar Blocks. Você deverá garantir que a rota desejada esteja habilitada no componente Right Sidebar Blocks. O nome do bloco será upcoming-events-list. Historicamente, havia configurações adicionais necessárias no próprio plugin Calendário, 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
categoryId é a categoria na qual o calendário será exibido no topo.
postId é o post no qual você colocou o calendário com[calendar][/calendar]↩︎pode exibir um seletor de fuso horário no canto superior direito do calendário. Padrão é falso, você pode habilitá-lo com
tzPicker=true↩︎pode ocultar sábados e domingos do calendário. Padrão é verdadeiro. Você pode defini-lo como falso com
weekends=false. ↩︎defaultView definirá a visualização do calendário (dia, semana, etc.). Pode ser definido como:
defaultView=agendaDay
defaultView=agendaWeek
defaultView=month(padrão)
defaultView=listNextYear↩︎