Enabling the Momotor app for a course
=====================================

Enabling the app for a course is done by adding it to the course navigation.
In Canvas, the course navigator is configured from :menuselection:`Course --> Settings --> Navigation`:

.. image:: default_nav.png

By default, the Momotor tab is hidden. To make it visible, click the drop-down arrow at the end of the Momotor
tab and click :guilabel:`enable` or drag the Momotor tab to the top section.

The Momotor tab can be positioned anywhere in the navigator, but since Momotor is related to the assignments,
we advise to put it directly beneath the Assignments tab.

.. image:: modified_nav.png

Save the changes to the navigator. The Momotor section should now be available in the navigator.

Disabling the Momotor app
-------------------------

The app can be removed from the navigation by moving the Momotor tab in the course navigator to the hidden section.

This will only remove the app from the navigator making it impossible to access, but existing configuration and
results will not be deleted and processing of submissions for configured assignments will remain active.

Authorising the Momotor app
===========================

In order to process the assignments, the app needs access to the course data in Canvas.
The first time you select the Momotor tab in the navigator to open the app, it will ask for authorisation
to access your Canvas account. Click :guilabel:`Authorise` to continue.

.. image:: authorise.png

Students will need to authorise the app as well when they want to review the results of their submissions in Momotor.
However, for the processing of submissions only the teacher’s access is needed. Student submissions will be
processed even if they have not authorised the app.

Revoking Momotor app authorisation
----------------------------------

Without a teacher’s access to Canvas, the app will not be able to function. If however you want to revoke the app’s
authorisation, you can do so from your Canvas profile settings. Momotor will be listed as an approved integration.
To remove the authorisation, click the trash can icon after the app name.

.. _lti_1p0_deprecation:

Upgrading from LTI 1.0
======================

"LTI" is the protocol that Canvas uses to integrate Momotor. There are multiple versions, the latest supported by
Momotor LTI being LTI 1.3. Older LTI versions have been
`deprecated <http://www.imsglobal.org/lti-security-announcement-and-deprecation-schedule>`_.

Unfortunately, the upgrade from the older version to the latest LTI version is not done automatically. If you
see the following message when opening Momotor:

.. image:: lti_deprecation_alert.png

you need to upgrade the integration. This can be done by going to :menuselection:`Course --> Settings --> Navigation`
in Canvas, disabling the active "Momotor" tab and enabling the disabled "Momotor" tab. Unfortunately these have
the same label and cannot be visually distinguished.

If the new integration is active, the warning shown above will not show when re-opening Momotor.