الترقية من الإصدار 6 إلى 7

الإصدار الرئيسي LimeSurvey 7

تقدم هذه الصفحة نظرة عامة على التغييرات الرئيسية التي تم إدخالها في LimeSurvey 7 وروابط إلى صفحات التوثيق ذات الصلة.

  تنطبق هذه المعلومات في الغالب على LimeSurvey Community Edition (CE).

التغييرات الرئيسية في LimeSurvey 7

تعديل بنية جدول الردود وأسماء الحقول

يقدم LimeSurvey 7 تنظيمًا هيكليًا جديدًا لكيفية إنشاء جداول الردود وأسماء الحقول. يحسّن هذا التغيير الاتساق ويجعل المنصة أسهل في الصيانة والتوسعة.

للمزيد من التفاصيل، راجع: إعادة هيكلة أسماء الحقول وجدول الردود - LimeSurvey 7

محرر الأسئلة الجديد

يقدم LimeSurvey 7 أيضًا محرر أسئلة جديدًا بواجهة مستخدم محدثة وسير عمل محسّن لإنشاء الأسئلة وإدارتها.

للمزيد من التفاصيل، راجع: محرر الأسئلة الجديد في LimeSurvey 7

تغييرات واجهة RemoteControl API

تم تحسين الردود الصادرة من واجهة RemoteControl 2 API من خلال إرجاع رموز الأخطاء بالإضافة إلى نص الخطأ. يُرجى مراجعة وثائق RemoteControl 2 API للاطلاع على هذه التغييرات. بحسب طريقة تعاملك مع القيم المُرجعة، يجب أن يكون ذلك متوافقًا مع الإصدارات السابقة، ولكن قد لا تتم معالجته بشكل صحيح في تنفيذك.

للمزيد من التفاصيل، راجع: RemoteControl 2 API

تغييرات المنطقة الزمنية

في الإصدار 6 والإصدارات السابقة، كانت الطوابع الزمنية المسجلة غير محددة من حيث المنطقة الزمنية وتعتمد على تاريخ/وقت الخادم. عند الانتقال إلى الإصدار 7، يتم ترحيل إعداد 'فرق التوقيت' القديم إن أمكن، ويتم تسجيل جميع الطوابع الزمنية من الآن فصاعدًا بتوقيت UTC. لا يتم ترحيل الطوابع الزمنية القديمة. يمكن تعيين منطقة زمنية افتراضية في الإعدادات العامة، كما يمكن تعيين منطقة زمنية فردية لكل مستخدم. تنطبق هذه الإعدادات على عرض البيانات فقط. أما التصدير وواجهة RemoteControl API فتقبلان/تقدمان الطوابع الزمنية الخام فقط.

قوالب الاستبيان المخصصة

ستظل جميع قوالب الاستبيان المتوافقة مع LS6 نشطة بعد الترقية. أما إذا كان قالب الاستبيان غير متوافق مع LS6 فسيتم إلغاء تثبيته، وستتم إعادة تعيين خيارات القالب في الإعدادات العامة وإعدادات المجموعة وإعدادات الاستبيان إلى الإعدادات الافتراضية الجديدة.

استراتيجية الترقية:

1. صدّر قالب الاستبيان من التطبيق القديم
2. قبل استيراده إلى التطبيق الجديد، تأكد من ضبط وسم التوافق بشكل صحيح: https://manual.limesurvey.org/Extension_compatibility#Survey_themes
3. استورده إلى التطبيق الجديد
4. تحقق من الشيفرة التي قمت بتخصيصها لقالب الاستبيان وحدّثها وفقًا للإصدار الجديد من التطبيق الذي تريد استخدامه.
5. صدّر قالب الاستبيان المخصص المحدّث من التطبيق الجديد
6. بعد الترقية، ستظل قوالب الاستبيان المتوافقة مع LS6 نشطة بينما سيتم إلغاء تثبيت القوالب الأقدم.
7. إذا اخترت تحديث قالب استبيان، يمكنك الآن استيراده. وبعد التأكد من تحديثه بشكل صحيح، يمكنك اختيار حذف القالب القديم.

قوالب الإدارة المخصصة

سيتم تفعيل قالب الإدارة الافتراضي بشكل افتراضي. ستبقى القوالب المخصصة دون تغيير، ولكن لا يمكن إعادة تفعيلها ما لم يتم تحديثها.

للتطبيق المستضاف ذاتيًا:

