| Резюме | Интеграция с рассылкой Discourse добавляет настраиваемые службы подписки на рассылку в ваш экземпляр. | |
| Ссылка на репозиторий | 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-ключи вашей учетной записи.
- Нажмите Создать новый ключ.
- Дайте имя вашему ключу.
- Нажмите Сгенерировать ключ.
- Нажмите Копировать ключ в буфер обмена. Сохраните ключ в надежном месте.
- Нажмите Готово.
discourse newsletter integration mailchimp list id
Каждая аудитория Mailchimp имеет уникальный ID аудитории (иногда называемый ID списка), который могут требовать интеграции, плагины и виджеты для подключения и передачи данных подписчиков. ID аудитории генерируется системой Mailchimp при создании аудитории и не может быть изменен.
Чтобы найти ID аудитории, выполните следующие действия:
- Перейдите в Аудиторию
- Выберите нужную аудиторию
- Нажмите на выпадающее меню Настройки и выберите Имя аудитории и параметры по умолчанию.
- В разделе ID аудитории вы увидите строку из букв и цифр. Это ваш ID аудитории.
Найти ID аудитории | Mailchimp
discourse newsletter integration mailchimp server prefix
Войдите в свою учетную запись Mailchimp и посмотрите URL-адрес в браузере. Вы увидите что-то вроде https://us19.admin.mailchimp.com/; часть us19 — это префикс сервера. Обратите внимание, что ваше конкретное значение может отличаться.
Известные проблемы
Этот плагин имеет базовую функциональность и работает хорошо, но вот некоторые известные проблемы, которые мы будем решать в будущем:
Смена учетной записи Mailchimp
После настройки интеграции с Mailchimp и создания аудиторий для рассылки, если вы перейдете на новую учетную запись (через настройки сайта), аудитории не будут синхронизироваться с новой учетной записью.
Размещено нами? Этот плагин доступен в нашем корпоративном плане.





