Invio di inviti utente in blocco

[Discourse]

Questa guida spiega come invitare più utenti alla propria istanza Discourse utilizzando la funzione di invito in blocco.

Livello utente richiesto: Amministratore

Invitare un gran numero di utenti alla propria istanza Discourse può richiedere molto tempo se fatto individualmente. Fortunatamente, Discourse offre una funzione di invito in blocco che consente di invitare più utenti contemporaneamente. Questa guida ti illustrerà il processo di invio degli inviti in blocco.

Non è possibile invitare gli utenti a gruppi predefiniti come gruppi di livello di fiducia, admin, mod o staff. Come soluzione alternativa, è possibile configurare un gruppo personalizzato per impostare automaticamente il livello di fiducia di un utente nella sezione Effetti della pagina di configurazione del gruppo. In questo modo, sarà possibile impostare il livello di fiducia degli utenti invitati su un livello di fiducia diverso da quello impostato dalla configurazione default invitee trust level del sito.

Panoramica

1. Assicurarsi che l’impostazione del sito Allow bulk invite sia abilitata (è abilitata per impostazione predefinita)
2. Preparare un file CSV con le informazioni dell’utente
3. Caricare il file CSV nell’istanza Discourse
4. Monitorare l’avanzamento dell’invito in blocco

Assicurarsi che l’impostazione del sito Allow bulk invite sia abilitata

L’impostazione Allow bulk invite è abilitata per impostazione predefinita. Se è stata disabilitata sul proprio sito:

1. Accedere alle impostazioni del sito su Admin > Tutte le impostazioni del sito e cercare bulk invite. Oppure andare su {your.domain.com}/admin/site_settings/category/all_results?filter=bulk%20invite
2. Se non è già abilitata, spuntare la casella accanto a Allow bulk invite e fare clic sul segno di spunta per salvare l’impostazione del sito.

Preparazione del file CSV

Il primo passo è creare un file CSV (Comma-Separated Values) contenente le informazioni degli utenti che si desidera invitare. Ecco cosa è necessario sapere:

• Ogni riga rappresenta un utente
• L’indirizzo email è obbligatorio e deve trovarsi nella prima colonna
• Le assegnazioni di gruppo (facoltative) vanno nella seconda colonna
• Un ID argomento specifico (facoltativo) va nella terza colonna
• Una locale (facoltativa) va nella quarta colonna
• Qualsiasi colonna aggiuntiva può essere utilizzata per impostare valori di campo utente personalizzati (l’intestazione della colonna deve corrispondere al nome del campo utente)

Ecco la struttura del file CSV:

email,groups,topic_id,locale

Linee guida per il file CSV

• Gli indirizzi email devono essere validi
• Separare più gruppi con punti e virgola (es. group_1;group_2;group_3)
• È possibile includere utenti esistenti se si desidera aggiungerli a gruppi
• Solo l’email è obbligatoria; gruppi, ID argomento, locale e campi utente sono facoltativi
• Se si includono campi utente personalizzati, il CSV deve avere una riga di intestazione che inizia con email

Esiste un’impostazione del sito nascosta max_bulk_invites che consente 50k righe in un CSV per impostazione predefinita.

Esempi di file CSV

user1@example.com,group_1;group_2,topic_id
user2@example.com,group_3,
user3@example.com,,

È possibile creare file CSV facilmente utilizzando software di fogli di calcolo come Microsoft Excel o Fogli Google. Ecco un esempio di come potrebbe apparire in un foglio di calcolo:

Basta assicurarsi di salvare il file come CSV al termine.

Formato CSV delimitato da virgole in Fogli Google

Formato CSV delimitato da virgole in Microsoft Excel

Caricamento del file CSV

Una volta preparato il file CSV, seguire questi passaggi per caricarlo:

1. Accedere alla scheda Inviti sul profilo utente Amministratore. {your.domain.com}/my/invited/pending

2. Fare clic sul pulsante “Bulk Invite from File”
   

   

3. Nel riquadro che appare, caricare il file CSV
   

   

4. Confermare il caricamento

Dopo il caricamento, si riceverà un messaggio di conferma che indica che si verrà notificati al completamento del processo.

Monitoraggio dell’avanzamento dell’invito in blocco

Una volta che il file CSV è stato elaborato, si riceverà una notifica tramite messaggio personale con un rapporto di avanzamento. Questo rapporto includerà:

• Numero totale di inviti inviati
• Numero di inviti non inviati (se presenti)
• Eventuali errori verificatisi durante il processo

È possibile controllare la pagina degli inviti sul proprio profilo utente per visualizzare un elenco degli inviti inviati con successo.

Cosa succede dopo

Ogni indirizzo email nel file CSV riceverà un’email di invito. L’email includerà:

• Il nome della persona che ha inviato l’invito
• Il titolo della propria community
• Una breve descrizione della propria community (dall’impostazione site description)
• Un link di invito

Quando un utente invitato fa clic sul link di conferma:

• Il suo account verrà attivato immediatamente e associato al suo indirizzo email
• Verrà aggiunto ai gruppi specificati (se inclusi nel CSV)
• Verrà indirizzato all’argomento di destinazione (se è stato specificato un ID argomento)

Gli inviti non cliccati scadranno in base all’impostazione invite expiry days (predefinita: 90 giorni).

Personalizzazione delle email di invito

Se si desidera personalizzare il testo delle email di invito:

• Per gli inviti generali, modificare il modello email “Invite Forum Mailer”
• Per gli inviti che includono un ID argomento specifico, modificare il modello email “Invite Mailer”

Risorse aggiuntive

• Adding users from groups to other groups in bulk