استخدام عمليات نشر GitHub في WordPress.com

تُتيح ميزة GitHub Deployments إمكانية دمج مستودعات GitHub الخاصة بك مباشرةً مع موقعك على WordPress.com، ما يمنحك سير عمل مؤتمتًا وخاضعًا لنظام إدارة الإصدارات لنشر الإضافات أو القوالب أو تغييرات الموقع الكاملة. يغطي هذا الدليل عملية الإعداد وكيفية إدارة مستودعاتك المرتبطة.

تتوفر هذه الميزة على المواقع التي تستخدم خطة الأعمال وخطة التجارة على منصة WordPress.com. إذا كنت تستخدم خطة أعمال، فتأكد من تفعيلها. فيما يتعلق بالمواقع المجّانية والمواقع التي تستخدم الخطّة الشّخصيّة والخطة المميزة، قم بترقية خطتك للوصول إلى هذه الميزة.

قبل أن تتمكن من نشر مستودع GitHub على موقعك على WordPress.com، ستحتاج أولاً إلى إعداد الربط بينهما باتباع الخطوات التالية:

1. تفضَّل بزيارة صفحة المواقع الخاصة بك: https://wordpress.com/sites/
2. انقر على اسم موقعك لإلقاء نظرة عامة على الموقع.
3. انقر على علامة تبويب عمليات النشر.
4. انقر على الزر “ربط المستودع“. بعد ذلك، إذا ظهرت لك المستودعات مدرجة في قائمة، فهذا يعني أنك قد قمت بالفعل بربط حسابك على GitHub. تابع إلى الخطوة 11.
5. انقر على الزر “تثبيت تطبيق WordPress.com“.
6. ستظهر نافذة جديدة، وسيُطلب منك تسجيل الدخول إلى حسابك على GitHub إذا لم تكن قد فعلت ذلك من قبل. وبعد ذلك سترى أمامك هذه الشاشة:

7. انقر على الزر “التصريح لتطبيق WordPress.com للمطورين“.
8. حدد مؤسسة GitHub أو الحساب الذي يحتوي على مستودعك.
9. حدد المستودع/المستودعات التي ترغب في ربطها:
   • كل المستودعات: سيؤدي تحديد هذا الخيار إلى منح WordPress.com صلاحية الوصول إلى جميع المستودعات الحالية والمستقبلية التابعة لحساب GitHub المحدد. يتضمن ذلك المستودعات العامة المتاحة للقراءة فقط.
   • مستودعات محددة فقط: سيؤدي تحديد هذا الخيار إلى السماح لك باختيار المستودعات التي يمكن لـ WordPress.com الوصول إليها على حساب GitHub المحدد. 
10. بمجرد تحديد أي من الخيارات، انقر على الزر تثبيت.
11. سيتم إغلاق النافذة الجديدة، وستتم إعادة توجيهك إلى WordPress.com. يجب إدراج مستودعك/مستودعاتك المحددة مع حساب GitHub المرتبط بذلك المستودع:

12. انقر على الخيار تحديد الموجود بجوار المستودع الذي ترغب في ربطه.

في هذه المرحلة، يجب أن يظهر لك تطبيق WordPress.com للمطورين ضمن تطبيقات GitHub المصرح بها وتطبيقات GitHub المثبتة لديك.

بمجرد تحديد أي مستودع، ستحتاج إلى ضبط إعدادات النشر:

• فرع النشر: يتم تعيينه افتراضيًا على الفرع الافتراضي للمستودع (عادةً ما يُسمى الفرع الرئيسي) ولكن يمكن تغييره إلى الفرع الذي ترغب في استخدامه.
• الدليل الوجهة: مجلد الخادم الذي تريد نشر الملفات فيه. فيما يتعلق بالإضافات، سيكون المسار /wp-content/plugins/my-plugin-name. وفيما يتعلق بالقوالب، سيكون المسار /wp-content/themes/my-theme-name. للنشر الجزئي للموقع (أي: عدة إضافات أو قوالب)، يمكنك استخدام /wp-content. وسيتم دمج محتويات المستودع مع المحتويات الحالية لموقع ووردبريس في الدليل المحدد.
• عمليات النشر التلقائية: هناك طريقتان يمكنك اتباعهما للنشر على WordPress.com:
  • تلقائي: بمجرد حفظ الكود، سيتم نشره على موقعك على WordPress.com. ويوصى باستخدام عمليات النشر التلقائية لمواقع التشغيل المرحلي.
  • يدوي: سيتم نشر الكود بمجرد أن تقوم بطلب النشر. ويوصى باستخدام عمليات النشر اليدوية لمواقع الإنتاج.
• وضع النشر: هناك نوعان من عمليات النشر:
  • بسيط: في هذا الوضع، سيتم نسخ جميع الملفات من فرع المستودع إلى الموقع ونشرها دون الحاجة إلى معالجة إضافية.
  • متقدم: في هذا الوضع، يمكنك استخدام برنامج نصي لسير العمل، ما يتيح تنفيذ خطوات إنشاء مخصصة مثل تثبيت تبعيات Composer، وإجراء اختبارات على الكود قبل عملية النشر، والتحكم في نشر الملفات. ويُعد هذا الوضع مثاليًا للمستودعات التي تحتاج إلى برنامج Node أو Composer. للحصول على مزيد من المعلومات، اطلع على “النشر المتقدم” أدناه.

بمجرد أن يتم تكوين جميع الإعدادات، انقر على الزر ربط. ستتم إضافة مستودعك:

لاحظ أنه يجب عليك تنفيذ عملية النشر الأولى، إما تلقائيًا أو يدويًا. وبعد ذلك، يمكنك ربط مستودع آخر في أي وقت عن طريق النقر على الزر “ربط المستودع“.

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

لإعداد النشر المتقدم:

1. سيظهر لك نموذج حيث يمكنك تكوين النشر.
2. انقر على اسم المستودع لإدارة عملية الربط.
3. على الجانب الأيمن، وضمن الخيار “اختر وضع النشر الخاص بك“، اختر متقدم.

4. إذا كان المستودع يحتوي بالفعل على ملف سير عمل، يمكنك تحديده هنا. وسيفحص النظام الملف للكشف عن أي أخطاء. وإذا لم يتم العثور على أي أخطاء، فانتقل إلى الخطوة 7.
5. يمكنك أيضًا تحديد الخيار “إنشاء ملف سير عمل جديد” لإضافة ملف سير عمل تم تكوينه مسبقًا. وسيؤدي اختيار هذا الخيار إلى استبدال ملف سير العمل wpcom.yml إذا كان موجودًا بالفعل في مستودعك.
6. انقر على الزر “تثبيت سير العمل نيابةً عني” لحفظ ملف سير العمل في المستودع.
7. وبمجرد أن تتم إضافة ملف سير العمل والتحقق منه، انقر على تحديث. سيستخدم مستودعك الآن وضع النشر المتقدم.

بعد ربط مستودع GitHub الخاص بك بموقع ما، فإن الخطوة التالية ستكون نشر الكود الخاص بك بالفعل. هناك طريقتان متاحتان للنشر: تلقائي ويدوي.

لا يوصى بعمليات النشر التلقائية لمواقع الإنتاج الفعلية، حيث يتم نشر أي تغييرات مُجراة على الكود في المستودع تلقائيًا من GitHub إلى الموقع الفعلي. بدلاً من ذلك، فكّر في إعداد النشر التلقائي على موقع تشغيل مرحلي ومزامنته مع موقع الإنتاج بمجرد أن تكون مستعدًا.

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

لتشغيل أي عملية نشر يدويًا:

1. تفضَّل بزيارة صفحة المواقع الخاصة بك: https://wordpress.com/sites/
2. انقر على اسم موقعك لإلقاء نظرة عامة على الموقع.
3. انقر على علامة تبويب عمليات النشر.
4. انقر على القائمة الممثلة في أيقونة النقاط الثلاث (⋮) في المستودع الذي ترغب في نشره.
5. اختر “تشغيل النشر اليدوي“. يجب أن يظهر لك الآن تنبيه على شكل شريط يحتوي على الرسالة “تم إنشاء عملية تشغيل النشر”، وستتغير حالة النشر إلى “مُدرج في قائمة الانتظار”.
6. انتظر حتى يكتمل النشر (ستتغير الحالة إلى “منشور”).

7. انقر على القائمة الممثلة في أيقونة النقاط الثلاث (⋮) مرة أخرى واختر “عرض عمليات تشغيل النشر“. 
8. يعرض سجل تشغيل النشر المؤلف والنسخة المحفوظة التي تم نشرها. ويمكنك عرض مزيد من المعلومات من خلال النقر على إدخال تشغيل النشر.

لإدارة عمليات الربط الحالية لمستودع GitHub لديك:

