Calendário do Discourse - Como fazer?

[ben_t (Ben)]

Olá a todos,
Primeira vez instalando/mantendo o Discourse. Sou usuário há muito tempo.
Estou me sentindo um pouco perdido com alguns dos plugins e com a aparente falta de documentação. Meu foco no momento é o plugin Discourse Calendar.

Encontrei 2 tópicos:
O próprio plugin - Discourse Calendar
Uma solicitação de ajuda: How to use the calendar plugin?

Nenhum deles explica realmente como usar o plugin, além de criar o calendário principal na primeira postagem e como adicionar eventos a esse calendário principal nas respostas ao mesmo tópico.

As capturas de tela mostram várias cores, o que me faz pensar que talvez haja uma maneira de um calendário puxar dados de múltiplas categorias.

Nas configurações do plugin, há também a opção calendar categories, mas não tenho certeza de como usá-la. Consegui fazer um calendário aparecer no topo de uma página de exibição de categoria, mas ele está vazio.

Atualmente estou usando categoryId=7;postId=19, onde a categoria 7 é a categoria na qual quero que o calendário apareça no topo. Depois, não estava claro sobre o postId. Tentei uma postagem que continha um evento. Outra postagem que tinha um calendário como primeira postagem e datas como respostas. O calendário aparece no topo da Categoria (em uma caixa deformada e sem rolagem), mas nenhum evento aparece nele, independentemente do postId que eu use.

O texto de ajuda também menciona: Outras configurações válidas: tzPicker, weekends e defaultView.
mas não há explicação sobre o que essas opções fazem ou como usá-las.

Resumindo, estou procurando por qualquer orientação ou links para algo que explique o plugin com um pouco mais de detalhe.

No final das contas, o que espero é uma maneira de ter um calendário que consiga ler múltiplas postagens dentro de uma categoria. O que estou fazendo agora é instruir os usuários a criarem duas postagens: criar um novo tópico e adicionar um evento, incluindo a descrição do evento, etc… Esse será o tópico para discussão sobre o evento.

Depois, peço que copiem o link desse tópico, acessem o tópico fixo “Calendário Mestre de Eventos” e respondam a ele inserindo uma data e colando o link do evento. Dessa forma, o calendário do tópico “Calendário Mestre de Eventos” terá todos os eventos, mas haverá tópicos separados para permitir a discussão sobre eles.

Parece que deve haver uma maneira melhor, mas não sei qual seria.

Muito obrigado por qualquer insight.

[Benjamin_D (Benjamin Decotte)]

Olá!
O Postid pode ser encontrado no JSON e é o ID da postagem onde o calendário é declarado (não o ID do tópico).

Sobre os eventos com cores, acredito que eles venham (por enquanto ) do plugin events (mas posso ter perdido algum commit!)

E talvez isso possa responder a algumas das suas perguntas:

@angus

Se você apenas instalar o plugin discourse-calendar (e nada mais), existem três tipos de itens relacionados ao tempo que você pode adicionar ao editor do Discourse: [event], [calendar] e [date]. Os casos de uso desses itens e como eles interagem estão ficando um pouco confusos se você já não estiver familiarizado com os próprios plugins e com o Discourse em geral.

Por exemplo, o plugin discourse-calendar existente exige que você crie [dates] em postagens no mesmo tópico que o [calendar]. O conjunto de recursos [event] (que está no mesmo plugin) exige que você crie [events], que são diferentes de [dates], mas também são adicionados a um calendário que se parece exatamente com o [calendar] específico do tópico que incluía os [dates], embora atue de forma bastante diferente.

[ben_t (Ben)]

Muito obrigado. A diferença entre PostID e TopicID era onde eu estava errando. Isso esclareceu tudo. Ainda gostaria que houvesse um “man page” ou algo equivalente para todas as variáveis e entradas possíveis no plugin, mas continuarei explorando.

Também agradeço pelo link para o Plugin de Eventos. Como mencionei no post para o qual seu link direciona, é confuso como Calendar, Date e Event estão relacionados ou não, considerando que o Plugin de Eventos faz parte do Plugin de Calendário.

[runinsideout (Chris O)]

@ben_t, seu caso de uso descreve exatamente o tipo de funcionalidade que eu esperava… vários grupos poderiam ter tópicos de discussão sobre seus eventos, mas, ao criar seus eventos em seus tópicos, eles preencheriam o Calendário Mestre de Eventos, que contém todos os eventos de todos os grupos. Assim, leitores do calendário principal de eventos poderiam clicar em qualquer item e ser levados ao tópico do evento.

Não me entenda mal, como está agora, eu aprecio a ideia de um evento em um tópico que não chega ao calendário principal de eventos (digamos, um pequeno grupo realizando reuniões de planejamento antes do grande evento no calendário principal),

No entanto, acredito que nosso caso de uso seria um ótimo recurso, pois consigo visualizar várias aplicações (calendários de esportes escolares, murais comunitários…)

A propósito, encontrei uma maneira alternativa de criar o tópico onde você coloca o calendário na primeira mensagem e depois responde ao calendário com datas que são adicionadas à mensagem inicial… sem precisar ir nas configurações e contar os números dos tópicos…
Em algum lugar da primeira mensagem, coloque:

[calendar]
[/calendar]

Encontrei isso na [página do GitHub|Discourse Calendar (and Event)].
Acho que isso pode ter sido adicionado depois que você postou isso.

… Estou indo descobrir essa história das cores!

[jrgong]

@Benjamin_D

O Postid é encontrado no json e é o Id do post onde o calendário é declarado (não o Id do tópico)

Alguém pode compartilhar os passos para encontrar o Postid para declarar o calendário? Estou travado nesta etapa e apreciaria muito a ajuda.

