|||
| Riepilogo | Discourse Newsletter Integration aggiunge servizi personalizzabili di iscrizione alla newsletter alla tua istanza.
| Link al Repository | https://github.com/discourse/discourse-newsletter-integration
| Guida all’Installazione | Come installare 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 alla pagina delle preferenze dell’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 annullano l’iscrizione.
Il plugin sincronizza lo stato di iscrizione tra Discourse e il provider della newsletter.
Attualmente, il plugin supporta Mailchimp come provider della newsletter e una sola newsletter globale per tutti gli utenti. Il supporto per provider aggiuntivi e newsletter limitate ai gruppi è previsto per le future release.
Guida alla Configurazione 
Per abilitare il plugin, puoi usare l’interruttore nella tua pagina /admin/plugins, o controllando l’impostazione admin 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 sulla 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 sua 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 in base a ciò che ogni utente vede nella sua pagina delle preferenze:
js.discourse_newsletter_integration.preferences.section_headjs.discourse_newsletter_integration.preferences.checkbox_description
Integrazione Mailchimp
Ci sono tre impostazioni del sito Discourse relative all’integrazione 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 che vuoi sincronizzare con 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:
- Naviga alla sezione API Keys del tuo account.
- Clicca su Create New Key.
- Dai un nome alla tua chiave.
- Clicca su Generate Key.
- Clicca su Copy Key to Clipboard. Salva la tua chiave in un luogo sicuro.
- Clicca su Done.
Informazioni sulle Chiavi API | Mailchimp
discourse newsletter integration mailchimp list id
Ogni audience Mailchimp ha un ID audience univoco (a volte chiamato ID lista) di cui le integrazioni, i plugin e i widget potrebbero aver bisogno per connettersi e trasferire i dati degli iscritti. L’ID audience viene generato dal sistema di Mailchimp al momento della creazione dell’audience e non può essere modificato.
Per trovare il tuo ID audience, segui questi passaggi:
- Naviga a Audience
- Seleziona l’Audience che desideri
- Clicca sul menu a discesa Settings e scegli Audience name and defaults.
- Nella sezione Audience ID, 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:
Cambio di account Mailchimp
Dopo aver configurato l’integrazione Mailchimp e stabilito le audience per una newsletter, se cambi a un nuovo 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.





