ربط Connect WP بـ Discourse

بعد تثبيت إضافة WP Discourse، تحتاج إلى ربطها بـ Discourse الخاص بك. عندما تكون جاهزًا للانطلاق، شاهد هذا الفيديو القصير، أو اتبع التعليمات أدناه.

الخطوة التالية

بمجرد ربط الإضافة، انتقل إلى الموضوع الذي يصف الميزة التي تريد إعدادها:


التعليمات

الخطوات

عندما تنظر إلى علامة التبويب “الاتصال” في إعدادات إضافة WP Discourse، ستجد دائمًا إشعارًا في أعلى الصفحة يخبرك بما إذا كانت متصلة بـ Discourse الخاص بك. لإنشاء اتصال، أدخل:

  1. أدخل عنوان URL لمنتدى الخاص بك في حقل إعداد “عنوان URL لـ Discourse”.

  2. راجع إعداد “اسم المستخدم للنشر”. ما لم يكن لديك سبب محدد لتغييره، اتركه على “system”. إذا قمت بتغييره، فيجب أن يكون اسم مستخدم لمسؤول في Discourse الخاص بك. يمكنك العثور على اسم المستخدم للمستخدم تحت اسمه عند النقر على صورته الرمزية.

  3. قم بإنشاء مفتاح API لـ Discourse لـ WordPress:

    1. انتقل إلى لوحة تحكم المسؤول في Discourse (في منتدى Discourse الخاص بك)، وانقر على “API”.

    2. قم بإنشاء مفتاح جديد مع ما يلي:

      • الوصف: أدخل تسمية توضح الغرض من هذا المفتاح.
      • مستوى المستخدم: حدد “جميع المستخدمين”.
      • النطاق: حدد “عام”.
    3. انسخ المفتاح الذي يظهر على الشاشة وانقر على “متابعة”.

  4. الصق مفتاح API في إعداد “مفتاح API” في WP Discourse.

عندما تقوم بملء هذه الإعدادات، تأكد من النقر على زر “حفظ الخيارات”. إذا تم تكوين كل شيء بشكل صحيح، يجب أن ترى إشعارًا بأن “أنت متصل بـ Discourse” في أعلى الصفحة.

مواقع متعددة

تحتوي إضافة WP Discourse على خيار “تكوين مواقع متعددة” للحالة التي يكون فيها منتدى Discourse واحد متصلاً بشبكة من مواقع WordPress متعددة. هذا الخيار متاح في علامة التبويب “إعدادات الاتصال” للموقع الرئيسي للشبكة.

يتيح تحديده استخدام بعض إعدادات الإضافة عبر الشبكة بأكملها (جميع خيارات الاتصال، خيارات Webhook، مفتاح سر DiscourseConnect، وإعداد تمكين DiscourseConnect). سيؤدي تمكين هذا الإعداد إلى إنشاء جدول قاعدة بيانات إضافي يُستخدم لربط معرفات مواضيع Discourse بمعرفات مدونات WordPress عند نشر المشاركات من WordPress إلى Discourse.

الميزات غير المدعومة في المواقع المتعددة

لا يتم دعم استخدام WordPress كعميل DiscourseConnect في مواقع WordPress المتعددة.

مفتاح API محدد (جديد :sparkles:)

يمكنك الآن إنشاء مفتاح API محدد لإضافة WP Discourse. ستصبح مفاتيح API المحددة هي الطريقة القياسية لربط WP Discourse بـ Discourse في المستقبل القريب.

كيفية استخدام مفتاح محدد

إليك كيفية استخدام مفتاح محدد:

  1. أولاً، تأكد من أنك تستخدم الإصدار 2.4.3 من الإضافة، وأحدث إصدار من Discourse على فرع tests-passed. مفاتيح API المحددة لـ WP Discourse غير مدعومة حاليًا على إصدار Discourse stable.

  2. انتقل إلى لوحة API في لوحة تحكم المسؤول في Discourse وأنشئ مفتاح “جميع المستخدمين” جديدًا، ولكن بنطاق “محدد”.

  3. في أسفل قائمة النطاقات، ستجد نطاقات WordPress. حدد نطاق “النشر” (مطلوب حاليًا)، والنطاقات لأي ميزات أخرى تستخدمها في إضافة WP Discourse، وانقر على “حفظ”.

  4. الآن استبدل مفتاحك القديم في إعداد “مفتاح API” في WP Discourse بمفتاحك المحدد الجديد واحفظ إعداداتك.

عند حفظ إعدادات WP Discourse الخاصة بك، يجب أن ترى الرسالة العادية “أنت متصل بـ Discourse!”.

إذا رأيت “أنت غير متصل بـ Discourse…” فقد يكون ذلك بسبب أن نطاقاتك غير صحيحة. تقارن الإضافة نطاقات مفتاح API الخاص بك بالميزات التي قمت بتمكينها حاليًا. إذا كانت لديك نطاقات غير كافية، فستعتبر أنك غير متصل. يمكنك رؤية النطاقات المفقودة عن طريق تمكين سجلات الاتصال والنظر إلى رسائل الخطأ في عارض السجلات.

نطاقات WP Discourse

