| الملخص | يضيف إضافة تكامل النشرة الإخبارية لـ 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 | معرف جمهور 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 على معرف جمهور فريد (يُسمى أحيانًا معرف القائمة) قد تتطلبه التكاملات والإضافات والأدوات المتحركة للاتصال ونقل بيانات المشتركين. يتم إنشاء معرف الجمهور بواسطة نظام Mailchimp عند إنشاء الجمهور ولا يمكن تغييره.
لعثور على معرف جمهورك، اتبع الخطوات التالية:
- انتقل إلى الجمهور
- حدد الجمهور الذي تريده
- انقر على القائمة المنسدلة الإعدادات واختر اسم الجمهور والإعدادات الافتراضية.
- في قسم معرف الجمهور، سترى سلسلة من الأحرف والأرقام. هذا هو معرف جمهورك.
العثور على معرف جمهورك | Mailchimp
discourse newsletter integration mailchimp server prefix
سجّل الدخول إلى حسابك على Mailchimp وانظر إلى عنوان URL في متصفحك. سترى شيئًا مثل https://us19.admin.mailchimp.com/؛ الجزء us19 هو بادئة الخادم. لاحظ أن قيمتك الخاصة قد تكون مختلفة.
المشاكل المعروفة
تتمتع هذه الإضافة بوظائف أساسية وتعمل بشكل جيد، ولكن إليك بعض المشاكل المعروفة التي سنتعامل معها في المستقبل:
تغيير حسابات Mailchimp
بعد إعداد تكامل Mailchimp وإنشاء جماهير لنشرة إخبارية، إذا قمت بالتبديل إلى حساب جديد (عبر إعدادات الموقع)، فلن تتم مزامنة الجماهير مع الحساب الجديد.
مستضاف من قبلنا؟ هذه الإضافة متاحة في خطتنا Enterprise.





