Moodle Manual Kialo LTI Setup Documentation

The Kialo Moodle plugin is the easiest way for institutions to set up Kialo LTI in the Moodle platform. For institutions unable to use the plugin on Moodle, you can manually add Kialo as an LTI tool via the methods outlined in this article. Kialo also supports LTI integration with Canvas and Blackboard.

Please note:

  • Only the EDU version of Kialo (kialo-edu.com) supports LTI integration.
  • Only LTI 1.3 is supported (versions such as LTI 1.0, 1.1, or 2.0 are not supported).
  • When accessing Kialo Edu via LTI:
    • students and teachers will be automatically signed into Kialo using their Moodle email address.
    • in discussions, students are automatically assigned the Writer role, while teachers are assigned the Admin role.

Adding Kialo LTI as an External Tool

There are various methods to add Kialo as an external tool to Moodle, depending on whether you are an Administrator on Moodle.

If you are an Administrator, you can register Kialo as an external tool via dynamic registration (recommended) or as an external tool manually.

If you are not an Administrator, you can register Kialo as an external course specific tool.

1a. Admins: Registering Kialo as external tool via dynamic registration (recommended)

Note: Ensure you’re an Admin on Moodle. The endpoint that should be called is https://www.kialo-edu.com/lti/dynreg.

Moodle dynamic registration walkthrough:

  1. Enter https://www.kialo-edu.com/lti/dynreg as the Tool URL, then click Add LTI Advantage. Kialo Edu should appear as a configured tool.
  2. Click Activate next to Kialo Edu to activate it as an external tool.
  3. Done! You can recommend educators view the Creating a New Kialo Activity section on how to add a Kialo activity in their course.

1b. Admins: Registering Kialo as external tool manually

In older versions of Moodle that don’t support dynamic registration, you can configure the required endpoints manually.

Moodle manual registration walkthrough:

  1. In your Moodle instance, navigate to Site administration > Plugins > External Tool > Manage tools.
  2. Click configure a tool manually.
  3. Complete the Tool Settings section using the values below:
    1. Tool name: Kialo Edu
    2. Tool URL: https://www.kialo-edu.com/
    3. Tool description: Insert any description for teachers to see, such as Perfect for class discussions and argumentative reasoning, online debates are easy with Kialo Edu!
    4. LTI version: LTI 1.3
    5. Public key type: Keyset URL
    6. Public keyset: https://www.kialo-edu.com/lti/jwks.json
    7. Initiate login URL: https://www.kialo-edu.com/lti/start
    8. Redirection URL(s): https://www.kialo-edu.com/lti/launch
    9. Tool configuration usage: Show in activity chooser and as a preconfigured tool (optional but recommended)
    10. Default launch container: New window (optional but recommended)
    11. Check the Supports Deep Linking option
    12. Content Selection URL: https://kialo-edu.com/lti/deeplink
  4. In the Privacy section, select the following (read more):
    1. Share launcher’s name with tool: Always
    2. Share launcher’s email with tool: Always
  5. Done! You can recommend educators view the Creating a New Kialo Activity section on how to add a Kialo activity in their course.

Regarding privacy settings: The launcher’s name and email are required in order to automatically provide an account for students who do not yet have a Kialo account, and set the username of the provisioned account to be the same as the one used by the student in Moodle. Students are not able to participate in discussions without an account and this process is necessary to provide a seamless experience without students having to actively register themselves. After one account is created for a student, the same account will be reused whenever a discussion activity in Moodle is accessed.

2. Teachers: Registering Kialo as External Course Specific Tool

If you would like to use Kialo as a tool in your Moodle course but Kialo has not yet been registered as a tool by your Moodle administrator, you can register Kialo as a course specific tool.

If this is your first time adding Kialo as a course specific tool on Moodle:

  1. Add an appropriate Activity Name, such as Kialo discussion about Shakespeare.
  2. Click the + to the right of the Preconfigured tool menu.
  3. Complete the External tool configuration form using the values below. See the screenshot below to double-check your form.
    1. In the Tool Settings section, insert the following:
      1. Tool name: Kialo
      2. Tool URL: https://www.kialo-edu.com/
      3. LTI version: LTI 1.3
      4. Public keyset: https://www.kialo-edu.com/lti/jwks.json
      5. Initiate login URL: https://www.kialo-edu.com/lti/start
      6. Redirection URI(s): https://www.kialo-edu.com/lti/launch
      7. Default launch container: New window 
      8. Check the Supports Deep Linking option
    2. In the Privacy section, select the following: (read more)
      • Share launcher’s name with tool: Always
      • Share launcher’s email with tool: Always
  4. Click Save changes.
  5. Click Select Content, then select the Kialo discussion to use for the activity.
  6. Save the activity. Kialo has now been registered as a course specific tool!

