
##<div dir="rtl"> سكربت نتائج الطلاب</div>
<p dir="rtl">سكربت نتائج الطلاب هو تطبيق مبني بلغة php يسهل على مديري مواقع المدارس إضافة نتائج الطلاب وعرضها بشكل سهل وبسيط</p>

<p dir="rtl">هذا التطبيق مجاني، يمكنك تعديله وإعادة نشره تحت رخصة GNU. نشارك هذا السكربت على أمل أن تعم الفائدة لكن لا نتحمل أية مسؤولية أو أية ضمانات لاستخدامك، اطلع على تفاصيل رخصة GNU للمزيد من المعلومات عبر الملف `LICENSE.txt` وللمزيد من المعلومات:</p>
- <http://www.gnu.org/licenses/>.
- <http://opensource.org/licenses/>.

<p dir="rtl"><em>ملحوظة: هذا التطبيق قد لا يمثل الحل الأمثل لعرض بيانات الطلاب على الإنترنت فقد تم بناؤه بشكل سريع لمساعدة من لا يملكون الموارد لتنفيذ نظم خاصة بهم على أمل أن يتم تحسينه مستقبلًا</em></p>

<br/>

### <div dir="rtl"> المحتويات</div>
<div dir="rtl">
<ul>
<li><a href="#features">مميزات التطبيق</a></li>
<li><a href="#screenshots">صور من التطبيق</a></li>
<li><a href="#installation">طريقة التثبيت</a></li>
<li><a href="#sheet_structure">إعداد ملف الـExcel</a></li>
<li><a href="#site_configuration">إعدادات الموقع</a></li>
</ul>
</div>

#### <div dir="rtl"><a href="http://natiga-script.cf">مثال حي للتطبيق</a></div>
---

### <div dir="rtl"> <a name="features"></a>مميزات التطبيق</div>

<div dir="rtl"><ul>
<li>إمكانية استيراد النتيجة من ملف Excel مباشرة</li>
<li>إمكانية البحث باستخدام الاسم أو رقم الجلوس</li>
<li>التحكم في طرق البحث المسموح بها</li>
<li>عرض درجات كلّ مادة بشكل منفصل</li>
<li>تصميم انسيابي متوافق مع مختلف أحجام الشاشات</li>
</ul></div>

###  <div dir="rtl"> <a name="screenshots"></a> صور من التطبيق</div>

![الواجهة](readme_files/screen001.JPG?raw=true)
![البحث](readme_files/screen002.JPG?raw=true)
![النتيجة](readme_files/screen003.JPG?raw=true)

###  <div dir="rtl"> <a name="installation"></a>طريقة التثبيت</div>

<p dir="rtl">1. قم بنسخ ملفات التطبيق إلى الخادم (السيرفر) </p>
<p dir="rtl">2. باستخدام متصفحك، قم بالتوجه إلى صفحة installer.php ستظهر بالشكل الآتي</p>
![الواجهة](readme_files/install000.JPG?raw=true)
<br/>
<p dir="rtl">3.قم بالضغط على زر رفع ملف واختر ملف الـExcel الذي يحتوي على النتيجة المراد عرضها</p>
![رفع الملف](readme_files/install001.JPG?raw=true)
<br/>
<p dir="rtl">4.قم باختيار ورقة العمل التي تحتوي على البيانات، ثم اختر الأعمدة المناسبة كما هو موضح بالصورة</p>
![اختيار البيانات](readme_files/install002.JPG?raw=true)
<p dir="rtl">5.قم بكتابة البيانات اللازمة للتواصل بقاعدة البيانات ثم اضغط تثبيت</p>
![بيانات قاعدة البيانات](readme_files/install003.JPG?raw=true)
<p dir="rtl">6.إذا تمت الخطوات السابقة بشكل صحيح من المفترض أن ترى هذه الصفحة في النهاية ^_^</p>
![النهاية](readme_files/install004.JPG?raw=true)

###  <div dir="rtl"> <a name="sheet_structure"></a>إعداد ملف الـExcel</div>
<p dir="rtl">
غالبا لن يحتاج ملف الإكسل الخاص بك إلى إعدادات خاصة ليتم قراءته بواسطة التطبيق ولكن لضمان الحصول على أفضل نتيجة تأكد من وجود الآتي
<ul dir="rtl">
<li>تأكد من وجود 3 أعمدة أساسية في ملف الإكسل الخاص بك وهي (الاسم، رقم الجلوس، الصف الدراسي) حتى وإن كنت لا تنوي تفعيل البحث بالاسم أو رقم الجلوس سيمكنك تعديل ذلك لاحقًا في إعدادات الموقع</li>
<li>تأكد من وجود عمود لكل مادة دراسية حتى وإن لم تكن مقررة على هذا الصف وسيتم شرح كيفية إخفاء المواد الغير مقررة لاحقا</li>
<li>إذا كنت تريد إضافة فواصل بين المواد كما هو موضح <a href="templates/assets/images/sep_cell_example.jpg"> بالصورة</a> تأكد أيضا من إضافته كعمود مستقل</li>
</ul>
</p>
#### <div dir="rtl">كيف يمكنني إخفاء المواد الغير مقررة عند عرض النتيجة</div>
<p dir="rtl">
لن تحتاج إلى تعديلات كثيرة، فقط تأكد من خلو هذا العمود من أيّ درجات لهذا الصف وسيقوم التطبيق بتجاهل هذه المادة
مثال
في الصورة التالية ستجد أنّ هناك صفين لشعبتين مختلفتين (علمي علوم، علمي رياضيات)
ستجد أنّ خانة مادة الرياضيات فارغة بالنسبة للفرقة التي تدرس علمي علوم وبالتالي لن يتم عرضها في درجاتهم
وبالمثل لمادة الأحياء للفرقة التي تدرس علمي رياضيات فلن يتم عرضها أيضا
</p>
![المواد الغير مقررة](readme_files/excel_example000.JPG?raw=true)

