|||
| Résumé | Discourse Newsletter Integration ajoute des services d’abonnement personnalisables à votre instance.
| Lien du dépôt | https://github.com/discourse/discourse-newsletter-integration
| Guide d’installation | Comment installer des plugins dans Discourse
Fonctionnalités 
Les administrateurs peuvent configurer une newsletter globale qui sera synchronisée avec une liste de diffusion dans le fournisseur de newsletter.
Les utilisateurs peuvent s’abonner à la newsletter depuis une bannière sur le site.
Une fois la bannière fermée, elle n’apparaîtra plus pour l’utilisateur.
Une case à cocher est ajoutée à la page des préférences utilisateur (/my/preferences/emails), permettant aux utilisateurs de modifier leur abonnement à la newsletter à tout moment.
Les abonnés sont ajoutés ou supprimés de la liste de diffusion liée dans le fournisseur de newsletter via son API lorsque les utilisateurs s’abonnent ou se désabonnent.
Le plugin synchronise le statut d’abonnement entre Discourse et le fournisseur de newsletter.
Actuellement, le plugin prend en charge Mailchimp comme fournisseur de newsletter et une seule newsletter globale pour tous les utilisateurs. La prise en charge de fournisseurs supplémentaires et de newsletters limitées aux groupes est prévue pour les futures versions.
Guide de configuration 
Pour activer le plugin, vous pouvez utiliser le commutateur sur votre page /admin/plugins, ou en cochant le paramètre d’administration discourse newsletter integration enabled. Vous pouvez également accéder aux paramètres du plugin depuis cette page :
![]()
Personnaliser le texte de la bannière et des paramètres utilisateur
Les utilisateurs verront une bannière concernant la newsletter, leur permettant de s’abonner ou de la fermer. Cette bannière peut être personnalisée pour mieux répondre aux besoins de votre forum, et ne sera visible que si tous les paramètres liés au plugin sont configurés. Une fois fermée, l’utilisateur ne la verra plus mais pourra choisir de s’abonner depuis sa page de préférences.
Vous pouvez personnaliser le texte de la bannière d’abonnement depuis le panneau d’administration. Voici les étiquettes personnalisables pour la bannière :
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
Vous pouvez également personnaliser le nom de votre newsletter tel qu’il apparaît pour chaque utilisateur dans sa page de préférences :
js.discourse_newsletter_integration.preferences.section_headjs.discourse_newsletter_integration.preferences.checkbox_description
Intégration Mailchimp
Il existe trois paramètres de site Discourse liés à l’intégration Mailchimp :
| Nom | Description |
|---|---|
| discourse newsletter integration mailchimp api key | Clé API pour votre compte Mailchimp. |
| discourse newsletter integration mailchimp list id | L’ID de votre audience Mailchimp que vous souhaitez synchroniser avec Discourse. |
| discourse newsletter integration mailchimp server prefix | La partie sous-domaine de l’URL que vous voyez lorsque vous vous connectez à votre compte Mailchimp, par exemple us14 et us19. |
discourse newsletter integration mailchimp api key
Pour générer une clé API, suivez ces étapes :
- Accédez à la section Clés API de votre compte.
- Cliquez sur Créer une nouvelle clé.
- Nommez votre clé.
- Cliquez sur Générer la clé.
- Cliquez sur Copier la clé dans le presse-papiers. Enregistrez votre clé dans un endroit sûr.
- Cliquez sur Terminé.
À propos des clés API | Mailchimp
discourse newsletter integration mailchimp list id
Chaque audience Mailchimp a un ID d’audience unique (parfois appelé ID de liste) dont les intégrations, plugins et widgets peuvent avoir besoin pour se connecter et transférer les données des abonnés. L’ID d’audience est généré par le système de Mailchimp lors de la création de l’audience et ne peut pas être modifié.
Pour trouver votre ID d’audience, suivez ces étapes :
- Accédez à Audience
- Sélectionnez l’Audience que vous souhaitez
- Cliquez sur le menu déroulant Paramètres et choisissez Nom et paramètres par défaut de l’audience.
- Dans la section ID d’audience, vous verrez une chaîne de lettres et de chiffres. C’est votre ID d’audience.
Trouver votre ID d’audience | Mailchimp
discourse newsletter integration mailchimp server prefix
Connectez-vous à votre compte Mailchimp et regardez l’URL dans votre navigateur. Vous verrez quelque chose comme https://us19.admin.mailchimp.com/; la partie us19 est le préfixe du serveur. Notez que votre valeur spécifique peut être différente.
Problèmes connus
Ce plugin a des fonctionnalités de base et fonctionne bien, mais voici quelques problèmes connus que nous traiterons à l’avenir :
Changement de comptes Mailchimp
Après avoir configuré l’intégration Mailchimp et établi des audiences pour une newsletter, si vous changez pour un nouveau compte (via les paramètres du site), les audiences ne seront pas synchronisées avec le nouveau compte.
Hébergé par nous ? Ce plugin est disponible sur notre plan Enterprise.





