السلام عليكم
اليوم بإذن الله سأضع أول درس مقدم من فريق Joomla Ultimate عن برمجة موديل جملة متصل بقاعدة البيانات
بإسم الله نبدأ
القاعدة الأولى هي أن أي موديل لجملة يجب أن يتكون من ملفين على الأقل ، بمعنى ملفان أو أكثر .
الملف الأول و الرئيسي هو ملف البي إتش بي و يكون إمتداده
رمز PHP:
الملف الثاني و يكون إمتداده
رمز PHP:
ملف الـ PHP مسؤول على محتوى الموديل و ما يظهر في الواجهة ، أي انه الأساس الذي يحمل الشيفرة البرمجية
أما ملف الـ xml فهو المحرك الداخلي ، و هو على الأقل يؤدي وظيفتين ،
الوظيفة الأولى : يرفع ملفات الموديل إلى موقعك أثناء التنصيب .
الوظيفة الثانية : يعطينا خيارات التحكم بالموديل من لوحة التحكم .
الآن لنبدأ تطبيقنا لهذا اليوم ، و هو برمجة موديل مبسط لمجلة جملة .
نبدأ بملف الـ XML وهذه محتوياته :
ننشئ ملفا و نسميه
رمز PHP:
و نضع فيه التالي :
اليوم بإذن الله سأضع أول درس مقدم من فريق Joomla Ultimate عن برمجة موديل جملة متصل بقاعدة البيانات
بإسم الله نبدأ
القاعدة الأولى هي أن أي موديل لجملة يجب أن يتكون من ملفين على الأقل ، بمعنى ملفان أو أكثر .
الملف الأول و الرئيسي هو ملف البي إتش بي و يكون إمتداده
رمز PHP:
.php
الملف الثاني و يكون إمتداده
رمز PHP:
.xml
ملف الـ PHP مسؤول على محتوى الموديل و ما يظهر في الواجهة ، أي انه الأساس الذي يحمل الشيفرة البرمجية
أما ملف الـ xml فهو المحرك الداخلي ، و هو على الأقل يؤدي وظيفتين ،
الوظيفة الأولى : يرفع ملفات الموديل إلى موقعك أثناء التنصيب .
الوظيفة الثانية : يعطينا خيارات التحكم بالموديل من لوحة التحكم .
الآن لنبدأ تطبيقنا لهذا اليوم ، و هو برمجة موديل مبسط لمجلة جملة .
نبدأ بملف الـ XML وهذه محتوياته :
ننشئ ملفا و نسميه
رمز PHP:
mod_jut_example.xml
و نضع فيه التالي :
رمز PHP:
السطر الأول يحمل رقم الإصدار و الترميز و هو utf-8 ، الذي هو ترميز جملة .
رمز PHP:
السطر الثاني
1 - يبدأ بكلمة install و بهذا يعلم المجلة ببدأ التثبيت .
2 - يحمل نوعه الإضافة و هي module ثم إصدار المجلة و الذي هو 1.5 .
إصدار المجلة يعطي المستخدم مدى توافقية الموديل مع المجلة ، ثم إنه لن يثبت في إصدارات أخرى إلا بعد تفعيل نظام التوافقية
رمز PHP:
.
1 - يبدأ بكلمة install و بهذا يعلم المجلة ببدأ التثبيت .
2 - يحمل نوعه الإضافة و هي module ثم إصدار المجلة و الذي هو 1.5 .
إصدار المجلة يعطي المستخدم مدى توافقية الموديل مع المجلة ، ثم إنه لن يثبت في إصدارات أخرى إلا بعد تفعيل نظام التوافقية
رمز PHP:
Legacy
.
رمز PHP:
mod_jut_example
السطر الثالث يحمل إسم الموديل و الذي غالبا ما يبدأ إسمه بـ
رمز PHP:
mod_
رمز PHP:
xx-xx-2009
السطر الرابع كما هو واضح ، يحمل تاريخ إنشاء الموديل .
رمز PHP:
Rifizm - JUT
السطر الخامس يحمل إسم المبرمج لعرضه للمستخدم في لوحة التحكم
رمز PHP:
GPL
السطر السادس يحمل نوع الرخصة ، و هنا نرى أن موديلنا هذا يحمل رخصة GPL العمومية . أي أنه مجاني .
رمز PHP:
khalid@joomlaut.org
السطر السابع يحمل بريد المبرمج
رمز PHP:
http://joomlaut.org
السطر الثامن يحمل موقع المبرمج
رمز PHP:
1.0
السطر التاسع يحمل إصدارة الموديل
رمز PHP:
موديل example يصلح لكذا و كذا ...
السطر العاشر يحمل الوصف
هنا أكملنا المقدمة التي يتكون منها أي موديل ، طبع يمكن الإستغناء عن بعض الأسطر في هذه المقدمة لكن من الأفضل تعبئتها كلها .
المقدمة مهمتها التعريف بالموديل و مبرمجه ، الآن نأتي للباقي
رمز PHP:
mod_jut_youtube.php
example.gif
السطر الأول يعلم جملة أن القادم هو الملفات التي يجب أن تنقل إلى مجلد الموديلات
السطر الثاني يبين الملف الرئيسي للموديل
السطر الثالث هو ملف ثانوي ينقل إلى مجلد الموديل عند الثتبيت ، نحن وضعنا كمثال ، صورة example.gif لكن يمكن أن يكون ملفا آخر
كما يمكن تكرار السطر الثالث لنقل عدد أكبر من الملفات
السطر الرابع ، نغلق عملية النقل
رمز PHP:
السطور التالية هي التي تعطينا التحكم بالموديل من لوحة التحكم ، أي أنها لوحة تحكم مصغرة خاصة بالموديل و تتكون من حقول نحن نحددها .
و تبدأ كما هو مبين في السطر الأول بـ params
السطر الثاني مكون من حقل واحد من نوع text و تفصيله كالتالي :
رمز PHP:
<span style="color: #000000"><span style="color: #007700">name="name"
كلمة name و هي إسم الحقل ، و التي سيصل الحقل بملف الـ php
رمز PHP:
type="text"
نوع الحقل ، و قد يكون أيضا textarea أو غيره
رمز PHP:
default="كلمة"
و هو ما يظهر إفتراضيا في الحقل
رمز PHP:
label="حقل للكتابة"
و هو إسم الحقل الذي يظهر إلى جانبه في لوحة التحكم
رمز PHP:
description="أدخل هنا أي كلمة و سيتم عرضها في الواجهة">
وهو الوصف الذي يظهر عندما نمر بالفأرة على إسم الحقل .
رمز PHP:
نغلق الحقل
رمز PHP:
نغلق الإعدادات
و أخيرا نغلق الملف بأكمله بالعبارة :
رمز PHP:
هنا يجدر الذكر أن ملف XML قد يحتوي على إعدادات أخرى مثل
و تكون نهاية الملف كالتالي :
رمز PHP:
mod_jut_example
05-04-2009
Rifizm - JUT
GPL
khalid@joomlaut.org
http://joomlaut.org
1.0
موديل example
mod_jut_example.php
و الآن نبرمج ملف الـ php وهذه محتوياته :
ننشئ ملفا و نسميه
رمز PHP:
mod_jut_example.php
و نضع فيه التالي :
كأي ملف php فإننا نبدأ بـ
رمز PHP:
<span style="color: #000000"><span style="color: #0000BB">
وهكذا نكون قد إنتهينا من ملف الـ php و يكون الناتج النهائي كالتالي :
رمز PHP:
3 - يجب أن يكون إسم الملفين معا نفسه الذي وضع في ملف الـ XML
و هذا الموديل الذي أنشأناه تجدونه بالمرفقات .
الموضوع الأصلي
http://joomlaut.org/forum/show.php?main=1&id=34
و أبواب الإنضمام للفريق مفتوحة من هنا [مبرمجين و غير مبرمجين]
http://joomlaut.org/forum/show.php?main=1&id=5
الملفات المرفقة
