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



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





 جوال ديموفنف


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


 محول العملات


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

دوال كائن $tpl داخل ملف الـPHP



         mk_template($var)

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

ملاحظة :

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

CODE :
mk_template("article/tpl/article.htm");

حيث أن article هو إسم مجلد البلجن و tpl هو إسم مجلد القوالب للبلجن و article.htm هو القالب.

      newBlock($var)

هذه الدالة تستخدم لتعريف بلوك التكرار داخل القالب ، حيث $var هو إسم البلوك ، مع ملاحظة لتكرار ظهور هذا البلوك داخل القالب أكثر من مره ، فيتم إستدعاء هذه الدالة بنفس إسم البلوك أكثر من مره .

مثال :

1- بلوك منفرد :

- شكل البلوك داخل القالب :

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

- تعريف البلوك داخل ملف الـPHP :

CODE :
$tpl->newBlock("blockname");[/code>
2- بلوك متعدد :>
- شكل البلوك داخل القالب :>
[code]<[START BLOCK : blockname]>        <[START BLOCK : blockname2]>         <[END BLOCK : blockname2]><[END BLOCK : blockname]

- تعريف البلوك داخل ملف الـPHP :

CODE :
// Defining the main block in the beginning
$tpl->newBlock("blockname");				
//Defning the sub-block but the single parent block must be added to the sub-block
$tpl->newBlock("blockname,blockname2");

ملاحظة :

يمكن وضع أكثر من بلوك داخل البلوك بشكل شجري ، و عند تعريفهم ، يتم وضع المسار الشجري للبلوك بداية من البلوك الأب حتي البلوك الفرعي ، مع الفصل بينهم بفاصلة.

      assign($var,$value='')

تستخدم هذه الدالة في تعيين قيم المتغييرات المعرفة داخل البلوك المعرف فقط  ، حيث يتم إستخدامها بعد تعريف بلوك بدالة newBlock()، حيث أن $var هو إسم المتغير داخل البلوك المعرف في القالب ، و $value هي قيمة المتغير ، مع ملاحظة أنه يمكن تمرير مصفوفة من المتغيرات و قيمها دفعة واحده للدالة بدلاً من تكرار إستدعاء الدالة مره لكل متغير ، حيث يكون المفتاح هو إسم المتغير و قيمته هي قيمة المتغير.

مثال :

CODE :
$tpl->assign("m", THIS_SCRIPT);
$tpl->assign(array(
	"totalcatkeys" => $num_rows,
	"catkey" => $catkeys,
	"width" => $catwidth,
	"cat_id" => $cat['id'],
	"cat_name" => $cat['name'],
	"description" => bbcodeparse($cat['description'], THIS_PRODUCT, true),
	"last_add" => $last_add
));

      assignGlobal($var,$value='')

تستخدم هذه الدالة في تعيين قيم المتغييرات العامة المعرفة عامة داخل القالب و غير مرتبطة داخل بلوك ، ويمكن إستخدامها دون الحاجه لتعريف بلوك سواء في القالب أو في ملف الـPHP، حيث أن $var هو إسم المتغير ، و $value هي قيمة المتغير ، مع ملاحظة أنه يمكن تمرير مصفوفة من المتغيرات و قيمها دفعة واحده للدالة بدلاً من تكرار إستدعاء الدالة أكثر من مره لكل متغير ، حيث يكون المفتاح هو إسم المتغير و قيمته هي قيمة المتغير.

 

مثال :

CODE :
$tpl->assignGlobal("thelast", 1);

ملاحظة :

يمكن تعيين قيم متغيرات عامة بطريقة أخري في حالة عدم تعريف الكائن $tpl بإستخدام المتغير العام $Globalassigneds و الذي يحتوي علي مصفوفة من المتغيرات و قيمها.

CODE :
$Globalassigneds = array_merge($Globalassigneds, array(
	"allow_add" => $allow_add,
	"forum_id" => $dimofinf->GPC['id']
));

      gotoBlock($var)

تستخدم هذه الدالة في التنقل بين البلوكات المعرفة في ملف الـPHP ، فائدة التنقل هي أنه في حالة قمت بتعريف البلوك blockname1 ، ثم قمت بتعيين قيم لمتغيرات معرفة داخل البلوك بإستخدام الدالة assign ، ثم بعد ذلك أردت تعريف بلوك أخر بإسم blockname2  و قمت بتعيين قيم لمتغيرات معرفة داخل البلوك بإستخدام الدالة  assign ، ثم أردت بعد ذلك الذهاب مره أخري للبلوك blockname1 لتعيين قيم جديده للمتغيرات ، تأتي هنا فائدة هذه الدالة ، حيث أن $var هو إسم البلوك المراد الذهاب له بشرط أن يكون معرفاً من قبل.

 

مثال:

CODE :
$tpl->newBlock("catinfo");
$tpl->assign(array(
						"totalcatkeys" => $num_rows,
						"catkey" => $catkeys,
						"width" => $catwidth,
						"cat_id" => $cat['id'],
						"cat_name" => $cat['name'],
						"description" => bbcodeparse($cat['description'], THIS_PRODUCT, true),
						"last_add" => $last_add
					));
$tpl->newBlock("catinfo","catinfopic");
$tpl->assign(array(
							"cat_id" => $cat['id'],
							"catpicture" => $cat['picture'],
							"cat_name" => $cat['name']
));
$tpl->gotoBlock("catinfo");
$tpl->assign("fgf", "fgf");

      printToScreen()

تستخدم هذه الدالة في طباعة القالب في النهاية إلي المتصفح مباشرة بعد المعالجة .

مثال:

CODE :
$tpl->printToScreen();

      getOutputContent()

تستخدم هذه الدالة لإرجاع القالب علي هيئة String بعد معالجته ، بدون طباعته إلي المتصفح.

مثال:

CODE :
$tpl->getOutputContent();

      variable($variable,$currentBlock= false)

تستخدم هذه الدالة لإرجاع قيمة متغير معرف داخل البلوك ، أو متغير عام ، و لكن من كود الـ PHP سواء من خلال ملف القالب بإستخدام وسم كود PHP أو من خلال ملف PHP ، حيث أن $variable هو إسم المتغير المعرف داخل البلوك ، و $currentBlock هو إسم البلوك المحتوي للمتغير (في حال كان المتغير ليس متغير عام و معرف داخل بلوك) ، مع ملاحظة أنه يمكن تمرير بلوك متفرع متشجر من بلوك رئيسي عن طريق تزويد تفرع البلوك كاملاً مفصول بفاصلة.

مثال:

$tpl->variable('variable'); $tpl->variable('variable','blockname'); $tpl->variable('variable','blockname1,blockname2'); [/code]

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

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

اقرأ أيضاً :

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

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


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

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


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

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


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

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


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

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



Online