الخطوة 1 - تسجيل External Tool في Moodle Moodle
تتم الخطوة الاولى بالكامل داخل Moodle بواسطة مسؤول الموقع. ستقوم بتسجيل DrillBit كـ External Tool جديدة من نوع LTI 1.3، وتوجيهها الى نقاط نهاية DrillBit، وتمكين الخدمات التي يحتاجها DrillBit، ثم الانتهاء بفتح تفاصيل تكوين الاداة لنسخ Platform ID / Client ID / Deployment ID - تُستخدم هذه القيم في الخطوة 2 على جانب DrillBit.
1. فتح مدير External Tool
- سجّل الدخول الى Moodle بصفتك Administrator.
- افتح Site Administration › Plugins › External Tool › Manage Tools.
- اسفل حقل URL الاداة، انقر فوق configure a tool manually.
يُفتح نموذج External tool configuration.
2. تعيين عناوين URL الاداة واصدار LTI
املا قسم Tool settings. العناوين ادناه هي نفسها لكل عميل:
| Tool name | DrillBit Plagiarism Tool |
|---|---|
| Tool URL | https://lti.drillbitplagiarismcheck.com/lti/launch |
| Tool description | DrillBit Plagiarism LTI 1.3 Tool |
| LTI version | LTI 1.3 |
| Public key type | Keyset URL |
| Public keyset | https://lti.drillbitplagiarismcheck.com/lti/keys |
| Initiate login URL | https://lti.drillbitplagiarismcheck.com/lti/login |
| Redirection URI(s) | https://lti.drillbitplagiarismcheck.com/lti/launchhttps://lti.drillbitplagiarismcheck.com/ltihttps://lti.drillbitplagiarismcheck.com/lti/ |
اترك Custom parameters فارغا ما لم يخبرك دعم DrillBit صراحةً بخلاف ذلك.
3. Tool configuration usage و launch container
لا تزال ضمن Tool settings:
- Tool configuration usage -
Show as preconfigured tool when adding an external tool. هذا ما يتيح للمدرّسين اختيار DrillBit من القائمة المنسدلة Preconfigured tool عند اضافة External tool الى مقرر. - Default launch container -
New window. واجهة DrillBit اوسع من اطار النشاط النموذجي في Moodle، لذا فان الفتح في نافذة جديدة يمنح المدرّسين عرض التقرير الكامل. - Supports Deep Linking (Content-Item Message) - حدّد هذا الخيار. الـ deep linking هو ما يشغّل مربع حوار Create Assignment الذي يراه المدرّسون عند اضافة الاداة الى مقرر.
4. تمكين الخدمات المطلوبة
افتح قسم Services وعيّن:
- IMS LTI Assignment and Grade Services - Use this service for grade sync and column management. يتيح لـ DrillBit كتابة درجات التشابه مرة اخرى في دفتر درجات Moodle.
- IMS LTI Names and Role Provisioning - Use this service to retrieve members' information as per privacy settings. يتيح لـ DrillBit تحديد الطالب / المدرّس وراء كل عملية تشغيل.
- Tool Settings - Use this service.
5. اعدادات الخصوصية
افتح قسم Privacy وعيّن كل مشاركة على Always:
- Share launcher's name with tool -
Always. - Share launcher's email with tool -
Always. - Accept grades from the tool -
Always.
اترك Force SSL بدون تحديد ما لم تفرض بيئة Moodle الخاصة بك عنوان URL تشغيل غير HTTPS في مكان اخر - نقاط نهاية DrillBit هي بالفعل HTTPS.
6. الحفظ وفتح تفاصيل الاداة
- انقر فوق Save changes اسفل النموذج.
- ستعود الى صفحة Manage Tools مع بطاقة جديدة بعنوان LTI Deployed (او اي Tool name قمت بتعيينه) محددة كـ Active.
- انقر فوق ايقونة قائمة الهامبرغر على بطاقة الاداة.
يُفتح مربع حوار Tool configuration details. انسخ كلا من هذه القيم - ستلصقها في DrillBit في الخطوة 2:
- Platform ID - عنوان URL لموقع Moodle الخاص بك.
- Client ID - معرّف عميل LTI الذي ولّده Moodle للتو.
- Deployment ID - معرّف رقمي لعملية النشر هذه.
- Public keyset URL -
https://<your-moodle>/mod/lti/certs.php. - Access token URL -
https://<your-moodle>/mod/lti/token.php. - Authentication request URL -
https://<your-moodle>/mod/lti/auth.php.
لا تغلق مربع حوار Tool configuration details حتى تنسخ القيم الست جميعها. يمكنك اعادة فتحه لاحقا من قائمة الهامبرغر نفسها، لكن Client ID على وجه الخصوص يسهل نسخه بشكل خاطئ - لصقه اولا في مستند مؤقت اكثر امانا من اعادة كتابته.
تم تسجيل الاداة في Moodle. تابع الى الخطوة 2 - ربط Moodle بـ DrillBit لتسجيل التفاصيل نفسها على جانب DrillBit.