This document provides instructions on integrating the Panorama platform into your Moodle 4.0 Learning Management System (LMS). Before proceeding with the steps below, please ensure that you have full access to your Moodle instance as an admin. If you have questions regarding any steps in this process, please contact your dedicated Account Manager.
Obtaining Moodle Web Service Token
The Panorama - LMS Connector requires an Access Token to be generated in order to access the API provided by Moodle. To obtain the Access Token, follow the instructions below.
- Log in to Moodle as an admin and select Site administration from the top row.
- Select the Server tab.
- Scroll down to Web Services and select Overview.
- Ensure the Status for Enable web services is set to Yes, and Enable protocols is set to rest.
- Navigate back to Web Services and select External services.
- Click Add.
- Enter the Name, Panorama, and ensure the Enabled checkbox is checked.
- Click Show more.
- Ensure Can download files and Can upload files are checked.
- Under the Required capability drop-down menu, search for and add repository/url:view.
- Click Add service.
- You'll be redirected to a page to add functions to the service. Click Add functions.
- In the search bar, add the following functions, and click Add functions.
core_enrol_get_enrolled_users_with_capability
core_enrol_get_enrolled_users
core_course_get_courses
core_files_get_files
mod_page_get_pages_by_courses
mod_assign_get_assignments
- core_course_get_categories
core_course_get_contents
mod_forum_get_forums_by_courses
mod_glossary_get_glossaries_by_courses
mod_data_get_databases_by_courses
mod_folder_get_folders_by_courses
mod_lesson_get_lessons_by_courses
mod_quiz_get_quizzes_by_courses
mod_survey_get_surveys_by_courses
mod_workshop_get_workshops_by_courses
mod_book_get_books_by_courses
- Navigate back to Web Services, and select Manage tokens.
- Click Create token.
- Under the User drop-down menu, select a user with administrative permissions.
- For Service, select the Panorama service created earlier, and click Save changes.
-
After saving the token, you will be redirected to the Manage tokens page. Under the Token column, send the generated token to your Account Manager.
- Note: Move to the next section of the guide only once you have received all the required information from your Account Manager.
Installing the Panorama Plugin
Installing the Panorama plugin requires you to have received the local_panorama.zip and filter_panorama.zip files from your Account Manager.
- Select Site administration from the top row.
- Select the Plugins tab.
- Click Install plugins.
- Click Choose a file.
- Select the Upload a file tab from the left-side menu, and click Choose File.
- Select the local_panorama.zip file provided to you by your Account Manager, and click Upload this file.
- Click Install plugin from the ZIP file.
- Click Continue to install the plugin.
-
Repeat the above steps to install the filter_panorama.zip file provided to you by your Account Manager.
Configure Settings for Panorama
After installing the plugins, you will need to configure your settings for Panorama.
Enable the Panorama Filter
Enabling the Panorama filter allows Panorama to be displayed within Moodle.
Panorama Configuration Application for Moodle LTI 1.3
- Select Site administration from the top row.
- Select the Plugins tab.
- Click Manage tools.
-
Click configure a tool manually.
- For External tool configuration, certain fields for Tool settings will require your Zone URL to be entered. Refer to the following URLs for your zone.
- US Zone: https://panorama-api.yuja.com
- CA Zone: https://panorama-api-cz.yuja.com
- EU Zone: https://panorama-api-ez.yuja.com
- Fill out the following information as follows, and then scroll down and click Save changes.
- Tool name: Panorama LTI 1.3
- Tool URL: https://<YOUR_ZONE_URL>/lti/lti-app-1.3-entry
- Tool description: Panorama LTI 1.3 App
- LTI version: LTI 1.3
- Public key type: Keyset URL
- Public Keyset: https://<YOUR_ZONE_URL>/lti/lti-app-1.3-jkw
- Initiate login URL: https://<YOUR_ZONE_URL>/lti/lti-app-1.3-oidc-initiation
- Redirection URL(s): https://<YOUR_ZONE_URL>/lti/lti-app-1.3-entry
- Default Launch Container: We recommend selecting New Window.
- Once the Panorama tool has been added, you will be redirected to the Manage tools page. Locate the newly created tool, and click the View Configuration Details icon.
- Important: Send the Tool configuration details to your Account Manager to complete the Panorama and Moodle LTI 1.3 configuration. You may send the details by clicking the Email button.
- Once your Account Manager has confirmed the integration process, you may continue to the next section of this guide.
Enabling the Panorama LTI Link within a Moodle Course
Once the Panorama Moodle application is configured, admins can enable Panorama within courses.
- Log in to Moodle as an admin and navigate to the course you would like to add Panorama to.
- Enable Edit Mode from the top-right corner of the page.
- Create or navigate to any section, and then click Add an activity or resource.
- Select External Tool.
- In the Activity name field, enter Panorama or any identifiable name you wish to use.
- For the Preconfigured tool drop-down menu, select the Panorama LTI 1.3 created earlier.
- Click Save and return to course. The Panorama LTI link will now be available within your chosen course.