.. include:: /shortcuts.rstext .. index:: pair: LTI 1.1 setup; Mahara Setup of LTI 1.1 in Mahara ------------------------------ In order to use LTI, complete the setup in Mahara as well as in the LMS that you want to connect. Mahara supports LTI 1.1 and **experimentally** :ref:`LTI (1.3) Advantage `. .. index:: single: LTI; Enable LTI 1.1 in Mahara .. _enable_lti: Enable LTI 1.1 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ *Administration menu → Extensions → Plugin administration → lti* Ensure that LTI 1.1 is enabled for your Mahara site. You do that by :ref:`activating the plugin 'lti' ` in the *Plugin administration*. .. figure:: /images/administration/plugin_lti_enabled.* :alt: The LTI plugin is enabled The LTI plugin is enabled The LTI plugin is enabled when there are no warning signs on the plugin page and the text at the top reads 'The LTI API is enabled'. .. note:: It is best to enable LTI using this method rather than enabling individual web services manually to ensure that all dependencies are set up correctly. .. index:: single: LTI; Enable LTI 1.1 for institution .. _enable_lti_institution: Enable LTI 1.1 for an institution ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can enable LTI for an institution as site administrator. Institution administrators cannot set up LTI for their own institution. .. figure:: /images/administration/external/external_apps_setup.* :alt: Enable LTI 1.1 for an institution Enable LTI 1.1 for an institution #. Go to *Administration menu → Web services → External apps*. #. **Application**: Give your application that you want to connect a name. This is an identifier that only you need to understand. #. Choose the institution in which you want to set up the application. #. Select 'LTI 1.1' from the drop-down menu. #. Click the *Add* button to generate the consumer key and secret. .. note:: If your institution does not already have the 'Web services' authentication method, it will be added automatically. #. Click the *Edit* button |edit| to make changes to the web services configuration. #. Click the *Manage* button |manage| to make changes to the authentication part of this app. #. Click the *Delete* button |delete| to remove this app. .. seealso:: You can :ref:`connect a second authentication method to LTI ` to allow account holders to log in via Mahara and via the LMS. .. _lti_assessment_settings: Confirm LTI 1.1 assessment settings ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Before any learners can use the activity that you set up in the LMS, you need to confirm the activity settings as a teacher. .. figure:: /images/administration/external/assessment_settings.* :alt: Set the submission criteria Set the submission criteria #. **Email tutors on student submission**: Set this to 'Yes' if course tutors / teachers / assessors shall be informed when a submission has been made. #. **Keep portfolio locked after grading**: Set this to 'Yes' if you don't want learners to make any changes to their portfolio once grading is done. The default setting is 'No'. .. note:: This option will keep the portfolio locked from editing, and learners can't delete any of the submitted artefacts or make changes to them or delete the portfolio itself from their account. They can still make a copy or change artefacts that are not affected by the locking. #. **Archive when graded**: If you want or need to keep a copy of the graded portfolio to comply with assessment regulations, you can set this option to 'Yes'. An archive is made automatically after you finished grading and placed on the Mahara server. Administrators can view the archives in the ':ref:`Archived submissions `', and a server administrator can download all archives from a folder within the content file structure of Mahara. .. warning:: SmartEvidence collections cannot yet be archived properly as Leap2A. #. Click the *Save and allow submissions* button to confirm the settings and allow your learners to submit their portfolios. .. note:: You can change the assignment settings until the first learner submitted their portfolio. After that, they are locked in. Currently, learners cannot re-submit portfolios to the same activity once you've completed grading. They can also not make any changes to the portfolio while it is being assessed. .. _submit_lti_portfolio: Submit a portfolio as learner ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ As a learner, you can submit any of your portfolios to an assignment in your learning management system (LMS). .. note:: Any portfolio you submit is locked. Depending on the assignment settings, you may be able to edit the portfolio again after grading. .. figure:: /images/administration/external/submit_portfolio.* :alt: Submit a portfolio for assessment via your LMS Submit a portfolio for assessment via your LMS #. Click the link to the assignment in your LMS. Mahara opens either in a new tab or embedded as iframe depending on the assignment settings. #. If you don't already have a portfolio that you can submit for this particular assignment, click the *create one* link. You are taken to *Pages and collections* where you can create a new portfolio. Once you are finished, click the assignment link in your LMS again to be taken to the correct submission screen. #. If you do have a portfolio to submit, select it from the drop-down menu. You can select an entire collection or a page when it is not part of a collection. #. Click the *Submit* button to confirm your choice. .. note:: By clicking the *Submit* button, your portfolio is locked from editing. #. You receive a confirmation on screen that lets you know when you submitted the portfolio. .. note:: :index:`If ` you want to or are asked by your assessor to make changes to your submitted portfolio, you can revoke the submission, make the changes, and then submit it again to the same activity. |revoke submission| This is only possible when the assessor has not yet graded your portfolio. Once your portfolio has been assessed and a grade given, you can see the result in Mahara after having clicked on the assignment link in the LMS. .. figure:: /images/administration/external/assessed_portfolio.* :alt: View grade in Mahara View grade in Mahara #. Review when you submitted your portfolio. #. View the number of points you received on your portfolio. #. View who assessed your portfolio. #. Shows the time when the portfolio was assessed. Assess a portfolio as teacher ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Once learners have submitted portfolios for assessment, as a teacher, you can click the link to the assignment in the LMS and be taken to Mahara, where you see all the submitted portfolios. .. figure:: /images/administration/external/teacher_to_grade.* :alt: View portfolios that require assessment View portfolios that require assessment #. **First name**: The first name of the portfolio author. #. **Last name**: The last name of the portfolio author. #. **Portfolio title**: Title of the submitted portfolio. #. **Time submitted**: Time when the author submitted their portfolio. #. Click the *Grade* link to be taken to the portfolio itself and give it a grade. #. **Grade**: Grade given for this portfolio out of 100 points. #. **Time graded**: Time when the grade was submitted. #. **Graded by**: Teacher who graded the portfolio. When you click the *Grade* link, you are taken to the portfolio and can review it. As usual, you can leave comments on the content where available and on a page itself. Once you are ready to give the grade, you can select it above the comments section. .. figure:: /images/administration/external/teacher_grading.* :alt: Grade a portfolio Grade a portfolio #. The name of the assignment is displayed. #. The course title from the LMS is listed. #. The time when the learner submitted the portfolio is shown. #. **Grade**: Select a grade between 0 and 100 points from the drop-down menu. .. note:: If the learner should make changes before you can give a final grade, do not enter a grade here but give the learner feedback, e.g. private feedback on a page, and let them know what to change. They can then revoke their submission, make the changes, and resubmit their portfolio to the same assignment. #. Click the *Submit* button to lock the grade in. You cannot revoke your decision. #. The grade is also entered into the gradebook in the LMS.