[ حصريا ] - دورة برمجة الاضافات - [ الدرس الاول - تهيئة ال xenforo لبيئة البرمجة وانشاء اول اضافة ] | XenArabia | زين فورو العربية

[ حصريا ] دورة برمجة الاضافات - [ الدرس الاول - تهيئة ال xenforo لبيئة البرمجة وانشاء اول اضافة ]

shqawe

:: طاقم الإشراف ::
طاقم الإدارة
إنضم
27 يونيو 2019
المشاركات
174
مستوى التفاعل
248
النقاط
43
الإقامة
K.S.A
بسم الله الرحمن الرحيم

الحمد لله والصلاة والسلام على رسول الله نبينا محمد عليه افضل الصلاة واتم التسليم

اللهم لا علم لنا إلا ما علمتنا، إنك أنت العليم الحكيم، اللهم علمنا ما ينفعنا، وانفعنا بما علمتنا، وزدنا علما،

احبتي واخوتي في الله اعضاء وزوار معهدنا الغالي اهلا وسهلا بكم في هذا الصرح الغالي على قلوبنا

كما وعدناكم سابقا ً بعمل دورة خاصة ببرمجة الاضافات ها نحن والحمد لله الذي اعطانا العمر لكي نوفي بوعدنا ونقدم لكم هذه الدورة.

متطلبات الدورة للغات البرمجة:

- معرفة تامة بلغة html

  • معرفة تامة بلغة css
  • معرفة بسيطة بلغة php بحيث تستطيع التفرقة بين وسوم ال html ووسوم php
  • معرفة بسيطة بلغة javascript او لغة jQuery
  • معرفة بسيطة باوامر شاشة الدوس او ما يسمى ب Terminal Command Line لان برمجة الاضافات مبنية على هذا الاساس


قبل البدأ في الدورة يفترض انك تملك سيرفر شخصي ونسخة 2.1 xenforo على جهازك وتستيطع المرور على دورة استاذنا ابو عبد الله على الرابط التالي وتنصيب السيرفر ونسخة xenforo


ايضا ً احد متطلبات الدورة ان تكون تملك برنامج تعديل على الملفات وانصح بشدة ببرنامج Visual Studio Code فهو خفيف ومجاني وفيه ميزة حقيقة لم اجدها في غيره وهي المقارنة بين الملفات (y)

رابط البرنامج للتحميل


بعد توفير جميع ماذكر سابقا ً سمي بالله واكمل الدرس معنا

سوف نقوم اولا ً بتهيئة xenforo للبيئة البرمجية وهي ووضع التطوير والبرمجة وذلك يتم عن طريق ملف config.php والموجود على المسار التالي:

كود:
xenforo\src\config.php
نقوم بفتح الملف للتعديل عليه ونضيف الاكواد التالية بعد معلومات قاعدة البيانات:

PHP:
$config['debug'] = true;
$config['development']['enabled'] = true;
$config['development']['defaultAddOn'] = 'AddonName';

لنشرح الاوامر التي تهمنا في الدورة:

الامر الاول: هو لتفعيل بيئة المعالجة او التصحيح واظهار بعض المعلومات الخاصة بالمعالجة مثل عدد الاستعلامات وعدد القوالب المستخدمة في الصفحة المزارة
الامر الثاني: وهو لتفعيل خيارات البرمجة والتطوير في لوحة التحكم وسوف ترون ما اقصد لاحقا ً
الامر الثالث: وهو امر اختياري ولكن مفيد وهو في حين بداية برمجة اي اضافة قم بكتابة اسم الاضافة بدلا ً من AddonName وسوف يكون اي خيار تقوم باضافة تلقائيا ً مدرج باسم الاضافة

من صعب عليه فهم ما اقصد في الاومر السابقة فاتمنى ان لايستعجل فلاحقا ً سوف تظهر فائدة كل امر

الان كل ما عليك هو لصق هذه المعلومات في ملف config.php ومن ثم حفظ الملف واغلاقه

الان لكي تتأكد ان عملك على ما يرام اذهب لصفحة المنتدى الرئيسية وانزل الى اخر الصفحة بالضبط تحت الفوتيير

سوف تجد عدد الاستعلامات واجمالي الوقت والذاكرة القصوى كما بالصورة التالية:

1069

اذا وجدت هذه الاستعلامات فانت في الطريق الصحيح الان لنتوجه ايضا ً الى لوحة التحكم وسوف تجد خيار جديد تم اضافته في اخر القائمة باسم تطوير وبرمجة كما بالصورة التالية:

1070

اذا ظهر لك هذا الخيار ايضا ً فاقول لك مبروك تم تهيئة ال xenforo لبيئة التطوير والبرمجة.

الان سوف ننتقل الى انشاء اضافة جديدة باي اسم تريد ويفضل ان تكون اسماء الاضافات بنفس عملها

وفي هذا الدرس سوف اقوم بانشاء اضافة باسم MyFirstAddon

ولاحظو ان كل حرف من كل كلمة يفضل ان يكون كبير Capital Letter لان هذا ما تستخدمه xenforo في قرائة الملفات


الان لانشاء اضافة لابد من استخدام اوامر الدوس DOS Command line

وانا كما ذكرت في بداية الدرس انني استخدم برنامج Visual Studio Code والذي يتيح لك استخدام شاشة الدوس داخل البرنامج كما ترون في هذه الصورة:

a-3.jpg

لاحظو المنطقة المشار اليها باللون الاحمر هذه هي شاشة الدوس

ولكن ان كنت تستخدم اي برنامج اخر فلا مشكلة قم بفتح شاشة الدوس

ثم توجه الى المسار الذي قمت بتنصيب نسخة 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)
وبهذا الكود الاخير تكون قد انشأت اول اضافة باستخدام الاوامر وهذه صورة للاوامر التي كتبناها من شاشة الدوس.

a-4.jpg

الان سوف تجد انه تم انشاء مجلد جديد باسم MyFirstAddon على المسار التالي:

كود:
xf2\src\addons
ولو قمت بفتح لوحة تحكم المنتدى وتوجهت الى الاضافات فسوف تجد الاضافة الجديدة التي قمنا بانشائها موجودة كما بالصورة التالية:

1072

والى هنا انتهينا من الدرس الاول لهذه الدورة بتهيئة xenforo لبيئة التطوير والبرمجة وانشاء اول اضافة

والى لقاء اخر في الدرس القادم باذن الله وبانتظار تطبيقاتكم و استفساراتكم وتفاعلكم

ان اصبت فمن فضل الله علي وان اخطأت فجل من لا يخطأ واتمنى ان تعذروني على خطأي

احترامي وتقديري
اخوكم
شقاوي
 

XenArabia

الحياة محطات فاترك في كل محطة ابتسامة
طاقم الإدارة
إنضم
23 يناير 2019
المشاركات
852
مستوى التفاعل
851
النقاط
93
العمر
36
الإقامة
المغرب
الموقع الالكتروني
ما شاء الله عليك أستاذنا ..
دورة مهمة جدا و مطلوبة
يثبت الموضوع للأهمية ..
 

shqawe

:: طاقم الإشراف ::
طاقم الإدارة
إنضم
27 يونيو 2019
المشاركات
174
مستوى التفاعل
248
النقاط
43
الإقامة
K.S.A
اشكرك على التثبيت مديرنا الغالي

وان شاء الله ان الدورة تكون على القدر المطلوب منها ان تكون

واتمنى ان يكون الشرح سلس وسهل للجميع وانا تحت الخدمة في الرد على اي استفسار

تقبل احترامي وتقديري
اخوك
شقاوي
 

shqawe

:: طاقم الإشراف ::
طاقم الإدارة
إنضم
27 يونيو 2019
المشاركات
174
مستوى التفاعل
248
النقاط
43
الإقامة
K.S.A
حياك اخوي عابر سبيل شرفت الموضوع 🤚
 

Alrajabane

:: الإدارة العامة ::
طاقم الإدارة
إنضم
27 يناير 2019
المشاركات
280
مستوى التفاعل
240
النقاط
43
الإقامة
السعودية
الموقع الالكتروني
ماشاء الله عليك اخوي @shqawe
واصل ابداعك ، يالغالي ..
 

shqawe

:: طاقم الإشراف ::
طاقم الإدارة
إنضم
27 يونيو 2019
المشاركات
174
مستوى التفاعل
248
النقاط
43
الإقامة
K.S.A
حياك الله اخوي @Alrajabane

