اجعل البرنامج المساعد الخاص بك متوافقًا مع LS4
From LimeSurvey Manual
التغييرات التقنية
ملف إعدادات XML الجديد
منذ الإصدار LimeSurvey 4.0، تحتاج البرامج المساعدة إلى ملف إعدادات XML لكي يتم تشغيلها في التطبيق.
والسبب في ذلك هو إمكانية تخزين البيانات الوصفية مثل مؤلف البرنامج المساعد، والبريد الإلكتروني للدعم، أو معلومات المحدِّثين.
هذا الملف بصيغة XML إلزامي في LimeSurvey 4. ويجب أن يكون موجودًا في المجلد الرئيسي للبرنامج المساعد. لمزيد من المعلومات، راجع تطوير البرامج المساعدة البرامج المساعدة
مثال:
المجلد الجديد للبرنامج المساعد
تم تغيير مجلد البرامج المساعدة في LimeSurvey 4. لأسباب أمنية، يقع مجلد البرامج المساعدة الآن داخل مجلد التحميل (/upload/plugins) بسبب مدير البرامج المساعدة الجديد (أداة تحميل البرامج المساعدة). بالنسبة للتحميل اليدوي، نوصي بتحميل ملفاتك إلى المجلد الجديد لتجنب حدوث أعطال في البرنامج.
تأكد من تغيير المجلد الجديد أو إضافته إذا كان مكتوبًا بشكل ثابت في الشيفرة البرمجية للبرنامج المساعد الخاص بك.
مثال:
أحداث البرامج المساعدة الجديدة
تم إهمال بعض أحداث البرامج المساعدة من LS3. استخدم أحداث البرامج المساعدة الجديدة التي تم تقديمها في LS4 لاستبدال الأحداث القديمة. لمزيد من المعلومات، راجع دليل التطوير لدينا حول أحداث البرامج المساعدة.
الدوال والطرق المهملة
نظرًا لتغير قاعدة الشيفرة البرمجية وبنية LimeSurvey 4، هناك الكثير من الطرق والدوال التي لم تعد مستخدمة. ولحل هذه المشكلة، عليك أولًا تفعيل وضع التصحيح في ملف config.php ثم الانتقال إلى صفحة البرامج المساعدة. ستظهر أي طريقة لم تعد موجودة في صفحة الخطأ.
تمت إعادة تسمية بعض الطرق في LS4 أو لم تعد مستخدمة. للتأكد من أن البرنامج المساعد الخاص بك يعمل مع كل من LS3 وLS4، تحقق من إصدار LS قبل استدعاء الطريقة التي تحتاجها.
مثال:
أفضل الممارسات
تجنب ملفات SVG
لأسباب أمنية (XSS)، لا يمكن تحميل ملفات SVG. ستتجاهل أداة تحميل البرامج المساعدة ملفات SVG. استبدلها بملفات PNG أو JPEG. يمكن تحميل ملفات SVG فقط إذا كان لديك وصول إلى مجلد التثبيت عبر FTP أو أدوات الخادم الأخرى (قم بتحميل أي ملفات على مسؤوليتك الخاصة).
تجنب الثوابت العامة
تجنب استخدام الثوابت العامة التي قد تتعارض مع متغيرات التطبيق الأساسي أو البرامج المساعدة الأخرى مثل „ROOT_PATH“. لا تستخدم الثوابت العامة بشكل عام عند تطوير البرامج المساعدة.
استخدم مساحات الأسماء
استخدم مساحات الأسماء (namespaces) لتنظيم أفضل من خلال تجميع الفئات التي تعمل معًا لأداء مهمة في البرنامج المساعد الخاص بك. بهذه الطريقة تتجنب استخدام فئات مستخدمة بالفعل في التطبيق الأساسي.
مثال:
