# Moodle : Using Digital Samba as an LTI external tool

### Adding Digital Samba as an external tool

*On your Digital Samba Dashboard* : 

*  The LTI external tool will use your[ default room settings](https://dashboard.digitalsamba.com/default-room-settings).
*  You should set available roles to **Teachers** & **Students** & make **Students** default role.

<figure><img src="https://lh7-eu.googleusercontent.com/docsz/AD_4nXebJse5aRRW8JYt1Lu7o_6oaofwysDGzXafPAI1e07CFg3bkITP8UAbmRD7GyB6hV1CqR_iDUANdU8fPUj76hel-4g39rzo473yFKCfTKyAFxk7jdm-Qe14cLEfzSoAAcmeGNpEF3z5Nn0-Sd2QkINOH0ut?key=s1hGXZw-M-XPoOGO_N7hrQ" alt=""><figcaption><p>Digital Samba default room settings</p></figcaption></figure>

* You can configure the rest of your default room settings to suit your requirements.

*On Moodle :*

* Log into your Moodle LMS instance as an Admin.
* Navigate to ***Site Administration*** > ***Plug-ins*** > ***Activity modules*** > ***External Tool*** > ***Manage tools***
* In the ***Add tool*** area – enter **<https://lti.digitalsamba.com/lti/1.3/register>** and click the ***Add LTI Advantage*** button.
* This will dynamically register Digital Samba as an LTI external tool on your LMS.
* Once this is done – you will see the Digital Samba tool in a pending state.
* Click on the three lines ( Tool Configuration details ) and send this information back to us so that we can enable your LMS on our side.

<figure><img src="https://lh7-eu.googleusercontent.com/docsz/AD_4nXdBb5jINMMhmuYdtX_h1K-_AQip-DOwJeCL-Avl_mO-IFlqvQtraMt4bSkQH6tDC_ejh9VQZ3x9GMvkUPVU2x_O_wQFde5AKbMo7uMS0CcvGYoBYYB-cUUuSrJst8SoH1o0U9g3dpjgH2nC4wVRNMeEhJtC?key=s1hGXZw-M-XPoOGO_N7hrQ" alt=""><figcaption><p>Moodle tool configuration details</p></figcaption></figure>

* Once you have confirmation back from us that your LMS is enabled, click the Activate button.
* You may want to adjust a couple of settings within the tool to make best use of it.
* To access these click the Settings cog :

1. Make the **Digital Samba** tool available in the moodle **Activity chooser** :

   * For *Tool configuration usage* > Select the ‘*Show as preconfigured tool when adding an external tool*’ option.

   <figure><img src="https://lh7-eu.googleusercontent.com/docsz/AD_4nXeeZvNJgunabaM2ALZjQpM3Bx6cRFjGR36XxKdZCMbtDD_MXBhBbPZ-3TAzUxNiR4xmB5KHywY6WHoWFtVXOSZoGfXQbwzSPCXjk2iriv3_Xtlom6fiHrG2Nwi2CPuXG5qY7RzWBYK5sLFj-iunvL5tDdl9?key=s1hGXZw-M-XPoOGO_N7hrQ" alt=""><figcaption><p>Tool configuration usage</p></figcaption></figure>

2. Use LMS users names in Digital Samba rooms

   * In the **Privacy** section :
   * For *Share launcher's name* with tool select *Always*

   <figure><img src="https://lh7-eu.googleusercontent.com/docsz/AD_4nXfPqs7oejKE3rDrdHLFboM8D4xuO4mIcj1ybTR0FJwwSuXTvXVIV714-pUewfpYnJX9zGhGcMvtd5w8yMFIGQDAErA83hKrWqPXA0U6zUuuMEKWwDnRrz2kT0laWzp64Lm18ueQ-s_zdW2t1V6_pLJBdP5c?key=s1hGXZw-M-XPoOGO_N7hrQ" alt=""><figcaption><p>Share LMS name in external tool</p></figcaption></figure>

Congratulations! You are now ready to use Digital Samba rooms in your LMS course!

***

### Using Digital Samba as an external tool in an LMS course&#x20;

* Go to **My courses.**
* Enter ‘***Edit Mode***’ and click on the three dots to create a new course.

<figure><img src="https://lh7-eu.googleusercontent.com/docsz/AD_4nXc6t51DMq0Xg1cy65i6QL5XrCtnVIB6ZORr25ys9NKZRjFhg7wNDpVRIprzqC8HHUIo5DobIY3VmWxOkPmLI-RxtOW3Muh9o1eYNiF9g3URtuwpKv3Tl3U4ned0ygs9rwpPa5Sk421pPAmsFipHS7-oTftJ?key=s1hGXZw-M-XPoOGO_N7hrQ" alt=""><figcaption><p>New course</p></figcaption></figure>

* Fill in Course details as per your usual process and click **Save and display.**
* In desired section of your couse click on the ***Add an Activity or resource button.***

<figure><img src="https://lh7-eu.googleusercontent.com/docsz/AD_4nXfROtx1JCLHWVPZ1t2rL12Sti3avIwSz3WQFeIIYnIgVYXuRnxEfJR9yCLdlzNALletKhu50lDNe_TJMAwVQ-GIUu0jFQHCuniko3FVzIWyoH3kOdPVoXrj4zIo4sdlTpTEencyP5WdpqUXPBZS6rdaOBi7?key=s1hGXZw-M-XPoOGO_N7hrQ" alt=""><figcaption><p>Add activity or resource</p></figcaption></figure>

* Select **Digital Samba** from the activity/resource chooser

<figure><img src="https://lh7-eu.googleusercontent.com/docsz/AD_4nXdJu5YdrshV3lpDRqLS9uPVY8jp3vnp3Yq97HwDRblyHtz51i8OfEGlEi61iosXJKNk71nOHQBpKaWGYepobglbThurhJgIhR-A6WxNbtAHxNIw_34MKl3ZyAnSLrpdsQW2v6irQ2ReEF9T3WD3qKgt53Ai?key=s1hGXZw-M-XPoOGO_N7hrQ" alt=""><figcaption><p>Activity and resource chooser</p></figcaption></figure>

* Give the Activity a name and fill out any other settings as per your normal processes.
* Click **Save and return to course.**
* You can then enroll users in the course.
* Roles assigned here will be reflected in the room with the[ permissions assigned to the Student and Teacher roles](https://docs.digitalsamba.com/dashboard/adding-moderation-to-your-rooms-with-roles/permissions) in your[ Digital Samba Dashboard](https://dashboard.digitalsamba.com/).

<figure><img src="https://lh7-eu.googleusercontent.com/docsz/AD_4nXcHgw2GlZZKIBwf9hQ7D9oWmhFsdRJsU_uk-kuC1XJi-oPnskXJDbUVJPZ4GV8voaJgd5NdJoltQySAhCvwHk59CTXnl7RAG8lB23pS68zfU2jqrrLlOp46A_t6HEJr-M0-vJAyMHA0WYD8FBgkoIXFnJk?key=s1hGXZw-M-XPoOGO_N7hrQ" alt=""><figcaption><p>Enroll users in course</p></figcaption></figure>

* Your teachers and students will then be able to join the room whenever it is time for class!

<figure><img src="https://lh7-eu.googleusercontent.com/docsz/AD_4nXdq7fTzHCTmyW93mJ7HP4RXDkrRQMmixVAvT1OO7uZOrbWYIRSDB79S8vP24sneyCQipie1_vUS1vOmOQ5FR63xc5uw0oauL0ii_7I1Ng0qenK6WfmD4xoiE1ZmeetH6nqaRxEFgPLQbLE-viZSFLmM70sp?key=s1hGXZw-M-XPoOGO_N7hrQ" alt=""><figcaption><p>Join the Digital Samba class</p></figcaption></figure>