بسم الله الرحمن الرحيم
الحمد لله والصلاة والسلام على رسول الله نبينا محمد عليه افضل الصلاة واتم التسليم
اللهم لا علم لنا إلا ما علمتنا، إنك أنت العليم الحكيم، اللهم علمنا ما ينفعنا، وانفعنا بما علمتنا، وزدنا علما،
احبتي واخوتي في الله اعضاء وزوار معهدنا الغالي اهلا وسهلا بكم في هذا الصرح الغالي على قلوبنا
كما وعدناكم سابقا ً بعمل دورة خاصة ببرمجة الاضافات ها نحن والحمد لله الذي اعطانا العمر لكي نوفي بوعدنا ونقدم لكم هذه الدورة.
متطلبات الدورة للغات البرمجة:
- معرفة تامة بلغة html
قبل البدأ في الدورة يفترض انك تملك سيرفر شخصي ونسخة 2.1 xenforo على جهازك وتستيطع المرور على دورة استاذنا ابو عبد الله على الرابط التالي وتنصيب السيرفر ونسخة xenforo
ايضا ً احد متطلبات الدورة ان تكون تملك برنامج تعديل على الملفات وانصح بشدة ببرنامج Visual Studio Code فهو خفيف ومجاني وفيه ميزة حقيقة لم اجدها في غيره وهي المقارنة بين الملفات
رابط البرنامج للتحميل
بعد توفير جميع ماذكر سابقا ً سمي بالله واكمل الدرس معنا
سوف نقوم اولا ً بتهيئة xenforo للبيئة البرمجية وهي ووضع التطوير والبرمجة وذلك يتم عن طريق ملف config.php والموجود على المسار التالي:
نقوم بفتح الملف للتعديل عليه ونضيف الاكواد التالية بعد معلومات قاعدة البيانات:
لنشرح الاوامر التي تهمنا في الدورة:
الامر الاول: هو لتفعيل بيئة المعالجة او التصحيح واظهار بعض المعلومات الخاصة بالمعالجة مثل عدد الاستعلامات وعدد القوالب المستخدمة في الصفحة المزارة
الامر الثاني: وهو لتفعيل خيارات البرمجة والتطوير في لوحة التحكم وسوف ترون ما اقصد لاحقا ً
الامر الثالث: وهو امر اختياري ولكن مفيد وهو في حين بداية برمجة اي اضافة قم بكتابة اسم الاضافة بدلا ً من AddonName وسوف يكون اي خيار تقوم باضافة تلقائيا ً مدرج باسم الاضافة
من صعب عليه فهم ما اقصد في الاومر السابقة فاتمنى ان لايستعجل فلاحقا ً سوف تظهر فائدة كل امر
الان كل ما عليك هو لصق هذه المعلومات في ملف config.php ومن ثم حفظ الملف واغلاقه
الان لكي تتأكد ان عملك على ما يرام اذهب لصفحة المنتدى الرئيسية وانزل الى اخر الصفحة بالضبط تحت الفوتيير
سوف تجد عدد الاستعلامات واجمالي الوقت والذاكرة القصوى كما بالصورة التالية:
اذا وجدت هذه الاستعلامات فانت في الطريق الصحيح الان لنتوجه ايضا ً الى لوحة التحكم وسوف تجد خيار جديد تم اضافته في اخر القائمة باسم تطوير وبرمجة كما بالصورة التالية:
اذا ظهر لك هذا الخيار ايضا ً فاقول لك مبروك تم تهيئة ال xenforo لبيئة التطوير والبرمجة.
الان سوف ننتقل الى انشاء اضافة جديدة باي اسم تريد ويفضل ان تكون اسماء الاضافات بنفس عملها
وفي هذا الدرس سوف اقوم بانشاء اضافة باسم MyFirstAddon
ولاحظو ان كل حرف من كل كلمة يفضل ان يكون كبير Capital Letter لان هذا ما تستخدمه xenforo في قرائة الملفات
الان لانشاء اضافة لابد من استخدام اوامر الدوس DOS Command line
وانا كما ذكرت في بداية الدرس انني استخدم برنامج Visual Studio Code والذي يتيح لك استخدام شاشة الدوس داخل البرنامج كما ترون في هذه الصورة:
لاحظو المنطقة المشار اليها باللون الاحمر هذه هي شاشة الدوس
ولكن ان كنت تستخدم اي برنامج اخر فلا مشكلة قم بفتح شاشة الدوس
ثم توجه الى المسار الذي قمت بتنصيب نسخة xenforo عليه وتأكد انك في مسار النسخة الرئيسي
ففرضا ً لو كنت تستخدم برنامج appserver ونسخة الxenforo باسم xf2 فسوف يكون المسار كالتالي:
الان لانشاء اضافة جديدة سوف نقوم بكتابة هذا الامر في شاشة الدوس ونضغط Enter
سوف تظهر لك رسالة تطلب منك كتابة اسم خاص بالاضافة التي تود انشائها وكما اسلفت سابقا ً سوف تكون باسم MyFirstAddon لذا نكتب الاسم ونضغط Enter
ملاحظة ID الاضافة لابد ان يكتب بدون فراغات ويفضل ان يكون اول حرف من كلمة كبير Capital Letter
عندها سوف تظهر لك رسالة تطلب منك كتابة اسم لهذه الاضافة وهذا الاسم سوف يظهر كعنوان للاضافة في صفحة الاضافات في لوحة التحكم اكتب ما تشاء:
وانا وضعت هذا العنوان وضغطت Enter
My first Addon For XenArabia Add-on Course
عندها سوف تظهر لك رسالة مفادها ضع رقم النسخة ضع رقم 1000010 او بامكانك الاكتفاء بكتابة رقم 1 ثم اضغط Enter
ثم سوف تظهر لك رسالة اخرى مفادها نفس السابقة ولكن هنا ضع رقم النسخة بهذه الطريقة
1.0.0
والفرق بين الاولى والثانية ان الاولى بصيغة Integer والثانية بصيغة String وفائدتها هي عند عمل تحديث للاضافة فانك سوف تقوم بزيادة هذا العدد
بعد الضغط على Enter سوف تظهر لك هذه الرسالة لتسألك هل هذه الاضافة سوف تحل محل اضافة للجيل السابق ضع الحرف n واضغط Enter وهذه هي الرسالة
عندها سوف تظهر لك رسالة اخرى تسألك هل هذه الاضافة تحتاج الى ملف تنصيب ضع الحرف n واضغط Enter
وبهذا الكود الاخير تكون قد انشأت اول اضافة باستخدام الاوامر وهذه صورة للاوامر التي كتبناها من شاشة الدوس.
الان سوف تجد انه تم انشاء مجلد جديد باسم MyFirstAddon على المسار التالي:
ولو قمت بفتح لوحة تحكم المنتدى وتوجهت الى الاضافات فسوف تجد الاضافة الجديدة التي قمنا بانشائها موجودة كما بالصورة التالية:
والى هنا انتهينا من الدرس الاول لهذه الدورة بتهيئة xenforo لبيئة التطوير والبرمجة وانشاء اول اضافة
والى لقاء اخر في الدرس القادم باذن الله وبانتظار تطبيقاتكم و استفساراتكم وتفاعلكم
ان اصبت فمن فضل الله علي وان اخطأت فجل من لا يخطأ واتمنى ان تعذروني على خطأي
احترامي وتقديري
اخوكم
شقاوي
الحمد لله والصلاة والسلام على رسول الله نبينا محمد عليه افضل الصلاة واتم التسليم
اللهم لا علم لنا إلا ما علمتنا، إنك أنت العليم الحكيم، اللهم علمنا ما ينفعنا، وانفعنا بما علمتنا، وزدنا علما،
احبتي واخوتي في الله اعضاء وزوار معهدنا الغالي اهلا وسهلا بكم في هذا الصرح الغالي على قلوبنا
كما وعدناكم سابقا ً بعمل دورة خاصة ببرمجة الاضافات ها نحن والحمد لله الذي اعطانا العمر لكي نوفي بوعدنا ونقدم لكم هذه الدورة.
متطلبات الدورة للغات البرمجة:
- معرفة تامة بلغة html
- معرفة تامة بلغة css
- معرفة بسيطة بلغة php بحيث تستطيع التفرقة بين وسوم ال html ووسوم php
- معرفة بسيطة بلغة javascript او لغة jQuery
- معرفة بسيطة باوامر شاشة الدوس او ما يسمى ب Terminal Command Line لان برمجة الاضافات مبنية على هذا الاساس
قبل البدأ في الدورة يفترض انك تملك سيرفر شخصي ونسخة 2.1 xenforo على جهازك وتستيطع المرور على دورة استاذنا ابو عبد الله على الرابط التالي وتنصيب السيرفر ونسخة xenforo
فهرس [ دورة XenArabia ] لتثبيت XenForo 2.1 على السرفر الشخصي
بسم الله الرحمان الرحيم و الصلاة و السلام على المظلل بالغمام محمد ابن عبد الله عليه أفضل الصلاة و أزكى التسليم حرصا على التنظيم تم عمل هذا الموضوع ليشهل على جميع دروس [ دورة XenArabia ] لتثبيت XenForo 2.1 على السرفر الشخصي ، و هي من تقديم أخونا @أبو عبدالله فجزاه الله خيرا. [ دورة تثبيت...
xenarabia.com
ايضا ً احد متطلبات الدورة ان تكون تملك برنامج تعديل على الملفات وانصح بشدة ببرنامج Visual Studio Code فهو خفيف ومجاني وفيه ميزة حقيقة لم اجدها في غيره وهي المقارنة بين الملفات
رابط البرنامج للتحميل
بعد توفير جميع ماذكر سابقا ً سمي بالله واكمل الدرس معنا
سوف نقوم اولا ً بتهيئة xenforo للبيئة البرمجية وهي ووضع التطوير والبرمجة وذلك يتم عن طريق ملف config.php والموجود على المسار التالي:
كود:
xenforo\src\config.php
نقوم بفتح الملف للتعديل عليه ونضيف الاكواد التالية بعد معلومات قاعدة البيانات:
PHP:
$config['debug'] = true;
$config['development']['enabled'] = true;
$config['development']['defaultAddOn'] = 'AddonName';
لنشرح الاوامر التي تهمنا في الدورة:
الامر الاول: هو لتفعيل بيئة المعالجة او التصحيح واظهار بعض المعلومات الخاصة بالمعالجة مثل عدد الاستعلامات وعدد القوالب المستخدمة في الصفحة المزارة
الامر الثاني: وهو لتفعيل خيارات البرمجة والتطوير في لوحة التحكم وسوف ترون ما اقصد لاحقا ً
الامر الثالث: وهو امر اختياري ولكن مفيد وهو في حين بداية برمجة اي اضافة قم بكتابة اسم الاضافة بدلا ً من AddonName وسوف يكون اي خيار تقوم باضافة تلقائيا ً مدرج باسم الاضافة
من صعب عليه فهم ما اقصد في الاومر السابقة فاتمنى ان لايستعجل فلاحقا ً سوف تظهر فائدة كل امر
الان كل ما عليك هو لصق هذه المعلومات في ملف config.php ومن ثم حفظ الملف واغلاقه
الان لكي تتأكد ان عملك على ما يرام اذهب لصفحة المنتدى الرئيسية وانزل الى اخر الصفحة بالضبط تحت الفوتيير
سوف تجد عدد الاستعلامات واجمالي الوقت والذاكرة القصوى كما بالصورة التالية:
اذا وجدت هذه الاستعلامات فانت في الطريق الصحيح الان لنتوجه ايضا ً الى لوحة التحكم وسوف تجد خيار جديد تم اضافته في اخر القائمة باسم تطوير وبرمجة كما بالصورة التالية:
اذا ظهر لك هذا الخيار ايضا ً فاقول لك مبروك تم تهيئة ال xenforo لبيئة التطوير والبرمجة.
الان سوف ننتقل الى انشاء اضافة جديدة باي اسم تريد ويفضل ان تكون اسماء الاضافات بنفس عملها
وفي هذا الدرس سوف اقوم بانشاء اضافة باسم MyFirstAddon
ولاحظو ان كل حرف من كل كلمة يفضل ان يكون كبير Capital Letter لان هذا ما تستخدمه xenforo في قرائة الملفات
الان لانشاء اضافة لابد من استخدام اوامر الدوس DOS Command line
وانا كما ذكرت في بداية الدرس انني استخدم برنامج Visual Studio Code والذي يتيح لك استخدام شاشة الدوس داخل البرنامج كما ترون في هذه الصورة:
لاحظو المنطقة المشار اليها باللون الاحمر هذه هي شاشة الدوس
ولكن ان كنت تستخدم اي برنامج اخر فلا مشكلة قم بفتح شاشة الدوس
ثم توجه الى المسار الذي قمت بتنصيب نسخة xenforo عليه وتأكد انك في مسار النسخة الرئيسي
ففرضا ً لو كنت تستخدم برنامج appserver ونسخة الxenforo باسم xf2 فسوف يكون المسار كالتالي:
كود:
C:\AppServ\www\xf2
الان لانشاء اضافة جديدة سوف نقوم بكتابة هذا الامر في شاشة الدوس ونضغط Enter
كود:
php cmd.php xf-addon:create
سوف تظهر لك رسالة تطلب منك كتابة اسم خاص بالاضافة التي تود انشائها وكما اسلفت سابقا ً سوف تكون باسم MyFirstAddon لذا نكتب الاسم ونضغط Enter
ملاحظة ID الاضافة لابد ان يكتب بدون فراغات ويفضل ان يكون اول حرف من كلمة كبير Capital Letter
كود:
Enter an ID for this add-on:
عندها سوف تظهر لك رسالة تطلب منك كتابة اسم لهذه الاضافة وهذا الاسم سوف يظهر كعنوان للاضافة في صفحة الاضافات في لوحة التحكم اكتب ما تشاء:
كود:
Enter a title:
وانا وضعت هذا العنوان وضغطت Enter
My first Addon For XenArabia Add-on Course
عندها سوف تظهر لك رسالة مفادها ضع رقم النسخة ضع رقم 1000010 او بامكانك الاكتفاء بكتابة رقم 1 ثم اضغط Enter
ثم سوف تظهر لك رسالة اخرى مفادها نفس السابقة ولكن هنا ضع رقم النسخة بهذه الطريقة
1.0.0
والفرق بين الاولى والثانية ان الاولى بصيغة Integer والثانية بصيغة String وفائدتها هي عند عمل تحديث للاضافة فانك سوف تقوم بزيادة هذا العدد
بعد الضغط على Enter سوف تظهر لك هذه الرسالة لتسألك هل هذه الاضافة سوف تحل محل اضافة للجيل السابق ضع الحرف n واضغط Enter وهذه هي الرسالة
كود:
Does this add-on supersede a XenForo 1 add-on? (y/n)
عندها سوف تظهر لك رسالة اخرى تسألك هل هذه الاضافة تحتاج الى ملف تنصيب ضع الحرف n واضغط Enter
كود:
Does your add-on need a Setup file? (y/n)
وبهذا الكود الاخير تكون قد انشأت اول اضافة باستخدام الاوامر وهذه صورة للاوامر التي كتبناها من شاشة الدوس.
الان سوف تجد انه تم انشاء مجلد جديد باسم MyFirstAddon على المسار التالي:
كود:
xf2\src\addons
ولو قمت بفتح لوحة تحكم المنتدى وتوجهت الى الاضافات فسوف تجد الاضافة الجديدة التي قمنا بانشائها موجودة كما بالصورة التالية:
والى هنا انتهينا من الدرس الاول لهذه الدورة بتهيئة xenforo لبيئة التطوير والبرمجة وانشاء اول اضافة
والى لقاء اخر في الدرس القادم باذن الله وبانتظار تطبيقاتكم و استفساراتكم وتفاعلكم
ان اصبت فمن فضل الله علي وان اخطأت فجل من لا يخطأ واتمنى ان تعذروني على خطأي
احترامي وتقديري
اخوكم
شقاوي
التعديل الأخير: