Muitas comunidades apresentam altas taxas de inscrição, mas lutam contra o “abandono no primeiro dia”. Ao fornecer caminhos acionáveis, você reduz a carga cognitiva sobre novos membros e os guia em direção aos comportamentos de alto valor que constroem a retenção a longo prazo.
O modal usa uma implementação baseada em lógica para que você evite solicitar a membros regulares que já estão familiarizados com sua comunidade.
Novos Usuários: Exibido automaticamente para todos os usuários que se registraram após a sua feature_enabled_date.
Período de Carência: Durante uma janela configurável, o componente marca “silenciosamente” usuários ativos como tendo visto o modal para que eles não sejam interrompidos.
Usuários Legados: Exibido para usuários existentes que retornam ao fórum após o término do seu período de carência, ajudando a reorientá-los.
Nota: O estado de “visto” é armazenado localmente no navegador do usuário, portanto, o modal pode reaparecer se ele mudar de dispositivo ou limpar o cache.
Configurações
Configuração
Tipo
Padrão
Descrição
enabled
bool
false
Ative o Discourse Welcome Modal quando estiver pronto para habilitá-lo para os membros.
feature_enabled_date
string
\"2026-01-01\"
Insira a data no formato AAAA-MM-DD.
grace_period_months
integer
3
Número de meses após a data de ativação do recurso para marcar silenciosamente os usuários existentes como vistos.
card_layout
enum
\"grid\"
Escolha como os cartões são exibidos no modal de boas-vindas (grid ou list).
card_content
objects
[]
Configure os cartões mostrados no modal de boas-vindas (requer id, title, subtitle, imgUrl, altText, btnLabel e action).
title (Tradução)
text
Join the conversation
O título principal exibido na parte superior do modal.
close_btn (Tradução)
text
Done
O rótulo para o botão que fecha o modal.
Use ?show-welcome-modal=true para forçar a exibição do Modal de Boas-Vindas, independentemente de o recurso estar ativado ou de seu status de já ter sido visto - ideal para testes antes de lançar para sua comunidade
Este é meu primeiro verdadeiro componente de tema Gostaria de receber feedback, pensamentos, coisas que poderiam ter sido feitas melhor
Qual é a maneira mais fácil de testar isso e ver os blocos (tiles) como nas suas imagens de demonstração? Existe um conjunto de configurações que permitiria aos administradores ver os blocos antes de disponibilizarmos isso de forma mais ampla em um ambiente PORD?
Apenas uma ideia para sua próxima rodada de desenvolvimento. Seria bom se pudéssemos estipular quais mensagens seriam mostradas a novos usuários versus usuários existentes que não estiveram ativos durante o período de carência.
Assim, os novatos recebem mensagens do tipo boas-vindas (Vá para o material de introdução), enquanto os usuários existentes recebem uma mensagem do tipo novidades (confira estes novos recursos/categorias/coisas…).
O que você acha de remover o rodapé? Como existem CTAs, junto com o botão de fechar, Done parece um pouco desnecessário, mas estou curioso para saber sua opinião?
Adorei esta ideia! Foi algo que considerei para a primeira versão, mas decidi manter o lançamento inicial simples.
Enfim, acabei de enviar uma atualização que implementa essa segmentação! Há uma pequena alteração na lógica para distinguir entre diferentes estados de usuário, para que você possa adaptar o conteúdo sem ser intrusivo.
Como funciona agora:
1. As Definições
Novos Usuários: Registrados na ou após a sua feature_enabled_date (data de ativação do recurso).
Usuários Existentes: Registrados antes dessa data.
Usuários Engajados: Membros que visitam regularmente (dentro da sua janela de inatividade).
Usuários Retornando: Membros anteriormente engajados que ficaram ausentes por tempo suficiente para exceder o limite de inatividade.
2. O Fluxo da Lógica Para garantir que não incomodemos seus membros mais ativos, o componente segue uma prioridade específica:
Novo Registro: Eles veem o modal imediatamente (direcionados com cartões marcados como new_users ou both).
Período de Carência: Se um ‘Usuário Existente’ visitar durante seu período de carência, o componente marca-o silenciosamente como visto para que não seja interrompido.
A Lacuna de Inatividade: Uma vez que um usuário é marcado como ‘visto’, o componente rastreia as visitas localmente. Se ele visitar diariamente, ele permanece Engajado e nunca mais o verá. Ele só o verá (como um Usuário Retornando) se a lacuna entre suas visitas exceder sua configuração returning_user_inactivity_months (esta é uma nova configuração )
3. Conteúdo Adaptado Agora você pode usar a configuração displayFor em cada cartão:
new_users: Perfeito para ‘Como postar’ ou ‘Apresente-se.’
returning_users: Perfeito para ‘Veja o que mudou enquanto você estava fora.’
both: Links essenciais como Diretrizes ou FAQ.
Eu também adicionei parâmetros de visualização para que você possa testar esses fluxos facilmente: ?show-welcome-modal=true&user-type=new ou &user-type=returning.
Por que usar isto?
Capturas de Tela
Configurações
Gostaria de receber feedback, pensamentos, coisas que poderiam ter sido feitas melhor 