Editar: Encontrei! Caso alguém esteja com dificuldades, você pode seguir os seguintes passos para encontrar o postId. Vamos usar este tópico como exemplo:

https://meta.discourse.org/t/discourse-calendar-how-to/165536/5

1. Remova o slug do tópico para que fique assim: https://meta.discourse.org/t/165536/5
2. Remova o número do post no final (/5) e substitua por /posts.json, então a URL ficará assim:
   https://meta.discourse.org/t/165536/posts.json
3. Abra a URL e você encontrará o postId necessário na primeira linha:
   
   
4. Cole a URL nas configurações do plugin de calendário, então em nosso exemplo ficaria algo assim:
   
   
5. Seu calendário na categoria agora deve exibir todas as entradas [date] desse tópico.

[Tara_Walton]

@ben_t

O texto de ajuda também oferece Outras configurações válidas: tzPicker, weekends e defaultView.
mas nenhuma explicação sobre como ou o que essas configurações fazem ou como usá-las.

Alguém pode responder o que são essas configurações? Não consegui encontrar nenhuma referência a elas, exceto neste post e não há explicação.

[Benjamin_D (Benjamin Decotte)]

[calendar weekends="false"]
[/calendar]

esconderia os fins de semana

[calendar defaultView="listNextYear"]
[/calendar]

mostraria a visualização de lista como padrão (outras opções são month ou basicWeek)

[calendar tzPicker="true"]
[/calendar]

permitiria ao usuário escolher o fuso horário no canto superior direito do calendário

[Tara_Walton]

Útil, mas isso significa que essas informações para a configuração não são aplicáveis, ou apenas definem a configuração padrão para o calendário na postagem especificada?

[Benjamin_D (Benjamin Decotte)]

Desculpe, não tenho certeza se entendi a pergunta
Eu diria que as configurações são definidas por item, ou seja, para um calendário (que está na postagem especificada)

[Tara_Walton]

Peço desculpas pela confusão.
Nas configurações do calendário do Discourse, você vê a imagem que postei anteriormente.
Ele requer o categoryId e o postID, em seguida, declara as outras configurações válidas, mas não o que elas fazem nessa instância.

Estou imaginando se este é um caso de texto de ajuda ruim ou má compreensão de como essas configurações funcionam quando relacionadas à configuração “categorias de calendário”.

Pelos meus testes, não vejo nada acontecendo, mas posso estar errado.

[Benjamin_D (Benjamin Decotte)]

@Tara_Walton

Minhas desculpas pela confusão.

Ah, sem problemas, meu inglês é como queijo suíço, a maioria buracos, daí a dúvida

@Tara_Walton

Pelos meus testes, não vejo nada acontecendo

Acho que deveria funcionar sem as aspas duplas, por exemplo
categoryId=31;postId=4867;tzPicker=true;weekends=false

[Ethsim2 (Ethan)]

@jrgong

Caso alguém esteja com dificuldades, você pode seguir os seguintes passos para encontrar o postId

Descobri que você mudou
meta.discourse.org/t/discourse-calendar-how-to/165536/6
para
meta.discourse.org/t/discourse-calendar-how-to/165536.json

[Heliosurge (Dan DeMontmorency)]

Concordo. Acho que às vezes as instruções são escritas da perspectiva de um desenvolvedor e precisam de mais informações passo a passo e imagens para um leigo. O calendário poderia talvez usar um Theme component para tornar a configuração mais clara dentro de um tópico ou algo assim.

[Ethsim2 (Ethan)]

Não acabei usando o calendário do Tópico de Sobre, porque a maneira fácil de criar um evento é sempre o 1º post de um tópico e você o usaria para o calendário de qualquer maneira, não para eventos.

Consegui editar o 1º post dos tópicos existentes em subcategorias, então a cor das subcategorias apareceu no calendário exibido da categoria pai.

Além disso, você mencionou o componente de tema, o que sugere ajustabilidade; o calendário sobre o qual estou falando, o implementado pela configuração de administrador Calendário de Eventos por Categorias, eu gostaria de poder ajustar:

• O tamanho do calendário no site desktop, o site móvel parece bom
• O dia em que a semana começa

Não estou listando muitas coisas aqui porque não quero desanimar as pessoas, imagino que houve problemas de desenvolvimento que significaram que precisavam haver maneiras diferentes para um superusuário implementar o discourse-calendar.

[Heliosurge (Dan DeMontmorency)]

Pelo que observei, não vi um TC companheiro de Calendário. Talvez você possa criar um Theme component personalizado usando o elemento de inspeção no seu navegador para identificar e ajustar o tamanho do calendário no Desktop. Apenas certifique-se de colocá-lo no cabeçalho CSS do Desktop.

A equipe lançou recentemente um plugin companheiro para Transmissões ao Vivo. Isso pode ser de interesse. Ele usava Chat e Calendário.

Discourse Livestream

Summary Discourse Livestream allows you to create Livestream topics that let your users join and participate in chat Repository Link https://github.com/discourse/discourse-livestream Install Guide How to install plugins in Discourse Features [A screenshot of a Discourse forum with a YouTube video titled "Rick Astley - Never Gonna Give You Up" in the center. (Captioned by AI)] Open any topic to start a livestream event. …

[Ethsim2 (Ethan)]

Bom, eu gosto desse plugin, não é algo que eu faça com frequência eu sou do tipo de fórum privado. Talvez um dia eu tenha dinheiro suficiente para fazer uma transmissão ao vivo de revisão de física

Tanto pelo calendário da Categoria por Pai, seria bom se Uncategorized (potencialmente?) exibisse um calendário na página inicial (ou na categoria General), e unisse os eventos de todas as outras categorias.