[شرح] : [joomla]برمجة مكون بسيط

SH3A3-Q

ابو الميرزا
طاقم الإدارة
إنضم
14 نوفمبر 2007
المشاركات
48,690
النقاط
113
العمر
49
الإقامة
QATIF-القطيف
السلام عليكم
اليوم بإذن الله سيكون درسنا حول إنشاء مكونات [Components] مجلة جملة ،
سنبدأ اليوم بمكون بسيط جدا و دون قاعدة بيانات حتى ، لكن تأكدوا بإذن الله سنصل معا إلى برمجة مكون إحترافي و بمقاييس الكود البرمجي للمجلة ،
علما إنه دون إحترام هذه المقاييس يمكن لأي مبرمج متوسط دمج أي سكريبت مع المجلة ، كما في حال phpnuke مثلا ، لكن مجلة جملة تعمل تحت مقاييس صارمة ،
و حتى تكون الإضافات التي نبرمجها الآن رسمية في المستقبل ، الأفضل لنا إتباع هذه المقاييس و المعايير ...


بإسم الله نبدأ

سنحاول برمجة مكون بإسم
رمز PHP:
com_example


أي مكون يتكون بالضرورة من ثلاث ملفات أو أكثر
سنقتصر على الأبسط و هو 3 ملفات
بما أن المكون الذي سنحاول برمجته يسمى com_example يجب أن تكون ملفاته بنفس الإسم [مع حذف العبارة com_ خلاف الموديلات]و بهذه الوتيرة
رمز PHP:
example.php


هو الملف الرئيسي الذي يظهر في واجهة الموقع
رمز PHP:
example.xml


هو الملف المسؤول عن نقل الملفات إلى مجلة المكونات في موقعك
(له خصائص كثيرة سنشرحها في دروس قادمة)
رمز PHP:
admin.example.php


هو الملف الذي يُظهر إعدادات المكون في لوحة التحكم

الآن نبدأ مع ملف XML المسؤول عن النقل
ننشئ الملف
رمز PHP:
example.xml


نضع فيه التالي
رمز PHP:


كالعادة نضع الإصدار و الترميز
رمز PHP:



نبدأ بإخبار المجلة أننا نريد تثبيت إضافة و ذلك بـفتح
رمز PHP:
<span style="color: #000000"><span style="color: #007700"> Example


إسم الإضافة
رمز PHP:
1.0


إصدار الإضافة
رمز PHP:
08.04.2009


تاريخ الإصدار
رمز PHP:
Rifizm - JoomlaUT


معلومات المبرمج
رمز PHP:
rifizm@joomlaut.org


البريد الإلكتروني للمبرمج
رمز PHP:
http://www.joomlaut.org


رابط موقع المبرمج
رمز PHP:
JoomlaUT 2009


حقوق النشر
رمز PHP:
GNU General Public License


الترخيص
رمز PHP:
Example Component By JoomlaUT


وصف الإضافة

الآن نبدأ مع وظيفة ملف الـ xml الحقيقية [في حالتنا هذه] و التي هي النقل .

نعرف المجلة عن نوع العملية
رمز PHP:



نضع الملف الرئيسي للإضافة
رمز PHP:
example.php


كما قلنا في درسنا السابق فيمكننا إضافة ملفات أخرى في حال كانت الإضافة تتكون من عدة ملفات .
نغلق التعريف
رمز PHP:



الآن نفتح تعريفا من نوع مختلف لم نتطرق إليه في الدرس الماضي و هو نقل الملفات إلى مجلد المدير
رمز PHP:
administrator/components/com_example


و ذلك بفتح التعريف :
رمز PHP:



ثم نكتب إسم المكون الذي سيظهر في القائمة العلوية من لوحة التحكم في : التطبيقات
رمز PHP:
Example


و يكون بين
رمز PHP:



و
رمز PHP:



ثم نكمل التعريف بالملفات التي سيتم نقلها لمجلد المكونات في الـ administrator

رمز PHP:



نفتح تعريف نقل الملفات
رمز PHP:
admin.example.php


الملف المراد نقله
رمز PHP:



نغلق تعريف نقل الملفات
كما في السابق

ثم نغلق تعريف نقل الملفات لمجلد الإدارة
رمز PHP:



ثم نغلق ملف الـ xml

رمز PHP:



و يكون الناتج كالتالي :

رمز PHP:


Example
1.0
08.04.2009
Rifizm - JoomlaUT
rifizm@joomlaut.org
http://www.joomlaut.org
JoomlaUT 2009
GNU General Public License
Example Component By JoomlaUT

example.php


example

admin.example.php





الآن أمامنا ملفان و هما :
رمز PHP:
example.php


و
رمز PHP:
admin.example.php


ننشي الملف
رمز PHP:
example.php


نفتح الملف بـ
رمز PHP:



و يكون الناتج
رمز PHP:


دون عبارات تعريفية كما في الملف السابق مثل
رمز PHP:
defined( '_VALID_MOS' )


الآن نضغط الملفات الثلاثة بالـ ZIP أو غيره إذا كان سيرفرك يستطيع فك الضغط عنه

و نثبت الإضافة من لوحة تحكم جملة

* الموضوع الأصلي

* لا زلنا بحاجة لأعضاء جدد بالفريق [مبرمجين و غير مبرمجين]

* الموضوع مفتوح المصدر

* المكون بالمرفقات




هذا و الله المعين

أخوكم

الملفات المرفقة
zip.gif
com_example.zip (943 بايت)
 
عودة
أعلى أسفل