Componente do tema Guest Gate

[Don]

	Repositório	GitHub - VaperinaDEV/discourse-guest-gate-theme-component: Forced login / registration popup insired by Quora · GitHub
	Achei útil?	> ./support --coffee
	Guia de Instalação	Como instalar um tema ou componente de tema
	Novo em Temas do Discourse?	Guia para iniciantes sobre o uso de Temas do Discourse

Guest Gate v1.0

Olá Este componente de tema foi criado a partir de Guest Gate (Sign Up Popup Plugin). Ele pode bloquear tópicos para visitantes anônimos com um modal e forçá-los a se Cadastrar ou Fazer Login. O componente pode ser usado para um modal de alerta, incentivando os visitantes a se cadastrarem, mas permitindo que fechem o modal (para isso, deixe a configuração dismissable false desmarcada). As opções incluem alterar o número de tópicos que podem ser visualizados antes que o modal seja exibido.

Dica: Se você usar a opção “custom gate” e quiser ocultar o cabeçalho do modal (como na imagem acima), você deve excluir o campo guest_gate.title e pressionar a tecla espaço. Isso removerá o título do modal, permitindo que você use um título abaixo da imagem.

Você tem duas opções principais de gate:

1. Gate genérico (padrão: usará o texto do CTA de Cadastro do Discourse no modal). Ele usa estes textos: js.signup_cta.intro e js.signup_cta.value_prop

2. Gate personalizado (você pode personalizar o modal: adicionar imagem, texto personalizado e cores).

---

E há muitas outras configurações

Configurações globais do modal Guest Gate

1. max guest topic views
   Número de visualizações de tópicos até que o gate seja exibido. Após o gate aparecer pela primeira vez, ele aparece aleatoriamente entre 1 e este número.
2. dismissable false
   Remove o botão de fechar, impedindo os visitantes de fechá-lo.
3. use gate buttons
   Use botões no rodapé do modal em vez de links.
4. custom url enabled
   Ative as opções de URL de login personalizada e URL de cadastro personalizada. O comportamento normal (se você deixar esta opção desmarcada) é que o modal de Login ou Cadastro apareça na página do tópico atual.
5. custom login url
   Por exemplo, /login é a página inicial com o modal “Login” exibido.
6. custom signup url
   Por exemplo, /signup é a página inicial com o modal “Sign Up” exibido.
7. gate footer position
   Posição dos botões/links do rodapé.
8. gate show only once
   O modal Guest Gate é exibido apenas uma vez por sessão.

---

Configurações do Gate Personalizado

1. custom gate enabled
   Ative se você quiser personalizar o modal.
2. custom gate image
   Envie uma imagem para exibir no topo do modal.
3. custom gate image width
   A largura da imagem enviada. Você pode usar px, % etc., por exemplo, 100% adicionará uma imagem com a largura total do modal (menos o padding).
4. custom gate big text color
   O “texto grande” aparece abaixo da imagem. Você pode definir a cor do texto.
5. custom gate little text color
   O “texto pequeno” aparece abaixo do texto grande. Você pode definir a cor do texto.
6. custom gate background color
   Altere a cor de fundo do modal.
7. custom gate footer text color
   Altere a cor do texto do rodapé. Isso se aplica se a configuração use gate buttons estiver desativada e você tiver configurado um gate personalizado.
8. custom gate link color
   Altere a cor dos links do rodapé. Isso se aplica se a configuração use gate buttons estiver desativada e você tiver configurado um gate personalizado.

---

Crédito Grandes agradecimentos aos autores, mantenedores e contribuidores do plugin: @vinothkannans, @jgujgu e @michaeld

Guest Gate v2.0

Olá

Guest Gate v2.0 é um gate moderno e configurável para visitantes anônimos no Discourse.

Ele pode exibir um modal para incentivar os visitantes a Fazer Cadastro ou Login, seja como um prompt de conversão suave ou como um gate que os visitantes não podem dispensar.

O Guest Gate começou a partir do plugin original Guest Gate Sign Up Popup e evoluiu consideravelmente desde então.

Disparando o Guest Gate

A versão 2.0 suporta várias formas de disparar o gate:

1. Visualizações de página
   Exibir o gate após um número configurável de visualizações de página elegíveis.

2. Tempo
   Exibir o gate após um visitante ter passado um tempo configurável em uma página elegível.

