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

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

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 :