1. قبل نسخ قالب الإدارة إلى التطبيق الجديد، تأكد من ضبط وسم التوافق بشكل صحيح: https://manual.limesurvey.org/Extension_compatibility#Admin_themes
2. انسخ قالب الإدارة الحالي من التطبيق القديم إلى التطبيق الجديد https://manual.limesurvey.org/Custom_Admin_Themes
3. تحقق من الشيفرة التي قمت بتخصيصها لقالب الإدارة وحدّثها وفقًا للإصدار الجديد من التطبيق الذي تريد استخدامه.
4. بعد ترقية تطبيقك القديم، يتم عرض قالب الإدارة الجديد لدينا بشكل افتراضي. لتحديث قالب الإدارة الذي ثبّتّه سابقًا، يمكنك إما:
   • تحديث شيفرة قالب الإدارة المميز حاليًا على أنه غير متوافق يدويًا
   • حذف قالب الإدارة القديم وتثبيت القالب الجديد الذي قمت بتحديثه سابقًا في بيئة الاختبار الخاصة بك.

لمستخدمي Cloud:
يُرجى التواصل مع فريق الدعم لدينا.

قوالب الأسئلة المخصصة

لا يمكن تثبيت قوالب الأسئلة المخصصة التي لا تتوافق مع الإصدار الحالي، لكنها ستظل نشطة بعد الترقية. يمكنك العثور على مزيد من المعلومات حول قوالب الأسئلة هنا: قوالب الأسئلة. كما أن شيفرة JavaScript المخصصة المضافة إلى قالب الاستبيان أو إلى أي من الأسئلة في الاستبيان قد لا تعمل بعد الآن.

ترقية قالب السؤال المخصص الخاص بك:

1. نزّل قالب السؤال من أحد المواقع أو صدّر قالب السؤال الحالي
2. قبل التحميل، تأكد من أن توافق قالب السؤال المخصص مضبوط بشكل صحيح
3. حاول تحميل قالب السؤال إلى التطبيق الجديد.
4. إذا كان قالب السؤال من إنشائك، فقم بإجراء التعديلات اللازمة
5. بعد التحميل بنجاح، يُرجى التحقق من ظهور قالب السؤال وعمله كما هو متوقع.

ترقية قالب لا تملكه:
تحقق مما إذا كان هناك تحديث متاح من الموقع أو المطور الذي وفّره

البرامج المساعدة المخصصة

سيتم تعطيل البرامج المساعدة المخصصة التي لا تتوافق مع الإصدار الحالي أثناء عملية الترقية.

للتطبيق المستضاف ذاتيًا:

1. تحقق مما إذا كان يمكن تثبيت البرنامج المساعد على الإصدار الجديد.
2. حدّث البرنامج المساعد أو تواصل مع مؤلفه لتحديثه.
3. استبدل ملفات البرنامج المساعد يدويًا بالملفات الجديدة في تطبيقك مما سيحافظ على الإعدادات، أو ألغِ تثبيت الإصدار القديم وأعد تثبيت الإصدار الجديد، وفي هذه الحالة سيتعين عليك إعادة إدخال جميع الإعدادات.

لمستخدمي Cloud:

1. سيظل LimeSAML نشطًا
2. تحقق مما إذا كان يمكن تثبيت البرنامج المساعد على الإصدار الجديد.
3. حدّث شيفرة البرنامج المساعد أو تواصل مع مؤلفه لتحديثه.
4. خيارات التثبيت:
   • ألغِ تثبيت الإصدار القديم وأعد تثبيت الإصدار الجديد (ستفقد جميع الإعدادات وسيتعين إعادة تطبيقها)
   • تواصل مع الدعم لإجراء تحديث للبرنامج المساعد دون فقدان بيانات التكوين

المتطلبات

	LimeSurvey 6	LimeSurvey 7
PHP	7.4 أو أحدث	8.1 أو أحدث (يوصى بـ 8.3)
MySQL	8.0 أو أحدث	8.0 أو أحدث
MariaDB	10.3.38 أو أحدث	10.3.38 أو أحدث
PostgreSQL	12 أو أحدث	14 أو أحدث
MSSQL	2016 أو أحدث	2019 أو أحدث
تنسيق URL	get أو path	path، وهو مطلوب للمحرر الجديد

لا تحتاج إلى Node.js أو npm. المحرر الجديد مضمن في حزمة LimeSurvey وجاهز للاستخدام.

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

