اولین کامپوننت Hello World در جوملا 2.5: تفاوت بین نسخه‌ها   

از دانشنامه جوملا فارسی - مامبو فارسی
پرش به: ناوبری، جستجو
(←‏ایجاد یک بسته نصبی از کامپوننت)
سطر ۱: سطر ۱:
 
=مقدمه=
 
=مقدمه=
−
از تمام انواع افزونه های [[جوملا]] [[کامپوننت]] ها ضروری ترین نوع افزونه ها هستند. از آن جهت معتقدم که آنها ضروری چون بخش عمده ای از هر صفحهی [http://www.joomlafarsi.com جوملا] به [[کامپوننت]] اختصاص دارد. در حقیقت [[جوملا]] یک هر [[کامپوننت]] را در یک صفحه لود میکند و از طریق [[کامپوننت]]ها بین صفحات مختلف تمیز قائل میشود. در این مقاله آموزشی خواهیم آموخت که چگونه یک [[کامپوننت]]Hello World در [[جوملا]] 2.5 ایجاد کنیم.
+
 
−
=قدم اول ایجاد [[کامپوننت]] در بخش سایت=
+
از تمام انواع افزونه‌های [http://www.joomlafarsi.com جوملا] [[کامپوننت]]‌ها ضروری‌ترین نوع افزونه‌ها هستند. از آن جهت معتقدم که آنها ضروری‌اند چون بخش عمده‌ای از هر صفحه‌ی [http://www.joomlafarsi.com جوملا] به [[کامپوننت]] اختصاص دارد. در حقیقت [[جوملا]] هر [[کامپوننت]] را در یک صفحه لود می‌کند و از طریق [[کامپوننت]]‌ها بین صفحات مختلف تمیز قائل می‌شود. در این مقاله آموزشی خواهیم آموخت که چگونه یک [[کامپوننت]] Hello World در [[جوملا]] 2.5 ایجاد کنیم.
−
* یک فولدر به نام '''com_helloworld''' در Joomlaroot\components بسازید. <br/>
+
 
 +
=قدم اول ایجاد کامپوننت در بخش سایت=
 +
 
 +
* یک فولدر به نام '''com_helloworld''' در Joomlaroot\components بسازید.
 +
 
 
''نکته : Joomlaroot فولدری است که سایت جوملا را در آن نصب کردید (معمولا درhtdocs یا www ).''   
 
''نکته : Joomlaroot فولدری است که سایت جوملا را در آن نصب کردید (معمولا درhtdocs یا www ).''   
−
<br/>
+
 
−
* سپس یک فایل به نام '''helloworld.php''' در فولدر Joomlaroot\components\com_helloworld ایجاد کنید. سپس آن فایل بنویسید:  
+
* سپس یک فایل به نام '''helloworld.php''' در فولدر Joomlaroot\components\com_helloworld ایجاد کنید. سپس در آن فایل بنویسید:  
 +
 
 +
 
 
<div dir=ltr>Hello World</div>
 
<div dir=ltr>Hello World</div>
 +
 +
 
''نکته : توجه داشته باشید که نام فایل helloworld.php هم نام با نام کامپوننت است.''
 
''نکته : توجه داشته باشید که نام فایل helloworld.php هم نام با نام کامپوننت است.''
−
<br/>
+
 
−
شما میتوانید نتایج کاری که تا کنون انجام دادید با وارد کردن آدرس <nowiki>http://localhost/sitename/index.php?option=com_helloworld</nowiki > در مرورگر مشاهده کنید. شما باید نتیجه ای همانند شکل زیر مشاهده کنید.
+
شما می‌توانید نتایج کاری که تاکنون انجام داده‌اید را با وارد کردن آدرس <nowiki>http://localhost/sitename/index.php?option=com_helloworld</nowiki > در مرورگر مشاهده نمایید. شما باید نتیجه‌ای همانند شکل زیر مشاهده کنید.
 +
 
 +
 
 
[[پرونده: Turorial component test.jpg|center|frame ]]
 
[[پرونده: Turorial component test.jpg|center|frame ]]
−
=قدم دوم ایجاد [[کامپوننت]] در بخش مدیریت=
+
 
 +
 
 +
=قدم دوم ایجاد کامپوننت در بخش مدیریت=
 +
 
 
* یک فولدر به نام '''com_helloworld''' در Joomlaroot\administrator\components بسازید.
 
* یک فولدر به نام '''com_helloworld''' در Joomlaroot\administrator\components بسازید.
−
<br/>
 
 
* سپس یک فایل به نام '''helloworld.php''' در فولدر Joomlaroot\administrator\components\com_helloworld ایجاد کنید. سپس آن فایل بنویسید:  
 
* سپس یک فایل به نام '''helloworld.php''' در فولدر Joomlaroot\administrator\components\com_helloworld ایجاد کنید. سپس آن فایل بنویسید:  
 
<div dir=ltr>Hello World Administrator</div>
 
<div dir=ltr>Hello World Administrator</div>
−
* شما میتوانید نتایج کاری که تا کنون انجام دادید با وارد کردن آدرس <nowiki>http://localhost/sitename/administrator/index.php?option=com_helloworld</nowiki > در مرورگر مشاهده کنید. شما باید نتیجه ای همانند شکل زیر مشاهده کنید.
+
* شما می‌توانید نتایج کاری که تاکنون انجام داده‌اید را با وارد کردن آدرس <nowiki>http://localhost/sitename/administrator/index.php?option=com_helloworld</nowiki > در مرورگر مشاهده نمایید. شما باید نتیجه‌ای همانند شکل زیر مشاهده کنید.
 +
 
 +
 
 
[[پرونده: Basictut component admin.jpg|center|frame ]]
 
[[پرونده: Basictut component admin.jpg|center|frame ]]
−
=ایجاد یک بسته نصبی از [[کامپوننت]]=
+
 
−
برای ایجاد بسته نصبی از افزونه های جوملا از فرمت '''ZIP''' استفاده میکنیم. جهت ایجاد بسته نصبی از کامپوننت مان باید فایلها زیر را در یک فولدر خارج از جوملا آماده کنیم.  
+
 
−
<br/>
+
=ایجاد یک بسته نصبی از کامپوننت=
−
*یک پوشه هم نام با کامپوننت مان ایجاد میکنیم به نام ''' com_helloworld''' و فایل های زیر را در آن قرار میدهیم.
+
 
−
در داخل پوشه ای که ایجاد کردیم یک 2 فولدر دیگر با نام های site و admin ایجاد میکنیم.
+
برای ایجاد بسته نصبی از افزونه‌های جوملا از فرمت '''ZIP''' استفاده می‌کنیم. جهت ایجاد بسته نصبی از کامپوننت مان باید فایل‌ها زیر را در یک فولدر خارج از جوملا آماده کنیم.  
 +
 
 +
*یک پوشه هم نام با کامپوننت مان ایجاد می‌کنیم به نام ''' com_helloworld''' و فایل‌های زیر را در آن قرار می‌دهیم.
 +
در داخل پوشه‌ای که ایجاد کردیم یک 2 فولدر دیگر با نام‌های site و admin ایجاد می‌کنیم.
 +
 
 +
 
 
<div dir=ltr>
 
<div dir=ltr>
 
helloworld.xml (فایل نصب کننده افزونه)
 
helloworld.xml (فایل نصب کننده افزونه)
سطر ۳۵: سطر ۵۴:
  
 
</div>
 
</div>
 +
 +
 
فایل ''' helloworld.xml''' باید شامل کدهای زیر باشد
 
فایل ''' helloworld.xml''' باید شامل کدهای زیر باشد
 +
 +
 
<source lang="xml">
 
<source lang="xml">
 
<?xml version="1.0" encoding="utf-8"?>
 
<?xml version="1.0" encoding="utf-8"?>
سطر ۵۴: سطر ۷۷:
 
</files>
 
</files>
 
<administration>
 
<administration>
−
<!-- جهت ایجاد یک منو در قسمت کامپوننت ها -->
+
<!-- جهت ایجاد یک منو در قسمت کامپوننت‌ها -->
 
<menu img="components/com_hello/images/icon.png" >COM_HelloWorld</menu>
 
<menu img="components/com_hello/images/icon.png" >COM_HelloWorld</menu>
−
<!-- توجه کنید شما ما پوشه تصاویر را ایجاد نکردیم اما شما میتوانید این کارا انجام دهید -->
+
<!-- توجه کنید شما ما پوشه تصاویر را ایجاد نکردیم اما شما می‌توانید این کارا انجام دهید -->
  
 
<files folder="admin">
 
<files folder="admin">
سطر ۶۷: سطر ۹۰:
 
</install>
 
</install>
 
</source>
 
</source>
 +
 +
 
* فایل'''  site/hello.php''' باید شامل کدهای زیر باشد:
 
* فایل'''  site/hello.php''' باید شامل کدهای زیر باشد:
 +
 +
 
<div dir=ltr>
 
<div dir=ltr>
 
Hello World
 
Hello World
 
</div>
 
</div>
 +
 
* فایل ''' admin/hello.php''' باید شامل کدهای زیر باشد:
 
* فایل ''' admin/hello.php''' باید شامل کدهای زیر باشد:
 +
 
<div dir=ltr>
 
<div dir=ltr>
 
Hello World Administrator
 
Hello World Administrator
 
</div>
 
</div>
 +
 
* در هر فولدر معمولا یک فایل''' index.html''' وجود دارد که باید شامل کدهای زیر باشد :
 
* در هر فولدر معمولا یک فایل''' index.html''' وجود دارد که باید شامل کدهای زیر باشد :
 +
 +
 
<source lang="xml">
 
<source lang="xml">
 
<html><body bgcolor="#FFFFFF"></body></html>
 
<html><body bgcolor="#FFFFFF"></body></html>
 
</source>
 
</source>
−
قرار دادن فایلهای مربوط به بخش admin و بخش سایت در فولدر com_helloworld بدین صورت که تمامی فایلهای مربوط به هر بخش را در فولدر com_helloworld قرار میدهیم.
+
 
−
<br/>
+
 
−
ایجاد فایل''' helloworld.zip ''' با فایلها و فولدرهایی که در قسمت های قبل ایجاد کردیم.
+
قرار دادن فایل‌های مربوط به بخش admin و بخش سایت در فولدر com_helloworld بدین صورت که تمامی فایل‌های مربوط به هر بخش را در فولدر com_helloworld قرار می‌دهیم.
−
<br/>
+
 
−
نصب فایل''' zip شده توسط قسمت مدیریت افزونه های [[جوملا]] 2.5
+
ایجاد فایل''' helloworld.zip ''' با فایل‌ها و فولدرهایی که در قسمت‌های قبل ایجاد کردیم.
−
<br/>
+
 
−
'''نکته''' : توجه داشته باشید اگر در مراحل قبل [[کامپوننت]] را در میان سورس [[جوملا]] ساخته و اجرا کرده اید قبل نصب فایل zip [[کامپوننت]] باید فایلهای مربوط به افزونه این آموزش را از [[جوملا]] پاک کنید و بعد اقدام به نصب فایل zip پکیج شده بکنید.
+
نصب فایل''' zip شده توسط قسمت مدیریت افزونه‌های [[جوملا]] 2.5
−
<br/>
+
 
−
تاکنون باید یک زیر منو به نام''' comhelloworld''' در منوی [[کامپوننت]] ها ایجاد شده باشد.
+
'''نکته''' : توجه داشته باشید اگر در مراحل قبل [[کامپوننت]] را در میان سورس [[جوملا]] ساخته و اجرا کرده‌اید قبل نصب فایل zip [[کامپوننت]] باید فایل‌های مربوط به افزونه این آموزش را از [[جوملا]] پاک کنید و بعد اقدام به نصب فایل zip پکیج شده بکنید.
−
<br/>
+
 
−
شما میتوانید کارکرد این افزونه را با وارد کردن <nowiki>http://localhost/sitename/index.php?option=com_hello</nowiki> در مرورگر چک کنید. اگر عبارت بالا را در آدرس بار مرورگر وارد کنیم باید نتیجه ای همانند شکل زیر دریافت کنیم.
+
تاکنون باید یک زیر منو به نام''' comhelloworld''' در منوی [[کامپوننت]]‌ها ایجاد شده باشد.
 +
 
 +
شما می‌توانید کارکرد این افزونه را با وارد کردن <nowiki>http://localhost/sitename/index.php?option=com_hello</nowiki> در مرورگر چک کنید. اگر عبارت بالا را در آدرس بار مرورگر وارد کنیم باید نتیجه‌ای همانند شکل زیر دریافت کنیم.
 +
 
 +
 
 
[[پرونده: Basic component zip test.jpg|center|frame ]]
 
[[پرونده: Basic component zip test.jpg|center|frame ]]
−
همچنین شما میتوانید خروجی کارکرد این [[کامپوننت]] را در قسمت مدیریت با وارد کردن <nowiki>http://localhost/sitename/administrator/index.php?option=com_hello</nowiki> در مرورگر یا با کلیک برروی منوی ''' comehelloworld''' در منوی [[کامپوننت]] ها چک کنید. در صورت انجام این کار شما باید نتیجه ای همانند تصویر زیر مطالعه کنید.
+
 
 +
 
 +
همچنین شما می‌توانید خروجی کارکرد این [[کامپوننت]] را در قسمت مدیریت با وارد کردن <nowiki>http://localhost/sitename/administrator/index.php?option=com_hello</nowiki> در مرورگر یا با کلیک برروی منوی ''' comehelloworld''' در منوی [[کامپوننت]]‌ها چک کنید. در صورت انجام این کار شما باید نتیجه‌ای همانند تصویر زیر مطالعه کنید.
 +
 
 +
 
 
[[پرونده: Lastresult zip admin.jpg|center|frame ]]
 
[[پرونده: Lastresult zip admin.jpg|center|frame ]]
−
در آموزش های بعدی نحوه ایجاد [[کامپوننت]] های کاربردی تر و حرفه ای تر که با اطلاعات [[پایگاه داده]] ها کار میکنند را با ارائه خواهیم داد.
+
 
 +
 
 +
در آموزش‌های بعدی نحوه ایجاد [[کامپوننت]]‌های کاربردی تر و حرفه‌ای تر که با اطلاعات [[پایگاه داده]]‌ها کار می‌کنند را با ارائه خواهیم داد.
 +
 
 
----
 
----
  
−
جمع آوری شده توسط :[http://forum.joomlafarsi.com/members/26237-shmata شهاب مطاع پور] -  [http://www.joomlafarsi.com/about/the-team/ گروه آموزش] - تیم [http://www.joomlafarsi.com جوملا فارسی]
+
جمع آوری شده توسط :[http://forum.joomlafarsi.com/members/26237-shmata شهاب مطاع پور]
 +
 
 +
{{آموزش}}
  
 
{{معرفی پشتیبانی}}
 
{{معرفی پشتیبانی}}

نسخهٔ ‏۳۰ دسامبر ۲۰۱۲، ساعت ۰۹:۳۱

مقدمه

از تمام انواع افزونه‌های جوملا کامپوننت‌ها ضروری‌ترین نوع افزونه‌ها هستند. از آن جهت معتقدم که آنها ضروری‌اند چون بخش عمده‌ای از هر صفحه‌ی جوملا به کامپوننت اختصاص دارد. در حقیقت جوملا هر کامپوننت را در یک صفحه لود می‌کند و از طریق کامپوننت‌ها بین صفحات مختلف تمیز قائل می‌شود. در این مقاله آموزشی خواهیم آموخت که چگونه یک کامپوننت Hello World در جوملا 2.5 ایجاد کنیم.

قدم اول ایجاد کامپوننت در بخش سایت

  • یک فولدر به نام com_helloworld در Joomlaroot\components بسازید.

نکته : Joomlaroot فولدری است که سایت جوملا را در آن نصب کردید (معمولا درhtdocs یا www ).

  • سپس یک فایل به نام helloworld.php در فولدر Joomlaroot\components\com_helloworld ایجاد کنید. سپس در آن فایل بنویسید:


Hello World


نکته : توجه داشته باشید که نام فایل helloworld.php هم نام با نام کامپوننت است.

شما می‌توانید نتایج کاری که تاکنون انجام داده‌اید را با وارد کردن آدرس http://localhost/sitename/index.php?option=com_helloworld در مرورگر مشاهده نمایید. شما باید نتیجه‌ای همانند شکل زیر مشاهده کنید.


Turorial component test.jpg


قدم دوم ایجاد کامپوننت در بخش مدیریت

  • یک فولدر به نام com_helloworld در Joomlaroot\administrator\components بسازید.
  • سپس یک فایل به نام helloworld.php در فولدر Joomlaroot\administrator\components\com_helloworld ایجاد کنید. سپس آن فایل بنویسید:
Hello World Administrator
  • شما می‌توانید نتایج کاری که تاکنون انجام داده‌اید را با وارد کردن آدرس http://localhost/sitename/administrator/index.php?option=com_helloworld در مرورگر مشاهده نمایید. شما باید نتیجه‌ای همانند شکل زیر مشاهده کنید.


Basictut component admin.jpg


ایجاد یک بسته نصبی از کامپوننت

برای ایجاد بسته نصبی از افزونه‌های جوملا از فرمت ZIP استفاده می‌کنیم. جهت ایجاد بسته نصبی از کامپوننت مان باید فایل‌ها زیر را در یک فولدر خارج از جوملا آماده کنیم.

  • یک پوشه هم نام با کامپوننت مان ایجاد می‌کنیم به نام com_helloworld و فایل‌های زیر را در آن قرار می‌دهیم.

در داخل پوشه‌ای که ایجاد کردیم یک 2 فولدر دیگر با نام‌های site و admin ایجاد می‌کنیم.


helloworld.xml (فایل نصب کننده افزونه)

site\hello.php

site\index.html

admin\hello.php

admin\index.html


فایل helloworld.xml باید شامل کدهای زیر باشد


<source lang="xml"> <?xml version="1.0" encoding="utf-8"?> <install type="component" version="2.5"> <name>hello</name> <creationDate>2012-12-09</creationDate> <author>Shahab Matapour</author> <authorEmail>[email protected]</authorEmail> <authorUrl>http://www.joomlafarsi.com</authorUrl> <copyright>Copyright Info</copyright> <license>License Info</license> <version>1.01</version> <description>Hello World Test Component ...</description>

<files folder="site"> <filename>index.html</filename> <filename>hello.php</filename> </files> <administration> <menu img="components/com_hello/images/icon.png" >COM_HelloWorld</menu>

<files folder="admin"> <filename>index.html</filename> <filename>hello.php</filename>

</files> </administration> </install> </source>


  • فایل site/hello.php باید شامل کدهای زیر باشد:


Hello World

  • فایل admin/hello.php باید شامل کدهای زیر باشد:

Hello World Administrator

  • در هر فولدر معمولا یک فایل index.html وجود دارد که باید شامل کدهای زیر باشد :


<source lang="xml"> <html><body bgcolor="#FFFFFF"></body></html> </source>


قرار دادن فایل‌های مربوط به بخش admin و بخش سایت در فولدر com_helloworld بدین صورت که تمامی فایل‌های مربوط به هر بخش را در فولدر com_helloworld قرار می‌دهیم.

ایجاد فایل helloworld.zip با فایل‌ها و فولدرهایی که در قسمت‌های قبل ایجاد کردیم.

نصب فایل zip شده توسط قسمت مدیریت افزونه‌های جوملا 2.5

نکته : توجه داشته باشید اگر در مراحل قبل کامپوننت را در میان سورس جوملا ساخته و اجرا کرده‌اید قبل نصب فایل zip کامپوننت باید فایل‌های مربوط به افزونه این آموزش را از جوملا پاک کنید و بعد اقدام به نصب فایل zip پکیج شده بکنید.

تاکنون باید یک زیر منو به نام comhelloworld در منوی کامپوننت‌ها ایجاد شده باشد.

شما می‌توانید کارکرد این افزونه را با وارد کردن http://localhost/sitename/index.php?option=com_hello در مرورگر چک کنید. اگر عبارت بالا را در آدرس بار مرورگر وارد کنیم باید نتیجه‌ای همانند شکل زیر دریافت کنیم.


Basic component zip test.jpg


همچنین شما می‌توانید خروجی کارکرد این کامپوننت را در قسمت مدیریت با وارد کردن http://localhost/sitename/administrator/index.php?option=com_hello در مرورگر یا با کلیک برروی منوی comehelloworld در منوی کامپوننت‌ها چک کنید. در صورت انجام این کار شما باید نتیجه‌ای همانند تصویر زیر مطالعه کنید.


Lastresult zip admin.jpg


در آموزش‌های بعدی نحوه ایجاد کامپوننت‌های کاربردی تر و حرفه‌ای تر که با اطلاعات پایگاه داده‌ها کار می‌کنند را با ارائه خواهیم داد.

جمع آوری شده توسط :شهاب مطاع پور

Indent support.png
هر گونه سوال و یا مشکلی در این رابطه دارید، می‌توانید در انجمن تخصصی تیم جوملا فارسی جستجو کرده و در صورت عدم دریافت نتیجه مورد نظر، سوال جدیدی را مطرح کنید.
8.pngاستفاده از مطالب دانشنامه جوملا فارسی - مامبو فارسی با ذکر منبع ( دانشنامه جوملا فارسی ) و لینک مستقیم به http://docs.joomlafarsi.com بلامانع است.
برگرفته از «https://docs.joomlafarsi.com/index.php?title=اولین_کامپوننت_Hello_World_در_جوملا_2.5&oldid=3611»