Korvaa Moodlen sisäänrakennetut Open Badges -merkit Badges Ninjalla (parempi suunnittelutyökalu, sama API)

Moodle on myöntänyt Open Badges -merkkejä sisäänrakennetusti versiosta 2.5 lähtien, ja monelle kurssiadministraattorille se on jo riittävä syy olla katsomatta muualle. Se on valmiiksi mukana, se on ilmainen, ja se tuottaa teknisesti standardinmukaisen tunnisteen. Miksi sitten niin moni Moodlen ylläpitäjä päätyy turhautuneeksi siihen mennessä, kun he ovat myöntäneet viidennenkymmenennen merkkinsä?

Rehellinen vastaus: Moodlen merkkijärjestelmä suunniteltiin täyttämään vaatimustenmukaisuuslaatikko, ei olemaan varsinainen tunnistetuote. Se toimii, mutta samalla tavalla kuin oppimisalustaan pultattu lisäominaisuus toimii — toimiva, vanhentunut ja alustan omien rajoitteiden kahlitsema. Jos olet koskaan yrittänyt saada Moodle-merkin näyttämään joltain muulta kuin pyöreältä clip art -ikonilta, tai kuullut valmistuvan kysyvän ”hetkinen, mistä minä oikeasti näen tämän uudestaan?”, tiedät jo, mistä kuilussa on kyse.

Tämä ei ole hyökkäys Moodlea vastaan — se on erinomainen oppimisalusta, ja sen merkkien kriteerimoottori (kurssin suoritus, aktiviteetin suoritus, manuaalinen myöntäminen, kohorttijäsenyys) on aidosti hyvin mietitty tunnisteen laukaisemiseen. Ongelma on kaikki, mitä tapahtuu laukaisun jälkeen: suunnittelutyökalut, vastaanottajakokemus ja merkin näkyvyys Moodle-instanssisi ulkopuolella. Juuri siihen badges.ninja on rakennettu, eikä sinun tarvitse luopua Moodlen suorituslogiikasta käyttääksesi sitä — kohdistat laukaisimen vain toiseen myöntämismoottoriin.

Missä Moodlen sisäänrakennetut merkit jäävät vajaaksi

Suunnittelutyökalu on koordinaattipohjainen kuvien yhdistelijä, ei suunnittelutyökalu. Moodlen merkkieditorissa valitset pohjakuvan, lisäät muutaman valmiin ikonipäällysteen ja säädät sijaintia pikselisiirtymillä. Siellä ei ole muotokirjastoa, ei väripalettijärjestelmää, ei fonttivalintoja muiden kuin ikonisarjaan valmiiksi leivottujen lisäksi. Jos organisaatiollasi on brändi — logo, väripaletti, tietty visuaalinen kieli sertifikaateillenne — Moodlen editori ei pysty ilmaisemaan sitä. Useimmat oppilaitokset päätyvät suunnittelemaan merkkigrafiikan Photoshopissa tai Canvassa ja lataamaan litteän PNG-kuvan, mikä tekee koko sisäänrakennetun suunnittelutyökalun tarkoituksesta tyhjän.

Vastaanottajat tarvitsevat Moodle-kirjautumisen nähdäkseen omat merkkinsä. Oppijan myönnetyt merkit sijaitsevat hänen Moodle-profiilisivullaan. Jos hän on siirtynyt eteenpäin kurssilta, unohtanut oppilaitoksen tunnuksensa, tai oppilaitos on sittemmin poistanut hänen tilinsä käytöstä, merkki on käytännössä poissa hänen näkökulmastaan — vaikka itse väite (assertion) saattaisikin yhä ratketa Moodlen backpack-yhteyden tai julkisen merkkisivun kautta. Ei ole olemassa omistettua, brändättyä, aina saavutettavissa olevaa paikkaa, jossa vastaanottaja voisi kirjautua pelkällä sähköpostiosoitteellaan ja nähdä jokaisen kaikilla kursseilla ansaitsemansa tunnisteen.