خطط لفترة صيانة. يحوّل LimeSurvey الموقع إلى وضع الصيانة أثناء تحديث قاعدة البيانات، وقد يستغرق ذلك بعض الوقت في التثبيتات التي تحتوي على عدد كبير من بيانات الردود.

موصى به: استخدم خدمة ComfortUpdate لدينا

أسهل وأأمن طريقة للترقية هي استخدام خدمة ComfortUpdate لدينا. فهي تقوم بتنزيل الإصدار الجديد وتثبيته نيابةً عنك، لذلك لا تحتاج إلى استبدال أي ملفات يدوياً.

إذا كنت تفضل الترقية يدوياً، فاتبع الخطوات التالية بدلاً من ذلك.

الترقية يدوياً

1. قم بعمل نسخة احتياطية من ملفاتك وقاعدة بياناتك، وضع الموقع في وضع الصيانة.
2. احتفظ بالملفات والمجلدات التالية من التثبيت القديم:
   • application/config/config.php
   • application/config/security.php
   • application/config/allowed_hosts.php
   • مجلد upload/، الذي يحتوي على ملفاتك المحمّلة وقوالب المستخدم والبرامج المساعدة الخاصة بالمستخدم
   • مجلد plugins/، إذا قمت بتثبيت برامج مساعدة فيه يدوياً
3. قم بتنزيل حزمة LimeSurvey 7 وحدّث التثبيت باستخدام إحدى الطرق التالية:
   1. احذف الملفات القديمة أولاً. انقل الملفات المذكورة أعلاه بعيداً، واحذف كل شيء آخر في مجلد LimeSurvey، ثم فك ضغط الحزمة الجديدة فيه وأعد الملفات المحتفظ بها إلى مكانها.
   2. أو انسخ الملفات الجديدة فوق القديمة. فك ضغط الحزمة الجديدة فوق التثبيت الحالي واسمح لها باستبدال الملفات الموجودة، مع ترك الملفات المذكورة أعلاه دون تغيير.
4. مع أي من الخيارين، استخدم ملف .htaccess الجديد من الحزمة، لأن ملف الإصدار 6.x لا يعمل مع المحرر الجديد. بعد ذلك، أفرغ مجلد tmp/runtime/ حتى لا تبقى أي بيانات مخزنة مؤقتاً من الإصدار 6.
5. اضبط تنسيق URL على path في ملف application/config/config.php.
6. تأكد من أن خادم الويب لديك يقدم مجلد /editor/ مباشرة ويمرر رأس Authorization إلى PHP. مزيد من التفاصيل: New Question Editor in LimeSurvey 7
7. شغّل تحديث قاعدة البيانات. يكتشف LimeSurvey إصدار قاعدة البيانات الأقدم ويعرض ترقيتها. قم بالتأكيد واتركه ينتهي دون مقاطعته.
8. عند اكتمال العملية، أوقف وضع الصيانة وراجع قائمة التحقق أدناه.

بعد الترقية

• تحقق من رقم الإصدار في تذييل صفحات الإدارة.

• أعد تنشيط البرامج المساعدة التي تحتاجها، واحداً تلو الآخر.

• افتح استبياناً وتأكد من تحميل المحرر الجديد.

• شغّل رداً تجريبياً كاملاً واحداً في كل استبيان نشط، بحيث يشمل الشروط والحصص والبريد الإلكتروني والرابط النهائي.

استكشاف الأخطاء وإصلاحها

رسالة "Action needed" بشأن تنسيق URL. لا يزال تنسيق URL هو get. غيّره إلى path وامسح محتويات tmp/runtime/.

يتم تحميل المحرر ولكنه يبقى فارغاً. رأس Authorization لا يصل إلى PHP.

يعرض /editor/ صفحة LimeSurvey أو خطأ "لم يوجد". تحقق من إعدادات خادم الويب وتأكد من أن مجلد /editor/ يُقدَّم مباشرة بدلاً من توجيهه عبر LimeSurvey.

"You cannot use this theme with the new question editor". يستخدم الاستبيان قالباً غير مبني على fruity_twentythree. بدّل القالب، أو تابع في المحرر الكلاسيكي.

يتسبب برنامج مساعد في حدوث أخطاء بعد إعادة تنشيطه. إنه غير متوافق مع LimeSurvey 7. قم بإلغاء تنشيطه وتواصل مع القائم على صيانته.

ملاحظات

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