Dit document bevat instructies voor het integreren van het videoplatform in uw Moodle-leeromgeving (LMS). Als u vragen hebt over een stap in dit proces, neemt u contact op met uw vaste account manager. Om de integratie uit te voeren hebt u een YuJa-sleutel, een gedeeld geheim en een zone-URL nodig. Deze vindt u in uw document voor zoneprovisioning.
Het videoplatform toevoegen als externe tool
Overzicht
Met de onderstaande stappen maakt u van het videoplatform een LTI-tool die toegankelijk is binnen een of meer van uw Moodle-cursussen.
Het videoplatform instellen als externe tool
- Meld u als beheerder aan bij Moodle.
- Kies in de linkerzijbalk Sitebeheer. Kies daaronder Plugins.
- Klik onder Externe tool op de knop Tools beheren.
- Klik op de volgende pagina op Een tool handmatig configureren.
- Vul het formulier dat verschijnt (hieronder afgebeeld) in met de onderstaande gegevens.
- Toolnaam: YuJa.
- Basis-URL van de tool: https://<YourInstitutionZone>.yuja.com/LMSEntry.jsp.
- Consumentensleutel: De door YuJa verstrekte Consumer Key.
- Gedeeld geheim: De door YuJa verstrekte Shared Key.
- Gebruik van toolconfiguratie: Weergeven als vooraf geconfigureerde tool bij het toevoegen van een externe tool.
- Standaard startcontainer: Selecteer Nieuw venster om de YuJa LTI-koppeling in een nieuw tabblad te openen (deze methode raden wij aan) of selecteer Insluiten om de YuJa LTI-koppeling in hetzelfde tabblad als Moodle te openen.
- Vouw het tabblad Privacy uit en maak de volgende selecties.
- Naam van de starter met de tool delen: Altijd.
- E-mailadres van de starter met de tool delen: Altijd.
- Cijfers van de tool accepteren: Altijd.
- Klik op Wijzigingen opslaan.
Het videoplatform toevoegen aan een cursus
In dit gedeelte vindt u instructies voor het toevoegen van YuJa als externe leertool aan een cursus.
- Meld u aan bij Moodle en ga naar de gewenste cursus.
-
Selecteer onder Cursusbeheer Bewerken aan.
-
Kies Een activiteit of materiaal toevoegen, selecteer Externe tool en klik vervolgens op Toevoegen.
- Voer onder Naam van de activiteit YuJa in.
-
Mogelijk vindt u YuJa onder Vooraf geconfigureerde tool. Selecteer het dan en ga direct door naar stap 7. Zo niet, laat het Type externe tool dan op Automatisch, op basis van tool-URL staan en ga verder met stap 6.
-
Als u YuJa niet hebt gevonden in het menu Type externe tool, voert u https://<YourInstitutionZone>.yuja.com/LMSEntry.jsp in het veld Tool-URL in. Als Moodle instellingen voor YuJa vindt, verschijnt naast het veld Start-URL de tekst Toolconfiguratie wordt gebruikt.
-
Klik op Meer weergeven… Selecteer onder Startcontainer Nieuw venster om de YuJa LTI-koppeling in een nieuw tabblad te openen of selecteer Insluiten om de YuJa LTI-koppeling in hetzelfde tabblad als Moodle te openen.
- Vouw het tabblad Privacy uit en maak de volgende selecties.
- Naam van de starter met de tool delen: Inschakelen.
- E-mailadres van de starter met de tool delen: Inschakelen.
- Cijfers van de tool accepteren: Inschakelen.
-
Scrol nadat u alle vereiste gegevens hebt ingevuld omlaag en klik op Opslaan en terug naar cursus.
-
Klik bovenaan de cursuspagina op de YuJa-activiteit. Zo controleert u of alles correct werkt.
Het videoplatform openen vanuit Moodle
YuJa richt de groepsruimte in met de informatie die LTI doorgeeft, waaronder de cursusnaam, gebruikersrollen en machtigingen binnen de cursus. De onderstaande schermafbeelding laat zien hoe YuJa eruit hoort te zien zodra het is geïnstalleerd en ingesloten in Moodle.
De YuJa Media Chooser voor Moodle installeren
Overzicht
Opmerking: Bij deze installatie wordt ervan uitgegaan dat u de standaard LTI-installatie van het videoplatform al hebt uitgevoerd.
Dit document bevat instructies voor het integreren van de YuJa Media Chooser-extensie in uw Moodle-leeromgeving (LMS) met behulp van LTI. Deze extensie, de Moodle Media Chooser genoemd, kan in uw Moodle-LMS worden geïnstalleerd en is ontworpen voor Moodle 2.4+.
Als u vragen hebt over een stap in dit proces, neemt u contact op met uw accountmanager. Hieronder vindt u de pluginarchitectuur van de Moodle LMS-extensie.
| Lokaal | (local/yuja) | Maakt LTI-configuratie mogelijk en zorgt voor LTI-integratie voor de andere plugins. |
| Atto | (lib/editor/atto/plugins/yuja) | Hiermee kunt u door YuJa gehoste media invoegen met de Atto-editor |
| TinyMce | (lib/editor/tinymce/plugins/yuja) | Hiermee kunt u door YuJa gehoste media invoegen met de TinyMCE-editor |
Installatie
- U ontvangt één zipbestand met de titel “YuJa Enterprise Video Platform - LMS Media Extension - Moodle Media Chooser”.zip. Pak dit bestand uit.
- Bij elke pluginmap ziet u een bijbehorend zipbestand. De zipbestanden heten “atto_yuja.zip”, “local_yuja.zip” en “tinymce_yuja.zip”.
- Geef via Sitebeheer/Plugins/Plugins installeren het zipbestand op en klik vervolgens op Plugin installeren vanuit het ZIP-bestand. Begin met het bestand “local_yuja.zip” en installeer daarna de andere twee.
- Als alternatief voor de optie Plugin installeren vanuit het ZIP-bestand kunt u, als u één zipbestand voor alle plugins hebt of de installatie handmatig wilt uitvoeren, de map “yuja” uit elk van de onderstaande locaties kopiëren naar de bijbehorende mappen op uw Moodle-server:
- Moodle 2.4+: Kopieer vanuit “tinymce_yuja” de map “yuja” naar (path/to/your/moodle/lib/editor/tinymce/plugins/)
- Moodle 2.7+: Kopieer vanuit “atto_yuja” de map “yuja” naar (path/to/your/moodle/lib/editor/atto/plugins/)
- Kopieer vanuit “yuja_local” de map “yuja” naar (path/to/your/moodle/local/)
- Kies voor de volgende kopieerstap de juiste optie voor uw Moodle-versie:
- Om de installatie af te ronden, meldt u zich als beheerder aan bij uw Moodle en gaat u naar Sitebeheer/Meldingen. U ziet dan de gewijzigde plugins in de lijst. Is dat niet het geval, klik dan op Controleren op beschikbare updates.
- Zodra de gewijzigde plugins in de lijst staan, klikt u op Moodle-database nu upgraden om de installatie te voltooien.
- Als u de plugin local_yuja voor het eerst installeert, wordt u gevraagd uw configuratiegegevens in te voeren. De configuratiegegevens komen overeen met die waarmee u het videoplatform in sectie 1 hebt geconfigureerd.
- Als u de Atto-plugin voor het eerst installeert, houd er dan rekening mee dat hiervoor extra configuratie nodig is, zoals hieronder beschreven.
- Tot slot bevat Moodle een instelling die standaard voorkomt dat gebruikers iframes invoegen. Zorg er daarom voor dat Vertrouwde inhoud inschakelen onder Sitebeheer/Beveiliging/Sitebeleid is aangevinkt om iframes toe te staan. U kunt rechtstreeks naar de instellingenpagina gaan via https://<moodle_url>/admin/settings.php?section=sitepolicies.
Aanvullende configuraties
Hieronder vindt u de aanvullende stappen voor het configureren van de YuJa Media Chooser-plugins.
- Lokale plugin:
- Het dialoogvenster Instellingen voor de lokale plugin wordt direct na de installatie weergegeven. Is dat niet het geval, of wilt u het later openen, ga dan naar Sitebeheer/Plugins/Lokale plugins/YuJa Package Config.
- U wordt gevraagd uw YuJa-toegangs-URL, Consumentensleutel en Gedeeld geheim in te voeren. Deze hebt u ontvangen van uw YuJa-accountmanager en het zijn dezelfde gegevens die u gebruikt om een externe LTI-tool te configureren voor toegang tot het videoplatform.
- Atto Rich Text Editor-plugin:
- Na de installatie vereist de Atto-plugin een beetje extra configuratie.
- Ga naar http://your.moodle/admin/settings.php?section=editorsettingsatto en voeg in het tekstgebied Toolbar config een nieuwe regel toe met yuja = yuja op de plek waar u de knop wilt laten verschijnen. Raadpleeg http://docs.moodle.org/27/en/Text_editor#Toolbar_settings voor het afstemmen van de werkbalk van Atto op uw voorkeuren.
- TinyMCE Rich Text Editor-plugin:
- Zodra de plugin is geïnstalleerd (zie hierboven), verloopt de configuratie automatisch en hoeft u verder niets te doen.
Optioneel: de Media Chooser met Grade Book Sync voor Moodle installeren
Overzicht
Content Item Message (CIM) is een protocol waarmee LTI-gebaseerde tools authenticatiegegevens kunnen terugsturen voor onder meer ingesloten video's. In Moodle kan CIM worden gebruikt om inhoud in te sluiten via een door Moodle gedefinieerde CIM-workflow.
Video's die met de CIM-workflow van Moodle in Moodle worden geplaatst, kunnen analysegegevens bijhouden (de YuJa-gebruiker die de video bekijkt is dan bekend, in plaats van dat de kijker als “Anoniem” wordt gemarkeerd).
Opmerking: Moodle ondersteunt momenteel geen insluiting op basis van CIM via teksteditors. De Moodle-ontwikkelaarsgemeenschap heeft echter een openstaand ticket om LTI Content Item via teksteditors in de toekomst te ondersteunen (zie https://tracker.moodle.org/browse/MDL-56229 en https://moodle.org/mod/forum/discuss.php?d=354590).
De Media Chooser met Grade Book Sync voor Moodle installeren
Deze CIM-tool moet via de Moodle-LMS worden geïnstalleerd.
-
Ga naar Sitebeheer/Plugins/Activiteitenmodules/Externe tools/Tools beheren.
-
Klik op Een tool handmatig configureren. Vul de volgende velden in:
- Toolnaam: YuJa Media Chooser with Grade Book Sync.
- Tool-URL: https://<your_base_url>/LMSEntry.jsp
- Consumentensleutel: <your_consumer_key>
- Gedeeld geheim: <your_shared_secret>
- Gebruik van toolconfiguratie: Weergeven in de activiteitenkiezer en als vooraf geconfigureerde tool.
- Meer weergeven…: Selecteer het selectievakje Content-Item Message
- Vouw het tabblad Privacy uit en maak de volgende selecties.
- Naam van de starter met de tool delen: Altijd.
- E-mailadres van de starter met de tool delen: Altijd.
- Cijfers van de tool accepteren: Altijd.
-
Klik op Wijzigingen opslaan.
De Media Chooser met Grade Book Sync gebruiken om inhoud aan de cursus toe te voegen
Zodra CIM is ingeschakeld, kunt u video's uploaden met de geïnstalleerde tools.
-
Ga in Moodle naar de gewenste cursus, klik rechtsboven op het tandwielpictogram en kies Bewerken aan.
-
Selecteer onder het gewenste onderwerp Een activiteit of materiaal toevoegen. Kies in het menu Activiteiten YuJa Media Chooser with Grade Book Sync en klik op Toevoegen.
-
Klik op Inhoud selecteren. Hiermee opent u de YuJa Media Chooser.
- Scrol omlaag en selecteer een video.
- Vouw het tabblad Privacy uit en maak de volgende selecties.
- Naam van de starter met de tool delen: Inschakelen.
- E-mailadres van de starter met de tool delen: Inschakelen.
- Cijfers van de tool accepteren: Inschakelen.
-
Klik op Opslaan en terug naar cursus of Opslaan en weergeven. Uw video is nu beschikbaar als activiteit onder uw onderwerp.
Optioneel: LTI-gebaseerde cijferlijstintegratie met Moodle
Overzicht
Dit gedeelte bevat instructies voor de optionele integratie van de cijferlijst van het videoplatform in uw Moodle-cijferlijst. Hierbij wordt ervan uitgegaan dat u de voorgaande gedeelten al hebt gevolgd en de installatie hebt voltooid.
De Moodle-cijferlijst inschakelen
- Meld u aan als docent, selecteer de gewenste cursus en klik op het tandwielpictogram om Bewerken aan te zetten.
- Klik rechts op Bewerken en kies in het vervolgkeuzemenu Instellingen bewerken.
- Maak onder het tabblad Privacy de volgende selecties.
- Naam van de starter met de tool delen: Inschakelen.
- E-mailadres van de starter met de tool delen: Inschakelen.
- Cijfers van de tool accepteren: Inschakelen.
- Pas onder het tabblad Cijfer het Cijfertype en het Maximumcijfer aan naar wens.
- Klik op Opslaan en weergeven of Opslaan en terug naar cursus.
Cijfers van YuJa terug synchroniseren naar Moodle
Elke student moet de cijferlijst activeren wanneer die voor het eerst wordt gebruikt. Dit doet de student door de cursus te selecteren en vervolgens op YuJa te klikken. Na deze eerste activering wordt de cijferlijst automatisch bijgewerkt en kunnen studenten hun cijfer bekijken door op het tabblad Cijfers te klikken.
Optioneel: de multikolom-cijferlijstintegratie van Moodle gebruiken via de Media Chooser met Grade Book Sync voor Moodle
Een YuJa-quiz configureren
- Configureer de Media Chooser met Grade Book Sync. Als u die nog niet eerder hebt geïnstalleerd, volgt u de instructies in sectie 3.
-
Zorg er bij het toevoegen van uw YuJa Media Chooser-tool voor dat Cijfers accepteren op Altijd staat. Deze instelling vindt u in het gedeelte Privacy.
-
U kunt de instelling ook op Delegeren aan docent zetten en deze per quiz wijzigen, zodat u kunt kiezen welke quizzen aan de Moodle-cijferlijst worden toegevoegd.
Een YuJa-quiz plaatsen
- Voeg een quiz toe aan uw cursus met de YuJa Media Chooser met Grade Book Sync. Als u die nog niet eerder hebt geïnstalleerd, volgt u de instructies in sectie 3.
- Als u in de vorige stap Delegeren aan docent hebt geselecteerd, zorgt u er na het selecteren van een quiz met de YuJa Media Chooser voor dat de instelling Cijfers accepteren onder Privacy is aangevinkt. Onder Cijfer kunt u bovendien het maximumcijfer voor deze opdracht selecteren.
Deelnemen aan een videoquiz
-
Ga als student naar de startpagina van de cursus. Als u op de nieuw gepubliceerde opdracht klikt, gaat u naar de geplaatste YuJa-videoquiz.
-
Klik op Indienen nadat u de quiz hebt voltooid. De score van de student wordt automatisch vastgelegd in de Moodle-cijferlijst.
De cijferlijst bekijken
- Als docent: meld u aan als docent. Ga naar de startpagina van uw cursus. Klik in de linkerzijbalk op het tabblad Cijfers. Hier ziet u de score van elke student voor elke quiz, waarbij elke student een rij is en elke quiz een kolom.
- Als student: meld u aan als student en ga naar het tabblad Cijfers door in de linkerzijbalk op Cijfers te klikken. U ziet de cijfers voor de opdrachten die u hebt gemaakt.
Optioneel: Moodle Roster Sync
Overzicht
Met de plugin Moodle Roster Sync kunt u de deelnemerslijst van het platform synchroniseren met actief gebruikte cursussen in Moodle.
Moodle Roster Sync installeren
Om Moodle Roster Sync te gebruiken, moet u de plugin installeren.
- Ga naar Sitebeheer/Plugins/Plugins installeren.
- Upload het zipbestand van Roster Sync dat u van uw accountmanager hebt ontvangen. Klik op Meer weergeven. Selecteer als Plugintype Lokale plugin. Klik op Plugin installeren vanuit het ZIP-bestand.
- Ga verder met het uploaden van de plugin en het upgraden van de Moodle-database. Voer vervolgens de vereiste gegevens in zoals hieronder.
- Toegangs-URL: https://<your_base_url>/LMSEntry.jsp
- Consumentensleutel: <your_consumer_key>
- Gedeeld geheim: <your_shared_secret>
- Klik op Wijzigingen opslaan. Moodle Roster Sync is nu met succes geïnstalleerd.