ديسكورد غيت هب

[Discourse]

	الملخص	Discourse GitHub يسمح للمشرفين بتعيين شارات للمستخدمين بناءً على مساهماتهم في GitHub. كما يسمح للمستخدمين بإنشاء ارتباطات مرجعية (Linkbacks) وروابط دائمة (Permalinks) وعرض حالة طلبات السحب (PR) المباشرة في معاينات النصوص (oneboxes).
	دليل التثبيت	هذا المكون الإضافي مدمج مع نواة Discourse. لا حاجة لتثبيت المكون الإضافي بشكل منفصل.

نظرًا لأن هذا مكون إضافي #رسمي يتم صيانته بواسطة فريق Discourse، يمكن تقديم طلبات #الدعم، #المساهمة:أخطاء، #المساهمة:تجربة_المستخدم، و #المساهمة:ميزات في الفئات ذات الصلة هنا في Meta، مع وسمها بالوسم المناسب للمكون الإضافي. انقر على أحد الروابط أدناه لبدء موضوع جديد.

 الدعم  الأخطاء  تجربة المستخدم  الميزات

الميزات

شارات GitHub

قم بتعيين شارات لمستخدميك بناءً على مساهماتهم في GitHub.

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

1. فعّل إعداد github badges enabled في الإعدادات > المكونات الإضافية.
2. أنشئ رمز وصول (Access Token) من GitHub والصقه في إعداد github linkback access token. انظر الإرشادات أدناه.
3. أضف عنوانًا واحدًا أو أكثر لمستودعات GitHub التي تريد مسحها بحثًا عن المساهمات إلى إعداد الموقع github badges repos.

كيفية عمل عدّاد الشارات:

تقوم الشارات بحساب عمليات الدمج (commits) عبر جميع المستودعات، وعندما يساهم مستخدم في مستودعات متعددة، يتم جمع جميع عمليات الدمج الخاصة به معًا في إجمالي واحد.

شارات المُدمِج (Committer Badges):

الشارة	عدد عمليات الدمج المطلوبة
برونزي	1 عملية دمج
فضي	25 عملية دمج
ذهبي	1000 عملية دمج

تدرج الشارات: مع تراكم المساهمات عبر أي من المستودعات التي يتم تتبعها، ينتقل المستخدمون تلقائيًا عبر مستويات الشارات. على سبيل المثال، إذا قام مستخدم بدمج رمز في المستودع A ثم في المستودع B، فإن كلا المساهمتين تُحسبان في إجماليهم، مما يسمح لهم بالتقدم من البرونزي إلى الفضي إلى الذهبي.

---

الارتباط المرجعي لـ GitHub (GitHub Linkback)

إنشاء ارتباط من طلب سحب (Pull Request) أو عملية دمج في GitHub يعود إلى منشور في Discourse حيث تم ذكره.

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

