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



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





 جوال ديموفنف


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


 محول العملات


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

دوال مساعدة تستخدم للقوالب



هذه مجموعة من الدوال المساعدة التي يمكن إستخدامها في برمجيتك لبعض الأشياء المساعدة الجاهزة داخل القالب .                                                        

      maketitle($var1 ="", $var2 ="", $var3 ="")

تستخدم هذه الدالة لتعيين وسم عنوان الصفحة ، حيث أن $var1 و $var2 و $var3 هي متغيرات العناوين مع ملاحظة أنه يتم فلترة و حماية العنوان من الـ XSS.

مثال:

CODE :
maketitle($dimphrase['printing_content']);

      maketree($rootcatid, $module)

تستخدم هذه الدالة لبناء كود تفرع شجري للأقسام (Breadcrumb) ، لتوضيح تصنيف المحتوي أو القسم الذي تتواجد به الآن و من أين يتفرع .

البارميترز :

  •  $rootcatid(إجباري) : رقم الـ id  للقسم المندرج منه المحتوي أو المندرج منه القسم.
  • $module(إجباري) :إسم الجدول في قاعدة البيانات للموديول المحتوي علي الأقسام.

مثال:

CODE :
maketree($dimofinf->GPC['id'], "articles")

ملاحظة :

يجب أن يحتوي ملف القالب علي البلوكات و المتغيرات التالية حتي تستبدلها الدالة بالقيمة التي تعود منها و التي تكون عبارة عن كود HTML الخاص بالتفرع . 

مثال (يمكنك الإستعانة به مع تغيير ما يلزم به لما يتناسب مع الموديول) :

CODE :
<[START BLOCK : subcat]>
	{output} <a href="{function:getpermalink file="cards" args="action=l&id={catid}" caption="{catname}"}"> {catname}</a></td></tr><tr><td align="{lang_left}" height="16">
<[END BLOCK : subcat]>
	
<[START BLOCK : currcat]>
	{output} <a href="{function:getpermalink file="cards" args="action=l&id={catid}" caption="{catname}"}"> {catname}</a></td></tr><tr><td align="{lang_left}" height="16">
	{outputcaption}   {caption}
<[END BLOCK : currcat]>

      catprev_next($page, $perpage, $results, $address1, $address2 ='')

تستخدم هذه الدالة لعمل تعدد الصفحات داخل القالب للأقسام.

البارميترز :

  •  $page(إجباري): رقم الـصفحة المعروضة الحالية و تأتي من المتغير catpage المرسل مع الصفحة.
  • $perpage (إجباري): عدد الأقسام لعرضها بالصفحة الواحدة.
  • $results (إجباري): عدد الأقسام الإجمالي.
  • $address1 (إجباري): عنوان الأكشن الرئيسي للصفحة.
  • $address2 (إختياري): المتغيرات الإضافية في عنوان الصفحة.

مثال

CODE :
$pages = catprev_next($dimofinf->GPC['catpage'], $perpage, $count['total'], "l", "&id=" . $dimofinf->GPC['id'] . iif($dimofinf->GPC['page'] > 1, "&page=" . $dimofinf->GPC['page']));
$tpl->assignGlobal("catprev_next",$pages);

ملاحظة :

يجب أن يحتوي ملف القالب علي المتغير التالي حتي تستبدلها الدالة بالقيمة التي تعود منها و التي تكون عبارة عن كود HTML الخاص بتعدد الصفحات للأقسام.

{catprev_next}
 

      prev_next($page, $perpage, $results, $address1, $address2 ='')

تستخدم هذه الدالة لعمل تعدد الصفحات داخل القالب للمحتويات. 

البارميترز :

  •  $page(إجباري) : رقم الـصفحة المعروضة الحالية و تأتي من المتغير page المرسل مع الصفحة.
  • $perpage(إجباري) : عدد المحتويات لعرضها بالصفحة الواحدة.
  • $results(إجباري) : عدد المحتويات الإجمالي.
  • $address1(إجباري) : عنوان الأكشن الرئيسي للصفحة.
  • $address2(إختياري) : المتغيرات الإضافية في عنوان الصفحة.

مثال:

CODE :
$pages = prev_next($dimofinf->GPC['page'], $perpage, $count['total'], "l", "&id=" . $dimofinf->GPC['id'] . if($dimofinf->GPC['catpage'] > 1, "&catpage=" . $dimofinf->GPC['catpage']));

ملاحظة :

يجب أن يحتوي ملف القالب علي المتغير التالي حتي تستبدلها الدالة بالقيمة التي تعود منها و التي تكون عبارة عن كود HTML الخاص بتعدد الصفحات للمحتوي.

{prev_next}

      دوال القوالب الداخلية (Functions) :

كما تم توضيحه سابقاً في وسم الدوال الداخلية ، يمكنك كتابة الدالة الخاصة بك لإستخدامها داخل القوالب ، عن طريق الخطوات التالية :

  • إنشاء ملف داخل مجلد include/functions بصيغة الإسم التالية functions.name.php ، حيث أن name هو إسم الدالة.
  • كتابة الصيغة التالية للدالة داخل ملف الدالة :
CODE :
function Dimofinf_function_name($params)
    {
    	return $val;
    }

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

مثال (لدالة getpermalink التي يتم مناداتها من القالب و من ثم تقوم هي بالمعالجة من الدالة الرئيسية في الـ(PHP):

CODE :
function Dimofinf_function_getpermalink($params)
    {
    	if(isset($params['file'])){
    		return getpermalink($params['file'],$params['args'],$params['outputfiletype'],$params['default'],$params['caption']);	
    	}
   }

مثال لمناداتها من القالب :

{function:getpermalink file="albums"}


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

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

اقرأ أيضاً :

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

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


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

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


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

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


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

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


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

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



Online