||||
-|-|
| Riepilogo | Discourse Newsletter Integration aggiunge servizi di iscrizione alla newsletter personalizzabili alla tua istanza.
| Link al repository | https://github.com/discourse/discourse-newsletter-integration
| Guida all’installazione | Come installare i plugin in Discourse
Funzionalità 
Gli amministratori possono configurare una newsletter globale che verrà sincronizzata con una mailing list nel provider della newsletter.
Gli utenti possono iscriversi alla newsletter da un banner del sito
Una volta che il banner viene chiuso, non apparirà più per l’utente.
Viene aggiunta una casella di controllo nella pagina delle preferenze utente (/my/preferences/emails), consentendo agli utenti di modificare la propria iscrizione alla newsletter in qualsiasi momento.
Gli iscritti vengono aggiunti o rimossi dalla mailing list collegata nel provider della newsletter tramite la loro API quando gli utenti si iscrivono o si disiscrivono.
Il plugin sincronizza lo stato dell’iscrizione tra Discourse e il provider della newsletter.
Attualmente, il plugin supporta Mailchimp come provider della newsletter e prevede solo una newsletter globale per tutti gli utenti. Il supporto per provider aggiuntivi e newsletter limitate ai gruppi è previsto per le versioni future.
Guida alla configurazione 
Per abilitare il plugin, puoi utilizzare l’interruttore nella pagina /admin/plugins, oppure controllando l’impostazione amministrativa discourse newsletter integration enabled. Puoi anche accedere alle impostazioni del plugin da questa pagina:
![]()
Personalizza il testo nel Banner e nelle Impostazioni Utente
Gli utenti vedranno un banner relativo alla newsletter, che consentirà loro di iscriversi o chiuderlo. Questo banner può essere personalizzato per adattarsi meglio alle esigenze del tuo forum e sarà visibile solo se tutte le impostazioni relative al plugin sono configurate. Una volta chiuso, l’utente non lo vedrà più ma potrà scegliere di iscriversi dalla pagina delle preferenze.
Puoi personalizzare il testo del banner di iscrizione dal pannello di amministrazione. Ecco le etichette personalizzabili per il banner:
js.discourse_newsletter_integration.banner.headingjs.discourse_newsletter_integration.banner.descriptionjs.discourse_newsletter_integration.banner.subscribe
js.discourse_newsletter_integration.banner.manage_preferencesjs.discourse_newsletter_integration.banner.thank_youjs.discourse_newsletter_integration.banner.added_to_newsletter
Puoi anche personalizzare il nome della tua newsletter come appare a ciascun utente nella loro pagina delle preferenze:
js.discourse_newsletter_integration.preferences.section_headjs.discourse_newsletter_integration.preferences.checkbox_description
Integrazione con Mailchimp
Ci sono tre impostazioni del sito Discourse relative all’integrazione con Mailchimp:
| Nome | Descrizione
|-|
| discourse newsletter integration mailchimp api key | Chiave API per il tuo account Mailchimp.
| discourse newsletter integration mailchimp list id | L’ID della tua Audience Mailchimp con cui desideri sincronizzare Discourse.
| discourse newsletter integration mailchimp server prefix | La parte del sottodominio dell’URL che vedi quando accedi al tuo account Mailchimp, ad esempio us14 e us19.
discourse newsletter integration mailchimp api key
Per generare una chiave API, segui questi passaggi:
- Vai alla sezione Chiavi API del tuo account.
- Clicca su Crea nuova chiave.
- Dai un nome alla tua chiave.
- Clicca su Genera chiave.
- Clicca su Copia chiave negli appunti. Salva la tua chiave in un luogo sicuro.
- Clicca su Fatto.
Informazioni sulle chiavi API | Mailchimp
discourse newsletter integration mailchimp list id
Ogni audience di Mailchimp ha un ID audience univoco (a volte chiamato ID lista) che le integrazioni, i plugin e i widget possono richiedere per connettersi e trasferire i dati degli iscritti. L’ID audience è generato dal sistema di Mailchimp quando l’audience viene creata e non può essere modificato.
Per trovare il tuo ID audience, segui questi passaggi:
- Vai a Audience
- Seleziona l’Audience che desideri
- Clicca sul menu a discesa Impostazioni e scegli Nome audience e impostazioni predefinite.
- Nella sezione ID Audience, vedrai una stringa di lettere e numeri. Questo è il tuo ID audience.
Trova il tuo ID Audience | Mailchimp
discourse newsletter integration mailchimp server prefix
Accedi al tuo account Mailchimp e guarda l’URL nel tuo browser. Vedrai qualcosa come https://us19.admin.mailchimp.com/; la parte us19 è il prefisso del server. Nota che il tuo valore specifico potrebbe essere diverso.
Problemi noti
Questo plugin ha funzionalità di base e funziona bene, ma ecco alcuni problemi noti che affronteremo in futuro:
Modifica degli account Mailchimp
Dopo aver configurato l’integrazione con Mailchimp e stabilito le audience per una newsletter, se cambi account (tramite le impostazioni del sito), le audience non verranno sincronizzate con il nuovo account.
Ospitato da noi? Questo plugin è disponibile sul nostro piano Enterprise.





