Allyn työkalujen sekä suodatin- ja raporttilisäosien asentaminen

Lisäosien 3.3-versiot ovat yhteensopivia Moodle 3.2:n kanssa

  1. Lataa tai kloonaa Allyn hallintatyökalun tarvittava versio githubista.

    1. ZIP-tiedostona lataaminen
      1. Vaihda haaraversiota tarvittaessa.
      2. Tarkista version.php-tiedostosta, täsmääkö vaadittu Moodle-versionumero (kohdasta requires) ja -julkaisuversio oman Moodle-versiosi kanssa. Esimerkki: Moodle 3.4

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        3.4.3-julkaisun pitäisi toimia Moodle 3.4 -asennusten kanssa. Jos nämä parametrit eivät täsmää Moodle-asennuksesi kanssa, sinun täytyy ehkä vaihtaa haaraa uudelleen.

        Lisätietoja vastaavista Moodle-julkaisuista ja -versionumeroista

      3. Lataa tiedostopankki valitsemalla Clone or download > Download ZIP.
    2. Git-tiedostopankin kloonaaminen
      1. Siirry tools-kansioon.

        cd [moodle location]/admin/tool

      2. Tiedostopankin kloonaaminen
        • SSH:n avulla

          git clone [email protected]:blackboard-open-source/moodle-tool_ally ally

        • HTTP:n avulla

          git clone https://github.com/blackboard-open-source/moodle-tool_ally.git ally

      3. Kuittaa ulos vastaava haara. Esimerkiksi Moodle 3.4:lle se on MOODLE_34_STABLE.

        git checkout MOODLE_34_STABLE

        Kuittaamalla haaran ulos voit hankkia myös päivityksiä. Jos olet siis päivittänyt Moodle-asennuksesi, voit vain kuitata ulos vastaavan haaran. Jos haaraa ei löydy, tiedostopankkisi saattaa olla vanhentunut. Voit tehdä tämän suorittamalla haun:

        git fetch

  2. Lataa tai kloonaa Ally-suodattimen tarvittava versio githubista.

    1. ZIP-tiedostona lataaminen
      1. Vaihda haaraversiota tarvittaessa.
      2. Tarkista version.php-tiedostosta, täsmääkö vaadittu Moodle-versionumero (kohdasta requires) ja -julkaisuversio oman Moodle-versiosi kanssa. Esimerkki: Moodle 3.4

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        3.4.3-julkaisun pitäisi toimia Moodle 3.4 -asennusten kanssa. Jos nämä parametrit eivät täsmää Moodle-asennuksesi kanssa, sinun täytyy ehkä vaihtaa haaraa uudelleen.

        Lue lisätietoja vastaavista Moodle-julkaisuista ja -versionumeroista.

      3. Lataa tiedostopankki valitsemalla Clone or download > Download ZIP.
    2. Git-tiedostopankin kloonaaminen
      1. Siirry filters-kansioon.

        cd [moodle location]/filter

      2. Tiedostopankin kloonaaminen
        • SSH:n avulla

          git clone [email protected]:blackboard-open-source/moodle-filter_ally ally

        • HTTP:n avulla

          git clone https://github.com/blackboard-open-source/moodle-filter_ally.git ally

      3. Kuittaa ulos vastaava haara. Esimerkiksi Moodle 3.4:lle se on MOODLE_34_STABLE.

        git checkout MOODLE_34_STABLE

        Kuittaamalla haaran ulos voit hankkia myös päivityksiä. Jos olet siis päivittänyt Moodle-asennuksesi, voit vain kuitata ulos vastaavan haaran. Jos haaraa ei löydy, tiedostopankkisi saattaa olla vanhentunut. Voit tehdä tämän suorittamalla haun:

        git fetch

  3. Lataa tai kloonaa Ally-raportin LTI-työkalun tarvittava versio githubista.

    1. ZIP-tiedostona lataaminen
      1. Vaihda haaraversiota tarvittaessa.
      2. Tarkista version.php-tiedostosta, täsmääkö vaadittu Moodle-versionumero (kohdasta requires) ja -julkaisuversio oman Moodle-versiosi kanssa. Esimerkki: Moodle 3.4

        $plugin->release = '3.4.3';

        $plugin->requires = 2017111300;

        3.4.3-julkaisun pitäisi toimia Moodle 3.4 -asennusten kanssa. Jos nämä parametrit eivät täsmää Moodle-asennuksesi kanssa, sinun täytyy ehkä vaihtaa haaraa uudelleen.

        Lue lisätietoja vastaavista Moodle-julkaisuista ja -versionumeroista.

      3. Lataa tiedostopankki valitsemalla Clone or download > Download ZIP.
    2. Git-tiedostopankin kloonaaminen
      1. Siirry reports-kansioon.

        cd [moodle location]/report

      2. Tiedostopankin kloonaaminen
        • SSH:n avulla

          git clone [email protected]:blackboard-open-source/moodle-report_allylti ally

        • HTTP:n avulla

          git clone https://github.com/blackboard-open-source/moodle-report_allylti.git ally

      3. Kuittaa ulos vastaava haara. Esimerkiksi Moodle 3.4:lle se on MOODLE_34_STABLE.

        git checkout MOODLE_34_STABLE

        Kuittaamalla haaran ulos voit hankkia myös päivityksiä. Jos olet siis päivittänyt Moodle-asennuksesi, voit vain kuitata ulos vastaavan haaran. Jos haaraa ei löydy, tiedostopankkisi saattaa olla vanhentunut. Voit tehdä tämän suorittamalla haun:

        git fetch

  4. Tarkista kansiorakenne.

    Hallintatyökalun hakemiston nimen pitäisi olla ally. Sillä tulisi olla seuraava polku:

    [yourmoodledir]/admin/tool/ally

    Suodatinhakemiston nimen pitäisi olla ally. Sillä tulisi olla seuraava polku:

    [yourmoodledir]/filter/ally

    Raporttihakemiston nimen pitäisi olla allylti. Sillä tulisi olla seuraava polku:

    [yourmoodledir]/report/allylti

  5. Varmista, että kukin kansio ja sen sisältö ovat luettavissa verkkopalvelimellasi.
  6. Kirjaudu Moodle-sivustoosi ylläpitäjänä ja avaa ylläpitosivu. Tämän pitäisi tarkistaa uusien lisäosien saatavuus ja tarjota sinulle mahdollisuus päivittää Moodle-tietokanta nyt napsauttamalla Upgrade Moodle database now -painiketta. Asenna lisäosat napsauttamalla tätä painiketta.
  7. Kun olet asentanut lisäosat, valitse Järjestelmän ylläpito > Lisäosat > Ylläpitäjän työkalut > Ally.
  8. Valitse Määritä Ally-verkkopalvelu automaattisesti.

    Seuraavassa näytössä näet verkkopalvelun tunnuksen ja URL-osoitteen, joilla voit testata Ally-verkkopalvelua.

    URL-osoitteen täytyy olla suoraan käytettävissä Internetissä, jotta Ally voi käyttää sitä.

    Jos testi onnistuu, sinun täytyy kopioida Ally-verkkopalvelun tunnus ja linkki sekä toimittaa ne tekniselle Ally-konsultillesi IronBox-tiedostonjakopalvelun avulla, jotta hän voi määrittää käytön ja tarjota sinulla käyttömahdollisuuden sähköpostilinkin avulla. Tekninen konsultti ottaa sinuun yhteyttä, kun hän on määrittänyt kaiken. Hän toimittaa sinulle avaimen, salaisuuden, URL-käynnistysosoitteen, tiedostopäivitysten URL-osoitteen ja asiakastunnuksen.

    Jos Moodle-esiintymäsi käyttää mukautettuja pakollisia kenttiä käyttäjätileille, Kirjaudu käyttäjänä -toiminnolla käytetty Allyn verkkopalvelun käyttäjä luodaan lisäosan automaattisen määrityksen yhteydessä, jotta nämä mukautetut kentät täytetään ja tallennetaan.


