|||
| 概要 | Discourse Newsletter Integration は、カスタマイズ可能なニュースレター購読サービスをインスタンスに追加します。
| リポジトリリンク | https://github.com/discourse/discourse-newsletter-integration
| インストールガイド | Discourseにプラグインをインストールする方法
機能 
管理者は、ニュースレタープロバイダーのメーリングリストと同期されるグローバルニュースレターを設定できます。
ユーザーはサイトバナーからニュースレターを購読できます。
バナーを閉じると、ユーザーには再度表示されません。
ユーザー設定ページ(/my/my/preferences/emails)にチェックボックスが追加され、ユーザーはいつでもニュースレターの購読を変更できます。
ユーザーが購読または購読解除すると、ニュースレタープロバイダーのリンクされたメーリングリストにAPI経由で購読者が追加または削除されます。
プラグインは、Discourseとニュースレタープロバイダー間の購読ステータスを同期します。
現在、プラグインはニュースレタープロバイダーとしてMailchimpをサポートしており、すべてのユーザーに対して1つのグローバルニュースレターのみをサポートしています。将来のリリースでは、追加のプロバイダーや、グループに限定されたニュースレターのサポートが計画されています。
設定ガイド 
プラグインを有効にするには、/admin/plugins ページのトグルを使用するか、discourse newsletter integration enabled 管理設定を確認してください。このページからプラグインの設定にアクセスすることもできます。
![]()
バナーとユーザー設定のテキストをカスタマイズする
ユーザーにはニュースレターに関するバナーが表示され、購読または閉じるオプションが提供されます。このバナーは、フォーラムのニーズに合わせてカスタマイズでき、プラグインに関連するすべての設定が構成されている場合にのみ表示されます。閉じると、ユーザーには再度表示されませんが、設定ページから購読を選択できます。
管理パネルから購読バナーのテキストをカスタマイズできます。以下は、バナーのカスタマイズ可能なラベルです。
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
また、各ユーザーが設定ページで表示するニュースレターの名前をカスタマイズすることもできます。
js.discourse_newsletter_integration.preferences.section_headjs.discourse_newsletter_integration.preferences.checkbox_description
Mailchimp連携
Mailchimp連携に関連する3つのDiscourseサイト設定があります。
| 名前 | 説明 |
|---|---|
| discourse newsletter integration mailchimp api key | MailchimpアカウントのAPIキー。 |
| discourse newsletter integration mailchimp list id | Discourseと同期したいMailchimpオーディエンスのID。 |
| discourse newsletter integration mailchimp server prefix | Mailchimpアカウントにログインしたときに表示されるURLのサブドメイン部分。例:「us14」や「us19」。 |
discourse newsletter integration mailchimp api key
APIキーを生成するには、次の手順に従います。
- アカウントのAPIキーセクションに移動します。
- 新しいキーを作成をクリックします。
- キーに名前を付けます。
- キーを生成をクリックします。
- クリップボードにコピーをクリックします。キーを安全な場所に保存してください。
- 完了をクリックします。
discourse newsletter integration mailchimp list id
各Mailchimpオーディエンスには、統合、プラグイン、ウィジェットが接続して購読者データを転送するために必要とする可能性のある一意のオーディエンスID(リストIDと呼ばれることもあります)があります。オーディエンスIDは、オーディエンスが作成されたときにMailchimpのシステムによって生成され、変更することはできません。
オーディエンスIDを見つけるには、次の手順に従います。
- **オーディエンス**に移動します。
- オーディエンスを選択します。
- 設定ドロップダウンをクリックし、オーディエンス名とデフォルトを選択します。
- オーディエンスIDセクションに、文字と数字の文字列が表示されます。これがオーディエンスIDです。
discourse newsletter integration mailchimp server prefix
Mailchimpアカウントにログインし、ブラウザのURLを確認してください。https://us19.admin.mailchimp.com/のようなものが表示されます。us19の部分がサーバープレフィックスです。特定の値は異なる場合があることに注意してください。
既知の問題
このプラグインは基本的な機能であり、うまく機能しますが、将来的に対応する予定の既知の問題がいくつかあります。
Mailchimpアカウントの変更
Mailchimp連携を設定し、ニュースレターのオーディエンスを確立した後、新しいアカウントに変更した場合(サイト設定経由)、オーディエンスは新しいアカウントと同期されません。
当社でホストされていますか?このプラグインは当社のエンタープライズプランで利用可能です。