Jakaminen on jälkikäteen mietitty lisä. Moodle voi työntää merkkejä Mozilla Backpack -yhteensopivaan palveluun, ja se paljastaa julkisen varmennus-URL:n jokaiselle merkille, mutta siinä ei ole sisäänrakennettua ”Lisää LinkedIniin” -toimintoa, ei yhden klikkauksen jakonappia, eikä minkäänlaista sitoutumisanalytiikkaa siitä, katsoiko kukaan merkkiä sen jälkeen, kun se myönnettiin. Ohjelmille, jotka haluavat merkin toimivan puskaradiomarkkinointina — bootcampit, täydennyskoulutuksen tarjoajat, yritysvalmennus — se on todellinen menetetty mahdollisuus.

Massatoiminnot ovat kömpelöitä. Merkin myöntäminen kokonaiselle kohortille toimii, jos kaikki suorittavat laukaisevan aktiviteetin Moodlessa samaan aikaan. Mutta jos sinun täytyy jälkikäteen täydentää merkkejä aiemmalle kohortille, tuoda historiallisia suorituksia taulukkolaskentatiedostosta, tai myöntää merkki jostain, joka tapahtui kokonaan oppimisalustan ulkopuolella, jäät kirjoittamaan SQL-lausekkeita Moodlen tietokantaan tai taistelemaan CSV-tuontityökalujen kanssa, joita ei ole rakennettu nimenomaan merkkejä varten.

Korvaava malli: säilytä Moodlen laukaisimet, vaihda myöntäjä

Sinun ei tarvitse siirtyä pois Moodlesta korjataksesi tämän. Puhtain malli on antaa Moodlen jatkaa sitä, missä se on hyvä — kurssin suorituksen, aktiviteetin suorituksen ja kohorttijäsenyyden seurantaa — ja saada se kutsumaan Badges Ninjan API:a heti, kun suoritusehto laukeaa, sen sijaan että se myöntäisi (tai sen lisäksi, että se myöntäisi) oman sisäänrakennetun merkkinsä.

Moodle tukee tätä muutamalla tavalla:

1. Kurssin suorituksen webhook / kysely Moodle Web Servicesin (REST) kautta. Moodlen core_completion-API paljastaa suoritustilan käyttäjä- ja kurssikohtaisesti. Kevyt ajastettu tehtävä (Moodlen oma scheduled cron -tehtävä tai ulkoinen cron-työ, joka kutsuu Moodlen REST-API:a) voi kysellä äskettäin suoritettuja ilmoittautumisia ja kutsua jokaisen kohdalla Badges Ninjan awards-päätepistettä.

2. Paikallinen liitännäiskoukku. Jos käytössäsi on kehittäjä, Moodlen tapahtumajärjestelmää (\core\event\course_completed) voi tarkkailla pieni paikallinen liitännäinen, joka laukaisee HTTP-pyynnön heti suorituksen tapahtuessa — ilman kyselyn aiheuttamaa viivettä.

3. Zapier/Make/n8n liimana, jos haluat mieluummin välttää Moodlen koodikannan koskemista — Moodle voi työntää suoritustapahtumat webhook-vastaanottajalle, jonka koodivapaa automaatiotyökalu muuttaa myöntämiskutsuksi.

Tässä on itse myöntämiskutsu, kun sinulla on suorituksen tehneen käyttäjän nimi ja sähköposti:

curl -X POST https://api.badges.ninja/awards \
  -H "X-Api-Key: bws_3f9a1c2d4e5b6a7c8d9e0f1a2b3c4d5e" \
  -H "Content-Type: application/json" \
  -d '{
    "badgeId": "badge_moodle_course_completion",
    "recipient": { "name": "Jordan Alvarez", "email": "learner@example.edu" },
    "issuedOn": "2026-08-31"
  }'

Tai Node-ympäristössä, missä tahansa ajastetussa tehtävässä tai webhook-vastaanottajassa, jota ajat:

const response = await fetch("https://api.badges.ninja/awards", {
  method: "POST",
  headers: {
    "X-Api-Key": process.env.BADGES_NINJA_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    badgeId: "badge_moodle_course_completion",
    recipient: { name: completedUser.fullname, email: completedUser.email },
    issuedOn: Date.now(),
  }),
});
const award = await response.json();

Vastaanottajan sähköposti tallennetaan SHA-256-tiivisteenä, myöntö saa automaattisesti yksilöllisen varmennus-URL:n, QR-koodin ja A4-kokoisen PDF-sertifikaatin, ja — mikä on ratkaisevaa — vastaanottaja voi lunastaa sen magic-link-kirjautumisella osoitteessa badges.ninja/me, ilman erillistä Moodle-tiliä. Katso koko pyyntö-/vastausmuoto awards-API:n dokumentaatiosta ja autentikointioppaasta, jossa käydään läpi, miten API-avaimet toimivat päästä päähän.

Jos haluat mieluummin tehdä sen erässä — vaikkapa täydentää kokonaisen lukukauden suoritukset yhdellä kertaa reaaliaikaisten tapahtumien kytkemisen sijaan — vie suoritukset Moodlesta CSV-muodossa ja käytä suoraan massamyöntämistoimintoa, joka tukee taukoa ja jatkamista suurilla tiedostoilla. Tästä kerrotaan tarkemmin artikkelissa miten myöntää Open Badges -merkkejä CSV-tiedostosta.

Itse merkin suunnittelu

Kun putkisto on kunnossa, itse merkin suunnittelu vie minuutteja, ei tikettiä verkkotiimillesi. Visuaalinen suunnittelutyökalu tarjoaa yli 80 muotomallia, aidon väripalettijärjestelmän, ikonikirjastot ja mahdollisuuden ladata omia fontteja — joten merkki nimeltä ”Edistynyt tilastotiede — suoritettu” voi todella näyttää siltä, että se kuuluu oppilaitoksesi brändiin, eikä yleiseltä Moodlen saavutusikonilta.

Jokainen API-avain on rajattu ja peruutettavissa samasta hallintapaneelista, jossa hallinnoit merkkejä ja myöntäjiä, joten integraatioavaimen antaminen kehittäjälle (tai automaatiotyökalulle kuten Zapierille) ei tarkoita pääkäyttäjätilisi kirjautumistietojen jakamista.

Rinnakkain: vastaanottajakokemus

Moodle voittaa silti yhdessä asiassa: jos ainoa vaatimuksesi on, että ”merkki on olemassa, on teknisesti Open Badge v2.0 -yhteensopiva ja elää siinä oppimisalustassa, jota oppija jo käyttää”, sisäänrakennetut merkit eivät maksa mitään ylimääräistä eivätkä vaadi integraatiotyötä. Kompromissi tulee esiin sillä hetkellä, kun alat välittää suunnittelun laadusta, siirrettävyydestä kurssin päättymisen jälkeen tai siitä, että myöntämisestä tehdään rekrytointi- tai markkinointisignaali — mikä koskee lopulta useimpia oppilaitoksia.

Jos haluat laajemman katsauksen siihen, miten muut Open Badges -alustat vertautuvat hinnaltaan ja ominaisuuksiltaan, tutustu halvimpien Open Badges -alustojen vertailuun. Ja jos oppilaitoksesi puntaroi Open Badge v2.0:n ja uudemman verifioitavien tunnisteiden spesifikaation välillä, Open Badge v2 vs v3 selitettynä käsittelee, kumpi kannattaa oikeasti ottaa käyttöön jo tänään.

Valmiina myöntämään ensimmäisen todennettavan tunnisteesi? Aloita ilmaiseksi osoitteessa badges.ninja — visuaalinen suunnittelutyökalu, julkinen varmennussivu, PDF-sertifikaatti, Open Badge v2.0 -tuloste. Luottokorttia ei tarvita.