اولین کامپوننت Hello World در جوملا 2.5
محتویات
مقدمه
از تمام انواع افزونه های جوملا کامپوننت ها ضروری ترین نوع افزونه ها هستند. از آن جهت معتقدم که آنها ضروری چون بخش عمده ای از هر صفحهی جوملا به کامپوننت اختصاص دارد. در حقیقت جوملا یک هر کامپوننت را در یک صفحه لود میکند و از طریق کامپوننتها بین صفحات مختلف تمیز قائل میشود. در این مقاله آموزشی خواهیم آموخت که چگونه یک کامپوننتHello World در جوملا 2.5 ایجاد کنیم.
قدم اول ایجاد کامپوننت در بخش سایت
- یک فولدر به نام com_helloworld در Joomlaroot\components بسازید.
نکته : Joomlaroot فولدری است که سایت جوملا را در آن نصب کردید (معمولا درhtdocs یا www ).
- سپس یک فایل به نام helloworld.php در فولدر Joomlaroot\components\com_helloworld ایجاد کنید. سپس آن فایل بنویسید:
نکته : توجه داشته باشید که نام فایل helloworld.php هم نام با نام کامپوننت است.
شما میتوانید نتایج کاری که تا کنون انجام دادید با وارد کردن آدرس http://localhost/sitename/index.php?option=com_helloworld در مرورگر مشاهده کنید. شما باید نتیجه ای همانند شکل زیر مشاهده کنید.
قدم دوم ایجاد کامپوننت در بخش مدیریت
- یک فولدر به نام com_helloworld در Joomlaroot\administrator\components بسازید.
- سپس یک فایل به نام helloworld.php در فولدر Joomlaroot\administrator\components\com_helloworld ایجاد کنید. سپس آن فایل بنویسید:
- شما میتوانید نتایج کاری که تا کنون انجام دادید با وارد کردن آدرس http://localhost/sitename/administrator/index.php?option=com_helloworld در مرورگر مشاهده کنید. شما باید نتیجه ای همانند شکل زیر مشاهده کنید.
ایجاد یک بسته نصبی از کامپوننت
برای ایجاد بسته نصبی از افزونه های جوملا از فرمت 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
تاکنون باید یک زیر منو به نام comhelloworld در منوی کامپوننت ها ایجاد شده باشد.
شما میتوانید کارکرد این افزونه را با وارد کردن http://localhost/sitename/index.php?option=com_hello در مرورگر چک کنید. اگر عبارت بالا را در آدرس بار مرورگر وارد کنیم باید نتیجه ای همانند شکل زیر دریافت کنیم.
همچنین شما میتوانید خروجی کارکرد این کامپوننت را در قسمت مدیریت با وارد کردن http://localhost/sitename/administrator/index.php?option=com_hello در مرورگر یا با کلیک برروی منوی comehelloworld در منوی کامپوننت ها چک کنید. در صورت انجام این کار شما باید نتیجه ای همانند تصویر زیر مطالعه کنید.
در آموزش های بعدی نحوه ایجاد کامپوننت های کاربردی تر و حرفه ای تر که با اطلاعات پایگاه داده ها کار میکنند را با ارائه خواهیم داد.
جمع آوری شده توسط :شهاب مطاع پور - گروه آموزش - تیم جوملا فارسی
 استفاده از مطالب دانشنامه جوملا فارسی - مامبو فارسی با ذکر منبع ( دانشنامه جوملا فارسی ) و لینک مستقیم به http://docs.joomlafarsi.com بلامانع است.
|
