shqawe
ربي أشرح لي صدري
بسم الله الرحمن الرحيم
الحمد لله والصلاة والسلام على رسول الله نبينا محمد عليه افضل الصلاة واتم التسليم
اللهم لا علم لنا إلا ما علمتنا، إنك أنت العليم الحكيم، اللهم علمنا ما ينفعنا، وانفعنا بما علمتنا، وزدنا علما،
وها نحن نصل الى درسنا الاخير من دروس دورة برمجة الاضافات ومن فاتته الدروس السابقة يستطيع مراجعة فهرس الدورة عن طريق الرابط التالي:
xenarabia.com
في الدرس السابق قمنا بالتعامل مع تعديلات القوالب تلقائيا ً دون التعديل على اي قالب
وفي درسنا اليوم سوف نتكلم باذن الله عن كيفية تصدير الاضافة ولكن قبل ذلك سوف نتكلم قليلاً عن
ملف addon.json
وهذا الملف يتم انشائه تلقائيا ً عند انشاء الاضافة ومحتوياته كالتالي وسوف تجدون شرح بسيط داخل الكود:
الان سوف نقوم بالتعديل على الملف الخاص بالاضافة ونضيف له المعلومات التالية :
الان بعد اضافة المعلومات احفظ الملف وتوجه الى:
لوحة التحكم > الاضافات وابحث عن اضافاتنا سوف تجدها كالصورة التالية:

ستلاحظون ان العنوان والايقونة لم يتغيران
و رابط المطور و رابط التعليمات و رابط الدعم لم يظهرون
ولكن كما ترون هناك مربع ازرق مكتوب عليه [ التغييرات المعلقة ] وهذا معناة ان التغيير الذي قمنا به يحتاج الى مزامنة لكي يتم تطبيقة
لذا سوف نقوم بالضغط على السهم الموجود في المنطقة اليسرى ونختار منه مزامنة التغييرات كما بالصورة التالية:

الان لو عدنا الى الى الاضافات وقمنا بتحديث الصفحة سوف نرى النتيجة التالية:

