Moodle Integration

Getting Started

In this quick guide, basic steps are outlined to build web links in a Moodle environment. The assumptions are that implementation steps have been completed with your Tk20 Product Consultant (i.e. coursework has been created and sent in Tk20, provider domain has been registered in LMS) and you are ready to begin linking courses in your LMS to Tk20 coursework. For more information on the implementation process, please reference the LTI Overview document or speak to your IPC.

Note(s): Screenshots are from Moodle v2.6 which may be slightly different for other versions

External Tool Configuration (System Administrators)

  1. Log in as an administrator.
  2. Click the Site Administration link located in the lower left side.
  3. Click Plugins.
  4. Click Activity Modules.
  5. Click on "Manage Activities" link.
  6. Click on "External Tool" settings.
  7. The External Tool Type list shows Active, Pending, and Rejected tool types. If Tk20 is not already on the active list click the link Add external tool configuration to add it.
  8. Under Tool Settings, enter the following fields:
    1. Tool Name: This is the name of the tool type. e.g. Tk20 Tool or Tk20 Course LTI or Tk20 Coursework LTI.
    2. Tool Base URL: This is your server URL
    3. Consumer Key: If you are configuring the tool to accommodate both course and coursework integration types, leave this blank.
    4. Shared Secret: If you are configuring the tool to accommodate both course and coursework integration types, leave this blank.
      The Tool settings section showing fields for Tool Name, Tool Base URL, Consumer Key, Shared Secret with Unmask checkbox, and Custom parameters text box.
  9. Check Show tool type when creating tool instance.
  10. Default Launch Container: Select the option for whether you would like the TK20 integrations to be embedded or open in a new window.
  11. Under Privacy, the Tk20 integration does not require user data and so you may set these options however you, including Never. However, you may want to consider the following recommendations:
    1. Share launcher’s name with tool: Always is the recommended option.
    2. Share launcher’s email with tool: Always is the recommended option.
    3. Accept grade from the tool: Delegate to Teacher is the recommended.
      The section showing a checkbox for ‘Show tool type when creating tool instances,’ a dropdown for Default Launch Container, Privacy section showing dropdowns for sharing launcher’s name and email, a dropdown for accepting grades, and a checkbox for Force SSL.
  12. Click Save Changes.

Note(s): You can find essential integration information (e.g., consumer key, secret) from LTI Tool Provider Set in the Administration Tab.

Creating a Course or Assignment Link

Once the Tk20 domain is correctly registered as an External Tool, course administrators or instructors can create links to Tk20 content. To create the link, choose to Add an activity in some content area.

Tip: Make sure your editing is turned on to complete this step.

  1. Click on the courses title.
  2. Click on Turn editing on located at the top right of the page.
  3. Click Add an activity of resource in the content area.
  4. Select External Tool from the Add an activity or resource pop­up menu.
  5. Click the Add button.
  6. In the General area, enter in the following fields:
    1. Activity Name: The title of the integration such as the name of Course (e.g. Lesson Planning Module) or Coursework (Lesson Plan) link.
    2. External tool type: Select the tool type from the dropdown. This tool type was created in the External Tool Configuration step.
    3. Launch URL: Launch URL provided in the LTI Tool Provider Setup Menu of the Administration tab.
    4. Launch Container: Select the option for whether you would like the TK20 integrations to be embedded or open in a new window.
    5. Click Show more… Consumer Key and Shared Secret should be automatically populated.
    6. Consumer Key: This is the name of the server with the specification for course or assignment key.
    7. Shared Secret: This is the name of the server with the specification for course or assignment secret.
    8. Custom parameters: Not applicable. The section showing required fields for Activity Name and Activity Description, checkboxes for display options, dropdown for External tool type, fields for Launch URL and Secure Launch URL, dropdown for Launch Container, fields for Consumer Key and Shared Secret with Unmask checkbox, and text box for Custom parameters. The Privacy section showing checked checkboxes for ‘Share launcher’s name with the tool,’ ‘Share launcher’s email with the tool,’ and ‘Accept grades from the tool.’
  7. For Gradebook Integration (for only Coursework Integrations), click Privacy.
  8. Select the checkbox Accept grades from this tool.
  9. Click the Save and return to course button.

Note(s):

  • Faculty and student general account integrations link to the Tk20 Homepage.
  • Faculty coursework level integrations link to the Tk20 Coursework Submissions page.
  • Student course level integrations link to the Tk20 Coursework Submission page.

Gradebook Setup

  1. After you have setup up your Coursework Link and selected the checkbox Accept grades from this tool in the Privacy area of the link setup, Moodle will automatically add this to the gradebook. However, you may want to adjust the point value or calculation for the gradebook.
  2. Click Grades under the Course Administration menu.
  3. Click the Categories and items link.
  4. Click the Simple view link.
  5. Click the Edit icon associated with the assignment.
  6. Modify the assignment grade information as needed.
  7. Click Save changes.
    The Privacy section showing checked checkboxes for ‘Share launcher’s name with the tool,’ ‘Share launcher’s email with the tool,’ and ‘Accept grades from the tool.’
Was this article helpful?
0 out of 0 found this helpful

Articles in this section

How to Contact Support
There are many ways to reach out! Click the icon above for our support options.
Watermark Academy
Click the icon above to access the Watermark Academy for consultation, training, and implementation companion courses.
Customer Community
Can’t find the answer? Ask fellow users how they’re making the most of Watermark in our Community!