يشرح هذا الدليل كيفية إعداد وتكوين تكامل Patreon مع منتدى Discourse الخاص بك، بما في ذلك مزامنة المستخدمين وإدارة المجموعات والتحكم في الوصول.
مستوى المستخدم المطلوب: مسؤول
يتطلب تثبيت إضافة Discourse Patreon
ملخص
يغطي هذا الدليل:
- إعداد بيانات اعتماد واجهة برمجة تطبيقات Patreon
- تكوين إضافة Discourse Patreon
- مزامنة مستخدمي Patreon مع مجموعات Discourse
- إدارة إعدادات مجموعة الداعمين (Patron)
- إعداد خطافات الويب (webhooks) للتحديثات في الوقت الفعلي
- تقييد الوصول إلى الموقع لدعم Patreon
تتم مزامنة الأعضاء الذين تعهدوا باشتراك في مستوى عضوي فقط مع مجموعات Discourse. لن تتم مزامنة المستخدمين المجانيين أو المستخدمين الذين تقل فترة تجربتهم المجانية عن 7 أيام.
إنشاء بيانات اعتماد Patreon
- انتقل إلى صفحة عملاء Patreon ومفاتيح API
- انقر على “Create Client” (إنشاء عميل)
- املأ النموذج بهذه التفاصيل:
- اسم التطبيق (App Name)
- الوصف (Description)
- فئة التطبيق (App Category)
- المؤلف (Author)
- نطاق الشركة (Company Domain):
discourse.example.com - عنوان URL لسياسة الخصوصية (Privacy Policy URL):
https://discourse.example.com/privacy - عنوان URL لشروط الخدمة (Terms of Service URL):
https://discourse.example.com/tos - عناوين URL لإعادة التوجيه (Redirect URIs):
https://discourse.example.com/auth/patreon/callback - إصدار واجهة برمجة تطبيقات العميل (Client API Version): اضبطها على
1
تستخدم الإضافة حاليًا نقاط نهاية واجهة برمجة تطبيقات Patreon v1 داخليًا، لذا يجب تعيين إصدار واجهة برمجة تطبيقات العميل على 1. سيؤدي تعيينه على 2 إلى حدوث أخطاء في المصادقة لأن العملاء الذين يستخدمون v2 فقط لا يمكنهم الوصول إلى نقاط نهاية v1. لاحظ أن Patreon أعلنت أنه سيتم إهمال واجهة برمجة تطبيقات v1 في المستقبل.
- انقر على “Create Client” (إنشاء عميل)
- احفظ بيانات الاعتماد الخاصة بك للخطوة التالية
تكوين إضافة Discourse
- انتقل إلى لوحة الإشراف ← إعدادات الموقع (Admin → Site Settings)
- اكتب
Patreonفي شريط البحث. - انسخ والصق ما يلي من عميل Patreon الخاص بك إلى Discourse:
patreon client id(معرّف عميل Patreon)patreon client secret(سر عميل Patreon)patreon creator access token(رمز وصول منشئ المحتوى Patreon)patreon creator refresh token(رمز تحديث منشئ المحتوى Patreon)
إعدادات اختيارية:
- قم بتمكين مطالبات التبرع عن طريق تحديد
patreon donation prompt enabledوتعيين عنوان URL لحملتك. - قم بتمكين تسجيل الدخول عبر Patreon عن طريق تعيين
patreon creator discourse username(اسم مستخدم منشئ المحتوى Patreon في Discourse) وتحديدpatreon login enabled(تسجيل الدخول عبر Patreon ممكّن). - حدد
patreon enabledلتنشيط الإضافة.
مزامنة بيانات Patreon
- قم بزيارة
https://discourse.example.com/admin/plugins/patreon - انقر على “Update Patreon Data & Sync Groups” (تحديث بيانات Patreon ومزامنة المجموعات)
ستعرض المزامنة الناجحة رسالة تأكيد:
ربط مستويات Patreon بمجموعات Discourse
- حدد مجموعة Discourse من القائمة المنسدلة “Group” (المجموعة)
- اختر مستوى مكافأة Patreon من القائمة المنسدلة “Rewards” (المكافآت)
- انقر على أيقونة الحفظ (Save icon)
بعد ربط المجموعات، انقر على “Update Patreon Data & Sync Groups” (تحديث بيانات Patreon ومزامنة المجموعات) مرة أخرى لمزامنة المستخدمين الحاليين.
تخصيص مجموعة الداعمين (Patron Group)
تتضمن مجموعة الداعمين الافتراضية (Patron group):
- شارة صورة ملف شخصي (Avatar flair)
- شارة الداعم (Patron badge)
لتخصيص هذه:
- قم بزيارة صفحة مجموعة الداعمين (Patron group page)
- انقر على علامة التبويب “Manage” (إدارة)
- اضبط إعدادات الشارة ووصف المجموعة
إعداد خطافات الويب (Webhooks) (اختياري)
لتمكين المزامنة في الوقت الفعلي:
- قم بزيارة Platform | Applications | Patreon
- أنشئ خطاف ويب يشير إلى
https://discourse.example.com/patreon/webhook
- قم بتمكين المشغلات التالية:
- إنشاء تعهد (Create Pledge) (
pledges:createأوmembers:pledge:create) - تحديث تعهد (Update Pledge) (
pledges:updateأوmembers:pledge:update) - حذف تعهد (Delete Pledge) (
pledges:deleteأوmembers:pledge:delete)
- انسخ سر خطاف الويب إلى إعداد الموقع
patreon webhook secret
تقييد الوصول إلى الموقع لدعم Patreon
لتقييد الوصول إلى الموقع لمستخدمي Patreon فقط:
- تأكد من عمل تسجيل الدخول عبر Patreon
- قم بتعطيل الإعدادات التالية:
enable local logins(تمكين تسجيل الدخول المحلي)enable local logins via email(تمكين تسجيل الدخول المحلي عبر البريد الإلكتروني)
لتقييد الوصول إلى داعمي Patreon فقط:
- قم بتكوين إعدادات أمان الفئة (category security settings)
- اربط الفئات بالمجموعات المتصلة بـ Patreon
استكشاف الأخطاء وإصلاحها
قم بتمكين التسجيل المفصل عن طريق تفعيل الإعداد patreon verbose log. الوصول إلى السجلات على https://discourse.example.com/logs.