ستلاحظون ان العنوان تغير والايقونة كذلك وروابط المطور والتعليمات والدعم تم ظهورها وتطبيقها.
الان لم يتبقى لنا الا تصدير الاضافة ولتصدير الاضافة نحتاج لان نعود الى اول نقطة بدأنا بها دورتنا وهي شاشة اوامر التشغيل او ما يسمى بال DOS او Terminal
لذا نفتح سطر اوامر التشغيل ونتأكد اننا في في مسار نسخة الزين فورو بمعنى لو افترضنا ان السيرفر المحلي على القرص c فسوف يكون المسار كالتالي:
ونقوم بكتابة هذا الكود
ولنشرح الكود قليلاً
اول الاوامر وهو :
وهذا الامر استطيع ان اوقول هو الامر الرئيسي لبرنامج الزين فورو فلو كتبت هذا الامر فقط وضغط Enter سوف تظهر لك نتيجة كتابته جميع سطور اوامر الزين فورو
ونحن لا نحتاج من هذه الاوامر الا الامر
وبعد هذا الامر نقوم بكتابة اسم اضافتنا وفي دورتنا كان اسم اضافتنا هو MyfirstAddon وهو نفس اسم مجلد اضافتنا لمن لم يتذكره
الان بعد كتابة الامر والضغط على Enter سوف يتم تصدير ملف مضغوط خاص باضافتنا سوف تجدونه على المسار التالي:
عند الذهاب الى هذا المجلد سوف تجدون ملف مضغوط باسم اضافتنا ونسختها
وبهذا الامر نكون قد انتهينا من دورة برمجة الاضافات واصبح بامكانك الان عزيزي المتابع لهذه الدورة برمجة الاضافات وتصديرها ونشرها للغير
بعض النصائح:
- اتمنى ممن تابع هذه الدورة ان يقوي نفسه في اللغات التي ذكرتها في اول الدورة HTML, CSS, PHP ,JAVASCRIPT او JQUERY فمن لديه المعرفة في هذه اللغات سوف يستطيع الابحار بسهولة.
- حاول ان تقوم بفتح اضافات مبرمجين اخرين والتوغل فيها وفي ملفاتها وانظر كيف تم بناء هذه الاضافة فلكل مبرمج طريقته الخاصة في البرمجة وقد تأخد من كل منهم معلومة جديدة.
- قم بقرائة دليل المبرمجين الموجود في موقع الشركة ففيه بعض الاساسيات وبعض المعلومات التي لم اذكرها كلها في هذه الدورة
في النهاية ممكن ان يتبادر في الاذهان ان هذه الدورة لم تحمل الكثير من المعلومات ولكن ما اردته من هذه الدورة هو ان اقوم بفتح الطريق لمن اراد تعلم برمجة الاضافات فكبداية في البرمجة كان ينقصني المفتاح وهو ما قدمته في هذه الدورة يتبقى الاحتراف وهذا الشيء يأتي منك انت عزيزي المتابع تحتاج لكي تبحث هنا وهناك لكي تصل الى الاحتراف والتقدم والتطور.
اتمنى للجميع كل التوفيق في عالم برمجة الاضافات واتمنى ان ارى اخواني العرب يبدعون وينافسون الغرب في البرمجة فهم ليسو افضل منا في اي شيء
في النهاية ان اصبت فمن فضل الله علي وان اخطأت فجل من لايخطأ
احترامي وتقديري
اخوكم
شقاوي
الحمد لله والصلاة والسلام على رسول الله نبينا محمد عليه افضل الصلاة واتم التسليم
اللهم لا علم لنا إلا ما علمتنا، إنك أنت العليم الحكيم، اللهم علمنا ما ينفعنا، وانفعنا بما علمتنا، وزدنا علما،
وها نحن نصل الى درسنا الاخير من دروس دورة برمجة الاضافات ومن فاتته الدروس السابقة يستطيع مراجعة فهرس الدورة عن طريق الرابط التالي:
[ حصريا ] - فهرس [ دورة XenArabia لبرمجة الإضافات ] من تقديم الأستاذ شقاوي
بسم الله الرحمان الرحيم و الصلاة و السلام على المظلل بالغمام محمد ابن عبد الله عليه أفضل الصلاة و أزكى التسليم حرصا على التنظيم تم عمل هذا الموضوع ليسهل على الجميع الوصول لدروس [ دورة XenArabia لبرمجة الإضافات ] حتى تكون مرجعا لكل مبتدء في عالم برمجة إضافات XenForo كما نوجه الشكر الجزيل للأخ...

في الدرس السابق قمنا بالتعامل مع تعديلات القوالب تلقائيا ً دون التعديل على اي قالب
وفي درسنا اليوم سوف نتكلم باذن الله عن كيفية تصدير الاضافة ولكن قبل ذلك سوف نتكلم قليلاً عن
ملف addon.json
وهذا الملف يتم انشائه تلقائيا ً عند انشاء الاضافة ومحتوياته كالتالي وسوف تجدون شرح بسيط داخل الكود:
JavaScript:
{
"legacy_addon_id": "معرف الاضافة",
"title": "اسم الاضافة",
"description": "وصف الاضافة",
"version_id": "1000010", // اصدار الاضافة
"version_string": "1.0.0 النسخة", // اصدار الاضافة
"dev": "اسم مبرمج الاضافة",
"dev_url": "رابط موقع مبرمج الاضافة",
"faq_url": "رابط التعليمات",
"support_url": "رابط الدعم",
"extra_urls": [],// روابط اضافية
"require": [], // متطلبات اضافية
"icon": "fa-users" // ايقونة الاضافة
}
الان سوف نقوم بالتعديل على الملف الخاص بالاضافة ونضيف له المعلومات التالية :
JavaScript:
{
"legacy_addon_id": "",
"title": "اول اضافة لدورة زين فورو",
"description": "هذه هي اول اضافة لدورة برمجة الاضافات من معهد الزين فورو",
"version_id": 1,
"version_string": "1.0.0",
"dev": "SHQAWE",
"dev_url": "https://xenarabia.com/threads/363/",
"faq_url": "https://xenarabia.com/threads/363/",
"support_url": "https://xenarabia.com/threads/363/",
"extra_urls": [],
"require": [],
"icon": "fa-user"
}
الان بعد اضافة المعلومات احفظ الملف وتوجه الى:
لوحة التحكم > الاضافات وابحث عن اضافاتنا سوف تجدها كالصورة التالية:

ستلاحظون ان العنوان والايقونة لم يتغيران
و رابط المطور و رابط التعليمات و رابط الدعم لم يظهرون
ولكن كما ترون هناك مربع ازرق مكتوب عليه [ التغييرات المعلقة ] وهذا معناة ان التغيير الذي قمنا به يحتاج الى مزامنة لكي يتم تطبيقة
لذا سوف نقوم بالضغط على السهم الموجود في المنطقة اليسرى ونختار منه مزامنة التغييرات كما بالصورة التالية:

الان لو عدنا الى الى الاضافات وقمنا بتحديث الصفحة سوف نرى النتيجة التالية:

ستلاحظون ان العنوان تغير والايقونة كذلك وروابط المطور والتعليمات والدعم تم ظهورها وتطبيقها.
الان لم يتبقى لنا الا تصدير الاضافة ولتصدير الاضافة نحتاج لان نعود الى اول نقطة بدأنا بها دورتنا وهي شاشة اوامر التشغيل او ما يسمى بال DOS او Terminal
لذا نفتح سطر اوامر التشغيل ونتأكد اننا في في مسار نسخة الزين فورو بمعنى لو افترضنا ان السيرفر المحلي على القرص c فسوف يكون المسار كالتالي:
HTML:
C:\xampp\htdocs\xenforo
ونقوم بكتابة هذا الكود
PHP:
php cmd.php xf-addon:build-release MyFirstAddon
ولنشرح الكود قليلاً
اول الاوامر وهو :
كود:
php cmd.php xf
وهذا الامر استطيع ان اوقول هو الامر الرئيسي لبرنامج الزين فورو فلو كتبت هذا الامر فقط وضغط Enter سوف تظهر لك نتيجة كتابته جميع سطور اوامر الزين فورو
ونحن لا نحتاج من هذه الاوامر الا الامر
HTML:
xf-addon:build-release
وبعد هذا الامر نقوم بكتابة اسم اضافتنا وفي دورتنا كان اسم اضافتنا هو MyfirstAddon وهو نفس اسم مجلد اضافتنا لمن لم يتذكره
الان بعد كتابة الامر والضغط على Enter سوف يتم تصدير ملف مضغوط خاص باضافتنا سوف تجدونه على المسار التالي:
كود:
C:\xampp\htdocs\xenforo\src\addons\MyFirstAddon\_releases
عند الذهاب الى هذا المجلد سوف تجدون ملف مضغوط باسم اضافتنا ونسختها
وبهذا الامر نكون قد انتهينا من دورة برمجة الاضافات واصبح بامكانك الان عزيزي المتابع لهذه الدورة برمجة الاضافات وتصديرها ونشرها للغير
بعض النصائح:
- اتمنى ممن تابع هذه الدورة ان يقوي نفسه في اللغات التي ذكرتها في اول الدورة HTML, CSS, PHP ,JAVASCRIPT او JQUERY فمن لديه المعرفة في هذه اللغات سوف يستطيع الابحار بسهولة.
- حاول ان تقوم بفتح اضافات مبرمجين اخرين والتوغل فيها وفي ملفاتها وانظر كيف تم بناء هذه الاضافة فلكل مبرمج طريقته الخاصة في البرمجة وقد تأخد من كل منهم معلومة جديدة.
- قم بقرائة دليل المبرمجين الموجود في موقع الشركة ففيه بعض الاساسيات وبعض المعلومات التي لم اذكرها كلها في هذه الدورة
في النهاية ممكن ان يتبادر في الاذهان ان هذه الدورة لم تحمل الكثير من المعلومات ولكن ما اردته من هذه الدورة هو ان اقوم بفتح الطريق لمن اراد تعلم برمجة الاضافات فكبداية في البرمجة كان ينقصني المفتاح وهو ما قدمته في هذه الدورة يتبقى الاحتراف وهذا الشيء يأتي منك انت عزيزي المتابع تحتاج لكي تبحث هنا وهناك لكي تصل الى الاحتراف والتقدم والتطور.
اتمنى للجميع كل التوفيق في عالم برمجة الاضافات واتمنى ان ارى اخواني العرب يبدعون وينافسون الغرب في البرمجة فهم ليسو افضل منا في اي شيء
في النهاية ان اصبت فمن فضل الله علي وان اخطأت فجل من لايخطأ
احترامي وتقديري
اخوكم
شقاوي