السلام عليكم
اليوم بإذن الله سنضيف شريط أزرار التحكم إلى المكون الذي بدأنا ببرمجته في الدرس السابق .
مثال عن شريط الأزرار :
لذلك إن كنت تحضر أول درس لي هنا فعليك لزاما أن تراجع الروابط :
[درس]برمجة موديل بسيط
[درس]برمجة مكون بسيط [الدرس الأول]
* أو إبحث عن نفس الدروس موجودة في هذا القسم
نبدأ بإسم الله تعالى .
نرجع إلى المكون الذي برمجناه سابقا ، أي قبل تثبيته
ننشئ ملفين ، الأول
كود PHP:
toolbar.example.html.php
و هو الملف المسؤول عن إستدعاء عناصر الشريط و كذلك التنسيق .
و
كود PHP:
toolbar.example.php
هو الملف الحامل لكود ربط الشريط بالمكون
نفتح الملف
كود PHP:
toolbar.example.html.php
و نضع فيه
كود PHP:
<?php
defined( '_JEXEC' ) or die( 'الوصول المباشر لهذه الصفحة غير مسموح' );
كالعادة كود بداية ملف php ثم سطر منع الدخول المباشر بالإضافة إلى إعلان الإنتماء إلى المجلة .
ثم ننشئ الكلاس
كود PHP:
class TOOLBAR_example {
بإسم
داخله نكتب الدالة الأولى و هي مسؤولة عن الأزرار التي ستظهر عند الضغط على زر [جديد] ، أي أننا لن نراها الآن و إنما سنعمل عليها مستقبلا
كود PHP:
function _NEW() {
و إسمها
و هذا الإسم معد مسبقا و لا نستطيع تغييره
ثم محتوى الدالة سيكون :
كود PHP:
JToolBarHelper::save();
JToolBarHelper::apply();
JToolBarHelper::cancel();
هنا إستدعينا ثلاثة أزرار و هي [حفظ ، تنفيذ ، إلغاء]
لاحظوا معي أننا إستخدمنا الحرف في بداية كل سطر ثم و هي كلاسات جاهزة و مكانها
كود PHP:
/plugins/system/legacy/toolbar.php
و سنوعود إليها في دروس متقدمة إن شاء الله .
نغلق الدالة :
الآن ننشئ دالة جديدة و ستكون مسؤولة عن الأزرار التي تكون ظاهرة إفتراضيا بعد الدخول إلى المكون من لوحة التحكم
و الدالة إسمها أي كالتالي
كود PHP:
function _DEFAULT() {
هنا رأيت أن أعرض عليكم جميع الأزرار المتوفرة في المجلة ، الكود و الصورة :
كود PHP:
JToolBarHelper::title( JText::_( 'إدارة المكون Example' ), 'generic.png' );
عنوان المكون و الصورة
كود PHP:
JToolBarHelper::save();
كود PHP:
JToolBarHelper::back();
كود PHP:
JToolBarHelper::addNew();
كود PHP:
JToolBarHelper::editList();
كود PHP:
JToolBarHelper::trash();
كود PHP:
JToolBarHelper::deleteList();
كود PHP:
JToolBarHelper::publish();
كود PHP:
JToolBarHelper::publishList();
كود PHP:
JToolBarHelper::makeDefault();
كود PHP:
JToolBarHelper::assign();
كود PHP:
JToolBarHelper::unpublish();
كود PHP:
JToolBarHelper::unpublishList();
كود PHP:
JToolBarHelper::archiveList();
كود PHP:
JToolBarHelper::unarchiveList();
كود PHP:
JToolBarHelper::editHTML();
كود PHP:
JToolBarHelper::editCSS();
كود PHP:
JToolBarHelper::preview();
كود PHP:
JToolBarHelper::media_manager();
كود PHP:
JToolBarHelper::apply();
كود PHP:
JToolBarHelper::cancel();
طبعا يمكنكم إضافة أزرار خاصة و لكن ليس الآن 
نغلق الدالة _NEW
نغلق الكلاس
نغلق ملف الـ PHP
و يكون الناتج :
كود PHP:
<?php
defined( '_JEXEC' ) or die( 'الوصول المبائر لهذه الصفحة غير مسموح' );
class TOOLBAR_example {
function _NEW() {
JToolBarHelper::save();
JToolBarHelper::apply();
JToolBarHelper::cancel();
}
function _DEFAULT() {
JToolBarHelper::title( JText::_( 'إدارة المكون Example' ), 'generic.png' );
JToolBarHelper::save();
JToolBarHelper::back();
JToolBarHelper::addNew();
JToolBarHelper::editList();
JToolBarHelper::trash();
JToolBarHelper::deleteList();
JToolBarHelper::publish();
JToolBarHelper::publishList();
JToolBarHelper::makeDefault();
JToolBarHelper::assign();
JToolBarHelper::unpublish();
JToolBarHelper::unpublishList();
JToolBarHelper::archiveList();
JToolBarHelper::unarchiveList();
JToolBarHelper::editHTML();
JToolBarHelper::editCSS();
JToolBarHelper::preview();
JToolBarHelper::media_manager();
JToolBarHelper::apply();
JToolBarHelper::cancel();
}
}
?>
إنتهينا من الملف
كود PHP:
toolbar.example.html.php
الآن نفتح الملف :
كود PHP:
toolbar.example.php
و نضع فيه :
كود PHP:
<?php
defined( '_JEXEC' ) or die( 'الوصول المبائر لهذه الصفحة غير مسموح' );
و الذي نعرف معناه
ثم الدالة الرابطة للشريط بالمكون
كود PHP:
require_once( JApplicationHelper::getPath( 'toolbar_html' ));
وهي مجهزة من قبل و ما عليك إلا تكرارها كل مرة
الآن نستخدم أداة الشرط switch
كود PHP:
switch ( $task )
{
إستخدمنا هنا المتغير و هو متغير معد مسبقا مع المجلة
نفتح التحقق الأول بالعبارة
و مهمتها التحقق هل أنت قمت بمحاولة إضافة مادة جديدة من لوحة التحكم من الزر
نضيف
كود PHP:
TOOLBAR_example::_NEW();
فإذا أنت ضغطت على الزر [جديد] فهذا يعني أن الأزرار التي ستظهر في الشريط هي الأزرار التي حددناها فوق في الدالة :
من ملف
كود PHP:
toolbar.example.html.php
الآن نغلق التحقق بـ
نكتب
وهي حالة الشريط الإفتراضيه عند الدخول إلى المكون و دون الضغط على أي زر
الحالة الإفتراضية هي :
كود PHP:
TOOLBAR_example::_DEFAULT();
أي الدالة
كود PHP:
function _DEFAULT()
من ملف
كود PHP:
toolbar.example.html.php
نغلق التحقق
أو لا نغلقه ، لا يشكل أي مشكل لأنه يخرج من التحقق مباشرة
نغلق الأداة الشرطية switch
نغلق ملف الـ php
و يكون الناتج النهائي
كود PHP:
<?php
defined( '_JEXEC' ) or die( 'الوصول المبائر لهذه الصفحة غير مسموح' );
require_once( JApplicationHelper::getPath( 'toolbar_html' ));
switch ( $task )
{
case 'add' :
TOOLBAR_example::_NEW();
break;
default:
TOOLBAR_example::_DEFAULT();
break;
}
?>
إنتهينا تقريبا
الآن من ملف الـ XML الذي أنشأناه في الدرس السابق
بعد التعريف
كود PHP:
<administration>
نجد الملفات التي نريد نقلها لمجلة الإدارة
و كنا وضعنا
كود PHP:
<filename>admin.example.php</filename>
نضيف الملفين الذين أنشأناهما بنفس الطريقة
كود PHP:
<filename>toolbar.example.html.php</filename>
<filename>toolbar.example.php</filename>
و يكون ناتج ملف الـ XML [إضافة إلى مكوناته من الدرس السابق]
كود PHP:
<?xml version="1.0" encoding="utf-8"?>
<install version="1.5" type="component">
<name>Example</name>
<version>1.0</version>
<creationDate>08.04.2009</creationDate>
<author>Rifizm - JoomlaUT</author>
<authorEmail>rifizm@joomlaut.org</authorEmail>
<authorUrl>http://www.joomlaut.org</authorUrl>
<copyright>JoomlaUT 2009</copyright>
<license>GNU General Public License</license>
<description>Example Component By JoomlaUT</description>
<files>
<filename component="example">example.php</filename>
</files>
<administration>
<menu>example</menu>
<files>
<filename>admin.example.php</filename>
<filename>toolbar.example.html.php</filename>
<filename>toolbar.example.php</filename>
</files>
</administration>
<params />
</install>
و بهذا نكون إنتهينا من درس اليوم
* الموضوع الأصلي
* لا زلنا بحاجة لأعضاء جدد بالفريق [مبرمجين و غير مبرمجين]
* الموضوع مفتوح المصدر
* المكون بالمرفقات
و السلام عليكم و رحمة الله تعالى و بركاته
رد مع اقتباس
