Componente del tema Guest Gate

[Don]

	Repository	GitHub - VaperinaDEV/discourse-guest-gate-theme-component: Forced login / registration popup insired by Quora · GitHub
	Ti è stato utile?	> ./support --coffee
	Guida all’installazione	Come installare un tema o un componente di tema
	Nuovo ai temi di Discourse?	Guida per principianti all’uso dei temi di Discourse

Guest Gate v1.0

Ciao Questo componente di tema è stato creato a partire da Guest Gate (Sign Up Popup Plugin). Può bloccare i topic per i visitatori anonimi con una finestra modale e costringerli a Registrarsi o Accedere. Il componente può essere utilizzato per una finestra modale di avviso, che incoraggia i visitatori a registrarsi ma consente loro di chiuderla (per fare ciò, lasciare deselezionata l’impostazione dismissable false). Le opzioni includono la modifica del numero di topic che possono essere visualizzati prima che venga visualizzata la finestra modale.

Suggerimento: Se utilizzi l’opzione “gate personalizzato” e desideri nascondere l’intestazione della finestra modale (come nell’immagine sopra), devi eliminare il campo guest_gate.title e premere spazio. Questo rimuoverà il titolo della finestra modale, in modo da poter utilizzare invece un titolo sotto l’immagine.

Hai due opzioni principali per il gate:

1. Gate generico (impostazione predefinita: utilizzerà il testo CTA di registrazione di Discourse nella finestra modale). Utilizza questi testi: js.signup_cta.intro e js.signup_cta.value_prop

2. Gate personalizzato (puoi personalizzare la finestra modale: aggiungere immagine, testo personalizzato e colori).

---

E ci sono molte altre impostazioni

Impostazioni globali della finestra modale Guest Gate

1. max guest topic views
   Numero di visualizzazioni del topic prima che il gate venga visualizzato. Dopo la prima comparsa del gate, questo appare casualmente tra 1 e questo numero.
2. dismissable false
   Rimuove il pulsante di chiusura, impedendo ai visitatori di chiuderlo.
3. use gate buttons
   Usa pulsanti nel piè di pagina della finestra modale invece di link.
4. custom url enabled
   Attiva le opzioni per l’URL di accesso personalizzato e l’URL di registrazione personalizzato. Il comportamento normale (se lasci deselezionata questa opzione) è che la finestra modale di Accesso o Registrazione appaia nella pagina del topic corrente.
5. custom login url
   Ad esempio, /login è la pagina principale con la finestra modale “Accesso” visualizzata.
6. custom signup url
   Ad esempio, /signup è la pagina principale con la finestra modale “Registrazione” visualizzata.
7. gate footer position
   Posizione dei pulsanti/link nel piè di pagina.
8. gate show only once
   La finestra modale Guest Gate viene visualizzata solo una volta per sessione.

---

Impostazioni del Gate Personalizzato

1. custom gate enabled
   Attivalo se desideri personalizzare la finestra modale.
2. custom gate image
   Carica un’immagine da visualizzare in alto nella finestra modale.
3. custom gate image width
   La larghezza dell’immagine caricata. Puoi usare px, % ecc., ad esempio 100% aggiungerà un’immagine a tutta la larghezza della finestra modale (meno il padding).
4. custom gate big text color
   Il “testo grande” appare sotto l’immagine. Puoi impostare il colore del testo.
5. custom gate little text color
   Il “testo piccolo” appare sotto il testo grande. Puoi impostare il colore del testo.
6. custom gate background color
   Cambia il colore di sfondo della finestra modale.
7. custom gate footer text color
   Cambia il colore del testo nel piè di pagina. Questo si applica se l’impostazione use gate buttons è disabilitata e hai configurato un gate personalizzato.
8. custom gate link color
   Cambia il colore dei link nel piè di pagina. Questo si applica se l’impostazione use gate buttons è disabilitata e hai configurato un gate personalizzato.

---

Crediti Un grande ringraziamento agli autori, manutentori e contributor del plugin: @vinothkannans, @jgujgu e @michaeld

Guest Gate v2.0

Ciao

Guest Gate v2.0 è un gate moderno e configurabile per i visitatori anonimi su Discourse.

Può visualizzare una finestra modale per incoraggiare i visitatori a Registrarsi o Accedere, sia come sollecitazione di conversione soft che come gate che i visitatori non possono chiudere.

Guest Gate è nato dal plugin originale Guest Gate Sign Up Popup ed è evoluto notevolmente da allora.

Attivazione del Guest Gate

La versione 2.0 supporta diversi modi per attivare il gate:

1. Visualizzazioni di pagina
   Visualizza il gate dopo un numero configurabile di visualizzazioni di pagine ammissibili.

