Deploy a Tool – Moodle
You will need to access Oxford English Hub in one window and Moodle in another.
Within your Moodle administrator account, choose Site Administration > Plugins > Activity Modules > External tool > Manage Tools.
On the Manage tools page, choose Configure a tool manually.
This will open the External tool configuration page.
Within Hub, choose Show Oxford English Hub’s Tool Details.
Copy and paste the tool values from the Oxford English Hub panel into the Moodle External tool configuration window, as shown below. You can also copy the URLs from the Hub or from the Help text below.
- Tool name: Enter a name for the tool
- Tool URL: Copy the Tool URL and add to the field. https://lti.englishhub.oup.com/api/edu/open/ltitool1v3
- Tool description: Enter a description of the tool and what it will be used for.
- LTI version: Choose LTI 1.3
- Public key type: Choose Keyset URL
- Public keyset: Copy the Public keyset URL (JWKS) and add it to the field. https://lti.englishhub.oup.com/api/edu/open/ltitool1v3/jwks
- Initiate login URL: Copy the Initiate login URL and add it to the field. https://lti.englishhub.oup.com/api/edu/open/ltitool1v3/login/initiate
- Copy the Redirection URI(s) and paste here. There are two. Each URL must be on a separate line. https://lti.englishhub.oup.com/api/edu/open/ltitool1v3/content/launch https://lti.englishhub.oup.com/api/edu/open/ltitool1v3/content/selection
- Custom parameters: Optional – Add any specific customer parameters here. None are required by the Oxford English Hub tool.
- Tool configuration usage: We recommend Show as a preconfigured tool when adding an external tool.
- Default launch container: We recommend New window.
- Supports Deep Linking (Content-Item Message): Check this box to ensure products can be launched.
- Content Selection URL: Copy the Content Selection URL and add to the field. https://lti.englishhub.oup.com/api/edu/open/ltitool1v3/content/selection
In the Services section, IMS LTI Assignment and Grade Services choose Use this service for grade sync and column management.
In the Privacy section, accept grades from the tool, choose As specified in Deep Linking definition or Delegate to teacher. This will avoid duplication of line items in the LMS course grade book.
Enabling your LMS to send student and teacher roles, names and email information to OUP’s platforms allows them to be identified correctly in the user account and grade reporting areas.
If you do not select these options, student and teacher IDs will be anonymized in the OUP platforms, meaning they cannot be identified. If you do not choose these options, they can be enabled later.
Choose Save changes.
The tool will now appear on the Manage tools page.
Add LMS Values to Tool in Hub
Choose the configuration menu icon in the tool panel on the Moodle Manage tools page.
Choosing this icon will display the menu showing the Moodle values that must be copied and added to the OEH tool.
Copy the values from Moodle and add them to the Hub tool as below.
- Issuer / Platform ID: Copy the Platform ID value from Moodle and paste into the Hub field.
- Authentication request URL: Copy the Authentication request URL value from Moodle and paste into the Hub field.
- Public keyset URL (JWKS): Copy the Public keyset URL value from Moodle and paste into the Hub field.
- Access token URL: Copy the Access token URL value from Moodle and paste into the Hub field.
- Display name: Add a name for the tool.
- Deployment ID: Copy the Deployment ID value from Moodle and paste into the Hub field.
- Client ID: Copy the Client ID value from Moodle and paste into the Hub field.
When all values have been added to the OEH tool from Moodle, choose Add Integration.
The tool creation and deployment is now complete.
Choose Done to exit to your deployments page.
The deployment is now visible on the LTI deployments page.
Assign Pack or Product to LMS Course
On the My Course page, select the course to add to the LTI launch link.
Within your course in Moodle in Edit mode choose Add an activity or resource.
Choose External Tool from the menu.
Activity name: The title of the product you select will display automatically here.
Preconfigured tool: Choose the tool you have deployed in the dropdown menu.
Tool URL will fill automatically after you have selected you OUP product.
Assign Products
In the same menu, choose Select content.
A content selection menu will be displayed.
Search within the menu for the product you wish to assign to the LMS course.
You can search using course title, author, platform, ISBN, or level. Searching with the product ISBN will help you find the correct product without confusing it with others.
When you have selected your course pack or product choose Next.
Please check that you have chosen the correct pack or product and user type (student or teacher) and then choose Add learning materials.
For instructions on synchronizing grades and creating links to activities or pages, please check other Help and Support articles.
The selected product(s) will display in Moodle.
Choose Save and return to course.
Your chosen product is now available in your LMS course for teachers and students to access.
Important:
You can choose individual products e.g. e-book, Online Practice, or a pack of products if available.
Pack access codes are required for a course pack. Individual products have their own access code if used individually.
Student and teacher products also have different access codes for the same product.
Launch Products
When students or teachers accesses their course in Moodle, they will see the OUP product LTI launch link(s).
Clicking on the launch link will open the OUP product.
If pack or product licenses have been assigned to your Hub organization by OUP, the product will open. If licenses have not been assigned, the student or teacher should enter their access code on the first use.
(The teacher or student may have to accept the Terms and Conditions on the first launch.)
They should enter their access code and choose Continue.
The product will launch
They should check the box to agree to the Terms and Conditions, then select Continue.
They will then be able to use the product.
Assign Oxford English Hub to your Course
Access the tool you created in your Moodle course.
In the content selection menu, choose Oxford English Hub to create a launch link in your course.
Choose Next.
Choose Add learning materials.
Choose Save and return to course.
A launch link for Oxford English Hub will be created in your LMS course.
When a teacher or student launches the Oxford English Hub will they will be presented with the Terms and Conditions.
They should make their age choice and agree to the Terms and Conditions.
Then choose Update my account.
The user’s account will be created in the Oxford English Hub.
They can choose Get started to access the Oxford English Hub.
Within the Hub, students and teachers will be able to access the course content they are entitled to such as course Resources as Assessment material depending on their product.
They will also be able to access e-book, Online Practice and Assessment gradebooks.
Important:
If a student has not redeemed a license for a product, they will not see any course material in the Hub.
If a student has redeemed a pack license already, they will see the pack course materials available within the Hub.
If a student has redeemed an Online Practice license, they will be able to access course Resources in the Hub.
Students and teachers cannot launch Online Practice, e-books or Class Presentation Tools from the Hub. These products must be launched using their own launch link from the LMS.
Students and teachers can only access the Hub from their LMS. They cannot access their account or course material by signing in to the Hub directly.