 |
Resumo | 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 é integrado ao núcleo do Discourse. Não há necessidade de instalar o plugin separadamente. |
Habilitando Calendário e Eventos
O plugin Calendário e Eventos pode ser habilitado por meio da alternância (toggle) ou por meio de suas configurações, ambos acessíveis na página admin/plugins:
Recursos
Talvez não surpreenda, mas o Discourse Calendar and Events adiciona tanto os recursos de calendário quanto de 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 licença médica, criar tópicos de eventos interativos, bem como mostrar um resumo de calendário de fácil acesso de 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 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 assistir ou participar das atividades da sua comunidade. Todos eles são resumidos em um calendário dedicado em 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 para a 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 férias. |
| delete expired event posts after | Postagens com eventos expirados serão automaticamente excluídas após (n) horas. Defina como -1 para desativar a exclusão. |
| all day event start time | Eventos que não têm hora de início especificada começarão nesta hora. O formato é HH:mm. Para 6:00 da manhã, insira 06:00 |
| all day event end time | Eventos que não têm hora de término especificada terminarão nesta hora. O formato é HH:mm. Para 6:00 da tarde, insira 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 outlet deve exibir o calendário da categoria. |
| working days | Define 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 | Hora de início das horas de trabalho. |
| working day end hour | Hora 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 férias 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. Padrão é “Próximos eventos” |
Configurações de Eventos
| Nome | Descrição |
|---|---|
| discourse post event enabled | Habilita os recursos de Eventos. Nota: também precisa 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 marcados como going (indo) ainda são notificados 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 de tópicos de categoria por data de início do evento. |
| disable resorting on categories enabled | Permite que 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 sob ‘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 adicionado 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
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:
- Uma transmissão de vídeo (usando YouTube, por exemplo)
- Um evento de calendário usando Discourse Calendar and Events
- Um canal de chat complementar 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 (chat habilitado), já que a transmissão ao vivo cria um canal de chat para acompanhar seu evento, além de discourse post event enabled e calendar enabled.
Criando um evento de transmissão ao vivo
Para criar um evento de transmissão ao vivo:
- Abra um novo tópico.
- Selecione o ícone + na barra de ferramentas do compositor e clique em Create Event (criar evento) (se o evento não tiver sido adicionado ao seu tópico ainda).
- Cole o link do vídeo do evento (por exemplo, uma URL do YouTube) no campo local/URL.
- Ative a opção “livestream” (transmissão ao vivo)
Você verá então que o evento e a transmissão ao vivo foram criados, junto com um canal de chat complementar no lado direito.
Assim que qualquer usuário clicar em Going (Indo) no evento, eles entrarão automaticamente no canal de chat, permitindo que participem da conversa!
Transmitindo webinars do Zoom
Você pode usar a transmissão ao vivo para hospedar webinars do Zoom diretamente no Discourse, para que os membros possam assistir ao evento e participar do canal de chat complementar sem sair da sua comunidade.
Pré-requisitos para webinars do Zoom
Além dos pré-requisitos de transmissão ao vivo, você também precisará configurar as seguintes configurações:
- Ative
livestream zoom enabled - Insira sua chave do SDK de reunião do Zoom na configuração
livestream zoom sdk key - Insira seu segredo do SDK de reunião do Zoom na configuração
livestream zoom sdk secret
Para obter a chave e o segredo do SDK de reunião do Zoom:
-
Acesse marketplace.zoom.us, clique em Develop (Desenvolver) e clique em Build app (Criar aplicativo).
-
Quando perguntado que tipo de aplicativo você está criando, escolha General App (Aplicativo Geral) e clique em Create (Criar).
-
Na página App Credentials (Credenciais do Aplicativo) do aplicativo, copie o Client ID (ID do Cliente) (Chave do SDK) e Client Secret (Segredo do Cliente) (Segredo do SDK).
-
Em Embed (Incorporar), ative a permissão Meeting SDK (SDK de Reunião).
-
No seu Discourse, vá para Admin → All site settings (Admin → Todas as configurações do site) e insira os valores da etapa 3 em
livestream zoom sdk keyelivestream zoom sdk secret.
Para que o webinar do Zoom funcione corretamente no Discourse:
-
O webinar não deve exigir registro ou código de acesso para entrar.
-
Desative o chat integrado do webinar do Zoom para garantir que toda a discussão aconteça no único canal de chat do Discourse, mantendo todo o chat em um só lugar e garantindo que a conversa possa continuar após o término do webinar.
Criando um evento de transmissão ao vivo de webinar do Zoom
Para criar um evento de transmissão ao vivo para seu webinar do Zoom:
- Abra um novo tópico, selecione o ícone + e clique em Create Event (Criar Evento).
- Cole o link do seu webinar do Zoom (por exemplo,
https://zoom.us/``...) no campo URL/Localização. - Ative a opção Livestream (Transmissão ao vivo).
- Defina o nome do evento, hora de início, hora de término e outros detalhes do evento conforme desejado.
- Publique o tópico.
Como outros eventos de transmissão ao vivo, este evento será criado com um canal de chat do Discourse complementar, ao qual os membros entrarão automaticamente após confirmarem presença como “Going” (Indo).
Experiência do membro
Veja como seus membros experimentarão o webinar:
Antes do evento
Um botão Join Zoom (Entrar no Zoom) é exibido a partir de 30 minutos antes do início do evento. Fora desse intervalo, o botão está desativado com uma mensagem indicando quando estará disponível.
Durante o evento
Assim que os membros clicarem em Join Zoom (Entrar no Zoom), o webinar será carregado na página do tópico (ou, se o anfitrião ainda não tiver iniciado o evento, o membro precisará esperar até que ele o faça para ver o vídeo).
O áudio não se conecta automaticamente ao entrar no webinar; os participantes precisam clicar ou tocar no ícone de áudio na barra de ferramentas do Zoom para se conectar. Esta é uma limitação do SDK do Zoom e não pode ser alterada.
No celular, o webinar abre em uma visualização em tela cheia do Zoom (que também está acessível no desktop adicionando /zoom ao final da URL do tópico do evento) com um botão flutuante Chat que eles podem tocar para abrir um painel sobreposto de chat durante o evento.
Após o evento
O botão Join Zoom (Entrar no Zoom) é ocultado 10 minutos após a hora de término do evento. O canal de chat permanece acessível aos participantes até que você o feche.
Integrações com Outros Plugins
Você pode usar um componente deste plugin com Right Sidebar Blocks. Você precisará 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 de Calendário, mas isso foi simplificado.
É assim que o calendário da 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.
categoryId é a categoria onde o calendário será exibido no topo.
postId é a postagem em que 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 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 ↩︎
\n\n- Existe a possibilidade de adicionar a entrada do menu superior Calendário? Não encontro nas configurações\n