3. Rolagem (Scroll)
   Exibir o gate após um visitante ter rolado uma porcentagem configurável da página.

4. Lightbox
   Exibir o gate quando um visitante anônimo abre uma imagem no lightbox do Discourse.

5. Qualquer
   Ativar vários tipos de gatilho e exibir o gate quando o primeiro gatilho configurado for atingido.

Você também pode configurar um atraso entre o gatilho e a aparição do modal.

---

Comportamento de repetição

Após o Guest Gate ter sido exibido, você pode controlar quando ele pode aparecer novamente.

Modos disponíveis:

• Repetir gatilho: exibir o gate sempre que o gatilho configurado for acionado.

• Visualizações de página aleatórias: exibir o gate após um número aleatório de visualizações de página.

• Uma vez por sessão: exibir o gate no máximo uma vez durante a sessão do navegador.

A configuração legada Mostrar apenas uma vez também é suportada para compatibilidade reversa.

---

Visibilidade de URL

Duas configurações controlam onde o Guest Gate é permitido a aparecer:

url_for_show

Defina os caminhos onde o Guest Gate pode ser disparado.

Exemplos:

• * todas as páginas

• / página inicial

• /latest Mais recentes

• /t/* tópicos

• /c/* categorias

url_for_hide

Defina os caminhos onde o Guest Gate nunca deve aparecer.

Os padrões de ocultação sempre têm precedência sobre a lista de exibição.

---

Configurações do Modal

dismissable

Permitir que os visitantes fechem o modal do Guest Gate.

Desative esta opção para criar um gate não dispensável.

gate_modal_size

Escolha a largura do modal:

• compact

• standard

• wide

gate_body_alignment

Escolha o alinhamento horizontal do conteúdo principal do modal:

• left

• center

• right

gate_footer_position

Escolha o alinhamento dos links ou botões de Login / Cadastro:

• left

• center

• right

gate_title_visibility

Mostrar ou ocultar o título do modal.

gate_title_position

Controle a posição da margem do título.

---

Login e Cadastro

O Guest Gate suporta o fluxo de autenticação normal do Discourse, bem como URLs personalizadas.

use_gate_buttons

Use botões no rodapé do modal em vez de links de texto.

custom_url_enabled

Use URLs personalizadas de Login e Cadastro em vez das ações de autenticação nativas do Discourse.

custom_login_url

Destino usado para Login quando as URLs personalizadas estão habilitadas.

custom_signup_url

Destino usado para Cadastro quando as URLs personalizadas estão habilitadas.

Você também pode configurar os estilos dos botões e os ícones Font Awesome independentemente.

---

Discourse Connect

O Guest Gate suporta o Discourse Connect.

Quando o Discourse Connect está habilitado, você pode opcionalmente fornecer uma URL de Cadastro separada usando:

• enable_discourse_connect_signup

• discourse_connect_signup_url

---

Gate Personalizado

O Gate Personalizado permite que você personalize completamente o conteúdo e a aparência do modal.

Ative-o com:

custom_gate_enabled

Ative o design do gate personalizado.

custom_gate_image

Imagem opcional exibida acima do texto personalizado.

custom_gate_image_alt

Texto alternativo para a imagem personalizada.

custom_gate_image_width

Defina a largura da imagem usando valores como:

• 150px

• 50%

• 100%

custom_gate_image_position

Alinhe a imagem:

• left

• center

• right

custom_gate_big_text_position

Alinhe o título personalizado:

• left

• center

• right

custom_gate_little_text_position

Alinhe o texto personalizado:

• left

• center

• right

O gate personalizado também fornece configurações para as cores do título, texto, fundo, rodapé e links.

---

Analítica

O Guest Gate v2.0 inclui analítica opcional com consciência de privacidade.

Ative-o com:

enable_analytics

Quando habilitado, o Guest Gate rastreia:

• Impressões do gate

• Motivo do gatilho

• Caminho da página

• Cliques em Login

• Cliques em Cadastro

• Ações de SSO

• Ações de dispensa

Os eventos são expostos através de window.dataLayer e também são despachados como o evento do navegador:

discourse-guest-gate:analytics

Isso permite que o Guest Gate seja integrado a plataformas de analítica e gerenciamento de tags, como Google Analytics, Google Tag Manager, Matomo, ou implementações personalizadas de analítica.

Nenhum dado pessoal é coletado pelo Guest Gate.

A analítica está desativada por padrão.

analytics_debug_logging

Ative isso durante a configuração da analítica para imprimir os eventos do Guest Gate no console do navegador.

Recomenda-se desativar isso em produção.

---

Migração da v1

O Guest Gate v2.0 inclui uma migração de configurações para instalações existentes.

As seguintes configurações legadas são migradas automaticamente:

• max_guest_topic_views

• dismissable_false

• gate_show_when_thumbnail_clicked

As configurações existentes, portanto, não precisam ser recriadas manualmente após a atualização.

---

Requisitos

O Guest Gate v2.0 requer Discourse 3.2.0 ou mais novo.

---

Crédito
Grandes agradecimentos aos autores originais do plugin, mantenedores e contribuidores: @vinothkannans, @jgujgu e @michaeld

[markersocial]

Obrigado! Isso é ótimo

Gostei muito que os links de login/cadastro podem ser substituídos por botões.

Eu sugeriria que talvez o botão de cadastro devesse ter a cor destacada (azul) com o botão ‘Eu já tenho uma conta’ sendo cinza. Isso parece ser mais padrão, pelo menos com base nas minhas observações de sites populares. Provavelmente a maioria das pessoas que veem o modal não tem uma conta, então isso provavelmente faz sentido.

[Don]

Olá @markersocial,

Obrigado pela sugestão!

Adicionei estas duas configurações. Agora você pode alterar o estilo dos botões de login e cadastro do modal de entrada de convidados.

btn-primary ou btn-default

Feature: ability to change login and signup button style

[markersocial]

Fantástico, muito obrigado @Don! Atualizei agora e está funcionando muito bem

Minha única outra sugestão seria poder personalizar a frequência dos prompts recorrentes.

Configuração: max guest topic views
“Número de visualizações de tópicos até que o portão seja exibido. Depois que o portão aparece pela primeira vez, ele aparece aleatoriamente entre 1 e este número.”

Ter o max guest topic views definido como 1 ou 2 é bom, incentivando o cadastro antecipado - mas se o usuário recusar (e “mostrar uma vez por sessão” não estiver ativado), seria bom poder mostrar o modal novamente com uma frequência menor para que não seja muito agressivo com os “lurkers”. Como a cada 5 ou mais visualizações de tópicos, por exemplo.

[davidkingham]

Ei Don, ótimo componente! Haveria alguma chance de você tornar o botão de inscrição personalizável para que um URL pudesse ser inserido? Eu uso o Memberful para SSL, então o link de inscrição normal não funciona, apenas te leva para a página de login. Obrigado!

[Don]

Olá David,

Obrigado, esta é uma ótima sugestão!

Eu adicionei isso. Substituí a configuração redirect_to_home por custom_url_enabled e duas opções.

1. custom_login_url: /login
   (por padrão, isso redireciona para a página inicial e abre a modal de login)
2. custom_signup_url: /singup
   (por padrão, isso redireciona para a página inicial e abre a modal de inscrição)

Feature: abality to change guest gate buttons url

[davidkingham]

Fantástico! Apenas um problema, agora as opções de texto de portão personalizado não estão funcionando

[Don]

Verifiquei seu site e funciona para mim. Talvez tente uma atualização forçada ou reabra o navegador, acho que você está vendo uma versão em cache.

[davidkingham]

Era o que eu também pensava, limpei meu cache, tentei 4 navegadores diferentes e todos estavam iguais, muito estranho! Se você não se importar de tentar novamente, acabei de mudar o guest_gate.title para ‘Test’, você vê essa atualização?

[Don]

Sim, é isso que vejo agora.

Vou tentar verificar outros navegadores e dispositivos.

[davidkingham]

Mesmos resultados via VPN, no meu celular, em uma rede diferente. Isso é a coisa mais estranha de todas! Acho que, desde que todo mundo possa ver o texto correto, tudo bem!

[Don]

Olá David,

Acho que isso não é normal. Talvez haja um bug de localidade. Minha melhor dica é a configuração definir localidade a partir do cabeçalho de aceitação de idioma.
Como vejo que você está usando isso em seu site, talvez seja por isso que você veja os textos padrão no modal porque o idioma do seu navegador é diferente e o Discourse o retorna para o texto padrão.

Você pode desativar essa configuração e tentar novamente?

---

Agora consigo replicar isso. Mudei o idioma do Chrome de Inglês (Reino Unido) para Inglês (Estados Unidos) e isso aconteceu.

e volte para Inglês (Reino Unido)

[davidkingham]

Obrigado Don, você é incrivelmente prestativo! Acho que há um bug na minha instalação com os idiomas. Como isso não parece ser causado pelo seu componente, vou iniciar um novo tópico. Agradeço por investigar isso.

EDIT: Descobri que minha localidade de administrador havia sido alterada de alguma forma para UK em vez de US, muito estranho! Mudei de volta e preenchi os campos novamente, agora tudo está bem no mundo.

[Jonathan5]

Isso funciona muito bem. Obrigado.

Fiz algumas pequenas edições para tornar a primeira postagem mais fácil de ler. No entanto, havia uma frase que eu não conseguia entender de jeito nenhum:

URL personalizada ativada
Adicione uma URL personalizada aos botões/links de Login e Cadastro. Por padrão, isso redireciona o visitante após clicar no botão de Login ou Cadastro para a página inicial e abre o modal de Login ou Cadastro. Observação: Se você deixar isso desmarcado, o visitante permanecerá na página do tópico após clicar nos botões e o modal Guest Gate mudará para o modal de Login ou Cadastro, que pode ser dispensado, para que o visitante possa fechá-lo e ler o tópico.

[Don]

Obrigado Jonathan Eu realmente aprecio Infelizmente meu inglês não é o melhor Desculpe por isso! Eu mudarei isso no Componente de Tema ou, claro, você também pode enviar um PR.

A configuração do site custom url enabled significa.
Você pode adicionar URLs personalizadas aos botões/links de Login e Cadastro do Guest Gate, que por padrão usam essas URLs personalizadas /login e /signup, que redirecionam o visitante para a página inicial e abrem o modal de Login ou Cadastro. Portanto, se você a marcar, ela ativará as duas configurações abaixo dela. A custom login url e custom signup url.

Se você deixar esta configuração desmarcada, ela manterá o visitante na página do tópico após clicar nos botões/links de Login ou Cadastro do Guest Gate e abrirá o modal de Login ou Cadastro na mesma página do tópico. Depois disso, o visitante pode fechar o modal.

Espero que ajude a entender e, novamente, obrigado pelo seu tempo para torná-lo mais compreensível

[Jonathan5]

Seu inglês está bom e não há nada de errado com seu JavaScript, que é o importante Que tal isto?

4. URL personalizada ativada – Ative as opções URL de login personalizada e URL de cadastro personalizada. O comportamento normal (se você deixar esta opção desmarcada) é que a janela modal de Login ou Cadastro apareça na página do tópico atual.
5. URL de login personalizada – Por exemplo, /login é a página inicial com a janela modal de "Login" exibida.
6. URL de cadastro personalizada – Por exemplo, /signup é a página inicial com a janela modal de "Cadastro" exibida.

[Don]

@Jonathan5

e não há nada de errado com o seu JavaScript

Isso é em grande parte graças aos autores e contribuidores do plugin também. Mas eu faço o meu melhor para desenvolver isso e adicionar mais recursos, correções, etc.

---

Obrigado pela correção isso parece muito melhor. Eu também corrigirei isso no componente do tema.

[Himanshu_Singh]

Olá a todos,

Recentemente instalei este componente e ele funciona perfeitamente, mas não tenho certeza se o mecanismo de bloqueio retarda o Google bot de rastrear os tópicos.

Alguém sabe sobre o impacto nos rastreadores?

[Himanshu_Singh]

Estou tendo alguns problemas de configuração com o Guest Gate ao usar SSO com o Discourse Connect.

O usuário consegue fazer login no site principal e, em seguida, parece estar logado no Discourse, mas após clicar em alguns tópicos, a modal do Guest Gate aparece. Isso é incomum, pois o usuário está logado.

Tenho URLs personalizadas para login, então quando o usuário clica em “Já estou logado”, ele é direcionado para a página de login personalizada e o ciclo se repete.

A única maneira de contornar isso é quando o usuário clica no botão de login nativo no Discourse e é automaticamente logado.

Parece que, por algum motivo, o Guest Gate não está respeitando o login do SSO e requer o login nativo para ativar.

Outras pessoas já enfrentaram esse problema? Alguma sugestão de solução ou contorno?