| Résumé | Discourse Newsletter Integration ajoute des services d’abonnement à la newsletter 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 du 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 retirés de la liste de diffusion liée chez le fournisseur de newsletter via leur 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 en tant que fournisseur de newsletter et uniquement une newsletter globale pour tous les utilisateurs. La prise en charge de fournisseurs supplémentaires et de newsletters limitées à des groupes est prévue pour les futures versions.
Guide de configuration 
Pour activer le plugin, vous pouvez utiliser le bouton basculant sur votre page /admin/plugins, ou en cochant le paramètre administrateur discourse newsletter integration enabled. Vous pouvez également accéder aux paramètres du plugin depuis cette page :
![]()
Personnaliser le texte dans la bannière et les 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 libellés 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 sur 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 ex. 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écurisé.
- Cliquez sur Terminé.
À propos des clés API | Mailchimp
discourse newsletter integration mailchimp list id
Chaque audience Mailchimp possède un ID d’audience unique (parfois appelé ID de liste) que les intégrations, plugins et widgets peuvent nécessiter 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 souhaitée
- Cliquez sur le menu déroulant Paramètres et choisissez Nom de l’audience et paramètres par défaut.
- 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 de 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 :
Changer de compte Mailchimp
Après avoir configuré l’intégration Mailchimp et établi des audiences pour une newsletter, si vous changez de 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.





