 |
요약 | 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 통합
Mailchimp 통합과 관련된 Discourse 사이트 설정은 세 가지입니다:
| 이름 | 설명 |
|---|---|
| discourse newsletter integration mailchimp api key | Mailchimp 계정의 API 키. |
| discourse newsletter integration mailchimp list id | Discourse와 동기화하려는 Mailchimp Audience의 ID. |
| discourse newsletter integration mailchimp server prefix | Mailchimp 계정에 로그인할 때 URL에서 볼 수 있는 서브도메인 부분, 예: 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 Audience에는 고유한 Audience ID(때로는 List ID라고도 함)가 있으며, 통합, 플러그인 및 위젯이 연결하고 구독자 데이터를 전송하는 데 필요할 수 있습니다. Audience ID는 Audience가 생성될 때 Mailchimp 시스템에 의해 생성되며 변경할 수 없습니다.
Audience ID를 찾으려면 다음 단계를 따르세요:
- **Audience**로 이동합니다.
- 원하는 Audience를 선택합니다.
- Settings 드롭다운을 클릭하고 Audience name and defaults를 선택합니다.
- Audience ID 섹션에서 문자와 숫자의 문자열을 볼 수 있습니다. 이것이 Audience ID입니다.
Find Your Audience ID | Mailchimp
discourse newsletter integration mailchimp server prefix
Mailchimp 계정에 로그인하고 브라우저의 URL을 확인하세요. https://us19.admin.mailchimp.com/와 같은 내용을 볼 수 있으며, us19 부분이 서버 접두사입니다. 특정 값은 다를 수 있습니다.
알려진 문제
이 플러그인은 기본 기능을 갖추고 잘 작동하지만, 향후 처리할 알려진 문제가 있습니다:
Mailchimp 계정 변경
Mailchimp 통합을 설정하고 뉴스레터용 Audience를 설정한 후, 새 계정으로 변경(사이트 설정을 통해)하면 Audience가 새 계정과 동기화되지 않습니다.
