| Краткое описание | Discourse Newsletter Integration добавляет на ваш сайт настраиваемую службу подписки на рассылки. | |
| Ссылка на репозиторий | https://github.com/discourse/discourse-newsletter-integration | |
| Руководство по установке | Как установить плагины в Discourse |
Возможности 
Администраторы могут настроить глобальную рассылку, которая будет синхронизироваться со списком рассылки в сервисе новостей.
Пользователи могут подписаться на рассылку через баннер на сайте.
После закрытия баннер больше не появится для этого пользователя.
На странице настроек пользователя (/my/preferences/emails) добавляется флажок, позволяющий пользователям изменять подписку на рассылку в любое время.
Подписчики добавляются или удаляются из связанного списка рассылки в сервисе новостей через их API, когда пользователи подписываются или отписываются.
Плагин синхронизирует статус подписки между Discourse и сервисом новостей.
В настоящее время плагин поддерживает Mailchimp в качестве поставщика новостей и только одну глобальную рассылку для всех пользователей. Поддержка дополнительных поставщиков и рассылок, ограниченных группами, запланирована в будущих выпусках.
Руководство по настройке 
Чтобы включить плагин, вы можете использовать переключатель на странице /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
Существуют три настройки сайта Discourse, связанные с интеграцией Mailchimp:
| Имя | Описание |
|---|---|
| discourse newsletter integration mailchimp api key | API-ключ для вашего аккаунта Mailchimp. |
| discourse newsletter integration mailchimp list id | ID аудитории Mailchimp, которую вы хотите синхронизировать с Discourse. |
| discourse newsletter integration mailchimp server prefix | Часть поддомена в URL, которую вы видите при входе в свой аккаунт Mailchimp, например us14 и us19. |
discourse newsletter integration mailchimp api key
Чтобы создать API-ключ, выполните следующие действия:
- Перейдите в раздел API Keys вашего аккаунта.
- Нажмите Create New Key.
- Дайте название ключу.
- Нажмите Generate Key.
- Нажмите Copy Key to Clipboard. Сохраните ключ в безопасном месте.
- Нажмите Done.
discourse newsletter integration mailchimp list id
У каждой аудитории Mailchimp есть уникальный ID аудитории (иногда называемый ID списка), который может потребоваться интеграциям, плагинам и виджетам для подключения и передачи данных подписчиков. ID аудитории генерируется системой Mailchimp при создании аудитории и не может быть изменен.
Чтобы найти ID вашей аудитории, выполните следующие действия:
- Перейдите в раздел Audience
- Выберите нужную аудиторию
- Нажмите на выпадающее меню Settings и выберите Audience name and defaults.
- В разделе Audience ID вы увидите строку из букв и цифр. Это ваш ID аудитории.
Найдите ID вашей аудитории | Mailchimp
discourse newsletter integration mailchimp server prefix
Войдите в свой аккаунт Mailchimp и посмотрите на URL в браузере. Вы увидите что-то вроде https://us19.admin.mailchimp.com/; часть us19 — это префикс сервера. Обратите внимание, что ваше конкретное значение может отличаться.
Известные проблемы
У этого плагина базовая функциональность, и он работает хорошо, но вот некоторые известные проблемы, которые мы будем решать в будущем:
Смена аккаунтов Mailchimp
После настройки интеграции Mailchimp и создания аудиторий для рассылки, если вы перейдете на новый аккаунт (через настройки сайта), аудитории не будут синхронизированы с новым аккаунтом.
Хостинг у нас? Этот плагин доступен в нашем плане Enterprise.





