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

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

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

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

CODE :

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

-[code]{$dimphrase.dim_message} {lang_left} {script_url}[/codeالمبدلات (Modifiers) :

هي عباره عن دوال يتم إضافتها بعد المتغير داخل القالب ، لعمل تعديلات علي قيمة المتغير قبل عرضه ، حيث أن دوال المبدلات موجوده في مجلد include/modifiersأو بعض دوال الـ PHP.

مثال :

CODE :

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

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

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

CODE :

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

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

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

CODE :

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

ملاحظة :

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

CODE :

 ملاحظة 2:

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

CODE :

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

CODE :

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

CODE :

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

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

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

CODE :

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

ملاحظة :

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

CODE :

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

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

CODE :

مثال:

CODE :

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

CODE :

مثال:

[code] <[START PHP CODE]> global $relatedsearches_block; foreach($relatedsearches_block AS $key => $value){ echo '

'. $value .'

'; } <[END PHP CODE]> [/code]

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

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

CODE :

حيث أن :

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

args هي البارميترز التي يتم إرسالها للدالة.

مثال :

CODE :

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

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

مثال:

CODE :

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

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

CODE :

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

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

CODE :

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