J3.x

J3.x:تطوير مكون MVC/تطوير مكون بسيط

From Joomla! Documentation

< J3.x:Developing an MVC Component
This page is a translated version of the page J3.x:Developing an MVC Component/Developing a Basic Component and the translation is 93% complete.

Outdated translations are marked like this.
Other languages:
العربية • ‎Deutsch • ‎English • ‎español • ‎français • ‎Nederlands • ‎português do Brasil • ‎русский • ‎中文(中国大陆)‎
Joomla! 
3.x
درس
تطوير مكون MVC


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

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



ملاحظات

هذا الدرس هو جزء من درس تطوير مكون 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.

كيفية اضافة مكون الى 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
Info non-talk.png
General Information

الرجاء انشاء طلب سحب أو مشكلة على https://github.com/joomla/Joomla-3.2-Hello-World-Component لأي اختلافات في الكود أو أي تعديل في شفرة المصدر على هذه الصفحة.