بعد تثبيت إضافة WP Discourse، تحتاج إلى ربطها بـ Discourse الخاص بك. عندما تكون جاهزًا للانطلاق، شاهد هذا الفيديو القصير، أو اتبع التعليمات أدناه.
الخطوة التالية
بمجرد ربط الإضافة، انتقل إلى الموضوع الذي يصف الميزة التي تريد إعدادها:
- نشر المشاركات إلى Discourse
- استخدام Discourse لتعليقات WordPress
- تسجيل الدخول إلى Discourse باستخدام WordPress (DiscourseConnect)
التعليمات
الخطوات
عندما تنظر إلى علامة التبويب “الاتصال” في إعدادات إضافة WP Discourse، ستجد دائمًا إشعارًا في أعلى الصفحة يخبرك بما إذا كانت متصلة بـ Discourse الخاص بك. لإنشاء اتصال، أدخل:
-
أدخل عنوان URL لمنتدى الخاص بك في حقل إعداد “عنوان URL لـ Discourse”.
-
راجع إعداد “اسم المستخدم للنشر”. ما لم يكن لديك سبب محدد لتغييره، اتركه على “system”. إذا قمت بتغييره، فيجب أن يكون اسم مستخدم لمسؤول في Discourse الخاص بك. يمكنك العثور على اسم المستخدم للمستخدم تحت اسمه عند النقر على صورته الرمزية.
-
قم بإنشاء مفتاح API لـ Discourse لـ WordPress:
-
انتقل إلى لوحة تحكم المسؤول في Discourse (في منتدى Discourse الخاص بك)، وانقر على “API”.
-
قم بإنشاء مفتاح جديد مع ما يلي:
- الوصف: أدخل تسمية توضح الغرض من هذا المفتاح.
- مستوى المستخدم: حدد “جميع المستخدمين”.
- النطاق: حدد “عام”.
-
انسخ المفتاح الذي يظهر على الشاشة وانقر على “متابعة”.
-
-
الصق مفتاح API في إعداد “مفتاح API” في WP Discourse.
عندما تقوم بملء هذه الإعدادات، تأكد من النقر على زر “حفظ الخيارات”. إذا تم تكوين كل شيء بشكل صحيح، يجب أن ترى إشعارًا بأن “أنت متصل بـ Discourse” في أعلى الصفحة.
مواقع متعددة
تحتوي إضافة WP Discourse على خيار “تكوين مواقع متعددة” للحالة التي يكون فيها منتدى Discourse واحد متصلاً بشبكة من مواقع WordPress متعددة. هذا الخيار متاح في علامة التبويب “إعدادات الاتصال” للموقع الرئيسي للشبكة.
يتيح تحديده استخدام بعض إعدادات الإضافة عبر الشبكة بأكملها (جميع خيارات الاتصال، خيارات Webhook، مفتاح سر DiscourseConnect، وإعداد تمكين DiscourseConnect). سيؤدي تمكين هذا الإعداد إلى إنشاء جدول قاعدة بيانات إضافي يُستخدم لربط معرفات مواضيع Discourse بمعرفات مدونات WordPress عند نشر المشاركات من WordPress إلى Discourse.
الميزات غير المدعومة في المواقع المتعددة
لا يتم دعم استخدام WordPress كعميل DiscourseConnect في مواقع WordPress المتعددة.
مفتاح API محدد (جديد
)
يمكنك الآن إنشاء مفتاح API محدد لإضافة WP Discourse. ستصبح مفاتيح API المحددة هي الطريقة القياسية لربط WP Discourse بـ Discourse في المستقبل القريب.
كيفية استخدام مفتاح محدد
إليك كيفية استخدام مفتاح محدد:
-
أولاً، تأكد من أنك تستخدم الإصدار
2.4.3من الإضافة، وأحدث إصدار من Discourse على فرعtests-passed. مفاتيح API المحددة لـ WP Discourse غير مدعومة حاليًا على إصدار Discoursestable. -
انتقل إلى لوحة API في لوحة تحكم المسؤول في Discourse وأنشئ مفتاح “جميع المستخدمين” جديدًا، ولكن بنطاق “محدد”.
-
في أسفل قائمة النطاقات، ستجد نطاقات WordPress. حدد نطاق “النشر” (مطلوب حاليًا)، والنطاقات لأي ميزات أخرى تستخدمها في إضافة WP Discourse، وانقر على “حفظ”.
-
الآن استبدل مفتاحك القديم في إعداد “مفتاح API” في WP Discourse بمفتاحك المحدد الجديد واحفظ إعداداتك.
عند حفظ إعدادات WP Discourse الخاصة بك، يجب أن ترى الرسالة العادية “أنت متصل بـ Discourse!”.
إذا رأيت “أنت غير متصل بـ Discourse…” فقد يكون ذلك بسبب أن نطاقاتك غير صحيحة. تقارن الإضافة نطاقات مفتاح API الخاص بك بالميزات التي قمت بتمكينها حاليًا. إذا كانت لديك نطاقات غير كافية، فستعتبر أنك غير متصل. يمكنك رؤية النطاقات المفقودة عن طريق تمكين سجلات الاتصال والنظر إلى رسائل الخطأ في عارض السجلات.
نطاقات WP Discourse
هناك أربعة نطاقات لإضافة WP Discourse:
-
النشر. يسمح لك هذا النطاق بنشر المشاركات من WordPress إلى Discourse. هذا النطاق مطلوب، حتى لو كنت لا تنشر مشاركات (على سبيل المثال، تستخدم DiscourseConnect فقط) لأنه يتضمن وظائف تستخدمها جميع الميزات. سيتم فصل هذا في المستقبل، مما يجعل جميع النطاقات اختيارية.
-
التعليق. يسمح هذا النطاق بعرض الردود على المشاركات المنشورة في Discourse في WordPress كتعليقات.
-
DiscourseConnect. يسمح هذا النطاق باستخدام DiscourseConnect (بأي تكوين).
-
الأدوات المساعدة. هذا النطاق مطلوب لبعض وظائف الأدوات المساعدة المتاحة في الإضافة. إذا كان لديك أي كود مخصص يتفاعل مع الإضافة، فيجب عليك تمكين هذا النطاق، ما لم تكن متأكدًا من أنك لا تحتاجه.
لماذا استخدام مفتاح محدد؟
السبب الرئيسي لاستخدام مفتاح محدد هو الأمان. يسمح مفتاح API العام لأي شخص لديه المفتاح بالتصرف كمسؤول على Discourse الخاص بك. هذا يعني أن أمان Discourse الخاص بك يعتمد على أمان WordPress الخاص بك. مفتاح محدد أقل قوة بكثير، حيث يقتصر على النطاقات التي تمكنها له.