مكتبة الشروحات



 تصنيفات المكتبة





 جوال ديموفنف


اشترك الآن في موبايل ديموفنف واستمتع بعالم جديد من الخدمات المتميزة وبسعر رمزي تصلك رسائلنا على موبايلك أينما كنت . تفاصيل


 محول العملات


  • العملة
  • المبلغ بالدولار

أوسمة نظام القوالب داخل ملفات القوالب و المتغيرات و الثوابت و المتغيرات العامة



      أوسمة نظام القوالب داخل ملفات القوالب :

هناك عدة أوسمة (Tags) خاصة بنظام القوالب يتم وضعها داخل ملفات القوالب .htm حتي يتم معالجتها من نظام القوالب و إستبدالها بالقيم الخاصة بها ، هذه الأوسمة مشابهة في سياقها لأوسمة الـ HTML ، لذلك يجب أن تكون حريص أثناء تعديلك في ملفات القوالب ، حتي لا تقوم بحذف وسم خاص بنظام القوالب مما قد يتسبب لك بخطأ في العرض.

 

      المتغيرات و الثوابت و المتغيرات العامة :

يتم تعريف المتغيرات أو الثوابت أو المتغيرات العامة مسبقة التعريف داخل التيمبلت بهذا الشكل :

CODE :
{variablename}

 

حيث يمكن تعيين قيمتها بإستخدام Assign من ملف الـ PHP للمتغيرات ، أو إستخدام المتغيرات العامة مسبقة التعريف ، أو إستخدام الثوابت.

 

