If you do not maintain your Totara/Moodle LMS yourself, pass these instructions on to whoever does, e.g. your IT department or your Totara/Moodle Partner, as installation requires technical access to your platform. 

Contents:

1. Installation

   a) Local Plugin
   b) Activity Plugin

2. Configuration (you will need your thirst.io logins for this step)

3. Access Token Details Page

   a) Refresh Token
   b) Delete Token

4. Add thirst.io Activity

1. Installation

There are two components required for this plugin to work. They can be installed simultaneously.

1a. Local Plugin

  • Download the ZIP package [Local Plugin]
  • Add it to your local plugin folder inside your project
  • Refresh Totara/Moodle dashboard and install the plugin

1b. Activity Module

  • Download the ZIP package [Activity Module]
  • Add it to your mod folder inside your project
  • Refresh Totara/Moodle dashboard and install the activity module

2. Configuration

(You will require your thirst.io login details for this step, if you haven't created an account in thirst.io yet, you can do it here)

Totara

  1. Click on... 

...on the top bar

2. Select Configuration > Plugins

3. On the left side Plugins menu, select last position Configure thirst.io

Moodle

1. Click on 

2. Go to Plugins tab

3. Select Configure thirst.io


For both....You will then be presented with the Access Token form. The access token allows communication between the LMS and thirst.io. 

The form contains 3 fields:

Organisation Sub-domain:
This is taken from your unique thirst.io URL. https://[organisation-subdomain].thirst.io/

Email Address:
The email address of the organisation owner account

Password:
Organisation owner password

Please note that only the Organisation Owner can authenticate the LMS plugin. In any other case, including if your credentials are incorrect, you will be presented with the error message: Unable to request the token at this time. Make sure that the details you've provided are correct.

Once the token is successfully requested, you will see it listed on the top of the page. You can add more access tokens if you have multiple thirst.io organisations, but only one token per organisation is allowed. You also cannot use the thirst.io plugin in more than one LMS system.

3. Access token details page

On the right-hand side of each pre-configured access token, you’ll find the Details link which leads to the Access token details page.

On this page, you will be able to verify the connection with thirst.io by checking the list of projects that are currently available for your organisation (listed under Available Projects). 

3a. Refreshing a Token

The Refresh Token button will refresh the token in case of any connectivity issues that could occur. E.g. if your Organisation appears to have no Projects. Please note that the access token gets refreshed automatically on a daily basis, so there is no need to refresh the token manually unless the connection is interrupted for some reason.

3b. Deleting an Access Token

Click on the Delete button to remove the access token from your LMS. Before removing the token, make sure that there are no activities using it. If you try to delete an access token with activities linked, you will be presented with the error message, e.g.: Unable to delete access tokens as it is linked to 2 activities.

4. Add thirst.io activity

To add a thirst.io project, simply click on Add an activity or resource and select thirst.io from the available activities list. If you have no tokens configured, you will be presented with the error message: Looks like the plugin is missing important configuration. Make sure that the plugin is installed correctly before adding activity.

If you have at least one token configured, you will be presented with a form. Select an Organisation from the first drop-down. Once selected, the Projects drop-down will list all the available projects. Select a Project, fill the rest of details and save the activity.

If you have any problems installing or configuring this plugin please get in touch with us via support@thirst.io and we will be happy to help. 

Did this answer your question?