This document provides instructions on integrating the Panorama platform into your Moodle Learning Management System (LMS). If you have any questions regarding any steps in this process, please contact your dedicated Customer Success Manager.
Obtaining Moodle Web Service Token
The YuJa 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. In the side panel, click on Site administration.
- Select the Plugins tab from the top row.
- 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.
- Under Custom 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.
- After being redirected to the External Services page, find the newly added External service, and select Functions.
- Scroll down, and 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 on Add.
- 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. Send the generated token to your Customer Success Manager.
- Move to the next section of the guide only once you have received all the required information from your Customer Success 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 Customer Success Manager.
- Click Site administration from the left-side panel, and then click Plugins from the top row.
- 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 Customer Success 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 Customer Success Manager.
Configure Settings for Panorama
After installing the plugins, you will need to configure your settings for Panorama.
- From the left-side navigation menu, click Site administration, and then click the Plugins tab from the top row.
- Scroll down to Panorama, and select Panorama for Moodle Settings.
- Fill in your Primary Identify Key, Secondary Identify Key, LTI Consumer Key, and LTI Key provided to you by your Customer Success Manager, and then click Save changes.
Enable the Panorama Filter
Enabling the Panorama filter allows Panorama to be displayed within Moodle.
-
Log in to Moodle as an admin. In the side panel, click on Site administration.
- Select the Plugins tab from the top row.
- Scroll down to Filters, and select Manage Filters.
- Locate and enable the Panorama for Moodle filter by selecting On from the drop-down menu. The Panorama filter will now be enabled for Moodle Versions above 3.5.
Panorama Configuration Application for Moodle LTI 1.3
- Log in to Moodle as an admin. In the side panel, click on Site administration.
- Select the Plugins tab from the top row, and then 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
- 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 Customer Success Manager to complete the Panorama and Moodle LTI 1.3 configuration. You may send the details by clicking the Email button.
- Once your Customer Success 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. In the side panel, click on the course you would like to add Panorama to.
- Click Turn editing on in the top-right corner.
- Click Add an activity or resource.
- Click 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.
Uninstalling Panorama from Your Moodle Instance
- Log in to Moodle as an admin. In the side panel, click on Site administration.
- Select the Plugins tab from the top row, and then click Plugins overview.
- Locate the filter_panorama plugin, and click uninstall.
- Click Confirm to uninstall the plugin.
- After being redirected to the Plugins overview page, locate and uninstall the local_panorama plugin as well.
- Finally, remove the Panorama external tools located within your courses. In the side panel, click on the course that contains a Panorama external tool.
- Click Turn editing on in the top-right corner.
- Click Edit next to the Panorama LTI tool.
- Click Delete.
- Click Yes to remove the Panorama external tool from the course. Repeat steps 6-9 for any additional courses which contain the Panorama external tool in order to complete the uninstallation process of Panorama from Moodle.