1. فعّل إعداد github linkback enabled في الإعدادات > المكونات الإضافية.
2. أنشئ رمز وصول (Access Token) من GitHub والصقه في إعداد github linkback access token. انظر الإرشادات أدناه.
3. أخيرًا، أضف المشاريع التي ترغب في النشر فيها إلى إعداد الموقع github linkback projects بالتنسيقات التالية:
   • username/repository للمستودعات المحددة
   • username/* لجميع مستودعات مستخدم معين

---

الرابط الدائم لـ GitHub (GitHub Permalink)

استبدال الروابط غير الدائمة في GitHub بـ روابط دائمة.

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

1. فعّل إعداد github permalinks enabled في الإعدادات > المكونات الإضافية.

---

الحالة المباشرة لطلبات السحب (PR Live Status)

عرض مؤشرات الحالة المباشرة في معاينات نصوص (oneboxes) لطلبات السحب على GitHub في المنشورات ورسائل الدردشة. يتم تحديث الحالة تلقائيًا عبر الإشارات البرمجية (webhooks) عند تغيير طلبات السحب على GitHub.

أنواع الحالة

الحالة	اللون	الوصف
مسودة (Draft)	رمادي	تم تحديد طلب السحب كمسودة
مفتوح (Open)	رمادي	طلب السحب مفتوح وينتظر المراجعة
معتمد (Approved)	أخضر	تمت الموافقة على طلب السحب من قبل المراجعين
طلب تغييرات (Changes Requested)	برتقالي	طلب المراجعون إجراء تغييرات
مُدمَج (Merged)	بنفسجي	تم دمج طلب السحب
مغلق (Closed)	أحمر	تم إغلاق طلب السحب دون دمجه

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

الخطوة 1: تفعيل الميزة

انتقل إلى الإدارة > الإعدادات > المكونات الإضافية وقم بتعيين github pr status enabled إلى true.

الخطوة 2: تكوين رموز وصول GitHub

لجلب حالة طلبات السحب (خاصة للمستودعات الخاصة)، قم بتكوين رموز وصول GitHub.

الإعداد: github onebox access tokens

التنسيق:

organization_name|ghp_your_token_here
default|ghp_fallback_token_here

يمكنك تحديد رموز وصول لكل منظمة، بالإضافة إلى رمز default يُستخدم كاحتياط. يجب أن يحتوي كل سطر على org_name|token حيث يكون الرمز رمز وصول شخصي من GitHub (كلاسيكي) بصلاحية repo.

مثال:

discourse|ghp_xxxxxxxxxxxxxxxxxxxx
my-company|ghp_yyyyyyyyyyyyyyyyyyyy
default|ghp_zzzzzzzzzzzzzzzzzzzzzz

الخطوة 3: إعداد الإشارات البرمجية (Webhooks) على GitHub (للتحديثات في الوقت الفعلي)

للحصول على تحديثات تلقائية للحالة عند تغيير طلبات السحب، قم بإعداد إشارة برمجية (webhook) على GitHub.

إنشاء سر للإشارة البرمجية:

openssl rand -hex 32

قم بتعيين إعداد الموقع github webhook secret إلى السر الذي قمت بإنشائه.

إنشاء الإشارة البرمجية على GitHub:

يمكنك إنشاء الإشارة البرمجية على مستوى المنظمة (لتغطية جميع المستودعات) أو لكل مستودع على حدة.

لمنظمة:

1. انتقل إلى إعدادات المنظمة الخاصة بك
2. انتقل إلى الإشارات البرمجية (Webhooks) (تحت قسم Code، planning, and automation)
3. انقر على إضافة إشارة برمجية (Add webhook)

لمستودع:

1. انتقل إلى إعدادات المستودع الخاص بك
2. انتقل إلى الإشارات البرمجية (Webhooks)
3. انقر على إضافة إشارة برمجية (Add webhook)

تكوين الإشارة البرمجية:

الحقل	القيمة
عنوان حمولة البيانات (Payload URL)	https://your-discourse-site.com/discourse-github/webhooks/github
نوع المحتوى	application/json
السر	السر الذي قمت بإنشائه للإشارة البرمجية
التحقق من SSL	تمكين (موصى به)
الأحداث	حدد “دعني أختار أحداثًا فردية”

حدد هذه الأحداث:

• طلبات السحب (Pull requests)
• مراجعات طلبات السحب (Pull request reviews)

انقر على إضافة إشارة برمجية (Add webhook) للحفظ.

الخطوة 4: التحقق من الإعداد

1. أنشئ منشور اختبار يحتوي على عنوان URL لطلب سحب من GitHub
2. تحقق من أن معاينة النص (onebox) تعرض مع رمز الحالة
3. غيّر حالة طلب السحب على GitHub (على سبيل المثال، اعتمده، أو أغلقه)
4. بعد بضع ثوانٍ، قم بتحديث صفحة Discourse — يجب أن تتغير الحالة

يمكنك التحقق من حالة توصيل الإشارة البرمجية في إعدادات الإشارة البرمجية على GitHub لتأكيد إرسال الأحداث واستلامها بنجاح.

أولوية الحالة

عندما يكون لطلب السحب حالات متعددة (على سبيل المثال، معتمد ولكن هناك أيضًا طلبات لتغييرات)، يتم تحديد الحالة بناءً على الأولوية التالية:

1. مُدمَج (أعلى أولوية)
2. مغلق
3. مسودة
4. طلب تغييرات
5. معتمد
6. مفتوح (افتراضي)

منطق حالة المراجعة

تجلب هذه الميزة معلومات المراجعة من واجهة برمجة تطبيقات GitHub لتحديد حالة الاعتماد:

• تأخذ أحدث مراجعة من كل مراجع
• تتجاهل حالات المراجعة “تم التعليق” و “قيد الانتظار”
• تعرض “طلب تغييرات” إذا طلب أي مراجع إجراء تغييرات
• تعرض “معتمد” فقط إذا كانت هناك مراجعات ولم يطلب أي منها تغييرات

حيث تعمل

• منشورات المنتدى — أي منشور يحتوي على معاينة نص (onebox) لطلب سحب من GitHub
• رسائل الدردشة — تعرض معاينات نصوص (oneboxes) لطلبات السحب في الدردشة الحالة المباشرة أيضًا

ملاحظة: معاينات النصوص المضمنة (عندما يظهر الرابط ضمن النص بدلاً من كونه معاينة كاملة) لا تعرض أيقونات الحالة.

الترحيل من مكون السمة GitHub Status

تستبدل هذه الميزة مكون السمة GitHub Status Indicators. المكونان غير متوافقين ولا يجب استخدامهما معًا.

إذا كنت تستخدم مكون السمة حاليًا:

1. قم بإيقاف تعطيل وإزالة مكون السمة github-status-theme
2. فعّل هذه الميزة المدمجة عبر إعداد github pr status enabled

---

التكوين

رمز وصول GitHub

لكي تعمل ميزة الارتباط المرجعي ويتم منح الشارات لمستخدميك، تحتاج إلى توفير رمز وصول من GitHub. يمكنك إنشاء رمزك هنا: Sign in to GitHub · GitHub.

تتطلب ميزة الارتباط المرجعي صلاحية public_repo، ولا تتطلب منح الشارات أي صلاحية (اترك كل شيء غير محدد إذا كنت تريد الشارات فقط). نظرًا لأن صلاحية public_repo تمنح وصولاً للكتابة إلى المستودعات، نوصي بإنشاء حساب GitHub مؤقت لا يمتلك وصولاً إلى أي مستودعات واستخدامه فقط لإنشاء الرمز.

صلاحيات الرموز حسب الميزة

الميزة	الصلاحية المطلوبة
الشارات	لا توجد صلاحية مطلوبة
الارتباط المرجعي	public_repo
حالة طلب السحب (مستودعات عامة)	لا توجد صلاحية مطلوبة
حالة طلب السحب (مستودعات خاصة)	repo

---

مرجع إعدادات الموقع

الإعداد	الافتراضي	الوصف
enable discourse github plugin	false	المفتاح الرئيسي للمكون الإضافي
github badges enabled	false	تفعيل شارات مساهمات GitHub
github badges repos	(فارغ)	عناوين URL للمستودعات لتتبعها للحصول على الشارات
github linkback enabled	false	تفعيل الارتباطات المرجعية من GitHub إلى Discourse
github linkback access token	(فارغ)	رمز الوصول لميزة الارتباط المرجعي
github linkback projects	(فارغ)	المشاريع لإنشاء ارتباطات مرجعية لها
github permalinks enabled	false	استبدال روابط GitHub بروابط دائمة
github pr status enabled	false	تفعيل أيقونات حالة طلبات السحب في معاينات النصوص
github webhook secret	(فارغ)	سر للتحقق من توقيع الإشارة البرمجية
github onebox access tokens	(فارغ)	رموز الوصول لواجهة برمجة تطبيقات GitHub (التنسيق: org|token)

---

التفاصيل التقنية

استخدام واجهة برمجة تطبيقات حالة طلب السحب

عند إنشاء معاينة نص (onebox) لطلب سحب من GitHub، يقوم Discourse بإجراء ما يصل إلى استدعاءين لواجهة برمجة التطبيقات:

1. بيانات طلب السحب: GET /repos/{owner}/{repo}/pulls/{number} — يجلب معلومات أساسية عن طلب السحب بما في ذلك الحالة، حالة الدمج، وحالة المسودة
2. المراجعات: GET /repos/{owner}/{repo}/pulls/{number}/reviews — يجلب بيانات المراجعة لتحديد حالة الاعتماد

تستخدم هذه الاستدعاءات رمز الوصول الذي قمت بتكوينه إذا كان متاحًا، مما يسمح بالوصول إلى المستودعات الخاصة.

أمان الإشارات البرمجية (Webhooks)

يتم التحقق من طلبات الإشارات البرمجية باستخدام التحقق من توقيع HMAC-SHA256. يقوم GitHub بتوقيع حمولة البيانات للإشارة البرمجية باستخدام السر الخاص بك، ويقوم Discourse بالتحقق من هذا التوقيع قبل المعالجة. يتم رفض التواقيع غير الصالحة باستجابة 403.

أحداث الإشارات البرمجية التي تحفز التحديثات

• تغييرات حالة طلب السحب (مفتوح، مغلق، مُعاد فتحه)
• دمج طلب السحب
• تغييرات حالة المسودة (تحويله إلى مسودة، جاهز للمراجعة)
• تقديم مراجعات طلبات السحب
• تعديل المراجعات أو إزالتها

اعتبارات الأداء

• يتم جدولة إعادة المعالجة (Rebaking) كخلفية ذات أولوية منخفضة لتجنب التأثير على أداء الموقع
• يتم إعادة معالجة المنشورات/الرسائل التي تحتوي على معاينات نصوص (oneboxes) كاملة لطلبات سحب من GitHub فقط (يتم تخطي معاينات النصوص المضمنة)
• تتخطي إعادة معالجة رسائل الدردشة الإشعارات لمنع التنبيهات المكررة

---

سجل التغييرات (CHANGELOG)

2025-12-10

• إصلاح: تخطي الإشعارات عند إعادة معالجة رسائل الدردشة من إشارات GitHub البرمجية

2025-12-09

• إصلاح: تخطي إعادة معالجة المنشورات التي تحتوي على معاينات نصوص مضمنة لطلبات سحب من GitHub
• إصلاح: تجنب الحالة الوسيطة عند إعادة معالجة المنشورات التي تحتوي على معاينات نصوص
• إصلاح: إعادة معالجة رسائل الدردشة عند تغيير حالة طلب سحب من GitHub
• تجربة المستخدم: استخدام الارتفاع الأدنى (min-height) لمنع انزياح التخطيط عند تغيير أيقونة الحالة
• تجربة المستخدم: تقليل حجم أيقونة حالة طلب سحب من GitHub على الهاتف المحمول

2025-12-08

• ميزة: إضافة حالة “طلب تغييرات” إلى معاينات نصوص طلبات السحب على GitHub

2025-12-04

• ميزة: أيقونة الحالة المباشرة لطلبات السحب على GitHub

2025-11-10

• ميزة: السماح وقائمة الاستبعاد للارتباطات المرجعية

2025-11-08

• ميزة: إضافة قائمة استبعاد للفئات لارتباطات GitHub المرجعية

2024-12-20

• تطوير: نقل discourse-github إلى النواة (لم يعد يتطلب تثبيتًا منفصلاً)

[ImmaZoni (Justin)]

ما هي عملية الروابط المتعددة؟ هل تتم إضافتها ببساطة إلى نفس تعليق الالتزام؟ أم يتم إنشاء تعليق جديد تمامًا في كل مرة؟

[satonotdead]

أتساءل عما إذا كان يمكن تبسيط شارات الالتزامات وطلبات السحب لأننا نحاول الابتعاد عن مفارقة الاختيار

حاليًا، لقد قمت بعمل نسخة احتياطية وحذفت شارات الالتزام ولكن بالطبع، فقدت نفسي من شارة الالتزام (لأنني ألتزم مباشرة) والنسخة الاحتياطية لا تساوي البقاء دائمًا مع النواة.

[xomiamoore (Mia)]

@Discourse

• username/repository للمستودعات المحددة
• username/* لجميع المستودعات لمستخدم معين

لم تعمل العلامة العامة * معي لمؤسسة GitHub، وانتهى بي الأمر بوضع كل مستودع على حدة. هل واجه أي شخص آخر مشاكل مع هذا مع مؤسسة مقابل مستخدم؟

[greyli]

كيفية تعيين لغة تعليق الارتباط الخلفي؟

[cultiv (Sebastiaan Janssen)]

شكرًا لك، أنا حقًا أحب هذا المكون الإضافي! لقد كنت مرتبكًا بشأن نظام الشارات وسعدت بالعثور على الشرح في موضوع مختلف: Github Badges are not working. Its hard to see if I do something wrong or if the plugin is not working - #4 by simon

ومع ذلك، يشير هذا الرد إلى أن

يقوم المكون الإضافي بإنشاء 6 شارات:

لا أرى أيًا من هذه الشارات، ولست متأكدًا مما حدث؟ هل هناك طريقة لـ (إعادة) تشغيل إنشاء هذه الشارات؟

[cultiv (Sebastiaan Janssen)]

للإجابة على سؤالي بنفسي، بعد بضع ساعات تم تشغيل المهمة المجدولة وتم إنشاء الشارات في ذلك الوقت.

@cultiv

هل هناك طريقة لإعادة تشغيل إنشاء هذه الشارات؟

الطريقة اليدوية للقيام بذلك ستكون تشغيل مهمة sidekiq على ما يبدو.

[tomtjes (Thomas Reintjes)]

طلب ميزة: استبعاد التصنيفات و/أو العلامات من روابط العودة

لدينا فئة الإعلانات والتي يسحب إليها مكون RSS تلقائيًا الإصدارات الجديدة من GitHub. عندما تتصل ملاحظات الإصدار بمشكلات، يظهر ذلك أيضًا في Discourse ويتم إنشاء رابط عودة، ولكنه غير مفيد لأي شخص، مما يسبب فوضى على GitHub.

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

[david (David Taylor)]

هذه الإضافة مضمنة الآن مع Discourse الأساسي كجزء من Bundling more popular plugins with Discourse core. إذا كنت تستضيف بنفسك وتستخدم الإضافة، فأنت بحاجة إلى إزالتها من app.yml قبل الترقية التالية.