ساخت منو helloworld

ایجاد یک منو از نوع helloworld

در این بیاموز، نحوه ی قرار دادن یک لینک در سایت برای باز کردن یک صفحه خاص از کامپوننت، توضیح داده می شود.

در framework جوملا، کامپوننت ها با استفاده از آیتم های منو، اجرا می شوند. اگر به مدیریت منوها، در جوملای نصب شده تان بروید و یک منوی جدید ایجاد نمایید، زمانی که می خواهید نوع منو را مشخص نمایید، مشاهده می کنید که برای کامپوننت HelloWorld هنوز منویی از این نوع وجود ندارد.

در ادامه خواهید دید که اضافه کردن این قابلیت در جوملا به سادگی قابل انجام است.

در پایان این بیاموز خواهید توانست

در واقع شما می توانید از طریق مدیریت منوها در مدیریت جوملا (backend)، یک آیتم منو از نوع کامپوننت Helloworld ایجاد نمایید:

ایجاد منوی helloworld

1- در مدیریت جوملا، گزینه (منو ها => منوی اصلی) را اجرا نمایید.
شما می توانید بجای گزینه "منوی اصلی"، گزینه دیگری را انتخاب نمایید.

2- روی دکمه "جدید" کلیک نمایید.
مطابق شکل زیر، بعد از کلیک روی دکمه "انتخاب" فرم زیر ظاهر می شود. همانطور که در شکل مشخص است یک مجموعه "helloworld" با یک گزینه "COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_TITLE"، اضافه شده است.

3- روی عنوان "COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_TITLE" کلیک کنید.
بعد از کلیک، پنجره بسته شده و فیلد "لینک" در فرم اصلی با مقدار "index.php?option=com_helloworld&view=helloworld" تنظیم می شود. (مشاهده می کنید که این لینک، در واقع همان چیزی است که برای نمایش view نیاز داریم)

4- روی دکمه "ذخیره" کلیک نمایید.

فایل نصب کامپوننت

در فایل نصب کامپوننت، قسمت های قرمز رنگ مطابق شکل زیر، اضافه یا تغییر خواهند کرد:

توجه: در انتهای این بیاموز، فایل نصب کامپوننت برای دانلود قرار داده شده است.

فایل site/views/helloworld/tmpl/default.xml

احتمالاً تا این لحظه متوجه شده اید که برای اضافه کردن یک منو، فقط کافی است یک فایل xml به view مورد نظرتان اضافه کنید.

به عنوان مثال اگر فایل site/views/helloworld/tmpl/default.php صفحه مورد نظر شما باشد، باید فایل default.xml را در کنار آن قرار دهید.

انجام این کار، جوملا را قادر می سازد تا فایل default.php را به عنوان یک منو تشخیص دهد.

با ویرایشگر دلخواهتان فایل site/views/helloworld/tmpl/default.xml را با محتوای زیر، ایجاد نمایید:

site/views/helloworld/tmpl/default.xml

<?xml version="1.0" encoding="utf-8"?>
<metadata>
        <layout title="COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_TITLE">
                <message>
                        <![CDATA[COM_HELLOWORLD_HELLOWORLD_VIEW_DEFAULT_DESC]]>
                </message>
        </layout>
</metadata>

برای این لحظه، مقدار title و توضیحات آن (<message>...</message>) در مدیریت ترجمه نخواهند شد. در بیاموز های بعدی نحوه ترجمه رشته ها توضیح داده خواهد شد.

فایل helloworld.xml

فقط کافی است نسخه کامپوننت را به 0.0.3 تغییر دهید (<version>0.0.3</version>):

helloworld.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Id: helloworld.xml 14 2009-11-02 18:35:20Z chdemko $ -->
<extension type="component" version="1.6.0" method="upgrade">

    <name>Hello World!</name>
    <!-- The following elements are optional and free of formatting conttraints -->
    <creationDate>November 2009</creationDate>
    <author>beyamooz</author>
    <authorEmail>این آدرس ایمیل توسط spambots حفاظت می شود. برای دیدن شما نیاز به جاوا اسکریپت دارید</authorEmail>
    <authorUrl>https://beyamooz.com</authorUrl>
    <copyright>Copyright Info</copyright>
    <license>License Info</license>
    <!--  The version string is recorded in the components table -->
    <version>0.0.3</version>
    <!-- The description is optional and defaults to the name -->
    <description>Description of the Hello World component ...</description>

    <update> <!-- Runs on update; New in 1.6 -->
        <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>
        <filename>controller.php</filename>
        <folder>views</folder>
    </files>

    <administration>
        <!-- Administration Menu Section -->
        <menu>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>