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



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





 جوال ديموفنف


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


 محول العملات


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

دوال المبدلات (Modifiers)



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

  • إنشاء ملف داخل مجلد include/modifiers بصيغة الإسم التالية modifier.name.php ، حيث أن name هو إسم الدالة.
  • كتابة الصيغة التالية للدالة داخل ملف الدالة :
CODE :
functionDimofinf_modifier_name($params)		
    {
	$string = $params['string'];
	//الكود 
	return $string;
}

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

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

هذه بعض المبدلات المفيدة التي قد تساعدتك في برمجيتك و القوالب : 

      {var|calc values="5,5,8"sign="+"}

يستخدم هذا المبدل لإجراء عملية حسابية علي قيمة المتغير var

البارميترز :

  •  sign(إختياري): إشارة العملية الحسابية : + للجمع ، - للطرح ، * للضرب ، / للقسمة
  •  values(إجباري): القيم التي سيقوم بإجراء العملية الحسابية عليها 

مثال:

CODE :
{var|calc values="5,5,8"sign="+"|calcvalues="1"sign="*"}

سيقوم هذا المبدل بإجراء العملية الحسابية الأولي بجمع 5+5+8 ، ثم بعد ذلك إجراء العملية الحسابية الثانية بضرب ناتج العملية الحسابية الأولي في الرقم 1

      {string|defaultvalue="value"}

يستخدم هذا المبدل لتعيين قيمة إفتراضية في حال كانت قيمة المتغير string فارغة

 البارميترز :

  • value (إجباري): القيمة الإفتراضية التي سيتم تعيينها في حال كانت قيمة المتغير الأساسي فارغة 

مثال:

CODE :
{title|default value="Dimofinf CMS"}

      {string|replacevalues="value_before,value_after"}

يستخدم هذا المبدل لإستبدال كلمات من قيمة المتغير string.

البارميترز :

  •  values(إجباري) : تحتوي علي القيمة المراد إستبدالها و الكلمة المراد الإستبدال بها ، مفصول بينهم بفاصلة 

مثال:

CODE :
{string|replacevalues="hello,hellodimofinf"}<strong> </strong

      {string|wordwraplength="90"break="n"cut="true"}

يستخدم هذا المبدل لقسم الجملة بعد عدد معين من الأحرف ، حيث يقوم بإستدعاء دالة wordwrap من PHP. 

البارميترز :

  • length (إجباري) :عدد الأحرف ليقوم بعدها بالتقسيم.
  •  break(إختياري) : فاصل التقسيم ، إفتراضي n.
  •  cut(إختياري) :عند تعيين قيمتها إلي true  ، فيقوم إجبارياً بالتقسيم ، أي في حال كان لديك كلمة مكونة من 8 أحرف ، و أنت قمت بتحديد التقسيم بعد عدد أحرف 4 ، فسوف يقوم إجبارياً بقسم الكلمة بعد 4 أحرف و ليس إستثنائها بما أنها كلمة متصلة.

مثال:

CODE :
{string|wordwraplength="10"break="<br>"}


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

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

اقرأ أيضاً :

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

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


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

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


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

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


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

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


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

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



Online