Ally في Moodle

تثبيت المكونات الإضافية ذات الصلة بالتقارير وعوامل التصفية والأدوات الخاصة بـ Ally

Ally متوافق مع العديد من السمات وخيارات الاستضافة الخاصة بـ Moodle. الإصدارات والأشكال المدعومة في Ally هي:

Moodle 3.11.x

• Snap
• Boost
• Clean
• المزيد

Moodle 4.0.x

• Snap
• Boost

Moodle 4.1.x

• Snap
• Boost

Moodle 4.2.x

• Snap
• Boost

المكون الإضافي الخاص بـ Ally لبيئات OpenLMS 4.1
سيقوم OpenLMS بتحديث بيئاته إلى الإصدار 4.1 في فترات الصيانة المقبلة. انظر  جدول إصدار OpenLMS EDU. سيصبح المكون الإضافي الخاص بـ Ally للإصدار 4.1 متاحًا بعد تنفيذ فترات الصيانة، ويجب أن يكون متاحا في مصفوفة المكونات الإضافية لـ OpenLMS.

إن Ally متوافقة مع إصدارات Moodle قبل الإصدار 3.10.x ولكن لا يتم دعم أي إصلاحات. نقترح عليك ترقية إصدار Moodle لديك. تتوفر الإرشادات في دعم إصدار Moodle. 

ملاحظة: الإصدارات أو السمات الأخرى غير المذكورة لا يدعمها Ally.

لتكوين Ally باستخدام Moodle على بيئات استضافة لدى العميل، قم بتكوين المكونات الإضافية التالية:

• أدوات المسؤول في Ally
• عامل تصفية Ally
• LTI للتقارير لدى Ally

تتكامل البيئات التي يتم توزيعها بواسطة OpenLMS بالفعل مع Ally. 

خطوات التكوين

1. قم بتنزيل الإصدار المطلوب لأداة المسؤول لدى Ally أو استنساخه من github.

   1. التنزيل كملف مضغوط ZIP
      1. غيّر إصدار الفرع، إذا لزم الأمر.

      2. راجع ملف version.php لمعرفة ما إذا كان رقم إصدار Moodle المطلوب ("المتطلبات") ونسخته يطابق إصدار Moodle لديك. أي: لـ Moodle 3.11

         $plugin->release = '3.11.6';

         $plugin->requires = 2021051700;

         ينبغي أن يعمل الإصدار "3.11.6" مع تثبيتات Moodle 3.11 . في حالة عدم تطابق هذه المعلمات مع تثبيت Moodle لديك، فقد تحتاج إلى تغيير الفرع مرة أخرى.

         المزيد عن إصدارات Moodle المتوافقة وأرقام الإصدارات

      3. تنزيل المستودع باستخدام "Clone or download > Download ZIP" (الاستنساخ أو التنزيل > تنزيل ملف ZIP)
   2. استنساخ مستودع git

      1. الوصول إلى مجلد الأدوات.

         cd [moodle location]/admin/tool

      2. استنساخ المستودع

         • استخدام SSH

           git clone [email protected]:anthology-ally/moodle-tool_ally ally

         • استخدام HTTP

           git clone https://github.com/anthology-ally/moodle-tool_ally.git ally

      3. تحقق من الفرع المقابل، أي بالنسبة لـ Moodle 3.11، يكون MOODLE_311_STABLE

         git checkout MOODLE_311_STABLE

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

         git fetch

2. قم بتنزيل الإصدار المطلوب من عامل تصفية Ally أو استنساخه من github.

   1. التنزيل كملف مضغوط ZIP
      1. تغيير إصدار الفرع إذا لزم الأمر

      2. راجع ملف version.php لمعرفة ما إذا كان رقم إصدار Moodle المطلوب ("المتطلبات") ونسخته يطابق إصدار Moodle لديك. أي: لـ Moodle 3.11

         $plugin->release = '3.11.6';

         $plugin->requires = 2021051700;

         ينبغي أن يعمل الإصدار "3.11.6" مع تثبيتات Moodle 3.11 . في حالة عدم تطابق هذه المعلمات مع تثبيت Moodle لديك، فقد تحتاج إلى تغيير الفرع مرة أخرى.

         المزيد عن إصدارات Moodle المتوافقة وأرقام الإصدارات.

      3. تنزيل المستودع باستخدام "Clone or download > Download ZIP" (الاستنساخ أو التنزيل > تنزيل ملف ZIP)
   2. استنساخ مستودع git

      1. الوصول إلى مجلد عوامل التصفية.

         cd [moodle location]/filter

      2. استنساخ المستودع

         • استخدام SSH

           git clone [email protected]:anthology-ally/moodle-filter_ally ally

         • استخدام http

           git clone https://github.com/anthology-ally/moodle-filter_ally.git ally

      3. تحقق من الفرع المقابل، أي بالنسبة لـ Moodle 3.11، يكون MOODLE_311_STABLE

         git checkout MOODLE_311_STABLE

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

         git fetch

3. قم بتنزيل الإصدار المطلوب من أداة LTI لتقرير Ally من github.

   1. التنزيل كملف مضغوط ZIP
      1. تغيير إصدار الفرع إذا لزم الأمر

      2. راجع ملف version.php لمعرفة ما إذا كان رقم إصدار Moodle المطلوب ("المتطلبات") ونسخته يطابق إصدار Moodle لديك. أي: لـ Moodle 3.11

         $plugin->release = '3.11.6';

         $plugin->requires = 2021051700;

         ينبغي أن يعمل الإصدار "3.11.6" مع تثبيتات Moodle 3.11 . في حالة عدم تطابق هذه المعلمات مع تثبيت Moodle لديك، فقد تحتاج إلى تغيير الفرع مرة أخرى.

         المزيد عن إصدارات Moodle المتوافقة وأرقام الإصدارات.

      3. تنزيل المستودع باستخدام "Clone or download > Download ZIP" (الاستنساخ أو التنزيل > تنزيل ملف ZIP)
   2. استنساخ مستودع git

      1. الوصول إلى مجلد التقارير

         cd [moodle location]/report

      2. استنساخ المستودع

         • استخدام SSH

           git clone [email protected]:anthology-ally/moodle-report_allylti ally

         • استخدام HTTP

           git clone https://github.com/anthology-ally/moodle-report_allylti.git ally

      3. تحقق من الفرع المقابل، أي بالنسبة لـ Moodle 3.11، يكون MOODLE_311_STABLE

         git checkout MOODLE_311_STABLE

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

         git fetch

