ساختار دایرکتوری (پوشه) در یک الگوی معمولی

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

/templates/myTemplate

الگوهایی که مربوط به محیط مدیریت هستند در داخل این مسیر قرار دارند:

/administrator/templates

مثلا اگر ما الگویی را با نام myAdminTemplate بوجود آورده باشیم، این الگو باید در این آدرس قرار گیرد:

/administrator/templates/myAdminTemplate

معمولا ساختار پوشه ها در یک الگوی معمولی جوملا به شکل زیر است:

• css: تمام فایل های شیوه نامه های آبشاری (css) در این پوشه قرار می گیرند.
• html: فایلهایی که توسط الگو به جای فایل های از پیش تعیین شده قرار می گیرند (یعنی جایگزین فایل های از پیش تعیین شده می شوند) در داخل این پوشه قرار دارند.
• images: تمام تصاویری که توسط الگو استفاده می شوند در این پوشه قرار می گیرند.
• language: فایل های مربوط به زبان های اضافی که توسط الگو استفاده می شوند در این پوشه قرار دارند.

بر اساس میزان پیچیدگی الگویی که در حال مشاهده آن هستید ممکن است یک پوشه دیگر نیز حاوی فایل های جاوااسکریپت وجود داشته باشد:

• javascript: شامل فایل های جاوااسکریپت است که الگو از آنها استفاده می کند.

یک نمونه از ساختار فایل ها

معمولا مسیر مربوط به یک الگو بر روی سروری که وب سایت خود را نصب کرده اید به این شکل است:

 /public_html/domain-name/template/ 

که معمولا شامل فایلها و پوشه های زیر است:

/css
/html
/images
/javascript
/language
component.php
error.php
favicon.ico
index.php
templateDetails.xml
template_preview.png
template_thumbnail.png 

فایل های موجود در یک الگو

معمولا در یک الگو حداقل فایل های زیر وجود دارند:

• index.php
در این فایل، منطق لازم برای نمایش و محل قرار گیری کامپوننت ها و ماژول ها مشخص می شود.
• component.php
این فایل، منطق لازم برای نمایش صفحه مناسب برای پرینت، لینک مربوط به ارسال ایمیل برای یک دوست و چیزهایی شبیه به این مشخص می شود.
• error.php
شیوه مناسب برای مدیریت کردن خطاهای رخ داده (مثل خطای 404) در این صفحه مشخص می شود.
• favicon.ico
این فایل، آیکون مربوط به الگو است.
• template.css
همانطور که از پسوند (.css) این فایل پیداست، این یک فایل شیوه نامه آبشاری است که جنبه های ظاهری صفحه را مشخص می کنید. در این فایل خصوصیاتی مثل فونت ها، اندازه حاشیه ها، حاشیه های تصاویر، و سایر فرمت دهی های مربوط به ظاهر صفحات مشخص می شوند. البته ممکن است فایل های شیوه نامه آبشاری در داخل پوشه css قرار داشته باشند.
• templateDetails.xml
در داخل این فایل، فراداده هایی (داده در مورد داده) در مورد الگو قرار دارند که این اطلاعات توسط نصب کننده الگو و قسمت مدیریت الگو استفاده می شوند.
• template_preview.ext
منظور از ext فرمت مربوط به تصویر است که این فرمت می تواند .jpg, .png, .gif باشد.
معمولا یک تصویر با اندازه 600 در 400 پیکسل برای این کار در نظر گرفته می شود. زمانی که کاربر بر روی تصویر بندانگشتی مربوط به الگو کلیک می کند، این تصویر نمایش داده می شود (البته این اتفاق در قسمت Template Manager: Templates رخ می دهد). در این حالت، یک پنجره در سطحی بالاتر از صفحه فعلی باز می شود که پیش نمایشی از الگوی مورد نظر را نشان می دهد تا مدیر بتواند قبل از انتخاب آن الگو، متوجه شود نمایش ظاهری آن الگو چگونه است.
• template_thumbnail.ext
معمولا یک تصویر با اندازه 200 در 150 پیکسل برای این کار در نظر گرفته می شود. هنگامی که در قسمت مدیریت مربوط به الگو ها قرار داریم (Template Manager: Templates) این نمای بند انگشتی در ردیف مربوط به الگو نمایش داده می شود.