##
سكربت نتائج الطلاب هو تطبيق مبني بلغة php يسهل على مديري مواقع المدارس إضافة نتائج الطلاب وعرضها بشكل سهل وبسيط
هذا التطبيق مجاني، يمكنك تعديله وإعادة نشره تحت رخصة GNU. نشارك هذا السكربت على أمل أن تعم الفائدة لكن لا نتحمل أية مسؤولية أو أية ضمانات لاستخدامك، اطلع على تفاصيل رخصة GNU للمزيد من المعلومات عبر الملف `LICENSE.txt` وللمزيد من المعلومات:
- . - .ملحوظة: هذا التطبيق قد لا يمثل الحل الأمثل لعرض بيانات الطلاب على الإنترنت فقد تم بناؤه بشكل سريع لمساعدة من لا يملكون الموارد لتنفيذ نظم خاصة بهم على أمل أن يتم تحسينه مستقبلًا
- إمكانية استيراد النتيجة من ملف Excel مباشرة
- إمكانية البحث باستخدام الاسم أو رقم الجلوس
- التحكم في طرق البحث المسموح بها
- عرض درجات كلّ مادة بشكل منفصل
- تصميم انسيابي متوافق مع مختلف أحجام الشاشات
1. قم بنسخ ملفات التطبيق إلى الخادم (السيرفر)
2. باستخدام متصفحك، قم بالتوجه إلى صفحة installer.php ستظهر بالشكل الآتي
![الواجهة](readme_files/install000.JPG?raw=true)3.قم بالضغط على زر رفع ملف واختر ملف الـExcel الذي يحتوي على النتيجة المراد عرضها
![رفع الملف](readme_files/install001.JPG?raw=true)4.قم باختيار ورقة العمل التي تحتوي على البيانات، ثم اختر الأعمدة المناسبة كما هو موضح بالصورة
![اختيار البيانات](readme_files/install002.JPG?raw=true)5.قم بكتابة البيانات اللازمة للتواصل بقاعدة البيانات ثم اضغط تثبيت
![بيانات قاعدة البيانات](readme_files/install003.JPG?raw=true)6.إذا تمت الخطوات السابقة بشكل صحيح من المفترض أن ترى هذه الصفحة في النهاية ^_^
![النهاية](readme_files/install004.JPG?raw=true)غالبا لن يحتاج ملف الإكسل الخاص بك إلى إعدادات خاصة ليتم قراءته بواسطة التطبيق ولكن لضمان الحصول على أفضل نتيجة تأكد من وجود الآتي
- تأكد من وجود 3 أعمدة أساسية في ملف الإكسل الخاص بك وهي (الاسم، رقم الجلوس، الصف الدراسي) حتى وإن كنت لا تنوي تفعيل البحث بالاسم أو رقم الجلوس سيمكنك تعديل ذلك لاحقًا في إعدادات الموقع
- تأكد من وجود عمود لكل مادة دراسية حتى وإن لم تكن مقررة على هذا الصف وسيتم شرح كيفية إخفاء المواد الغير مقررة لاحقا
- إذا كنت تريد إضافة فواصل بين المواد كما هو موضح بالصورة تأكد أيضا من إضافته كعمود مستقل
لن تحتاج إلى تعديلات كثيرة، فقط تأكد من خلو هذا العمود من أيّ درجات لهذا الصف وسيقوم التطبيق بتجاهل هذه المادة مثال في الصورة التالية ستجد أنّ هناك صفين لشعبتين مختلفتين (علمي علوم، علمي رياضيات) ستجد أنّ خانة مادة الرياضيات فارغة بالنسبة للفرقة التي تدرس علمي علوم وبالتالي لن يتم عرضها في درجاتهم وبالمثل لمادة الأحياء للفرقة التي تدرس علمي رياضيات فلن يتم عرضها أيضا
![المواد الغير مقررة](readme_files/excel_example000.JPG?raw=true)
يمكنك التطبيق من تغيير عدد من الخيارات لسهولة التحكم في الموقع
لتعديل إعدادات الموقع قم بالتعديل على الخيارات الموجودة في ملف includes/site_config.php
وهي كالآتي
$_CONFIG['allow_partial_names'] = true;
يمكنك هذا الخيار من تفعيل/تعطيل البحث بجزء من الاسم بدلا عن الاسم كاملا قم باستبدال القيمة بـ
true
للتفعيل أوfalse
للتعطيل$_CONFIG['allow_partial_grades'] = false;
يمكنك هذا الخيار من تفعيل/تعطيل البحث بجزء من اسم الصف/الفرقة بدلا عن الاسم كاملا قم باستبدال القيمة بـtrue
للتفعيل أوfalse
للتعطيل$_CONFIG['allow_search_all_grades'] = false;
يمكنك هذا الخيار من تفعيل/تعطيل إمكانية البحث عن الطالب في كافة الصفوف قم باستبدال القيمة بـtrue
للتفعيل أوfalse
للتعطيل$_CONFIG['search_by'] = 6;
يمكنك هذا الخيار من تحديد طريقة البحث عن الطالب (بالاسم، رقم الجلوس، أو كليهما) قم باستبدال القيمة بـ2
للبحث برقم الجلوس فقط4
للبحث بالاسم فقط6
للبحث بالاسم أو رقم الجلوس
$_CONFIG['site_title'] = 'نتيجة المدرسة';
يمكنك هذا الخيار من التحكم في العنوان الذي يظهر في المتصفح فم باستبداله بالقيمة التي تناسبك$_CONFIG['template_assets_url'] = 'http://natiga-script.cf/templates/assets/';
قم بتعديل هذا الخيار إلى رابط موقعك، متبوعًا بمسار تثبيت التطبيق، متبوعا بمسار ملفات قالب التصميم 'templates/assets/'
فعلى سبيل المثال إذا كان رابط موقعك هو example.com وقمت بتثبيت التطبيق في مجلد natiga-script فسيكون الرابط'http://example.com/natiga-script/templates/assets/'
$_CONFIG['is_production_env'] = true;
تعطيل هذا الخيار يسمح بعرض كافة الأخطاء التي تحدث في التطبيق. قم باستبدال القيمة بـtrue
للتفعيل أوfalse
للتعطيل$_CONFIG['memory_limit'] = '1024M';
يتحكم هذا الخيار في مساحة الذاكرة المسموح بها للتطبيق، في بعض الحالات النادرة قد تحتاج إلى تعديل قيمة هذا الخيار إذا كان حجم ملف الإكسل ضخم جدًا$_CONFIG['allowed_file_ext'] = ...;$_CONFIG['allowed_file_mime']=...;
يتحكم هذين الخيارين في أنواع الملفات المسموح برفعها على الموقع . يفضل تركها كما هي لأسباب أمنية$_CONFIG['magic_number'] = 0.0123456789;
لن تحتاج إلى تعديل قيمة هذا الحقل ولكن من مبدأ العلم بالشئ. عند تعيين قيمة أيّ خلية إلى هذه القيمة. سيتم عرض هذا العمود كفاصل وليس كمادة أي لن تظهر درجات هذا العمود لهذا الطالب