Joomla! Documentation™

Joomla! 

3.x

درس

تطوير مكون MVC

المقالات في هذه السلسلة

1. مقدمة
2. تطوير مكون بسيط

اضافة عرض الى جزء الموقع

اضافة نمط قائمة الى جزء الموقع

اضافة موديل الى جزء الموقع

اضافة طلب متحول في نوع القائمة

استخدام قاعدة البيانات

واجهة خلفية بسيطة

اضافة ادارة لغة

اضافة أفعال في الواجهة الخلفية

اضافة ديكور الى الواجهة الخلفية

اضافة التحقيقات

اضافة فئات

اضافة اعداد

1. اضافة لائحة تحكم بالوصول ACL

اضافة ملف سكريبت لتثبيت/فك تثبيت/تحديث

Adding a Frontend Form

1. Adding an Image
2. Adding a Map
3. Adding AJAX
4. Adding an Alias

استخدام ميزات تصفية اللغة

1. Adding a Modal
2. Adding Associations
3. Adding Checkout
4. Adding Ordering
5. Adding Levels
6. Adding Versioning
7. Adding Tags
8. Adding Access
9. Adding a Batch Process
10. Adding Cache
11. Adding a Feed

اضافة مخدم تحديث

1. Adding Custom Fields
2. Upgrading to Joomla4

هذه سلسلة من عدة مقالات من الدروس حول كيفية تطوير موديل-عرض-موجه مكون لنسخة Joomla! .

تبدأ مع مقدمة, وتستعرض المقالات في هذه السلسلة باستخدام زر التنقل في الأسفل أو الصندوق الأيمن ("المقالات في هذه السلسلة").

ملاحظات

هذا الدرس هو جزء من درس تطوير مكون MVC لـ Joomla! 3.x . نشجعك على قراءة الجزء السابق من الدرس قبل قراءة هذا الدرس.

إذا كنت قد استخدمت Joomla! سابقا قبل قراءة هذا الدرس، ربما تكون لاحظت أن الملحقات مثبتة باستخدام ملف مضغوط يحتوي على كافة الأشياء التي تحتاج لتثبيتها أو فك تثبيتها.

يمكنك اتباع الخطوات في الأسفل لإنشاء مكون Hello World!,أو يمكنك مباشرة تحميل الرابط archive

وهنا بعض الشرائح المعتمدة على هذه الوثيقة تشرح كيفية انشاء مكون Joomla! بسيط أو متقدم.
Joomla! Basic Component Help
Joomla! Advance Component Help

There are also a number of videos which accompany steps in the tutorial, beginning with
Step 1, Developing a Basic Component and you can access the slides which are used in the series of video presentations at Slides.

Important! Around version 3.8 the Joomla developers started changing the naming of Joomla classes and where they were stored in the directory structure. Many of the tutorial steps and videos refer to the old naming convention. To find the equivalent new class and where it's stored, look in your libraries/classmap.php file.

كيفية اضافة مكون الى Joomla!

في هذا المقال سنغطي كيفية انشاء وتثبيت مكون Joomla! بسيط. ولهذا المثال سوف نعمل على مكون Hello World!.

لتبدأ، يجب عليك أولا أن تستخدم مدير الملف المفضل لديك لانشاء فهرس مكون Hello World!. وهذا الفهرس يمكن أن يكون بأي مكان على نظام الملف الخاص بك، طالما هو خارج فهرس تثبيت Joomla! . ولهذا المثال سنسمي الفهرس com_helloworld, ولكن يمكن تسمية الفهرس بأي اسم.

بعدها، داخل هذا الفهرس يجب علينا انشاء بعض الملفات، باستخدام مدير الملف المفضل لديك، انشئ الملفات التالية: ومع انشاء الملفات، أضف الكود المصدري لكل ملف موجود في File Details.

1	helloworld.xml	هذا ملف XML (manifest) والذي يخبر Joomla! عن كيفية تثبيت المكون الخاص بنا.
2	site/helloworld.php	وهذا هو نقطة دخول الموقع الى مكون Hello World!
3	site/index.html	منع مخدم الويب من عرض محتوى الفهرس
4	admin/index.html	منع مخدم الويب من عرض محتوى الفهرس
5	admin/helloworld.php	وهذا هو نقطة دخول المسؤول الى مكون Hello World!
6	admin/sql/index.html	منع مخدم الويب من عرض محتوى الفهرس
7	admin/sql/updates/index.html	منع مخدم الويب من عرض محتوى الفهرس
8	admin/sql/updates/mysql/index.html	منع مخدم الويب من عرض محتوى الفهرس
9	admin/sql/updates/mysql/0.0.1.sql	ملف يسمح لتهيئة اصدار مخطط مكون com_helloworld

تثبيت مكون Hello World!

باستخدام مدير الملف المفضل لديك، قم بانشا ملف .zip في الفهرس. في هذا المثال سنسمي الملف com_helloworld.zip, ومرة ثانية يمكن أن يسمى الملف بأي اسم.