CODE :
{$dimphrase.dim_message} {lang_left} {script_url}[/code<strong>المبدلات (</strong><strong>Modifiers</strong><strong>)</strong><strong> :</strong>>
هي عباره عن دوال يتم إضافتها بعد المتغير داخل القالب ، لعمل تعديلات علي قيمة المتغير قبل عرضه ، حيث أن دوال المبدلات موجوده في مجلد include/modifiersأو بعض دوال الـ PHP.>
 >
مثال :>
[code]{mname|strtolower} {mname|strtolower|strtolower}

 

حيث إستدعاء دالة strtolower تقوم بتحويل الأحرف لقيمة المتغير mname إلي حروف صغيره ، مع ملاحظة أنه يمكن إستدعاء المبدلات أكثر من مره لنفس المتغير بنفس الوقت.

    - بلوك التكرار (loop) :

يتم تعريف بلوك التكرار لجزء من القالب داخل القالب بهذا الشكل :

CODE :
[START BLOCK : blockname]> <[END BLOCK : blockname]

 

حيث أن blockname هو المسمي الخاص لبلوك التكرار و الذي يعين من الـ  PHP، مع ملاحظة أن جزء كود الـHTML لهذا البلوك لا يظهر إلا بتعريف البلوك من خلال الـPHP بإستخدام دالة newBlock().

    - وسم إدراج قوالب :

إدراج ملف قالب أخر داخل قالب ، يتم بهذا الشكل :

CODE :
[INCLUDE BLOCK : blockname]

 

حيث أن blockname هو إسم ملف القالب المراد إدراجه ، مع ملاحظة وضع إسم القالب المراد إستدعائه بدون وضع إمتداده .htm

 

ملاحظة :

عند إستدعاء قالب من مجلد القوالب للإستايل الرئيسي ، فقط ضع إسم ملف القالب مباشرة ، أما عندما تريد إستدعاء ملف قالب من مسار أخر غير مجلد القوالب للإستايل الرئيسي ، فقم بوضع مسار القالب ، كمثال ، عند إستدعاء قالب من داخل إحدي المجلدات داخل بلجن :

CODE :
[INCLUDE BLOCK : include/plugins/pluginfolder/tpl/blockname]

 

ملاحظة 2:

عند إدراج قالب ، يقوم نظام القوالب بداية بالبحث عن القالب إن كان موجود ضمن المصفوفة

CODE :
$dimofinf->globaldimvars['templateoverride']

و التي من خلالها يتم تخزين القوالب المستبدله بدلاً من القوالب الرئيسية إلي قوالب أخري من إحدي البلجنز ، حيث عند إستدعاء قالب :

CODE :
[INCLUDE BLOCK : blockname]

يقوم بالبحث في هذه المصفوفة عن قيمة مخزنة بدلالة إسم القالب المستدعي blockname :

CODE :
$dimofinf->globaldimvars['templateoverride']['blockname']

حيث إن وجدت ، فتكون القيمة المخزنة عباره عن إسم البلجن الذي يوجد بداخله القالب البديل الموجود داخل مجلد tpl داخل البلجن لإستدعائه بدلاً من القالب المستدعي الحالي.

    - وسم إدراج ملفات PHP داخل القالب :

إستدعاء داخل القالب ملف PHP و تنفيذه ، يتم بهذا الشكل :

CODE :
[INCLUDESCRIPT BLOCK : iblockname]

حيث أن iblockname هو إسم ملف الـ PHP  المراد إدراجه ، مع ملاحظة وضع إسم الملف المراد إستدعائه بدون وضع إمتداده .php

ملاحظة :

عند إستدعاء ملف من المجلد الرئيسي لديموفنف ، فقط وضع إسم الملف مباشرة ، أما عندما تريد إستدعاء ملف قالب داخل مسار أخر غير المسار الرئيسي لديموفنف ، فقم بوضع مسار الملف ، كمثال ، عند إستدعاء ملف من داخل مجلد include :

CODE :
[ INCLUDESCRIPT BLOCK : include/iblockname]

    - وسم IF/ELSEIF/ELSE الشرطية :

لكتابة الجمل الشرطية داخل القوالب ، يتم كتابتها هكذا :

CODE :
 <IF "الشرط"> // الكود <ELSEIF "الشرط"> // الكود // الكود

مثال:

CODE :
 <IF "is_value('{relatedsearches}')">

     - وسم كود PHP :

لتنفيذ كود PHP داخل القالب ، يتم ذلك كالتالي :

CODE :
 <[START PHP CODE]> // الكود <[END PHP CODE]>

مثال:

CODE :
<[START PHP CODE]>
	global $relatedsearches_block;
				
	foreach($relatedsearches_block AS $key => $value){
	echo '<li style="float:'.$this->variable('lang_left').';"><a href="'. $key .'" rel="follow">'. $value .'</a></li>';
	}	
		<[END PHP CODE]>

      وسم إستدعاء دالة :

لتنفيذ دالة من الدوال المعرفة مسبقاً بنظام القوالب ، يتم بإستخدام :

CODE :
{function:function_nameargs}

حيث أن :

  • function_name هو إسم الدالة المعرفة مسبقاً داخل النظام ، حيث أن دوال القالب المعرفة مسبقاً يتم وضع ملفاتها داخل المجلد include/functions.
  • args هي البارميترز التي يتم إرسالها للدالة.

مثال :

CODE :
{function:getpermalink file="contents" args="action=l&id={cat_id}" caption="{cat_name}"}

    - وسم التيمبلت زون :

هذا الوسم يتم وضعه في الأماكن التي تود إستعمالها داخل برمجيتك ، لإستدعاءها من ملف الـ PHP لإظهار شيء معين فيه أو عدة أشياء كما تريد ، التيمبلت زون تتيح لك و للمبرمجين الأخرين الفرصة في إستغلال مكان ما في القالب لإظهار أشياء أخري فيه سواء من قبلك أو من قبل المبرمجين الأخرين بإستخدام نظام البلجن.

مثال:

CODE :
[INCLUDEZONE BLOCK : MenucontentItemsAfter]

    - وسم تجاهل كود :

لتجاهل جزء معين من القالب لتجاهله من المعالجة من قبل نظام القوالب ، حيث أن التجاهل ليس المقصود به إخفاء الكود ، و لكن المقصود به عدم معالجة أوسمة نظام القوالب بداخله .

CODE :
 <[START IGNORE]> <[END IGNORE]>

      التعليق داخل القالب :

يمكنك كتابة تعليقاتك البرمجية داخل القوالب عن طريق :

CODE :
{*التعليق*}

حيث أن نظام المعالجة يقوم بإخفاء هذه التعليقات عند المعالجة ولا يظهرها في العرض ، و لكن تظهر فقط في ملف  المصدر للقالب.


هل كانت المقالة مفيدة ؟

أضفة للمفضلة أضفة للمفضلة    طباعة طباعة

اقرأ أيضاً :

دوال المبدلات (Modifiers) (الزيارات: 560)

كما تم توضيحه سابقاً في وسم المتغيرات ، أن المبدلات...


دوال مساعدة تستخدم للقوالب (الزيارات: 551)

هذه مجموعة من الدوال المساعدة التي يمكن إستخدامها...


دوال للمساعدة يمكن إستخدامها بالقوالب (Functions) (الزيارات: 587)

      {function:alternate name="blockname" values="alt1,alt2"} تستخدم هذه...


دوال كائن $tpl داخل ملف الـPHP (الزيارات: 428)

         mk_template($var) هذه الدالة يتم إستدعاءها من أجل...


نظام القوالب (الزيارات: 566)

ديموفنف توفر لك نظام قوالب متطور خاص بها ، تستطيع من...



Online