From 7d8d237168d8db55716859a89841f8c16025d2d7 Mon Sep 17 00:00:00 2001 From: Tim Hodson Date: Thu, 1 Oct 2015 15:42:45 +0100 Subject: [PATCH] Update README.md --- 2.x-activity-module/mod/aspirelists/README.md | 19 ++++++++++--------- 1 file changed, 10 insertions(+), 9 deletions(-) diff --git a/2.x-activity-module/mod/aspirelists/README.md b/2.x-activity-module/mod/aspirelists/README.md index c2a5ad0..21c2a49 100644 --- a/2.x-activity-module/mod/aspirelists/README.md +++ b/2.x-activity-module/mod/aspirelists/README.md @@ -4,7 +4,7 @@ Talis Aspire Reading Lists Moodle Integration Compatibility ------------- -This activity plugin has been tested with stable versions of Moodle 2.4, 2.6, 2.7, 2.8 +This activity plugin has been tested with stable versions of Moodle 2.4, 2.6, 2.7, 2.8, 2.9 If you do become aware of any issues affecting the plugin, then feel free to raise them with Talis directly, or by adding issues to the github repository. Feel free to submit Pull Requests too! @@ -19,8 +19,6 @@ If you are already logged in as an administrator - go to the 'notifications' pag "mod_lti" must also be enabled for this module to work. -That's it! - Configuration ------------- @@ -32,6 +30,7 @@ Once that is set, from the Talis Aspire Reading List navigation menu, select *Ad * A form will appear, choose a distinct, descriptive name and click *Add*. * Make note of the **API key** and **Shared secret** that are generated. +* Do not share key's and secrets between different instances of moodle. ## Configure moodle to use the Talis Aspire Reading Lists LTI tool @@ -45,7 +44,7 @@ At the next form, fill out the following:
Tool Name
Whatever you call Talis Aspire Reading Lists at your institution.
Tool Base URL
-
http://{{baseUrlOfTalisAspireReadingLists}}/lti/launch
+
https://{{tenancyShortName}}.rl.talis.com/lti/launch
Consumer Key
This should be API key from above
Shared Secret
@@ -53,7 +52,7 @@ At the next form, fill out the following:
Custom Parameters
You will almost certainly need to add some custom parameters here - read this article for more information
Show tool type when creating tool instances
-
Check this if you want TARL to appear as an option when an instructor adds an LTI resource as an External Tool
+
Check this if you want TARL to appear as an option when an instructor adds an LTI resource as an External Tool (note that you may not need to do this as the ativity module will add a 'resource' which can be chosen instead of using the built-in 'External Tool' activity type)
Default Launch Container
Choose either Embed or Embed, without blocks, depending on your preference
@@ -66,15 +65,15 @@ You should be taken to the **Course Resource List** settings page. Fill out the
Target Aspire URL
-
This should be http://{baseUrlOfTalisAspireReadingLists} with no trailing slash. It should be the same as you entered in Tool Base URL above, but leave off /lti/launch
+
This should be https://{tenancyShortName}.rl.talis.com with no trailing slash. It should be the same as you entered in Tool Base URL above, but leave off /lti/launch
Module code field
The course database field in Moodle that contains the module/course code that lists are associated with in TARL
Module Code Regex
-
Often module/course codes need to be rewritten slightly to match what is in TARL, enter a regex that matches the module code here
+
Often module/course codes need to be rewritten slightly to match what is in TARL, enter a regex that will pick out the module code in the first matching group
Time Period Regex
-
If the module code in Moodle contains the time period for the course, enter a regex that identifies it in the string
+
If the module code in Moodle contains the time period for the course, enter a regex that identifies it in the first matching group. The time period code here will need to match the 'slug' of a time period in Talis Aspire Reading Lists
Time Period Mapping
-
A JSON string that maps the strings extracted from the above regex to the time period slugs in TARL
+
A JSON string that maps the strings extracted from the above regex to the time period slugs in TARL - you only need to do use this if you have multiple codes in moodle that need to map to the same time periods in Talis Aspire
Default height of an embedded list
If a list is displayed inline within a course, this value will control the default height of the iframe
@@ -82,5 +81,7 @@ You should be taken to the **Course Resource List** settings page. Fill out the Click *Save changes*. **Course Resource List** should now be available as **Resource** in the *Add an activity or resource* menu when editing a course. +If you need help with any of the settings here, please contact [support@talis.com](mailto:support@talis.com) with screen shots of the above settings pages. +