يرجى الانتظار ...نبذة: كما تم توضيحه سابقاً في وسم المتغيرات ، أن المبدلات هي دوال تقوم بعمل تعديلات علي قيمة المتغير قبل طباعته ، يمكنك كتابة دالة المبدل الخاصة بك لإستخدامها داخل القوالب ، عن طريق الخطوات التالية :
1.إنشاء ملف داخل مجلد include/modifiers بصيغة الإسم التالية modifier.name.php ، حيث أن name هو إسم الدالة.
2.كتابة الصيغة التالية للدالة داخل ملف الدالة :
[code] functionDimofinf_modifier_name($params){ $string = $params['string']; //الكود return $string; } [/code]
حيث name هو إسم الدالة و $params هي مصفوفة تضم الباراميترز الخاصة بالدالة التي يتم منادتها مع إستدعاء المبدل من داخل القالب ، حيث أن كل مدخل يأخد إندكس في المصفوفة $params و تكون قيمته هي القيمة المدخله ، كما أنهاتضم الاندكس String وهو الذي يحتوي علي القيمة الخاصة بالمتغير ، مع ملاحظة أنه يجب أن تقوم الدالة في النهاية بإرجاع return بالقيمة ، حيث أن $val هي مثال للقيمة المرجعة من الدالة ، مع ملاحظة أنه يمكن إستدعاء المبدلات أكثر من مره لنفس المتغير بنفس الوقت.
مبدلات مساعدة يمكن إستخدامها بالقوالب (Modifiers) :
هذه بعض المبدلات المفيدة التي قد تساعدتك في برمجيتك و القوالب :
- {var|calc values="5,5,8"sign="+"}
يستخدم هذا المبدل لإجراء عملية حسابية علي قيمة المتغير var
البارميترز :
sign(إختياري): إشارة العملية الحسابية : + للجمع ، - للطرح ، * للضرب ، / للقسمة
values(إجباري): القيم التي سيقوم بإجراء العملية الحسابية عليها
مثال:
CODE :
سيقوم هذا المبدل بإجراء العملية الحسابية الأولي بجمع 5+5+8 ، ثم بعد ذلك إجراء العملية الحسابية الثانية بضرب ناتج العملية الحسابية الأولي في الرقم 1
- {string|defaultvalue="value"}
يستخدم هذا المبدل لتعيين قيمة إفتراضية في حال كانت قيمة المتغير string فارغة
البارميترز :
value (إجباري): القيمة الإفتراضية التي سيتم تعيينها في حال كانت قيمة المتغير الأساسي فارغة
مثال:
CODE :
- {string|replacevalues="value_before,value_after"}
يستخدم هذا المبدل لإستبدال كلمات من قيمة المتغير string.
البارميترز :
values(إجباري) : تحتوي علي القيمة المراد إستبدالها و الكلمة المراد الإستبدال بها ، مفصول بينهم بفاصلة
مثال:
CODE :
- {string|wordwraplength="90"break="n"cut="true"}
يستخدم هذا المبدل لقسم الجملة بعد عدد معين من الأحرف ، حيث يقوم بإستدعاء دالة wordwrap من PHP.
البارميترز :
length (إجباري) :عدد الأحرف ليقوم بعدها بالتقسيم.
break(إختياري) : فاصل التقسيم ، إفتراضي n.
cut(إختياري) :عند تعيين قيمتها إلي true ، فيقوم إجبارياً بالتقسيم ، أي في حال كان لديك كلمة مكونة من 8 أحرف ، و أنت قمت بتحديد التقسيم بعد عدد أحرف 4 ، فسوف يقوم إجبارياً بقسم الكلمة بعد 4 أحرف و ليس إستثنائها بما أنها كلمة متصلة.
مثال:
CODE :
