غرض هذا الإضافة
تقوم هذه الإضافة بعدة مهام:
-
تتيح لك تشغيل روبوت Discord باستخدام خادم Discourse الخاص بك للقيام بأشياء تربط النظامين معًا. انسخ هذا المستودع وقم بتوسيعه باستخدام Ruby بسيط لإنشاء جميع أنواع وظائف الروبوت.
-
الوظائف الموجودة لتقديم أمثلة وأدوات مفيدة:
- توفر نشرًا تلقائيًا ثنائي الاتجاه للمحتوى الذي يستوفي بعض المعايير.
- أمر لنسخ الرسائل بشكل فردي إلى Discourse.
- أمر لمزامنة عضوية المجموعات مع عضوية الأدوار في خادم Discord الخاص بك مع مثيل Discourse الخاص بك.
توفر الإضافة هيكلًا قابلًا للتوسع يمكنك من خلاله بناء ميزات إضافية. نرحب بطلبات الدمج (PRs) للإضافات المفيدة بشكل عام.
هذه ليست أوامر المزامنة الفعلية، بل مجرد توضيح لتفاعل الروبوت الممكن. الأمر الثاني في لقطة الشاشة تم إلغاؤه أثناء التطوير
من الضروري أن تكون معقدًا في الإعداد، لكنه رائع لعشاق كلا النظامين الذين يرغبون في بذل الوقت لفهم كيفية عمل كل نظام، على الأقل على المستوى الوظيفي والمفاهيمي. تحتاج إلى فهم بعض أساسيات كيفية عمل إدارة المستخدمين في Discourse و Discord للحصول على أفضل استفادة من هذه الإضافة.
أوامر الروبوت
هناك أربعة أوامر:
- Ping!
- !disckick
- !discsync
- !disccopy
Ping!
للتحقق مما إذا كان الروبوت يستجيب، اكتب ببساطة “Ping!” ويجب أن يستجيب الروبوت بـ “
: Pong!” - مذهل، أليس كذلك؟ 
(هذا في الواقع نوع من الميمز btw!)
!disckick <min_trust_level: الافتراضي 2>
سيؤدي كتابة هذا الأمر إلى طرد أي مستخدم موجود في Discourse الخاص بك ولكن بمستوى ثقة أقل من القيمة التي قدمتها. الافتراضي إذا لم تقم بتوفير قيمة هو 2.
مثال:
!discsync <clean up: الافتراضي false, min_visibility: الافتراضي 0, include automated groups: الافتراضي false>
سيحاول هذا الأمر نسخ جميع المجموعات إلى أدوار في Discord والتي تطابق المعايير المقدمة (أو الافتراضيات إذا لم يتم توفيرها). ثم سيحاول ملء الأدوار وفقًا لعضوية المجموعة في Discourse. إنها مزامنة في اتجاه واحد فقط. لا يتم تغيير أي بيانات في Discourse أبدًا.
!disccopy <number_of_messages> <optional_target_category_name> <optional_target_topic_name>
يتيح لك نسخ سجل محادثات Discord إلى مثيل Discourse الخاص بك من داخل دردشة Discord. يمكن التعامل مع آلاف الرسائل دفعة واحدة (ولكنه سيستغرق وقتًا لهذا الحجم).
اتصال ثنائي الاتجاه
إليك الإعدادات
- يمكنك تعيين قناة إعلانات في Discord في إعدادات الإضافة.
- يمكنك الآن الكتابة في قناة إعلانات Discord المحددة وسيتم نشر رسالتك في موضوع Discourse المحدد في إعدادات الإضافة.
- يمكنك إعداد قائمة بالفئات في Discourse للنشر في قناة الإعلانات في Discord إذا قام شخص ما بالنشر هناك أو إضافة موضوع جديد (أي منهما أو كلاهما).
- نسخ دردشة تلقائي لكل رسالة، من قناة إلى أي فئة تحمل نفس الاسم في Discourse: إذا كان اسم القناة يطابق اسم الفئة، فسيتم نسخ الرسالة إلى Discourse.
بالإضافة إلى ذلك، قمت بإضافة ملف جديد لإدارة أحداث Discord المدعومة من API discordrb، مع كون منطق الإعلانات هو المثال الأول (لا تتردد في تطوير أمثلة جديدة وتقديم طلب دمج إذا كانت مفيدة بشكل عام للمجتمع).
ملاحظة: بالنسبة لأي رسالة يتم نسخها إلى Discourse من Discord، سيظهر المستخدم بشكل صحيح إذا قام هذا المستخدم بتسجيل الدخول إلى Discourse باستخدام تسجيل دخول Discord (لذلك يمكن لـ Discord Bot مطابقة المستخدمين).
حالة هذه الإضافة
هذه إضافة معقدة في الإعداد. كان ذلك لا مفر منه إلى حد كبير.
ومع ذلك، فإن استخدامها سهل جدًا بمجرد تشغيلها بالكامل.
اعتبر الكود حاليًا في النسخة التجريبية (Beta). تم اختباره، حتى في بيئة الإنتاج، ولكن من المرجح أن يحتوي على أخطاء. أوصي باختباره أولاً على خادم Discord جديد قبل تطبيقه على خادم Discord الرئيسي “الإنتاجي” الخاص بك، ما لم تكن تبدأ للتو.
من المرجح أن أي أخطاء ستزعج مثيل Discord الخاص بك أكثر من مثيل Discourse الخاص بك، لأنه لا يتم إجراء أي تغييرات على Discourse. ومع ذلك، لقد كتبته بطريقة تعني أن معظم الأشياء قابلة للاسترداد ويمكنك ببساطة تكرار شيء ما لإصلاح مشكلة عادةً. يتم استخدام Discourse كمصدر أساسي لمعلومات العضوية والمجموعات، وتُستخدم هذه البيانات لتحديث العضوية والأدوار في خادم Discord الخاص بك.
تعليمات الإعداد
المتطلبات الأساسية
- خادم Discord أنت مدير فيه.
- تطبيق Discord (انظر أدناه).
- روبوت Discord (انظر أدناه).
- وصول ssh كمستخدم root إلى خادم Discourse الخاص بك.
- تحديثات لملف app.yml لتثبيت الإضافة.
- سيحتاج جميع مستخدمي Discourse الخاص بك إلى تسجيل الدخول باستخدام تسجيل دخول Discord OAuth الذي سيظهر على صفحة تسجيل الدخول الخاصة بك بمجرد تثبيت الإضافة.
تطبيق Discord
اذهب إلى هنا وأنشئ تطبيقًا:
اضغط على “New Application”.
ستحتاج إلى إنشاء روبوت وسيبدو شيئًا مثل هذا (اتركه غير ‘عام’):
ستحتاج إلى تفويض الروبوت في المتصفح، راجع OAuth2 - Documentation - Discord
بمجرد إعداد الروبوت، انسخ الرمز (Token). ستحتاج إلى إدخال ذلك في Discourse لاحقًا.
تغييرات app.yml
الإضافة
تحتاج فقط إلى إضافة واحدة الآن لأن تسجيل الدخول الاجتماعي لـ Discord أصبح جزءًا أساسيًا من نواة Discourse (واو 
)
ثم في المطالبة ./launcher rebuild app كما هو معتاد.
يجب أن يعمل هذا، لا مشكلة.
قد تحصل على بعض أخطاء وحدة التحكم والسجل تشير إلى فشل الروبوت في البناء الأول حيث لم تقم بعد بإدخال بيانات اعتماد الروبوت في واجهة إعدادات Discourse الأمامية. (التعامل مع هذا بشكل أكثر سلاسة هو أمر معلق، سأحذف هذا الجزء عندما يتم ذلك). لن يسبب ذلك أي ضرر وسيعمل Discourse نفسه بشكل طبيعي.
بمجرد الدخول إلى منطقة المسؤول في Discourse، انتقل إلى إعدادات الإضافة واملأ هذه الحقول:
ستحصل على المعرفات (IDs) من واجهة Discord. ستحتاج إلى تفعيل وضع المطور للسماح لك بنسخ هذه المعرفات. في Discord، انتقل إلى الإعدادات - > المظهر - > متقدم (ADVANCED) وقم بتفعيل وضع المطور:
يمكنك بعد ذلك الحصول على المعرفات من الواجهة، على سبيل المثال:
ستحتاج أيضًا إلى ملء إعدادات OAuth الخاصة بـ Discord. معرف العميل (Client ID) والسر (Secret) يأتيان من تطبيق Discord نفسه.
بمجرد تعيين هذه الإعدادات، عد إلى المطالبة الجذرية (root prompt) في linux واكتب:
./launcher restart app
إذا قمت بإعداد خوادم Discord و Discourse الخاصة بك بشكل صحيح، يجب أن ترى الروبوت ينضم إلى الخادم.
إذا سقط الروبوت في أي وقت (سيصبح غير متصل)، ستحتاج إلى فعل الشيء نفسه مرة أخرى لإعادته. الاستقلالية المحسنة للروبوت عن خادم نواة Discourse هي أمر معلق. مع ذلك، لقد شغلت روبوتًا في بيئة الإنتاج لفترة طويلة ولم يسقط حتى الآن.
أوامر مستقبلية؟
إذا كان لديك فكرة عن أمر آخر يستغل الرابط بين Discourse و Discord وتعتقد أنه سيكون مفيدًا للمجتمع الأوسع، فأخبرني في الردود ويمكننا النظر في إمكانية تنفيذ ذلك. ملاحظة: لا يُقصد بهذا الروبوت أداء مهام خارج نطاق Discourse.
القيود
كان الهدف الرئيسي من هذه الإضافة هو السماح للمستخدم بإنشاء روبوت على خادم Discord الخاص به يتم تشغيله بواسطة خادم Discourse الخاص به ويكون قادرًا على أداء بعض وظائف إدارة العضوية الأساسية. كما يوفر أساسًا لأي تفاعلات إضافية شبيهة بالروبوت بين النظامين في المستقبل. جزء من الدافع لاستخدام الروبوتات هو أنها ممتعة ببساطة fun.
أوامر الروبوت هي بشكل فردي بطبيعتها.
مشاكل معروفة
-
سيبدأ الروبوت مثيلًا من نفسه إذا ذهبت إلى جلسة وحدة تحكم rails على الخادم. سيسبب ذلك في ظهور الروبوت وكأنه يستجيب مرتين (ولكن في الواقع يوجد روبوتان الآن). في وحدة تحكم rails، ببساطة أوقف الروبوت الإضافي عن طريق كتابة:لم يعد هذا ضروريًا الآن!::DiscordBot::Bot.discord_bot.stop -
الروبوت ثرثار قليلاً خلال ترقيات Discourse ‘المتصل’ حيث يستمر في إعادة التفعيل أثناء عملية الترقية. هذا يعود إلى إيجاد طريقة جيدة لتشغيل الروبوت في عملية منفصلة ومدارة بدلاً من خيط فرع من خادم الويب. أعتقد أن هذا كله غير ضار، وإذا كان إخراج الروبوت فقط إلى قناة المسؤول الخاصة بك في Discord، فهل تهتم حقًا؟يجب أن يكون هذا قد تم حله الآن تقريبًا، مع إعلان الروبوت عن نفسه مرتين فقط أثناء إعادة البناء.
شكرًا
هناك العديد من الداعمين الذين يجب شكرهم على هذه الإضافة التي استغرقت وقتًا طويلاً للوصول إلى هذه المرحلة بما في ذلك @Wedgebert، @FoohonPie. شكرًا لـ Jeff على مساهمته السخية. شكرًا لـ @angus على كل التشجيع والتعامل مع الدعم المالي.
تمت استلهام الإضافة من العمل الذي قام به @Watercolor_Games في مرحلة سابقة وتعتمد على إضافة OAuth الخاصة بـ Discord التي بناها @featheredtoast.
تعتمد الإضافة على مكتبة Ruby discordrb شبه الرسمية المدعومة من Discord والعمل الرائع الذي قام به فريق Discord لجعل نظامهم في متناول الجميع. شكرًا لـ @Falco على مساعدتي في اعتماد في استجابة سريعة للغاية.
بالإضافة إلى ذلك، بالطبع، لن يكون هذا ممكنًا بدون نظام الإضافات المذهل في Discourse (واو!)
حالة هذه التعليمات
سيتم تحسينها مع مرور الوقت وأرحب بالتعليقات. هناك مناطق من المرجح أن تكون غير واضحة.