2. Tempo
   Visualizza il gate dopo che un visitatore ha trascorso una quantità di tempo configurabile su una pagina ammissibile.

3. Scroll
   Visualizza il gate dopo che un visitatore ha fatto scroll per una percentuale configurabile della pagina.

4. Lightbox
   Visualizza il gate quando un visitatore anonimo apre un’immagine nella lightbox di Discourse.

5. Qualsiasi
   Abilita più tipi di trigger e visualizza il gate quando viene raggiunto il primo trigger configurato.

Puoi anche configurare un ritardo tra il trigger e la comparsa della finestra modale.

---

Comportamento di ripetizione

Dopo che il Guest Gate è stato visualizzato, puoi controllare quando può apparire di nuovo.

Modalità disponibili:

• Ripeti trigger: mostra il gate ogni volta che si verifica il trigger configurato.

• Visualizzazioni di pagina casuali: mostra il gate dopo un numero casuale di visualizzazioni di pagina.

• Una volta per sessione: mostra il gate al massimo una volta durante la sessione del browser.

L’impostazione legacy Mostra solo una volta è supportata anche per la compatibilità retroattiva.

---

Visibilità URL

Due impostazioni controllano dove Guest Gate è consentito apparire:

url_for_show

Definisci i percorsi in cui Guest Gate può essere attivato.

Esempi:

• * tutte le pagine

• / pagina principale

• /latest Ultimi

• /t/* topic

• /c/* categorie

url_for_hide

Definisci i percorsi in cui Guest Gate non deve mai apparire.

I pattern di nascondimento hanno sempre la precedenza sull’elenco di visualizzazione.

---

Impostazioni della finestra modale

dismissable

Consenti ai visitatori di chiudere la finestra modale Guest Gate.

Disabilita questa opzione per creare un gate non chiudibile.

gate_modal_size

Scegli la larghezza della finestra modale:

• compact

• standard

• wide

gate_body_alignment

Scegli l’allineamento orizzontale del contenuto principale della finestra modale:

• left

• center

• right

gate_footer_position

Scegli l’allineamento dei link o dei pulsanti di Accesso / Registrazione:

• left

• center

• right

gate_title_visibility

Mostra o nascondi il titolo della finestra modale.

gate_title_position

Controlla la posizione dei margini del titolo.

---

Accesso e Registrazione

Guest Gate supporta il flusso di autenticazione normale di Discourse nonché URL personalizzati.

use_gate_buttons

Usa pulsanti nel piè di pagina della finestra modale invece di link di testo.

custom_url_enabled

Usa URL di Accesso e Registrazione personalizzati invece delle azioni di autenticazione native di Discourse.

custom_login_url

Destinazione utilizzata per l’Accesso quando gli URL personalizzati sono abilitati.

custom_signup_url

Destinazione utilizzata per la Registrazione quando gli URL personalizzati sono abilitati.

Puoi anche configurare in modo indipendente gli stili dei pulsanti e le icone Font Awesome.

---

Discourse Connect

Guest Gate supporta Discourse Connect.

Quando Discourse Connect è abilitato, puoi opzionalmente fornire un URL di Registrazione separato utilizzando:

• enable_discourse_connect_signup

• discourse_connect_signup_url

---

Gate Personalizzato

Il Gate Personalizzato ti consente di personalizzare completamente il contenuto e l’aspetto della finestra modale.

Attivalo con:

custom_gate_enabled

Abilita il design del gate personalizzato.

custom_gate_image

Immagine opzionale visualizzata sopra il testo personalizzato.

custom_gate_image_alt

Testo alternativo per l’immagine personalizzata.

custom_gate_image_width

Imposta la larghezza dell’immagine utilizzando valori come:

• 150px

• 50%

• 100%

custom_gate_image_position

Allinea l’immagine:

• left

• center

• right

custom_gate_big_text_position

Allinea l’intestazione personalizzata:

• left

• center

• right

custom_gate_little_text_position

Allinea il testo personalizzato:

• left

• center

• right

Il gate personalizzato fornisce anche impostazioni per i colori dell’intestazione, del testo, dello sfondo, del piè di pagina e dei link.

---

Analytics

Guest Gate v2.0 include analytics opzionali attente alla privacy.

Attivalo con:

enable_analytics

Quando abilitato, Guest Gate traccia:

• Visualizzazioni del gate

• Motivo del trigger

• Percorso della pagina

• Clic su Accesso

• Clic su Registrazione

• Azioni SSO

• Azioni di chiusura

Gli eventi sono esposti tramite window.dataLayer e vengono anche dispatchati come evento del browser:

discourse-guest-gate:analytics

Questo consente a Guest Gate di essere integrato con piattaforme di analytics e tag management come Google Analytics, Google Tag Manager, Matomo, o implementazioni di analytics personalizzate.

Nessun dato personale viene raccolto da Guest Gate.

Gli analytics sono disabilitati per impostazione predefinita.

analytics_debug_logging

Abilita questa opzione durante la configurazione degli analytics per stampare gli eventi di Guest Gate nella console del browser.

Si consiglia di disabilitare questa opzione in produzione.

---

Migrazione da v1

Guest Gate v2.0 include una migrazione delle impostazioni per le installazioni esistenti.

Le seguenti impostazioni legacy vengono migrate automaticamente:

• max_guest_topic_views

• dismissable_false

• gate_show_when_thumbnail_clicked

Le configurazioni esistenti quindi non devono essere ricreate manualmente dopo l’aggiornamento.

---

Requisiti

Guest Gate v2.0 richiede Discourse 3.2.0 o più recente.

---

Crediti
Un grande ringraziamento agli autori originali, manutentori e contributor del plugin: @vinothkannans, @jgujgu e @michaeld

[markersocial]

Grazie! È fantastico

Mi piace molto che i link di accesso/registrazione possano essere sostituiti da pulsanti.

Suggerirei che forse il pulsante di registrazione dovrebbe essere del colore evidenziato (blu) con il pulsante “Ho già un account” grigio. Sembra essere più standard, almeno dalle mie osservazioni di siti popolari. Probabilmente la maggior parte delle persone che vedono la modale non hanno un account, quindi probabilmente ha senso.

[Don]

Ciao @markersocial,

Grazie per il suggerimento!

Ho aggiunto queste due impostazioni. Ora puoi cambiare lo stile dei pulsanti di accesso e registrazione della modale del gate per gli ospiti.

btn-primary o btn-default

Feature: ability to change login and signup button style

[markersocial]

Fantastico, grazie mille @Don! L’ho aggiornato ora e funziona alla grande

Il mio unico altro suggerimento sarebbe di poter personalizzare la frequenza dei prompt ricorrenti.

Impostazione: visualizzazioni massime degli argomenti per gli ospiti
“Numero di visualizzazioni degli argomenti fino alla visualizzazione del gate. Dopo che il gate appare per la prima volta, appare casualmente tra 1 e questo numero.”

Avere un numero massimo di visualizzazioni degli argomenti per gli ospiti impostato su 1 o 2 è utile, incoraggiando l’iscrizione anticipata, ma se l’utente rifiuta (e non è abilitato “mostra una volta per sessione”), sarebbe bello poter mostrare di nuovo il modale a una frequenza minore in modo che non sia troppo aggressivo nei confronti dei lurker. Ad esempio, ogni 5 o più visualizzazioni di argomenti.

[davidkingham]

Ehi Don, ottimo componente! Potresti rendere il pulsante di iscrizione personalizzabile in modo da poter inserire un URL? Uso Memberful per SSL, quindi il normale link di iscrizione non funziona, rimanda solo alla pagina di accesso. Grazie!

[Don]

Ciao David,

Grazie, è un ottimo suggerimento!

L’ho aggiunto. Ho sostituito l’impostazione redirect_to_home con custom_url_enabled e due opzioni.

1. custom_login_url: /login
   (per impostazione predefinita questo reindirizza alla homepage e apre la modale di accesso)
2. custom_signup_url: /singup
   (per impostazione predefinita questo reindirizza alla homepage e apre la modale di registrazione)

Feature: abality to change guest gate buttons url

[davidkingham]

Fantastico! Solo un problema, ora le opzioni di testo personalizzato del cancello non funzionano

[Don]

Ho controllato il tuo sito e funziona per me. Prova un aggiornamento forzato o riapri il browser, penso che tu stia vedendo una versione memorizzata nella cache.

[davidkingham]

L’ho pensato anch’io, ho cancellato la cache, ho provato 4 browser diversi e tutti erano uguali, molto strano! Se non ti dispiace riprovare, ho appena cambiato guest_gate.title in ‘Test’, vedi questo aggiornamento?

[Don]

Sì, questo è quello che vedo ora.

Proverò a controllare altri browser e dispositivi.

[davidkingham]

Stessi risultati tramite VPN, sul mio telefono, rete diversa. Questa è la cosa più strana di sempre! Suppongo che finché tutti gli altri possono vedere il testo corretto, va bene!

[Don]

Ciao David,

Penso che non sia normale. Forse c’è un bug di localizzazione. Il mio miglior suggerimento è l’impostazione imposta la localizzazione dall'header accept language.
Come vedo che la stai usando sul tuo sito, forse è per questo che vedi i testi predefiniti nella modale perché la lingua del tuo browser è diversa e Discourse la riporta al testo predefinito.

Puoi disattivare questa impostazione e riprovare?

---

Ora posso replicare questo. Ho cambiato la lingua di Chrome da Inglese (Regno Unito) a Inglese (Stati Uniti) e questo è successo.

e sono tornato a Inglese (Regno Unito)

[davidkingham]

Grazie Don, sei incredibilmente disponibile! Penso che ci sia un bug nella mia installazione con le lingue. Dato che questo non sembra essere causato dal tuo componente, aprirò un nuovo argomento. Apprezzo che tu abbia approfondito la questione.

MODIFICA: Ho scoperto che la mia impostazione locale dell’amministratore era stata in qualche modo cambiata in UK invece che US, molto strano! L’ho ripristinata e ho compilato nuovamente i campi, ora tutto va bene nel mondo.

[Jonathan5]

Funziona molto bene. Grazie.

Ho apportato alcune piccole modifiche per rendere più facile la lettura del primo post. C’era una frase che non riuscivo a capire affatto:

url personalizzato abilitato
Aggiungi un url personalizzato ai pulsanti/link di Login e Signup, per impostazione predefinita questo reindirizza il visitatore dopo aver cliccato sul pulsante Login o Signup alla homepage e apre la modale di Login o Signup. Nota: Se deselezioni questa opzione, il visitatore rimarrà sulla pagina dell’argomento dopo aver cliccato sui pulsanti e la modale Guest Gate cambierà con la modale Login o Signup che è chiudibile, quindi il visitatore può chiuderla e leggere l’argomento.

[Don]

Grazie Jonathan Lo apprezzo molto Purtroppo il mio inglese non è dei migliori Scusa per questo! Li cambierò nel componente del tema o ovviamente potresti inviare anche una PR.

L’impostazione del sito custom url enabled significa.
Puoi aggiungere URL personalizzati ai pulsanti/link di accesso e registrazione del Guest Gate che per impostazione predefinita utilizzano questi URL personalizzati /login e /signup che reindirizzano il visitatore alla homepage e aprono la modale di accesso o registrazione. Quindi, se lo hai selezionato, attiverà le due impostazioni sottostanti. Il custom login url e il custom signup url.

Se lasci questa impostazione deselezionata, manterrà il visitatore sulla pagina dell’argomento dopo aver cliccato sui pulsanti/link di accesso e registrazione del Guest Gate e aprirà la modale di accesso o registrazione sulla stessa pagina dell’argomento. Dopo di che il visitatore può chiudere la modale.

Spero che aiuti a capire e ancora grazie per il tuo tempo per renderlo più comprensibile

[Jonathan5]

Il tuo inglese va benissimo e non c’è niente che non vada nel tuo JavaScript, che è la cosa importante Che ne dici di questo?

4. custom url enabled – Abilita le opzioni custom login url e custom signup url. Il comportamento normale (se lasci questa opzione deselezionata) è che la finestra modale di Login o Registrazione appaia sulla pagina dell’argomento corrente.
5. custom login url – Ad esempio, /login è la home page con la finestra modale "Login" visualizzata.
6. custom signup url – Ad esempio, /signup è la home page con la finestra modale "Registrazione" visualizzata.

[Don]

@Jonathan5

e non c’è niente di sbagliato nel tuo JavaScript

Questo è in gran parte grazie anche agli autori e ai collaboratori dei plugin. Ma faccio del mio meglio per sviluppare questo e aggiungere più funzionalità, correzioni, ecc.

---

Grazie per la correzione sembra molto meglio. Correggerò anche questi nel componente del tema.

[Himanshu_Singh]

Ciao a tutti,
Ho recentemente installato questo componente e funziona alla grande, ma non sono sicuro se il meccanismo di gating rallenti il Google bot dall’indicizzare gli argomenti.

Qualcuno conosce l’impatto sui crawler?

[Himanshu_Singh]

Sto riscontrando alcuni problemi di configurazione con Guest Gate quando utilizzo SSO con Discourse Connect.

L’utente è in grado di accedere al sito principale e quindi sembra essere connesso a Discourse, ma dopo aver cliccato su alcuni argomenti, appare la finestra modale di Guest Gate. Questo è insolito poiché l’utente è connesso.

Ho URL personalizzati per l’accesso, quindi quando l’utente clicca su “Sono già connesso”, viene indirizzato alla pagina di accesso personalizzata e il ciclo si ripete.

L’unico modo per aggirare questo problema è quando l’utente clicca sul pulsante di accesso nativo in Discourse e viene automaticamente connesso.

Sembra che per qualche motivo Guest Gate non riconosca l’accesso da SSO e richieda l’accesso nativo per attivarsi.

Altre persone hanno riscontrato questo problema? Avete suggerimenti per una soluzione o una soluzione alternativa?