 |
Resumo | O Discourse Calendar and Events adiciona recursos dinâmicos e interativos de calendário e eventos ao seu site Discourse. |
 |
Guia de Instalação | Este plugin vem integrado ao núcleo do Discourse. Não há necessidade de instalar o plugin separadamente. |
Habilitando Calendário e Eventos
O plugin Calendar and Events pode ser habilitado por meio do botão de alternância (toggle) ou nas suas configurações, ambos acessíveis na sua página admin/plugins:
Funcionalidades
Não surpreendentemente, o Discourse Calendar and Events adiciona tanto o calendário quanto os recursos de eventos ao seu site Discourse. Com isso, você pode criar calendários de tópicos individuais para acompanhar ocasiões importantes ou linhas do tempo, 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 calendário de fácil acesso para todos os seus eventos futuros.
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 mais informações detalhadas sobre como criar e usar calendários em:
Eventos
O recurso de Evento permite que elementos interativos sejam inseridos em tópicos, que seus membros podem usar para se inscrever para participar ou estar presentes nas atividades da sua comunidade. Todos eles são resumidos em um calendário dedicado a 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 (observe o plural)
Configurações do Calendário
| Nome | Descrição |
|---|---|
| calendar enabled | Habilita o plugin discourse-calendar. Isso adicionará suporte para uma tag [calendar][/calendar] na primeira postagem 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 | Postagens com eventos expirados serão excluídas automaticamente 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 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 (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 uma postagem, ex.: [timezones group=admins][timezones] |
| working day start hour | Horário de início das horas de trabalho. |
| working day end hour | Horário de término das horas de trabalho. |
| close to working day hours extension | Define o tempo de extensão nas horas de trabalho para destacar os fusos horários. |
| calendar automatic holidays enabled | Define automaticamente o status de feriado com base na região do usuário (observe: você pode desativar feriados automáticos específicos nas configurações do plugin) |
| map events title | Título do calendário na 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 Evento. Observação: 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 de tempo relativo. |
| discourse post event edit notifications time extension | Estende (em minutos) o período após o término de um evento quando os convidados que marcaram going ainda recebem notificações sobre edições na postagem 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 ordenação dos tópicos da categoria pela data de início do evento. |
| disable resorting on categories enabled | Permite que as categorias desativem 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 em “Mais”. Requer post event enabled. |
| map events to color | Atribui uma cor de evento a uma tag ou categoria especificada. |
O endpoint
discourse-post-event/events.jsonagora tem um parâmetro adicional para alternar entre resposta simples e detalhada. Para obter a resposta detalhada, você pode adicionar?include_details=true:
/discourse-post-event/events.json?include_details=true
Eventos de transmissão ao vivo (Livestream)
Para eventos ao vivo, use a funcionalidade de transmissão ao vivo para permitir que os membros assistam a um evento e participem do chat ao mesmo tempo.
Um evento de transmissão ao vivo inclui:
- Um fluxo de vídeo (usando o YouTube, por exemplo)
- Um evento de calendário usando Discourse Calendar and Events
- Um canal de chat acompanhado, criado automaticamente para o evento
Pré-requisitos para eventos de transmissão ao vivo
Para usar eventos de transmissão ao vivo, você deve ter chat enabled, pois a transmissão ao vivo cria um canal de chat para acompanhar seu evento, além de discourse post event enabled e calendar enabled.
Configurando a transmissão ao vivo
Há algumas configurações para configurar:
livestream enabled: Ative isso para usar eventos de transmissão ao vivo.livestream chat allowed groups: Defina comoTrust Level 0para permitir que todos os usuários logados conversem durante o evento.
Criando um evento de transmissão ao vivo
Para criar um evento de transmissão ao vivo:
- Abra um novo tópico.
- Cole o link do vídeo do evento (por exemplo, uma URL do YouTube) no editor.
- Selecione o ícone + na barra de ferramentas do editor e clique em Create Event (se o evento ainda não tiver sido adicionado ao seu tópico) e, em seguida, atualize esse evento com os detalhes do evento.
- Adicione a tag
#livestreamao tópico.
Você verá então que o evento e a transmissão ao vivo foram criados, junto com um canal de chat acompanhado no lado direito.
Assim que qualquer usuário clicar em Going no evento, eles entrarão automaticamente no canal de chat, permitindo que participem da conversa!
Integrações com Outros Plugins
Você pode usar um componente deste plugin com o Right Sidebar Blocks. Você deve garantir que a rota desejada esteja habilitada no componente Right Sidebar Blocks. O nome do bloco será upcoming-events-list. Historicamente, eram necessárias configurações adicionais no próprio plugin Calendar, mas isso foi simplificado.
É assim que o calendário na barra lateral aparecerá por padrão.
Se você não quiser a hora, pode adicionar um valor vazio para 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 é a postagem na qual você coloca o calendário com [calendar][/calendar] ↩︎pode exibir um seletor de fuso horário no canto superior direito do calendário. Falso por padrão, você pode habilitá-lo com tzPicker=true ↩︎
pode ocultar sábados e domingos do calendário. Verdadeiro por padrão. Você pode definir 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 ↩︎