شروحات تصميم ستايل ديموفنف - الدوال والمبدلات

فهرس الدوال والمبدلات

هذا الفهرس عبارة عن مرجع لجميع الدوال والمبدلات التي تم تنفيذها مسبقًا والمدعومة بشكل كامل داخل نظام قوالب ديموفنف 4 ، والتي تتيح للمطورين استخدام وتعديل المتغيرات المتاحة لديهم بعدة طرق مختلفة على حسب الحاجة.

ماهي المبدلات ( Modifiers ) ؟

هي عبارة عن مجموعة من الدوال المعدة مسبقًا داخل نظام البرمجة الخاص بديموفنف ، وتستخدم في التعديل على القيمة الحالية للمتغير لاستخراج قيمة أخرى ، أو لإعادة تنسيق شئ معين بها ,
على سبيل المثال , يمكنك باستخدام المبدلات تحديد عدد أحرف معينة لمتغير , وتنفيذ عملية حسابية على مجموعة من المتغيرات ، كما يمكنك استبدال النصوص .

ماهي الدوال ( Functions ) ؟

هي عبارة عن مجموعة من الدوال المعدة مسبقًا داخل نظام البرمجة الخاص بديموفنف ، وتستخدم في استعراض قيمة أو عرضها بشكل معين ,
على سبيل المثال , يمكنك باستخدام الدوال جلب الرابط الخاص بالمحتوى أو بالقسم , ويمكنك التبديل بين قيمتين أو أكثر داخل بلوك التكرار , كما يمكنك اختيار ألوان عشوائية .

المبدلات ( Modifiers )

مبدل العمليات الحسابية {calc}

يستخدم هذا المبدل في تنفيذ عمليات حسابية على المتغير الحالي , حيث يمكنه جمع قيمة عدد أو أكثر على القيمة الحالية للمتغير

مثال

						
							{value|calc values="$param[var1]"} // 1+(5)=6
							
							{$var[value]|calc name="row" values="5,5,8" sign="+"} // 1+(5+5+8)=19
							
							{$var.value|calc name="row" values="$var[value1],$var[value2],8" sign="+"|calc values="3" sign="-"} // 1+(5+8)=15 then 15-3=12
							
							{value|calc name="row" values="$var[value1],$var[value2]" sign="*"} // 2*(5*3)=20

الوصف	المتغير
اسم العملية الحسابية ( اختياري )	name
القيم التي سيتم تنفيذ العملية الحسابية عليها ، ويفصل بينها بفاصلة ( , )	values
العلامة الحسابية التي سيتم تطبيقها على القيم المدرجة ( العلامة الافتراضية " + " )	sign

مبدل الطباعة بأحرف كبيرة {capitalize}

يستخدم هذا المبدل بتحويل حالة الاحرف للمتغير المرسل الي أحرف كبيره

مثال

						
							{$string|capitalize values="uc_digits,lc_rest"} // Default -> values="false,false"
							// Example
							{$size|capitalize values="true,false"} // result -> From: x12kb   To: X12KB 
							{$caption|capitalize values="false,true"} // result -> Text like this

الوصف	المتغير
متغير من النوع boolean حيث يحتمل فقط القيم ( true / false ) ويقوم بتحويل الحروف في حالة احتوائها على أرقام إلى حروف كبيرة	uc_digits
متغير من النوع boolean حيث يحتمل فقط القيم ( true / false ) ويقوم بتحويل الحرف الأول من النص إلى حرف كبير ، وتحويل باقي حروف النص إلى حروف صغيرة	lc_rest

مبدل الطباعة بأحرف صغيرة {strtolower}

يقوم هذا المبدل بتحويل النص الموجود إلى حروف صغيرة

مثال

						
							{string|strtolower}

مبدل فلترة النص {escape}

يقوم هذا المبدل بفلترة النص بناءً على القيم المرسلة له , حيث يمكنه -على سبيل المثال- فلترة أكواد الـ html والجافا سكربت ، وكذلك علامات التنصيص

مثال

						
							{$string|escape esc_type="html"}
							{$string|escape esc_type="html" char_set="LANG_CHARSET"}

الوصف	المتغير
متغير خاص بنوعية الفلتر المطلوب تطبيقه على النص ، ويمكن إعطاؤه إحدى هذه القيم (html , htmlall , url , urlpathinfo , quotes , hex , hexentity , decentity , javascript , mail , nonstd)	esc_type
متغير خاص بنوعية الترميز المطلوب أخذه في الاعتبار لهذا النص	char_set

مبدل الاستبدال {replace}

يقوم هذا المبدل بالبحث عن القيمة المطلوب استبدالها ، ومن ثم تغييرها بقيمة الاستبدال

مثال

						
							{$string|replace values="hello,hello dimofinf"}
							{$string|replace values="$value1,$value2"}
							{$string[name]|replace values="$value[name1],$value[name2]"}
							{$string|replace name="myreplace" delimiter="," values="hello,hello dimofinf"}

