اولین کامپوننت Hello World در جوملا ۲٫۵

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

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

یک فولدر به نام 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

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

یک فولدر به نام 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

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

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

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

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

helloworld.xml (فایل نصب کننده افزونه)
site\hello.php
site\index.html
admin\hello.php
admin\index.html

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

4

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

Hello World

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

Hello World Administrator

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

5

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

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

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

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

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

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

شما می‌توانید کارکرد این افزونه را با وارد کردن http://localhost/sitename/index.php

option=com_hello در مرورگر چک کنید. اگر عبارت بالا را در آدرس بار مرورگر وارد کنیم باید نتیجه‌ای همانند شکل زیردریافت کنیم.

Basic_component_zip_test

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

http://localhost/sitename/administrator/index.php

option=com_hello در مرورگر یا با کلیک برروی منوی comehelloworld در منوی کامپوننت‌ها چک کنید. درصورت انجام این کار شما باید نتیجه‌ای همانند تصویر زیر مطالعه کنید.

Lastresult_zip_admin