### <div dir="rtl"><a name="site_configuration"></a>إعدادات الموقع</div>
<p dir="rtl">
يمكنك التطبيق من تغيير عدد من الخيارات لسهولة التحكم في الموقع
لتعديل إعدادات الموقع قم بالتعديل على الخيارات الموجودة في ملف <code>includes/site_config.php</code> وهي كالآتي

<ul dir="rtl">
<li><code dir="ltr">$_CONFIG['allow_partial_names'] = true;</code>
<br/>
<p dir="rtl">
يمكنك هذا الخيار من تفعيل/تعطيل البحث بجزء من الاسم بدلا عن الاسم كاملا
قم باستبدال القيمة بـ<code>true</code> للتفعيل أو <code>false</code> للتعطيل
</p>
</li>
<li><code dir="ltr">$_CONFIG['allow_partial_grades'] = false;</code>
<br/>
يمكنك هذا الخيار من تفعيل/تعطيل البحث بجزء من اسم الصف/الفرقة بدلا عن الاسم كاملا
قم باستبدال القيمة بـ<code>true</code> للتفعيل أو <code>false</code> للتعطيل
</li>
<li><code dir="ltr">$_CONFIG['allow_search_all_grades'] = false;</code>
<br/>
يمكنك هذا الخيار من تفعيل/تعطيل إمكانية البحث عن الطالب في كافة الصفوف
قم باستبدال القيمة بـ<code>true</code> للتفعيل أو <code>false</code> للتعطيل
</li>
<li><code dir="ltr">$_CONFIG['search_by'] = 6;</code>
<br/>
يمكنك هذا الخيار من تحديد طريقة البحث عن الطالب (بالاسم، رقم الجلوس، أو كليهما)
قم باستبدال القيمة بـ
<ul dir="rtl"><li><code>2</code> للبحث برقم الجلوس فقط</li>
<li><code>4</code> للبحث بالاسم فقط </li>
<li><code>6</code> للبحث بالاسم أو رقم الجلوس</li>
</ul>
</li>
<li><code dir="ltr">$_CONFIG['site_title'] = 'نتيجة المدرسة';</code>
<br/>
يمكنك هذا الخيار من التحكم في العنوان الذي يظهر في المتصفح
فم باستبداله بالقيمة التي تناسبك
</li>
<li><code dir="ltr">$_CONFIG['template_assets_url'] = 'http://natiga-script.cf/templates/assets/';</code>
<br/>
قم بتعديل هذا الخيار إلى رابط موقعك، متبوعًا بمسار تثبيت التطبيق، متبوعا بمسار ملفات قالب التصميم 
'templates/assets/'
<br/>
فعلى سبيل المثال إذا كان رابط موقعك هو example.com وقمت بتثبيت التطبيق في مجلد natiga-script فسيكون الرابط 
<code dir="ltr">'http://example.com/natiga-script/templates/assets/'</code>
</li>
</ul>

<h4 dir="rtl">إعدادات متقدمة</h4>
<ul dir="rtl">
<li><code dir="ltr">$_CONFIG['is_production_env'] = true;</code>
<br/>
تعطيل هذا الخيار يسمح بعرض كافة الأخطاء التي تحدث في التطبيق.
قم باستبدال القيمة بـ<code>true</code> للتفعيل أو <code>false</code> للتعطيل
</li>
<li><code dir="ltr">$_CONFIG['memory_limit'] = '1024M';</code>
<br/>
يتحكم هذا الخيار في مساحة الذاكرة المسموح بها للتطبيق، في بعض الحالات النادرة قد تحتاج إلى تعديل قيمة هذا الخيار إذا كان حجم ملف الإكسل ضخم جدًا
</li>
<li><code dir="ltr">$_CONFIG['allowed_file_ext'] = ...;$_CONFIG['allowed_file_mime']=...;</code>
<br/>
يتحكم هذين الخيارين في أنواع الملفات المسموح برفعها على الموقع . يفضل تركها كما هي لأسباب أمنية
</li>
<li><code dir="ltr">$_CONFIG['magic_number'] = 0.0123456789;</code>
<br/>
لن تحتاج إلى تعديل قيمة هذا الحقل ولكن من مبدأ العلم بالشئ. عند تعيين قيمة أيّ خلية إلى هذه القيمة. سيتم عرض هذا العمود كفاصل وليس كمادة أي لن تظهر درجات هذا العمود لهذا الطالب
</li>
</ul>
</p>