الوصف	المتغير
الاسم الخاص بعملية الاستبدال ( اختياري )	name
القيمة التي سيقوم المبدل بالبحث عنها ، وقيمة الاستبدال	values
العلامة التي سيتم من خلالها الفصل بين القيمة المطلوب استبدالها وقيمة الاستبدال ( الافتراضي " , " )	delimiter

مبدل اقتصاص النصوص {truncate}

يقوم هذا المبدل بقص النص الخاص بالمتغير وبطباعة عدد أحرف معينة منه

مثال

						
							{$string|truncate value="120"}
							{$string|truncate value="120" etc="..."}
							{$string|truncate value="120" etc="" break_words="true"}
							{$string|truncate value="120" etc="..." middle="true"}

الوصف	المتغير
عدد الأحرف المطلوب ألا يزيد النص عنها	value
متغير من النوع (Boolean) ويقوم بقص النص بعد عدد معين من الأحرف ، حتى إذا تضمن الأمر قطع الكلمة نفسها ( الافتراضي : flase )	break_words
متغير من النوع (Boolean) ويقوم بقص منتصف النص لتصبح النتيجة محتفظة بجزء من بداية النص وجزء من نهاية النص ( الافتراضي : flase )	middle

مبدل عدد أحرف السطر الواحد {wordwrap}

يقوم هذا المبدل بتحديد عدد الأحرف المطلوب إظهارها في السطر الواحد ، كما يقوم بتحديد نوعية الكسر التي سيتم تنفيذها في نهاية كل سطر

مثال

						
							{$string|wordwrap length="90"} 
							{$string|wordwrap length="90" break="
"} 
							{$string|wordwrap length="90" break="\n" cut="true"}

الوصف	المتغير
عدد الأحرف المطلوب ألا يزيد عنها السطر الواحد	length
يقوم هذا المتغير بتحديد القيمة المراد الفصل بها بين كل سطر وآخر	break
متغير من النوع (Boolean) ويقوم بقص السطر وإنهائه عند عدد معين من الأحرف ، حتى إذا تضمن الأمر قطع الكلمة نفسها ( الافتراضي : flase )	cut

مبدل التبادل {alternate}

يقوم هذا المبدل بعملية تبادل بين القيم المعطاه ويتم وضعه داخل بلوك التكرار للتبادل بين القيم مع كل عملية تكرار للبلوك

مثال

						
							{function:alternate values="alt1,alt2"}
							{function:alternate reset="true" values="#eeeeee,#d0d0d0d"}
							{function:alternate name="row" values="one,two,three" reset="true"}
							{function:alternate name="blockname" values="one,two,three"}

الوصف	المتغير
الاسم الخاص بعملية التبادل , ويجب إعطاء اسم موحد لكل عملية في حالة استخدامه أكثر من مرة داخل نفس بلوك التكرار	name
العلامة التي سيتم من خلالها الفصل بين القيم المطلوب التبادل بينها ( الافتراضي " , " )	delimiter
متغير من النوع (Boolean) ويقوم بقص السطر وإنهائه عند عدد معين من الأحرف ، حتى إذا تضمن الأمر قطع الكلمة نفسها ( الافتراضي : flase )	cut

الدوال ( Functions )

هي عبارة عن مجموعة من الدوال المعدة مسبقًا داخل نظام البرمجة الخاص بديموفنف ، وتستخدم في استعراض قيمة أو في عرضها بشكل معين ,
على سبيل المثال , يمكنك باستخدام الدوال جلب الرابط الخاص بالمحتوى أو بالقسم , كما يمكنك التبديل بين قيمتين أو أكثر داخل بلوك التكرار , واختيار ألوان عشوائية .

دالة العمليات الحسابية {calc}

تقوم هذه الدالة بإجراء عمليات حسابيه على القيمة المعطاه ويمكن لهذه القيم ان تكون قيم ثابته او متغيره

مثال

						
							{function:calc values="1,5"} // 1+5=6
							{function:calc name="row" values="1,5,8" sign="+"} // 1+5+8=15
							{function:calc name="row" values="1,5,8" sign="+":calc values="$var.value" sign="-"} // 1+5+8=15 then 15-3=12
							{function:calc name="row" values="$var[value1],$var[value2]" sign="*"}

الوصف	المتغير
اسم العملية الحسابية ( اختياري )	name
القيم التي سيتم تنفيذ العملية الحسابية عليها ، ويفصل بينها بفاصلة ( , )	values
العلامة الحسابية التي سيتم تطبيقها على القيم المدرجة ( العلامة الافتراضية " + " )	sign
العلامة التي سيتم من خلالها الفصل بين القيمة المطلوب تنفيذ العملية الحسابية عليها ( الافتراضي " , " )	delimiter

دالة جلب الروابط {getpermalink}

تقوم هذه الدالة بجلب الروابط بناءً على الإعدادات المحددة لها , حيث يوجد أكثر من احتمال لنتيجة الطباعة بناءً على هيئة الروابط المحددة يإعدادات برنامج ديموفنف

مثال

						
							{function:getpermalink file="albums"}
							{function:getpermalink file="news" args="action=s&id=1"}
							{function:getpermalink file="news" args="action=s&id=1" outputfiletype="xml" }
							{function:getpermalink file="news" args="action=s&id=1" default="true"}

الوصف	المتغير
اسم الملف المراد جلب الرابط الخاص به بناءً على الطباعة الناتجة عن الثابت THIS_SCRIPT	module
سلسلة الاستعلامات التي سيتم تنفيذها ؛ ويتم كتابتها بدون ( ? )	args
يقوم بتحديد نوعية الملف المطلوب , وفي حالة وجوده يجب تحديد نوع الملف	outputfiletype
عند إعطائه القيمة ( true ) سيقوم بطباعة الصيغة الافتراضية للرابط كسلسلة استعلامات ( Query_String )	default

دالة توليد ألوان عشوائية {randomcolor}

تقوم هذه الدالة بتوليد أكواد ألوان عشوائية ، ويمكنك استخدامها لأغراض متعددة ( مثال : وضع نص تنبيهي يتم تغيير لونه مع كل تحديث للصفحة )

مثال

						
							// OUTPUT COLOR HEX CODES without (#) Like -> 42E91D
							{function:randomcolor}

الإعدادات الخاصة ( Custom Settings )

الإعدادات الخاصة بالستايل ( Custom Settings )

يمكنك إضافة عدد لا نهائي من الإعدادات الخاصة بالستايل ، واستخدامها في قوالب الستايل الخاص بك لإضافة المزيد من الحيوية والسلاسة للعميل في تحكمات الستايل ؛ ويوجد أنواع كثيرة
على سبيل المثال ( Text input , Textarea , Yes/No , Select Input , ColorSelector ... etc )

الملفات الخاصة بإعدادات الستايل

الوصف	الملف
يحتوي على الإعدادات الخاصة بالستايل	options/options.xml
ملف اللغة الإنجليزية الخاص بإعدادات الستايل	options/language.xml
ملف اللغة العربية الخاص بإعدادات الستايل	options/ar-language.xml

وفي داخل نفس المجلد تجد ملفين باسم (dimcp.css , dimcp.js) وهي ملفات يتم استدعاؤها في اللوحة بشكل عام ، ويمكنك من خلالها إضافة أي تنسيقات ، أو تنفيذ أي أكواد جافا سكربت ، ليتم تطبيقها في أي مكان باللوحة ، ولا يقتصر فقط على صفحة إعدادات الستايل

بنية ملف options.xml

الوصف	اسم المتغير
هذا المتغير يخص أي تنسيقات أو أي أكواد جافا سكربت سيتم استخدامها ضمن الإعدادات	<headeroptions>
- هذا المتغير يخص أي تضمينات لملفات الجافا سكربت أو ملفات الـ css	- <jscripts>
- يمكنك هذا المتغير من إضافة أكواد جافا سكربت بشكل مباشر داخل ملف الإعدادات	- <jscode>
- يمكنك هذا المتغير من إضافة أكواد css بشكل مباشر داخل ملف الإعدادات	- <stylecss>
- هذا المتغير يخص الإعدادات والمتغيرات التي ستتم صياغتها والتعامل معها	<optiongroups>
- هذا المتغير مسؤول عن وضع مجموعة من الإعدادات ضمن جروب معين وإحاطته بهيدر مختلف	- <optiongroup>
- - هذا المتغير مسؤول عن صياغة الإعداد نفسه ، ويتم تكراره أكثر من مرة على حسب العدد المطلوب ( ويتم وضع قيمة المتغير المطلوب عن طريق varname="my_variable" )	- - <option>
- - - يقوم بتحديد نوعية الأوبشن المطلوب صناعته ، ويأخذ إحدى هذه القيم ( Y , T , TN , S )	- - - <datatype>
- - - يقوم بوضع القيمة الافتراضية للمتغير	- - - <defaultvalue>
- - - يتم استخدامه في حالة صناعة إعدادات من النوع ( Select Input ) ويتم وضع القيم المطلوبة داخله	- - - <optioncode>

بنية ملف language.xml

الوصف	اسم المتغير
يتضمن هذا التاج جميع العبارات التي سيتم إظهارها في لوحة الإعدادات	<phrases>
- مسؤول عن صناعة العبارة لكل متغير يتم إضافته عن طريق القيمة name="varname_1" حيث إن varname_1 هو اسم المتغير الموجود بملف الإعدادات options.xml	- <phrase >

وكذلك بخصوص ملف اللغة العربية ، حيث إنه يخضع لنفس البنية الموجودة بملف اللغة الإنجليزية