4. تحقق من بنية المجلد.

   يجب تسمية دليل أداة المسؤول ally. يجب أن يحتوي على مسار كما يلي:

   [yourmoodledir]/admin/tool/ally

   يجب تسمية دليل عامل التصفية ally. يجب أن يحتوي على مسار كما يلي:

   [yourmoodledir]/filter/ally

   يجب تسمية دليل التقرير allylti. يجب أن يحتوي على مسار كما يلي:

   [yourmoodledir]/report/allylti

5. تأكد من قابلية قراءة كل مجلد ومحتوياته من قِبل خادم الويب لديك.
6. قم بتسجيل الدخول كمستخدم مسؤول إلى موقع Moodle لديك، وافتح صفحة المسؤول. ينبغي أن يتحقق ذلك من المكونات الإضافية الجديدة، ويقدم لك خيار ترقية قاعدة بيانات Moodle الآن. حدد هذا الزر لتثبيت المكونات الإضافية.
7. بعد تثبيت المكونات الإضافية، انتقل إلى "System Administration > Plugins > Admin tools > Ally" (إدارة النظام > المكونات الإضافية > أدوات المسؤول > Ally).

8. حدد "Auto configure Ally web servic" (التكوين التلقائي لخدمة ويب Ally).

   في الشاشة التالية، سيكون هناك رمز مميز لخدمة الويب وعنوان URL لاختبار خدمة الويب لـ ally.

   يجب أن يكون عنوان URL هذا متاحًا للوصول إليه مباشرة من الإنترنت حتى يتمكن Ally من استخدامه.

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

   إذا كان مثيل Moodle الخاص بك يستخدم الحقول المخصصة المطلوبة لحسابات المستخدمين، قم بـ "تسجيل الدخول باسم" مستخدم Ally Webservice الذي يتم إنشاؤه بواسطة التكوين التلقائي للمكون الإضافي لضمان ملء هذه الحقول المخصصة وحفظها.

تكوين المكون الإضافي لـ Moodle

سيقوم المستشار الفني لـ Ally بإنشاء الوحدة التابعة لـ Ally باستخدام رمز Moodle Webservice المميز الذي تم إنشاؤه في القسم السابق، وسيزودك بتفاصيل تكوين المكون الإضافي لـ Ally.

1. سجل الدخول كمسؤول Moodle.
2. من إدارة الموقع، حدد المكونات الإضافية وأدوات المسؤول. حدد تكوين Ally.
3. أدخل التفاصيل التالية

   • مؤلفو المحتوى: أدوار المستخدمين الذين يعتبروا مؤلفي المحتوى. يجب أن تتمثل في: المدير، أو منشئ المقرر الدراسي، أو المدرس (الإعدادات الافتراضية).

     لا ينبغي تغيير هذا عادةً، يرجى عدم تعيير هذا الإعداد دون استشارة المستشار الفني لـ Ally.

   • المفتاح: مفتاح LTI الذي تم توفيره بواسطة المستشار الفني لـ Ally.
   • كلمة السر: كلمة سر LTI التي تم توفيرها بواسطة المستشار الفني لـ Ally.
   • عنوان URL للتشغيل: عنوان URL لتشغيل LTI الذي تم توفيره بواسطة المستشار الفني لـ Ally.
   • عنوان URL لتحديث الملف: عنوان URL للحدث/تحديث الملف الذي تم توفيره بواسطة المستشار الفني لـ Ally. https://[AllyEnvironment].ally.ac/api/v1/events
   • معرف الوحدة التابعة: معرف الوحدة التابعة الذي تم توفيره بواسطة المستشار الفني لـ Ally.
   • نطاق السجل: بسيط
4. احفظ التغييرات.

التقرير المؤسسي لـ Ally

بمجرد تكوين المكون الإضافي لـ Ally، ستتمكن من الوصول إلى التقرير المؤسسي الخاص بـ Ally.

لن تكون البيانات موجودة في التقرير إلا بعد حدوث مزامنة المقرر الدراسي لـ Ally وإنشاء التقرير الأولي.

للوصول إلى التقرير المؤسسي لـ Ally، انتقل إلى إدارة الموقع وحدد التقارير. حدد إمكانية وصول ذوي الاحتياجات الخاصة.

المزيد عن التقرير المؤسسي لـ Ally

عامل تصفية Ally

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

تمكين عامل تصفية Ally

1. من "Site administration" (إدارة الموقع)، حدد "Plugins" (المكونات الإضافية) و"Plugins overview" (نظرة عامة على المكونات الإضافية).
2. انتقل إلى الأسفل إلى قسم عوامل تصفية النص، وقم بتمكين عامل تصفية Ally.
3. انقل عامل تصفية Ally إلى أعلى قائمة عامل التصفية.

الوصول إلى واجهة مستخدم تكوين Ally

نقدم لك إرشادات حول كيفية الوصول إلى تكوين Ally أثناء الإعداد. إذا كنت لا تزال غير قادر على الوصول، فأرسل طلبًا على Behind the Blackboard.