Modale di benvenuto di Discourse

:information_source: Riepilogo Una modale di benvenuto per aiutare i membri della community nuovi o di ritorno con modi pratici per iniziare a esplorare/interagire in un forum
:eyeglasses: Anteprima Theme Creator (È necessario aver effettuato l’accesso)
:hammer_and_wrench: Repository GitHub - noahLovell/discourse-welcome-modal
:question: Guida all’installazione Come installare un tema o un componente tema
:open_book: Nuovo ai temi di Discourse? Guida per principianti all’utilizzo dei temi di Discourse

Installa questo componente tema

:rocket: Perché usarlo?

Molte community registrano alti tassi di iscrizione ma faticano con il “tasso di abbandono del primo giorno”. Fornendo percorsi attuabili, si riduce il carico cognitivo sui nuovi membri e li si guida verso i comportamenti di alto valore che costruiscono la fidelizzazione a lungo termine.


:camera_flash: Screenshot

Desktop


Mobile


Come funziona

La modale utilizza un’implementazione basata sulla logica in modo da evitare di sollecitare i membri abituali che hanno già familiarità con la tua community.

  1. Nuovi Utenti: Viene visualizzata automaticamente a tutti gli utenti registrati dopo la data feature_enabled_date.
  2. Periodo di Grazia: Durante una finestra configurabile, il componente contrassegna “silenziosamente” gli utenti attivi come se avessero visto la modale, in modo da non interromperli.
  3. Utenti Legacy: Viene mostrata agli utenti esistenti che tornano sul forum dopo la scadenza del periodo di grazia, aiutandoli a riorientarsi.

Nota: Lo stato “visto” viene memorizzato localmente nel browser dell’utente, quindi la modale potrebbe riapparire se l’utente cambia dispositivo o svuota la cache.


:gear: Impostazioni

Impostazione Tipo Predefinito Descrizione
enabled bool false Attiva/disattiva la Discourse Welcome Modal quando sei pronto per abilitarla per i membri.
feature_enabled_date string "2026-01-01" Inserisci la data nel formato AAAA-MM-GG.
grace_period_months integer 3 Numero di mesi dopo la data di abilitazione della funzione per contrassegnare silenziosamente gli utenti esistenti come visti.
card_layout enum "grid" Scegli come visualizzare le schede nella modale di benvenuto (grid o list).
card_content objects [] Configura le schede mostrate nella modale di benvenuto (richiede id, title, subtitle, imgUrl, altText, btnLabel e action).
title (Traduzione) text Join the conversation L’intestazione principale visualizzata nella parte superiore della modale.
close_btn (Traduzione) text Done L’etichetta per il pulsante che chiude la modale.

Usa ?show-welcome-modal=true per forzare la visualizzazione della Welcome Modal, indipendentemente dal fatto che la funzione sia abilitata o dal suo stato di visualizzazione precedente - ideale per i test prima di rendere pubblica la tua community :slight_smile:


Questo è il mio primo vero componente tema :raised_hands: Sarei lieto di ricevere feedback, pensieri, cose che avrebbero potuto essere fatte meglio :smile:

20 Mi Piace

Ciao @noahl

Qual è il modo più semplice per testarlo e vedere le tessere come nelle tue immagini demo? C’è un certo insieme di impostazioni che consentirebbe agli amministratori di vedere le tessere prima che le rendiamo disponibili più ampiamente in un ambiente PORD?

2 Mi Piace

Ehi @marksalter! Sei il mio primo “richiedente di funzionalità” :raising_hands:

Ho appena caricato un’impostazione enable, insieme a un parametro di query per forzare la visualizzazione del modale: ?show-welcome-modal=true

Se combini entrambe queste cose, potrai testare come amministratore prima di abilitarla per gli utenti :slight_smile:

Ad esempio: disattiva l’impostazione (non verrà visualizzata a nessuno) e poi usa il parametro di query per forzarne la visualizzazione.

6 Mi Piace

Funziona a meraviglia! Grazie per aver dato un’occhiata.

3 Mi Piace

Solo un pensiero per il vostro prossimo ciclo di sviluppo. Sarebbe bello se potessimo specificare quali messaggi vengono mostrati ai nuovi utenti rispetto agli utenti esistenti che non sono stati attivi durante il periodo di grazia.

Così i nuovi arrivati ricevono messaggi di benvenuto (vai al materiale introduttivo) mentre gli utenti esistenti ricevono un messaggio del tipo “cosa c’è di nuovo” (dai un’occhiata a queste nuove funzionalità/categorie/cose…).

4 Mi Piace

Questo è davvero bello! Ottimo lavoro :clap:

Cosa ne pensi di rimuovere il piè di pagina? Dato che ci sono le CTA, insieme al pulsante di chiusura, Done (Fatto) sembra un po’ superfluo, ma sono curioso di sapere cosa ne pensi?

Adoro questa idea! Era qualcosa a cui avevo pensato per la prima versione, ma ho deciso di mantenere semplice il rilascio iniziale.

Comunque, ho appena rilasciato un aggiornamento che implementa questa segmentazione! C’è una piccola modifica alla logica per distinguere tra diversi stati utente, in modo da poter personalizzare il contenuto senza essere invadenti.

Come funziona ora:

1. Le Definizioni

  • Nuovi Utenti: Registrati il o dopo la tua feature_enabled_date (data di abilitazione della funzionalità).
  • Utenti Esistenti: Registrati prima di quella data.
  • Utenti Attivi: Membri che visitano regolarmente (all’interno della tua finestra di inattività).
  • Utenti di Ritorno: Membri precedentemente attivi che sono stati assenti abbastanza a lungo da superare la soglia di inattività.

2. Il Flusso Logico Per assicurarci di non infastidire i membri più attivi, il componente segue una priorità specifica:

  • Nuova Registrazione: Vedono il modale immediatamente (targettizzati con schede contrassegnate come new_users o both).
  • Periodo di Grazia: Se un ‘Utente Esistente’ visita durante il tuo periodo di grazia, il componente lo marca silenziosamente come visto in modo che non venga interrotto.
  • Intervallo di Inattività: Una volta che un utente è contrassegnato come ‘visto’, il componente tiene traccia delle visite localmente. Se visita quotidianamente, rimane Attivo e non lo vedrà mai più. Lo vedrà (come Utente di Ritorno) solo se il divario tra le sue visite supera l’impostazione returning_user_inactivity_months (questa è una nuova impostazione :slight_smile: )

3. Contenuti Personalizzati Ora puoi usare l’impostazione displayFor su ogni scheda:

  • new_users: Perfetto per ‘Come pubblicare’ o ‘Presentati’.
  • returning_users: Perfetto per ‘Dai un’occhiata alle novità mentre eri assente’.
  • both: Link essenziali come Linee Guida o FAQ.

Ho anche aggiunto parametri di anteprima in modo da poter testare facilmente questi flussi: ?show-welcome-modal=true&user-type=new o &user-type=returning.

Grazie ancora per la spinta!

3 Mi Piace

@noahl Fantastico!

Proverò a dare un’occhiata più tardi oggi o lunedì e ti farò sapere come vanno le cose.

1 Mi Piace