Hamidy در ‏۲۲ نوامبر ۲۰۱۲، ساعت ۰۷:۳۸

2012-11-22T07:38:26Z

Shmata: صفحه‌ای جدید حاوی '=مقدمه= اگر به سورس کد قالب های [http://www.joomlafarsi.com جوملا] نگاهی انداختی باشید متوج...' ایجاد کرد

2012-09-26T07:33:48Z

صفحه‌ای جدید حاوی '=مقدمه= اگر به سورس کد قالب های [http://www.joomlafarsi.com جوملا] نگاهی انداختی باشید متوج...' ایجاد کرد

صفحهٔ تازه

=مقدمه=
اگر به سورس کد قالب های [http://www.joomlafarsi.com جوملا] نگاهی انداختی باشید متوجه خواهید شد که در تمام قالب های [[جوملا]] jdocها اضافه شده اند. تمام کاری jdoc ها میکنند اینست که مشخص مکنند قسمت های از محتوای [[سیستم مدیریت محتوا]]ی [[جوملا]] که این محتوا میتواند افزونه , مطلب , هدر یا ... باشد در کدام قسمت یک صفحه وب قرار بگیرند و نمایش داده شوند. به عنوان مثال یک مدل از دستورات jdoc میتواند به صورت زیر باشد.
<source lang="html4strict">
<jdoc:include type="component" />
</source>
برای کسب اطلاعات بیشتر درباره jdoc ها این مقاله را دنبال کنید.
=jdoc:include=
در واقع با استفاده از
<div dir="ltr"><jdoc:include /></div>
میتوانیم متد نمایش یک محتوای مشخص شده را در قالبمان فراخوانی کنیم که منجر به نمایش آن محتوا در صفحه میگردد. انواع متعددی از محتوا وجود دارند که توسط jdoc:include قابل اضافه شدن به صفحه وب هستند.
=توسط jdoc ها چه محتواهایی را میتوانیم به قالبمان include کنیم ؟=
در ذیل تمام گونه های محتوایی که توسط jdoc:include میتوانیم به قالب مان اضافه کنیم لیست شده است. در ادامه این مقاله به هر از انواع این محتوا '''attribute''' میگوییم.
*component
*head
*installation
*message
*module
*modules
همانطور که قبلا به آن اشاره هریک از انواع attribute ها مشخص کننده نوع محتوایی که در آن قسمت از صفحه نمایش داده میشود است. به عنوان مثال وقتی
<div dir="ltr"><jdoc:include type="head" /></div>
را مشاهده کردیم باید نتیجه بگیریم که نوع attribute ای که ای دستور jdoc:include از آن استفاده میکند از نوع head است.
<div dir="ltr">
type="head"
</div>
'''توجه''' بفرمایید که در مقابل کلمه type از دابل کوتیشن استفاده کردیم و اگر از تک کوتیشن استفاده میکردیم این دستور jdoc فراخوانی نمیشد.
=[[کامپوننت]] component=
<source lang="html4strict">
<jdoc:include type="component" />
</source>
عبارت بالا در صفحه محتویات body صفحه جاری را در قالبهای [[جوملا]] نمایش میدهد و این محتویات میتواند مطالبی که در مدیریت مطالب [[جوملا]] اضافه میکنید باشد تا [[کامپوننت]]های مختلفی که در [[جوملا]] پشتیبانی میشوند. از این دستور فقط یکبار در هر قالب [[جوملا]] استفاده میکنیم.
=Head=
<source lang="html4strict">
<jdoc:include type="head" />
</source>
این دستور محتویات تگ head صفحه جاری را به قالب [[جوملا]] اضافه میکند. در واقع باعث میشود تا لینک مربوط به style ها script ها و meta های مربوط به هر صفحه در template [[جوملا]] قرار بگیرند.از این دستور فقط یکبار در هر قالب [[جوملا]] استفاده میکنیم.
=Installation=
<source lang="html4strict">
<jdoc:include type="installation" />
</source>
این دستور فقط در قالبها و بسته های نصبی (quick start) استفاده میشود و در قالبهای سایت ( front-end ) و مدیریت ( back-end ) استفاده نمیشود. این attribute تا حدودی شبیه نوع component است با این تفاوت که مراحل نصب را در صفحه جاری نمایش میدهد.
=Message=
<source lang="html4strict">
<jdoc:include type="message" />
</source>
این دستور در واقع پیغام های احتمالی خطایی که رخ میدهند یا پیام های هشداری که سیستم به کاربران میدهد را نمایش می دهد برای تغییر استایل پیش فرض این attribute میتوانید به آدرس
<div dir="ltr">
joomlaroot\templates\system\css\system.css
</div>
مراجعه کنید. از این دستور فقط یکبار در هر قالب استفاده میشود.
=[[ماژول]] Module=
<source lang="html4strict">
<jdoc:include type="module" name="breadcrumbs" title="Breadcrumbs" />
<jdoc:include type="module" name="mainmenu" title="Main Menu" />
</source>
این attribute جهت نمایش یک [[ماژول]] در قالب استفاده میشود به این صورت که توسط name نوع [[ماژول]]ی که تصمیم داریم در آن قسمت از قالب داشته باشیم را مشخص میکنیم و توسط title نام آن [[ماژول]] را مشخص میکنیم. البته بعد از استفاده این کد در قالب آن [[ماژول]] باید منتشر شده و قابل دسترسی باشد تا نمایش داده شود.
=Modules=
Modules به صورت یکی از حالتها (syntax) زیر به قالب اضافه میشود . البته از این نوع میتوانیم به دفعات مورد نیاز در [[طراحی قالب در جوملا]] استفاده کنیم. در واقع این دستور و تغییرات لازم در فایل '''templateDetails.xml''' پوزیشنهای موجود در قالب های [[جوملا]] را میسازیم.دستورات زیر نمونه های هستند که توسعه دهندگان قالبهای [[جوملا]] به دفعات در [[طراحی قالب در جوملا]] در آنها استفاده میکنند.
<source lang="html4strict">
<jdoc:include type="modules" name="debug" />
<jdoc:include type="modules" name="icon" />
<jdoc:include type="modules" name="left" style="rounded" />
<jdoc:include type="modules" name="left" style="xhtml" />
<jdoc:include type="modules" name="right" style="xhtml" />
<jdoc:include type="modules" name="status" />
<jdoc:include type="modules" name="syndicate" />
<jdoc:include type="modules" name="title" />
<jdoc:include type="modules" name="toolbar" />
<jdoc:include type="modules" name="top" />
<jdoc:include type="modules" name="top" style="xhtml" />
<jdoc:include type="modules" name="user1" style="xhtml" />
<jdoc:include type="modules" name="user2" style="xhtml" />
<jdoc:include type="modules" name="user3" />
<jdoc:include type="modules" name="user4" />
</source>
----
منبع : <nowiki>http://docs.joomla.org/Jdoc_statements</nowiki>

جمع آوری و ترجمه توسط :[http://forum.joomlafarsi.com/members/26237-shmata شهاب مطاع پور] - [http://www.joomlafarsi.com/about/the-team/ گروه آموزش] - تیم [http://www.joomlafarsi.com جوملا فارسی]

{{معرفی پشتیبانی}}

{{کپی رایت}}

[[رده:طراحی قالب جوملا 2.5]] [[رده:مقالات جوملا 2.5]] [[رده:طراحی قالب جوملا 1.5]] [[رده:مقالات جوملا 1.5]] [[رده:طراحی قالب جوملا]] [[رده:مقالات جوملا]]

دستورات jdoc - تاریخچهٔ ویرایش‌ها

Hamidy در ‏۲۲ نوامبر ۲۰۱۲، ساعت ۰۷:۳۸

Shmata: صفحه‌ای جدید حاوی '=مقدمه= اگر به سورس کد قالب های [http://www.joomlafarsi.com جوملا] نگاهی انداختی باشید متوج...' ایجاد کرد