# تكوين تكامل Patreon مع Discourse

**URL:** https://meta.discourse.org/t/configure-patreon-integration-with-discourse/62380
**Category:** Integrations
**Tags:** patreon, how-to, platforms
**Created:** [9 مايو 2017، 6:46م UTC](https://meta.discourse.org/t/configure-patreon-integration-with-discourse/62380 "2017-05-09T18:46:55Z")
**Posts on this page:** 1
**Page:** 1

<div class="post-metadata">

### Author: ![Discourse](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/discourse/32/148734_2.png) [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [9 مايو 2017، 6:46م UTC](https://meta.discourse.org/t/configure-patreon-integration-with-discourse/62380/1 "2017-05-09T18:46:55Z")

</div>

> 🔖 يشرح هذا الدليل كيفية إعداد وتكوين تكامل Patreon مع منتدى Discourse الخاص بك، بما في ذلك مزامنة المستخدمين وإدارة المجموعات والتحكم في الوصول.
> 
> 🙋 مستوى المستخدم المطلوب: مسؤول
> 
> ⚠ يتطلب تثبيت إضافة Discourse Patreon

## ملخص

يغطي هذا الدليل:

- إعداد بيانات اعتماد واجهة برمجة تطبيقات Patreon
- تكوين إضافة Discourse Patreon
- مزامنة مستخدمي Patreon مع مجموعات Discourse
- إدارة إعدادات مجموعة الداعمين (Patron)
- إعداد خطافات الويب (webhooks) للتحديثات في الوقت الفعلي
- تقييد الوصول إلى الموقع لدعم Patreon

❗ تتم مزامنة الأعضاء الذين تعهدوا باشتراك في مستوى عضوي فقط مع مجموعات Discourse. لن تتم مزامنة المستخدمين المجانيين أو المستخدمين الذين تقل فترة تجربتهم المجانية عن 7 أيام.

## إنشاء بيانات اعتماد Patreon

1. انتقل إلى [صفحة عملاء Patreon ومفاتيح API](https://www.patreon.com/portal/registration/register-clients)
2. انقر على “Create Client” (إنشاء عميل)

 ![Creating a new Patreon client](https://global.discourse-cdn.com/meta/original/3X/5/b/5b376d0606891e9d490f32c09a873d695ab22f7e.png)

1. املأ النموذج بهذه التفاصيل:

- اسم التطبيق (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 client creation form](https://global.discourse-cdn.com/meta/original/3X/3/9/39c0c0891a4c8e7edbe661d6278e0163b3a32709.png)

⚠ تستخدم الإضافة حاليًا نقاط نهاية واجهة برمجة تطبيقات Patreon v1 داخليًا، لذا يجب تعيين إصدار واجهة برمجة تطبيقات العميل على `1`. سيؤدي تعيينه على `2` إلى حدوث أخطاء في المصادقة لأن العملاء الذين يستخدمون v2 فقط لا يمكنهم الوصول إلى نقاط نهاية v1. لاحظ أن Patreon أعلنت أنه سيتم إهمال واجهة برمجة تطبيقات v1 في المستقبل.

1. انقر على “Create Client” (إنشاء عميل)
2. احفظ بيانات الاعتماد الخاصة بك للخطوة التالية

 ![Patreon credentials](https://global.discourse-cdn.com/meta/original/4X/f/4/9/f49d13d2537427ceb1739ea1888313168e0fce37.png)

## تكوين إضافة Discourse

1. انتقل إلى لوحة الإشراف ← إعدادات الموقع (Admin → Site Settings)
2. اكتب `Patreon` في شريط البحث.
3. انسخ والصق ما يلي من عميل Patreon الخاص بك إلى Discourse:

- `patreon client id` (معرّف عميل Patreon)
- `patreon client secret` (سر عميل Patreon)
- `patreon creator access token` (رمز وصول منشئ المحتوى Patreon)
- `patreon creator refresh token` (رمز تحديث منشئ المحتوى Patreon)

 ![Discourse Patreon plugin settings](https://global.discourse-cdn.com/meta/original/3X/6/4/64384fab9293c2afe06fd82d3263a93ad8a219a3.png)

إعدادات اختيارية:

- قم بتمكين مطالبات التبرع عن طريق تحديد `patreon donation prompt enabled` وتعيين عنوان URL لحملتك.
- قم بتمكين تسجيل الدخول عبر Patreon عن طريق تعيين `patreon creator discourse username` (اسم مستخدم منشئ المحتوى Patreon في Discourse) وتحديد `patreon login enabled` (تسجيل الدخول عبر Patreon ممكّن).
- حدد `patreon enabled` لتنشيط الإضافة.

## مزامنة بيانات Patreon

1. قم بزيارة `https://discourse.example.com/admin/plugins/patreon`
2. انقر على “Update Patreon Data & Sync Groups” (تحديث بيانات Patreon ومزامنة المجموعات)

 ![Patreon sync interface](https://global.discourse-cdn.com/meta/original/3X/1/6/16dda57b7d2e2f53d0ca0c1df57d2e9d0d85a5ab.png)

ستعرض المزامنة الناجحة رسالة تأكيد:

 ![Sync confirmation](https://global.discourse-cdn.com/meta/original/3X/6/5/65c28b588dd7129dd35776c5333b82dc94988ccc.png)

## ربط مستويات Patreon بمجموعات Discourse

1. حدد مجموعة Discourse من القائمة المنسدلة “Group” (المجموعة)
2. اختر مستوى مكافأة Patreon من القائمة المنسدلة “Rewards” (المكافآت)
3. انقر على أيقونة الحفظ (Save icon)

 ![Group linking interface](https://global.discourse-cdn.com/meta/original/3X/b/f/bf85056abaa7cae07e35092a31ec069de09346e2.png)

بعد ربط المجموعات، انقر على “Update Patreon Data & Sync Groups” (تحديث بيانات Patreon ومزامنة المجموعات) مرة أخرى لمزامنة المستخدمين الحاليين.

## تخصيص مجموعة الداعمين (Patron Group)

تتضمن مجموعة الداعمين الافتراضية (Patron group):

- شارة صورة ملف شخصي (Avatar flair)
- شارة الداعم (Patron badge)

لتخصيص هذه:

1. قم بزيارة صفحة مجموعة الداعمين (Patron group page)
2. انقر على علامة التبويب “Manage” (إدارة)
3. اضبط إعدادات الشارة ووصف المجموعة

 ![Patron group management](https://global.discourse-cdn.com/meta/original/3X/3/a/3a5516a0ffa11d3624e0084bfe6e5a8d7fec8f81.png)

## إعداد خطافات الويب (Webhooks) (اختياري)

لتمكين المزامنة في الوقت الفعلي:

1. قم بزيارة [Platform | Applications | Patreon](https://www.patreon.com/portal/registration/register-webhooks)
2. أنشئ خطاف ويب يشير إلى `https://discourse.example.com/patreon/webhook`

 ![Creating webhook](https://global.discourse-cdn.com/meta/original/3X/d/a/dab07207fb811df8360897cdd0406c83408fe231.png)

1. قم بتمكين المشغلات التالية:

- إنشاء تعهد (Create Pledge) (`pledges:create` أو `members:pledge:create`)
- تحديث تعهد (Update Pledge) (`pledges:update` أو `members:pledge:update`)
- حذف تعهد (Delete Pledge) (`pledges:delete` أو `members:pledge:delete`)

 ![Webhook triggers](https://global.discourse-cdn.com/meta/original/3X/5/9/59f6b0ce0f7c5ed4d340b8da00ded2658f92728c.png)

1. انسخ سر خطاف الويب إلى إعداد الموقع `patreon webhook secret`

## تقييد الوصول إلى الموقع لدعم Patreon

لتقييد الوصول إلى الموقع لمستخدمي Patreon فقط:

1. تأكد من عمل تسجيل الدخول عبر Patreon
2. قم بتعطيل الإعدادات التالية:

- `enable local logins` (تمكين تسجيل الدخول المحلي)
- `enable local logins via email` (تمكين تسجيل الدخول المحلي عبر البريد الإلكتروني)

لتقييد الوصول إلى داعمي Patreon فقط:

1. قم بتكوين إعدادات أمان الفئة (category security settings)
2. اربط الفئات بالمجموعات المتصلة بـ Patreon

## استكشاف الأخطاء وإصلاحها

قم بتمكين التسجيل المفصل عن طريق تفعيل الإعداد `patreon verbose log`. الوصول إلى السجلات على `https://discourse.example.com/logs`.

## موارد إضافية

- [Discourse Patreon](https://meta.discourse.org/t/discourse-patreon-integration/44366)
- [فهم المجموعات وأذونات الفئة](https://meta.discourse.org/t/how-to-use-category-security-settings-to-create-private-categories/87678)
- [عملاء Patreon ومفاتيح API](https://www.patreon.com/portal/registration/register-clients)