Skip to content

Natiga Script [Excel Version], is an easy to use php script that imports student scores from excel sheet and provide a user friendly interface to lookup these data. (Designed for schools that wish to publish student scores online in an elegant way)

License

Notifications You must be signed in to change notification settings

natiga-script/natiga-script-excel

Repository files navigation

##

سكربت نتائج الطلاب

سكربت نتائج الطلاب هو تطبيق مبني بلغة 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)

إعداد ملف الـExcel

غالبا لن يحتاج ملف الإكسل الخاص بك إلى إعدادات خاصة ليتم قراءته بواسطة التطبيق ولكن لضمان الحصول على أفضل نتيجة تأكد من وجود الآتي

  • تأكد من وجود 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;
    لن تحتاج إلى تعديل قيمة هذا الحقل ولكن من مبدأ العلم بالشئ. عند تعيين قيمة أيّ خلية إلى هذه القيمة. سيتم عرض هذا العمود كفاصل وليس كمادة أي لن تظهر درجات هذا العمود لهذا الطالب

About

Natiga Script [Excel Version], is an easy to use php script that imports student scores from excel sheet and provide a user friendly interface to lookup these data. (Designed for schools that wish to publish student scores online in an elegant way)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages