تحديث التحكم في ظهور نسبة نتيجة الاختبار
========================================

هذا تحديث صغير مستقل يُثبت فوق آخر تحديث للاختبارات.
لا يحتوي على بقية ملفات النظام، ويستبدل فقط:

- student/exams.php
- teacher/exams.php
- admin/exams.php

طريقة التثبيت
-------------
1. ارفع ملف ZIP إلى داخل مجلد student-gateway.
2. فك الضغط داخل student-gateway مباشرة.
3. سجّل الدخول بحساب السوبر أدمن.
4. افتح الرابط:

   https://YOUR-DOMAIN/student-gateway/SMI-Percentage-Result-Toggle-Patch-2026-08-04/install.php

5. اضغط Install percentage result patch.

السلوك بعد التحديث
------------------
- يظهر في إنشاء وتعديل الاختبار لدى المعلم والأدمن خيار واضح:
  Show Percentage Automatically After Grading
- إذا كان الخيار مفعّلًا، تظهر للطالب النسبة النهائية تلقائيًا بعد اكتمال التصحيح.
- إذا احتوى الاختبار على أسئلة تحتاج تصحيحًا يدويًا، لا تظهر النسبة قبل انتهاء التصحيح كاملًا.
- هذا الخيار يعرض النسبة فقط، ولا يعرض الأسئلة أو إجابات الطالب أو الإجابات الصحيحة أو الشروحات.
- مراجعة الأسئلة والإجابات تبقى خيارًا منفصلًا باسم:
  Separate Option: Show Full Question & Answer Review
- إذا كان خيار النسبة غير مفعّل، تبقى النتيجة مخفية حتى يعتمدها المعلم أو الأدمن يدويًا.
- الاعتماد اليدوي السابق يبقى محفوظًا ولا يُلغى تلقائيًا عند تعديل إعداد الاختبار لاحقًا.

النسخة الاحتياطية
-----------------
ينشئ المثبت نسخة احتياطية من الملفات الثلاثة قبل استبدالها.
يمكن استخدام زر Rollback patch لاسترجاع الملفات السابقة.