Moodle-lisäosan määritys

Tekninen Ally-konsultti luo Ally-asiakkaan edellisessä osiossa luodun Moodle-verkkopalvelutunnuksen avulla ja toimittaa sinulle tiedot Ally-lisäosan määrittämiseen.

  1. Kirjaudu sisään Moodle-ylläpitäjänä.
  2. Valitse Sivuston hallinta > Lisäosat > Ylläpitäjän työkalut. Valitse Ally-määritykset.
  3. Anna seuraavat tiedot:
    • Content Authors: Nämä ovat sisällöntuottajien käyttämät käyttäjäroolit. Roolin täytyy olla Hallinnoija, Kurssinluoja tai Opettaja (oletukset).

      Näitä ei tulisi yleensä muuttaa. Älä muuta näitä konsultoimatta ensin Allyn teknistä konsulttia.

    • Key: tämä on teknisen Ally-konsultin toimittama avain.
    • Secret: tämä on teknisen Ally-konsultin toimittama LTI-salaisuus.
    • Launch URL: tämä on teknisen Ally-konsultin toimittama LTI-käynnistysosoite.
    • File Update URL: tämä on teknisen Ally-konsultin toimittama tiedostojen päivittämisen ja tapahtumien URL-osoite. https://[AllyEnvironment].ally.ac/api/v1/events
    • Client ID: tämä on teknisen Ally-konsultin toimittama asiakastunnus.
  4. Tallenna muutokset.

Allyn oppilaitosraportti

Kun Ally-lisäosa on määritetty, voit käyttää Allyn oppilaitosraporttia.

Raportissa ei ole mitään tietoja, ennen kuin Ally-kurssit on synkronoitu ja ensimmäinen raportti luotu.

Pääset Allyn oppilaitosraporttiin valitsemalla Sivuston hallinta > Raportit. Valitse Helppokäyttöisyys.

Lisätietoja Allyn oppilaitosraportista


Ally-suodatin

Kun olet valmis tarjoamaan Allyn helppokäyttöisyysarvojen ilmaisimet ja vaihtoehtoisten versioiden lataamismahdollisuuden Moodlessa, sinun täytyy ottaa Ally-suodatin käyttöön.

Ally-suodattimen käyttöönotto

  1. Valitse Sivuston hallinta > Lisäosat > Moduulien yhteenveto.
  2. Siirry alas tekstisuodattimien osioon ja ota Ally-suodatin käyttöön.
  3. Siirrä Ally-suodatin suodatinluettelon ensimmäiseksi.