اگر به سورس کد قالب‌های جوملا نگاهی انداختی باشید متوجه خواهید شد که در تمام قالب‌های جوملا jdocها اضافه شده‌اند. تمام کاری jdocها می‌کنند اینست که مشخص می‌کنند قسمت‌هایی از محتوای سیستم مدیریت محتوای جوملا که این محتوا میتواند افزونه ، مطلب ، هدر یا … باشد در کدام قسمت یک صفحه وب قرار بگیرند و نمایش داده شوند.
به عنوان مثال یک مدل از دستورات jdoc میتواند به صورت زیر باشد.
<jdoc:include type=”component” />
برای کسب اطلاعات بیشتر درباره jdocها این مقاله را دنبال کنید.
jdoc:include
در واقع با استفاده از
<jdoc:include />
می‌توانیم متد نمایش یک محتوای مشخص شده را در قالب فراخوانی کنیم که منجر به نمایش آن محتوا در صفحه می‌گردد. انواع متعددی از محتوا وجود دارند که توسط jdoc:include قابل اضافه شدن به صفحه وب هستند.
توسط jdocها چه محتواهایی را می‌توانیم به قالب include کنیم؟
در ذیل تمام گونه‌های محتوایی که توسط jdoc:include می‌توانیم به قالب اضافه کنیم لیست شده است.
در ادامه این مقاله به هر یک از انواع این محتوا attribute می‌گوییم.
- component
- head
- installation
- message
- module
- modules
همانطور که قبلا به آن اشاره شد هر یک از انواع attributeها مشخص کننده نوع محتوایی که در آن قسمت از صفحه نمایش داده می‌شود است.
به عنوان مثال وقتی
<jdoc:include type=”head” />
را مشاهده کردیم باید نتیجه بگیریم که نوع attributeای که دستور jdoc:include از آن استفاده می‌کند از نوع head است.
type=”head”
توجه بفرمایید که در مقابل کلمه type از دابل کوتیشن استفاده کردیم و اگر از تک کوتیشن استفاده می‌کردیم این دستور jdoc فراخوانی نمی‌شد.
کامپوننت component
عبارت بالا در صفحه محتویات body صفحه جاری را در قالب‌های جوملا نمایش می‌دهد و این محتویات میتواند مطالبی که در مدیریت مطالب جوملا اضافه می‌کنید باشد تا کامپوننتهای مختلفی که در جوملا پشتیبانی می‌شوند.
از این دستور فقط یکبار در هر قالب جوملا استفاده می‌کنیم.
Head
این دستور محتویات تگ head صفحه جاری را به قالب جوملا اضافه می‌کند. در واقع باعث می‌شود تا لینک مربوط به styleها scriptها و metaهای مربوط به هر صفحه در template جوملا قرار بگیرند.
از این دستور فقط یکبار در هر قالب جوملا استفاده می‌کنیم.
Installation
این دستور فقط در قالب‌ها و بسته‌های نصبی (quick start) استفاده می‌شود و در قالب‌های سایت ( front-end ) و مدیریت ( back-end ) استفاده نمی‌شود.
این attribute تا حدودی شبیه نوع component است با این تفاوت که مراحل نصب را در صفحه جاری نمایش می‌دهد.
Message
این دستور در واقع پیغام‌های احتمالی خطایی که رخ می‌دهند یا پیام‌های هشداری که سیستم به کاربران می‌دهد را نمایش می‌دهد برای تغییر استایل پیش فرض این attribute می‌توانید به آدرس
joomlaroot\templates\system\css\system.css
مراجعه کنید.
از این دستور فقط یکبار در هر قالب استفاده می‌شود.
ماژول Module
این attribute جهت نمایش یک ماژول در قالب استفاده می‌شود به این صورت که توسط name نوع ماژولی که تصمیم داریم در آن قسمت از قالب داشته باشیم را مشخص می‌کنیم و توسط title نام آن ماژول را مشخص می‌کنیم. البته بعد از استفاده این کد در قالب آن ماژول باید منتشر شده و قابل دسترسی باشد تا نمایش داده شود.
Modules
Modules به صورت یکی از حالت‌ها (syntax) زیر به قالب اضافه می‌شود. البته از این نوع می‌توانیم به دفعات مورد نیاز در طراحی قالب در جوملا استفاده کنیم. در واقع این دستور و تغییرات لازم در فایل templateDetails.xml موقعیت‌های موجود در قالب‌های جوملا را می‌سازیم.
دستورات زیر نمونه‌های هستند که توسعه دهندگان قالب‌های جوملا به دفعات در طراحی قالب در جوملا در آنها استفاده می‌کنند.
