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

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

هناك عدة أوسمة (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 :

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

    هل كانت المقالة مفيدة ؟ 0 أعضاء وجدوا هذه المقالة مفيدة (0 التصويتات)