1. تفضَّل بزيارة صفحة المواقع الخاصة بك: https://wordpress.com/sites/
2. انقر على اسم موقعك لإلقاء نظرة عامة على الموقع.
3. انقر على علامة تبويب عمليات النشر.
4. يجب أن تظهر لك بعد ذلك قائمة بعمليات الربط. 

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

هناك إجراءات إضافية تكون متاحة بعد النقر على القائمة الممثلة في أيقونة النقاط الثلاث (⋮):

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

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

لمراجعة سجلات النشر:

1. تفضَّل بزيارة صفحة المواقع الخاصة بك: https://wordpress.com/sites/
2. انقر على اسم موقعك لإلقاء نظرة عامة على الموقع.
3. انقر على علامة تبويب عمليات النشر.
4. انقر على القائمة الممثلة في أيقونة النقاط الثلاث (⋮) الموجودة بجوار المستودع الذي ترغب في عرض السجلات له.
5. حدد “عرض عمليات تشغيل النشر“.
6. تُظهر طريقة عرض قائمة عمليات تشغيل النشر النُسخ المحفوظة التي تم نشرها على الموقع، وحالة النشر، والتاريخ، والمدة.
7. انقر على أي مكان خلال عملية التشغيل للتوسيع وعرض مزيد من المعلومات حول النشر.

توفر السجلات سجلاً لجميع الأوامر التي تم تنفيذها، بداية من إحضار الكود من GitHub وحتى وضعه في الدليل الهدف. ويمكنك توسيع أسطر السجل للاطلاع على مزيد من المعلومات عن طريق النقر على “عرض المزيد“.

عندما تقوم بإلغاء الربط بين مستودع GitHub وموقعك، لن يتم تطبيق أي تغييرات مستقبلية تُجرى على المستودع على موقعك. بشكل افتراضي، تظل الملفات المنشورة على موقعك، ولكن يمكنك اختيار إزالتها خلال عملية إلغاء الربط.

لإزالة مستودع:

1. تفضَّل بزيارة صفحة المواقع الخاصة بك: https://wordpress.com/sites/
2. انقر على اسم موقعك لإلقاء نظرة عامة على الموقع.
3. انقر على علامة تبويب عمليات النشر.
4. انقر على القائمة الممثلة في أيقونة النقاط الثلاث (⋮) في المستودع.
5. حدد “إلغاء ربط المستودع“.
6. ستظهر نافذة حوار. انقر على المفتاح لإزالة الملفات المرتبطة من الموقع.
7. انقر على “إلغاء ربط المستودع” لإغلاق نافذة الحوار وإلغاء ربط المستودع.

لاحظ أن تطبيق WordPress.com للمطورين سيظل ظاهرًا في تطبيقات GitHub المثبتة وتطبيقات GitHub المصرح بها لديك. هذا لأن WordPress.com لا يزال لديه صلاحية الوصول إلى المستودع، ولكن تم حذف عملية الربط.

قد تختار أيضًا سحب الصلاحية الممنوحة لـ WordPress.com للوصول إلى حسابك على GitHub. يمكنك القيام بذلك في أي وقت عن طريق زيارة إعدادات التطبيقات لديك على GitHub. 

لسحب الصلاحية الممنوحة للتطبيق المصرح به للوصول إلى حسابك على GitHub:

1. انتقل إلى تطبيقات GitHub المصرح بها.
2. انقر على سحب صلاحية الوصول بجوار تطبيق WordPress.com للمطورين.
3. انقر على الزر “أفهم، اسحب صلاحية الوصول“.

حتى إذا سحبت صلاحية الوصول من التطبيق المصرح به، فسيظل بالإمكان نشر الكود لأن تطبيق WordPress.com للمطورين سيظل مثبتًا على الحسابات المحددة.

لسحب صلاحية الوصول إلى عملية تثبيت WordPress.com وتعطيل إمكانية نشر الكود على موقعك على WordPress.com:

1. انتقل إلى تطبيقات GitHub المثبَّتة.
2. انقر على تكوين بجوار تطبيق WordPress.com للمطورين.
3. في الجزء منطقة الخطر، انقر على إلغاء التثبيت، ثم انقر على موافق عند ظهور رسالة التأكيد.

إزالة WordPress.com من قائمة التطبيقات المصرح بها لا يعني أن المستودعات سيتم حذفها أو إيقافها عن العمل؛ ستظل مستودعاتك موجودة على GitHub بعد سحب صلاحية الوصول من WordPress.com، ولكن لن يتمكن WordPress.com من نشر الكود بعد الآن.