والآن نحتاج الى تثبيت مكون Hello World!. وهناك طريقتين للقيام بهذا، وكلاهما موجود في تثبيت ملحق. وهنا سنغطي الطريقة باستخدام مدير الملحقات في Joomla!.

• باستخدام متصفح ويب المفضل لديك، انتقل الى شاشة المدير في موقعك الخاص بـ Joomla!.

العنوان سيكون <yoursite>/joomla/administrator/index.php. ولهذا المثال سننتقل الى localhost/joomla/administrator/index.php.

• اضغط الملحقات  ←  مدير  ←  تثبيت  ←  رفع ملف الحزمة  ←  اختر ملف.
• انتقل واختر ملف.
• اضغط رفع و تثبيت

ملاحظة - يجب أن ترى رسالة تعلمك فيما إذا تم التثبيت بنجاح أو فشل.

يمكنك اختبار الوظيفة الأساسية للمكون وذلك عن طريق الدخول الى صفحة Hello World! في موقع Joomla! الخاص بك في جزئي المدير والموقع.

• باستخدام متصفحك المفضل، انتقل الى صفحة مكون Hello World! الموجودة في موقعك في قسم الموقع. العنوان سيكون <yoursite>/joomla/index.php?option=com_helloworld. وفي هذا المثال سننتقل الى localhost/joomla/index.php?option=com_helloworld.
• باستخدام متصفحك المفضل، انتقل الى صفحة مكون Hello World! الموجودة في موقعك في قسم المدير. العنوان سيكون<yoursite>/joomla/administrator/index.php?option=com_helloworld. وفي هذا المثال سننتقل الى localhost/joomla/administrator/index.php?option=com_helloworld.

يمكنك أيضا ملاحظة أن مكون Hello World! مرئي في موقع المدير في مكان تثبيت جوملا تحت قائمة "المكونات".

تفاصيل الملف

admin/sql/updates/mysql/0.0.1.sql ملف فارغ يسمح لتهيئة اصدار مخطط مكون com_helloworld

helloworld.xml

<?xml version="1.0" encoding="utf-8"?>
<extension type="component" version="3.0" method="upgrade">

	<name>Hello World!</name>
	<!-- The following elements are optional and free of formatting constraints -->
	<creationDate>January 2018</creationDate>
	<author>John Doe</author>
	<authorEmail>john.doe@example.org</authorEmail>
	<authorUrl>http://www.example.org</authorUrl>
	<copyright>Copyright Info</copyright>
	<license>License Info</license>
	<!--  The version string is recorded in the components table -->
	<version>0.0.1</version>
	<!-- The description is optional and defaults to the name -->
	<description>Description of the Hello World component ...</description>

	<update> <!-- Runs on update; New since J2.5 -->
		<schemas>
			<schemapath type="mysql">sql/updates/mysql</schemapath>
		</schemas>
	</update>

	<!-- Site Main File Copy Section -->
	<!-- Note the folder attribute: This attribute describes the folder
		to copy FROM in the package to install therefore files copied
		in this section are copied from /site/ in the package -->
	<files folder="site">
		<filename>index.html</filename>
		<filename>helloworld.php</filename>
	</files>

	<administration>
		<!-- Administration Menu Section -->
		<menu link='index.php?option=com_helloworld'>Hello World!</menu>
		<!-- Administration Main File Copy Section -->
		<!-- Note the folder attribute: This attribute describes the folder
			to copy FROM in the package to install therefore files copied
			in this section are copied from /admin/ in the package -->
		<files folder="admin">
			<!-- Admin Main File Copy Section -->
			<filename>index.html</filename>
			<filename>helloworld.php</filename>
			<!-- SQL files section -->
			<folder>sql</folder>
		</files>
	</administration>

</extension>

site/helloworld.php

Hello World

admin/helloworld.php

Hello World administration

index.html

عمومي لكل الفهارس

<html><body bgcolor="#FFFFFF"></body></html>

محتويات المكون

في هذه النقطة من الدرس، المكون الخاص بك يجب أن يملك الملفات التالية:

1	helloworld.xml	هذا ملف XML (manifest) والذي يخبر Joomla! عن كيفية تثبيت المكون الخاص بنا.
2	site/helloworld.php	وهذا هو نقطة دخول الموقع الى مكون Hello World!
3	site/index.html	منع مخدم الويب من عرض محتوى الفهرس
4	admin/index.html	منع مخدم الويب من عرض محتوى الفهرس
5	admin/helloworld.php	وهذا هو نقطة دخول المسؤول الى مكون Hello World!
6	admin/sql/index.html	منع مخدم الويب من عرض محتوى الفهرس
7	admin/sql/updates/index.html	منع مخدم الويب من عرض محتوى الفهرس
8	admin/sql/updates/mysql/index.html	منع مخدم الويب من عرض محتوى الفهرس
9	admin/sql/updates/mysql/0.0.1.sql	ملف يسمح لتهيئة اصدار مخطط مكون com_helloworld

General Information

السابق: مقدمة

التالي: اضافة عرض الى جزء الموقع