After registering Kialo as a course specific tool, to add a new Kialo activity:

  1. Open your Moodle course and enable Edit mode.
  2. Click Add an activity or resource in the appropriate topic.
  3. Select External tool.
  4. Add an appropriate Activity Name, such as Kialo discussion about Shakespeare.
  5. In the Preconfigured tool menu, select Kialo.
  6. Click Select Content. A new window should open showing you all of your discussions on your Kialo account.
    1. If this button is grayed out, refresh the page, ensure Kialo is still selected as the Preconfigured tool, then click Select Content again.
    2. In case your browser blocks the automatic pop up, follow the instructions on the page to return to the previous window.
  7. Select the Kialo discussion to use for the activity, then click Select Discussion.
  8. Adjust any further settings if required, then click the appropriate Save button.

Creating a new Kialo activity

After Kialo has been added as an external tool to your Moodle instance, to create a Kialo activity:

  1. Open your Moodle course and enable Edit mode.
  2. Click Add an activity or resource in the appropriate topic.
    1. Select Kialo and add an Activity name if the option appears. (This requires Kialo to have been configured to “Show in activity chooser and as a preconfigured tool“ by Moodle administrators.)
    2. Otherwise, select External tool. Add an Activity name, then choose Kialo in the Preconfigured tool menu.
  3. Click Select Content. A new window should open showing you all of your discussions on your Kialo account.
    1. Note: If your browser blocks the automatic pop up, follow the instructions on the page.
  4. Select the discussion to embed, then click Select Discussion. The tab will close, returning you to Moodle.
  5. Adjust any further settings if required, then click the appropriate Save button.

Using the Kialo LTI with Moodle Group Mode

The Kialo LTI does not currently inherently support Moodle group mode, however you can use a workaround. Inherent Moodle group support is planned in Q1 2024 – submit your email address to be notified when it is released.

If group mode is enabled, each group would normally receive their own instance of the same activity. Currently, using the Kialo LTI normally with group mode will result in all groups receiving access to the same Kialo discussion, rather than each group receiving their own discussion.

As a workaround, you can manually create a Kialo activity for each group, then use the restrict access setting to only show each activity to the desired group:

  1. Ensure your Moodle groups are set up as usual and create the desired starter Kialo discussion for your groups.
  2. In Kialo, clone the discussion until you have an equal amount of discussions and groups. For example, if there are four groups, clone the discussion three times so there are four discussions total. You may find it useful to number each discussion title to keep track easier.
  3. Create and set the restriction rules for the first discussion:
    • Create a Kialo activity in Moodle using the first Kialo discussion.
    • In the Restrict Access section of the activity settings, click the Add restriction button.
    • Click Grouping.
    • Select the first group.
    • Click Add Restriction.
    • Save the activity.
  4. Repeat the previous step for each group, selecting the appropriate Kialo discussion activity and group for each step. When finished, you should have a Kialo activity for each group with a separate discussion selected.

Once complete, you will be able to view separate Kialo activities and discussions for each group, and each group will have its own activity.

How accounts are managed

For Teachers

Teachers accessing Kialo via LTI need to be signed in on Kialo Edu (https://kialo-edu.com) in order to use the activity. If they are already signed in to Kialo, they can immediately use the LTI activity. Otherwise, they are prompted to log in (or create an account) the first time they click on “Select content”, or when opening an already configured Kialo activity.

For Students

Students who access Kialo via an LTI activity are usually automatically provided with a Kialo account with the same email address as provided by the LMS. The exact behavior depends on whether an account with the same email address already existed previously and some other factors.

Generally, if no Kialo account with the student’s email address has existed previously, a new account will be automatically created and the student is automatically signed into that account whenever they access Kialo via LTI. Subsequently, in most cases students won’t receive a login prompt.

If a Kialo account with the student’s email address has already existed before accessing Kialo via LTI, the student is prompted to log into that account by entering their password. Once they have entered their password, the account is linked to the LMS, so that the next time they access Kialo via LTI they are automatically signed in (even if they have been logged out of https://kialo-edu.com or if they access it via LTI on a different computer).

For security reasons, the student may be prompted to re-enter their password in certain circumstances, e.g. when they add or change an authentication method on their Kialo account.

Student Account Provisioning Details

When accounts are automatically created during the LTI process, their Kialo username is derived from the LMS account details. If still available, the Kialo account will have the same username as the account in the LMS. If the name is not available or invalid in Kialo, a valid account name will automatically be generated based on the student’s full name.

For provisioned student accounts, the Kialo terms and conditions are implicitly accepted, without the students having to explicitly check any checkboxes.

Was this article helpful?

Back to top