هناك أربعة نطاقات لإضافة WP Discourse:

  1. النشر. يسمح لك هذا النطاق بنشر المشاركات من WordPress إلى Discourse. هذا النطاق مطلوب، حتى لو كنت لا تنشر مشاركات (على سبيل المثال، تستخدم DiscourseConnect فقط) لأنه يتضمن وظائف تستخدمها جميع الميزات. سيتم فصل هذا في المستقبل، مما يجعل جميع النطاقات اختيارية.

  2. التعليق. يسمح هذا النطاق بعرض الردود على المشاركات المنشورة في Discourse في WordPress كتعليقات.

  3. DiscourseConnect. يسمح هذا النطاق باستخدام DiscourseConnect (بأي تكوين).

  4. الأدوات المساعدة. هذا النطاق مطلوب لبعض وظائف الأدوات المساعدة المتاحة في الإضافة. إذا كان لديك أي كود مخصص يتفاعل مع الإضافة، فيجب عليك تمكين هذا النطاق، ما لم تكن متأكدًا من أنك لا تحتاجه.

لماذا استخدام مفتاح محدد؟

السبب الرئيسي لاستخدام مفتاح محدد هو الأمان. يسمح مفتاح API العام لأي شخص لديه المفتاح بالتصرف كمسؤول على Discourse الخاص بك. هذا يعني أن أمان Discourse الخاص بك يعتمد على أمان WordPress الخاص بك. مفتاح محدد أقل قوة بكثير، حيث يقتصر على النطاقات التي تمكنها له.

7 إعجابات

نواجه مشكلة، أثناء تحديث المنشورات على ووردبريس لا يتم تحديث المنشورات ذات الصلة على ديسكورس. نحصل على الخطأ التالي في السجلات.

خطأ:
publish.ERROR: update_post.post_error {“wp_title”:"title … ",“wp_author_id”:“2205402”,“wp_post_id”:3179224,“response_message”:“You are not permitted to view the requested resource. The API username or key is invalid.”,“http_code”:403}

نحن نستخدم مفتاحًا تفصيليًا لربط WP Discourse بـ Discourse مع نطاقات “Wordpress Pubblishing” و “Wordpress Commenting”. هل يمكن لأحد مساعدتي في هذا؟

مرحباً @deepak_dhamde، يؤسفني أنك تواجه مشكلة. أنا مسافر اليوم ولكن سأحاول إعادة إنشاء مشكلتك والعودة إليك في أقرب وقت ممكن غداً.

إعجاب واحد (1)

مرحباً @deepak_dhamde لقد سجلت فيديو لنفسي وأنا أقوم بإعداد مفتاح حبيبي بالنطاقات التي تستخدمها. إذا كان بإمكانك مراجعته وإخباري إذا كنت تفعل أي شيء بشكل مختلف.

مرحباً @angus، آسف على التأخير في الرد.
نحن نتبع نفس الإجراء بالضبط لإنشاء مفتاح Granular Key ولكننا لا نزال نرى نفس الخطأ 403 في السجلات. عندما نقوم بتحديث منشورات ووردبريس، لا يتم تحديث الموضوع المتعلق به على discourse.

خطأ:

[2024-09-16 06:51:28] publish.ERROR: update_post.post_error {“wp_title”:“Testing update post feature on staging site”,“wp_author_id”:“2168699”,“wp_post_id”:3175772,“response_message”:“You are not permitted to view the requested resource. The API username or key is invalid.”,“http_code”:403}

مرحباً @deepak_dhamde.

من المحتمل أن يكون هناك بعض الاختلافات الطفيفة في الطريقة التي تقوم بها بالإعداد، أو في بيئتك. من الصعب عليّ العثور على هذا الاختلاف دون مزيد من المعلومات. إليك بعض الطرق التي يمكننا من خلالها المضي قدمًا:

  1. يمكنك منحني حق الوصول إلى بيئتك (يسعدني توقيع اتفاقية عدم إفشاء) حتى أتمكن من إلقاء نظرة؛ أو
  2. يمكنك تسجيل مقطع فيديو خاص بك وأنت تقوم بنفس الشيء الذي قمت به للتو (أرسله إليّ على الخاص)؛ أو
  3. يمكنك إلقاء نظرة أخرى والنظر في هذه العوامل:
    • هل Discourse و Wordpress لديك محدثان؟
    • هل يمكنك إنشاء مفتاح “Global” يعمل؟
    • هل حاولت جعل أعضاء آخرين في فريقك يقومون بنفس مجموعة الخطوات (أحيانًا يرى منظور جديد شيئًا مختلفًا)
    • شارك ملف “meta” في عارض سجلات WP Discourse الخاص بك معي (أي بيئة Wordpress الخاصة بك) وسأرى ما إذا كان هناك أي شيء يلفت انتباهي.

مرحباً @angus،
لقد أنشأنا مفتاحًا جديدًا للتفاصيل، واتبعنا الإجراء الذي ذكرته في الفيديو ومكّنا التعديل في نطاق النشر وبدأ العمل، شكرًا جزيلاً لك على صبرك ودعمك.

إعجاب واحد (1)

تم تقسيم 4 مشاركات إلى موضوع جديد: ربط WP Discourse بمثيل Discourse محلي يعمل بإصدار معين