دستورات jdoc: تفاوت بین نسخه‌ها   

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

نسخهٔ کنونی تا ‏۲۲ نوامبر ۲۰۱۲، ساعت ۰۷:۳۸

مقدمه

اگر به سورس کد قالب‌های جوملا نگاهی انداختی باشید متوجه خواهید شد که در تمام قالب‌های جوملا jdocها اضافه شده‌اند. تمام کاری jdocها می‌کنند اینست که مشخص می‌کنند قسمت‌هایی از محتوای سیستم مدیریت محتوای جوملا که این محتوا می‌تواند افزونه ، مطلب ، هدر یا ... باشد در کدام قسمت یک صفحه وب قرار بگیرند و نمایش داده شوند.

به عنوان مثال یک مدل از دستورات jdoc میتواند به صورت زیر باشد.


<source lang="html4strict"> <jdoc:include type="component" /> </source>


برای کسب اطلاعات بیشتر درباره 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

<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 می‌توانید به آدرس

joomlaroot\templates\system\css\system.css

مراجعه کنید.

از این دستور فقط یکبار در هر قالب استفاده می‌شود.

ماژول 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>


منبع : http://docs.joomla.org/Jdoc_statements

جمع آوری و ترجمه توسط :شهاب مطاع پور - گروه آموزش - تیم جوملا فارسی

Indent support.png
هر گونه سوال و یا مشکلی در این رابطه دارید، می‌توانید در انجمن تخصصی تیم جوملا فارسی جستجو کرده و در صورت عدم دریافت نتیجه مورد نظر، سوال جدیدی را مطرح کنید.
8.pngاستفاده از مطالب دانشنامه جوملا فارسی - مامبو فارسی با ذکر منبع ( دانشنامه جوملا فارسی ) و لینک مستقیم به http://docs.joomlafarsi.com بلامانع است.
برگرفته از «https://docs.joomlafarsi.com/index.php?title=دستورات_jdoc&oldid=3517»