نورت الموضوع يالغالي
 

MesterPerfect

:: الأعضاء ::
إنضم
27 يناير 2019
المشاركات
327
مستوى التفاعل
304
النقاط
63
الإقامة
sohag, Egypt
الموقع الالكتروني
جميل جدا أخي الحبيب جزاك الله خيرا
تم التطبيق وفي النهاية تم إنشاء ملف setup.php مع آخر خطوة
1076

وهذه الصورة بعد التطبيق من على الssh في برنامج xampp
واصل صديقي متابعين معكم إن شاء الله
 

shqawe

:: طاقم الإشراف ::
طاقم الإدارة
إنضم
27 يونيو 2019
المشاركات
174
مستوى التفاعل
248
النقاط
43
الإقامة
K.S.A
احسنت حبيبي احمد (y) مع انه في الدورة هذي ما راح نتطرق لملف setup

لكن تطبيقك ممتاز جدا ً للدرس اتوقع انك راح تكون افضل مني في المستقبل 😁

احترامي وتقديري
اخوك
شقاوي
 

MesterPerfect

:: الأعضاء ::
إنضم
27 يناير 2019
المشاركات
327
مستوى التفاعل
304
النقاط
63
الإقامة
sohag, Egypt
الموقع الالكتروني
احسنت حبيبي احمد (y) مع انه في الدورة هذي ما راح نتطرق لملف setup

لكن تطبيقك ممتاز جدا ً للدرس اتوقع انك راح تكون افضل مني في المستقبل 😁

احترامي وتقديري
اخوك
شقاوي
الله يبارك فيك ويعزك أخي الكريم
أنا فقط قمت بإنشائه لربما نحتاج له :D
وإذا ما أحتجنا له فلن يخسرنا شيء بإذن الله :)
تحياتي لك وبإنتظار باقي الدروس إن شاء الله
 

bousaid

:: الأعضاء ::
إنضم
27 يناير 2019
المشاركات
51
مستوى التفاعل
117
النقاط
33
بارك الله فيك ....
 

أبو عبدالله

:: الأعضاء ::
إنضم
2 فبراير 2019
المشاركات
145
مستوى التفاعل
142
النقاط
43
الإقامة
مكة المكرمة
الله الله يا تركي

واخيرا حنيت علينا وسويت لنا هالدوره

الله يجزاك عنا خير الجزاء

وانا واثق انه راح يستفيد عدد لاباس به من خبرتك في الاضافات

الله يزيدك علم وينفع بك وينفعك

شكرا لك يالامير

واصل ابداعك
 

Abu Ayesh

:: الأعضاء ::
إنضم
28 يناير 2019
المشاركات
52
مستوى التفاعل
18
النقاط
8
بارك الله فيك ياغالي
 

shqawe

:: طاقم الإشراف ::
طاقم الإدارة
إنضم
27 يونيو 2019
المشاركات
174
مستوى التفاعل
248
النقاط
43
الإقامة
K.S.A
الله الله يا تركي

واخيرا حنيت علينا وسويت لنا هالدوره

الله يجزاك عنا خير الجزاء

وانا واثق انه راح يستفيد عدد لاباس به من خبرتك في الاضافات

الله يزيدك علم وينفع بك وينفعك

شكرا لك يالامير

واصل ابداعك
ارحب بالشيخ @أبو عبدالله

والله وانا اخوك اني قاعد اجهز لها من بدري بس كنت انتظر الوقت المناسب

والحمد لله اللي اعطانا العمر والصحة اننا نقدمها

واهم شيء الكل يستفيد ان شاء الله

والدرس الثاني قاعد اجهز له وبيكون دسم ان شاء الله

بارك الله فيك ياغالي
وفيك اخوي @Abu Ayesh

احترامي وتقديري
اخوكم
شقاوي
 

جميع المواضيع والمشاركات المكتوبة تعبّر عن وجهة نظر صاحبها ,, ولا تعبّر بأي شكل من الاشكال عن وجهة نظر إدارة المنتدى .

إحصائيات المنتدى

المواضيع
416
المشاركات
2,670
الأعضاء
141
آخر عضو مسجل
lbebulk21
أعلى