KoppelingenEduframe
Eduframe koppelen aan je website.
Eduframe is de cursusadministratie van Drieam, gebouwd rond Canvas als leeromgeving. Het aanbod, de planning en de inschrijvingen zitten er samen in. Wij zetten dat aanbod als eigen pagina’s op je site en laten de inschrijving terugkomen in Eduframe.
Vertrouwd door
200+ bedrijven en webshops
Wat het oplevert
Wat een koppeling met Eduframe je oplevert.
Een eigen pagina per cursus. Op je eigen domein, met je eigen tekst eromheen en een adres om een advertentie heen te sturen.
Data en plaatsen kloppen altijd. Wat in Eduframe verandert aan startdatum, locatie of prijs, verandert op je site mee.
Inschrijven op je eigen site. Het formulier staat in je eigen opmaak en de inschrijving komt binnen als lead in Eduframe.
Technisch
De koppeling in het kort.
- Vorm van de koppeling
- De Organization API: REST met JSON, met een OpenAPI-beschrijving en webhooks. Er is een PHP-client, en voor WordPress en Drupal een kant-en-klare plugin
- Authenticatie
- Een API-sleutel uit je eigen profiel, als bearer in de Authorization-header. Per sleutel zet je de rechten, zoals courses:read, teachers:read en leads:modify
- Richting
- Beide kanten op
- Verversing
- Per aanroep, en webhooks voor wijzigingen
- Wij bouwen het op
- WordPress, Next.js, Maatwerk
Waar het misgaat
- Geef een sleutel alleen de rechten die hij nodig heeft. Eduframe werkt met scopes, en voor een website zijn dat er meestal maar een paar: het aanbod lezen, de docenten lezen en een lead mogen wegschrijven. Een sleutel die alles mag staat op een webserver, en dat is precies waar je hem niet wilt hebben.
- Er zijn twee routes en ze sluiten elkaar niet uit. Voor WordPress en Drupal is er een plugin die het aanbod binnenhaalt; die is snel klaar en levert pagina’s op in de vorm die de plugin kiest. Bouw je zelf, dan gebruik je de API en bepaal je die vorm helemaal zelf. Op een site met een eigen ontwerp is dat tweede meestal de reden dat we erbij zijn gehaald.
- Het aanbod in Eduframe is niet één lijst maar een structuur. Een cursus, een programma, een planning met data en plaatsen, en de inschrijvingen daarop. Wat je op een pagina wilt tonen is bijna nooit één van die dingen: het is de cursus met zijn eerstvolgende startdata erbij. Spreek aan het begin af wat er op de kaart en op de detailpagina staat, anders bouw je het twee keer.
- Eduframe hangt aan Canvas, en dat is waar de cursist na inschrijving terechtkomt. Voor de website verandert dat niets, maar het bepaalt wel de grens van de koppeling: wat er in de leeromgeving gebeurt hoort daar en niet op je site. Beloof een klant dus geen voortgang of certificaten op de eigen site zonder dat eerst na te gaan.
Eduframe koppelen
Wat je moet weten voor je begint.
Wat is Eduframe?
Eduframe is cursusadministratie voor opleiders, gemaakt door Drieam. Het beheert het aanbod, de planning, de inschrijvingen en de facturatie, en het hangt aan Canvas voor de leeromgeving zelf.
Dat laatste is het verschil met een los inschrijfsysteem: de cursist die zich inschrijft, komt in dezelfde keten terecht als de cursist die straks de lesstof doorloopt. Voor een opleider die met Canvas werkt is dat de reden om het aanbod ook daar te beheren, en niet in een tweede lijst op de website.
Hoe de koppeling met je website werkt
De API is REST met JSON en er is een OpenAPI-beschrijving bij, dus wat er kan staat zwart op wit in plaats van dat het moet worden uitgeprobeerd. Aanmelden gaat met een sleutel die je in je eigen profiel aanmaakt en als bearer meestuurt.
Bij die sleutel horen scopes. Voor een website zijn dat er meestal drie: het aanbod lezen, de docenten lezen en een lead mogen wegschrijven. Wij vragen niet meer aan dan dat.
Voor wijzigingen zijn er webhooks. Daarmee hoeft je site niet elk kwartier te vragen of er iets veranderd is; Eduframe meldt het zelf, en wij verversen de pagina die het betreft.
Inschrijven vanaf je eigen site
Het inschrijfformulier bouwen wij in je eigen opmaak, op de pagina van de cursus zelf. Dat scheelt de bezoeker een sprong naar een ander adres, en het scheelt jou de vragen van mensen die daar niet meer uit kwamen.
De inschrijving komt binnen als lead in Eduframe, bij de juiste cursus en planning. Wat er daarna gebeurt, van bevestiging tot factuur, blijft het werk van Eduframe; dat is precies zoals het hoort, want dat is het systeem waar je administratie in staat.
De aanroep loopt vanaf de server. De sleutel staat dus niet in de paginabron, ook niet in het formulier.
Waarom je aanbod op je eigen domein hoort
Iemand die een cursus zoekt, zoekt op het onderwerp en niet op de naam van je administratiesysteem. Die zoekopdracht komt uit bij een pagina, en die pagina hoort van jou te zijn.
Op je eigen site kun je per cursus schrijven wat hij oplevert, voor wie hij is en wat er van iemand wordt verwacht. Je zet er de veelgestelde vragen bij, een verwijzing naar de docent en het bewijs dat je het vaker hebt gedaan. In een standaardcatalogus past dat niet.
En er is een praktische kant: een eigen adres per cursus is een adres waar je een advertentie naartoe kunt sturen, waar je vanaf een artikel naar kunt linken, en dat Google als aparte pagina kan tonen.
Bijgewerkt op
Specialist voor koppelingen
JosDesign & Development085 83 30 533jos@klubb.nlVeelgestelde vragen
Kan ik mijn cursusaanbod uit Eduframe op mijn eigen website zetten?
Ja. Het aanbod komt via de API binnen en krijgt bij ons een eigen pagina per cursus op je eigen domein, met de eerstvolgende startdata erbij. Voor WordPress en Drupal bestaat daarnaast een plugin van Eduframe zelf.
Kan iemand zich op mijn eigen site inschrijven?
Ja. Het formulier staat in je eigen opmaak op de pagina van de cursus, en de inschrijving komt binnen als lead in Eduframe bij de juiste planning. De aanroep loopt vanaf de server, dus de sleutel staat niet in de pagina.
Wat moeten wij zelf regelen?
Een API-sleutel in je eigen Eduframe-profiel, met de rechten die wij noemen. Dat zijn er voor een website meestal drie: het aanbod lezen, de docenten lezen en een lead mogen wegschrijven.
Blijft het aanbod op de site actueel?
Ja. Eduframe stuurt webhooks bij een wijziging, dus we verversen de pagina die het betreft in plaats van de hele lijst elk kwartier op te halen. Wat in Eduframe verandert aan datum, locatie of prijs, verandert op je site mee.
Werkt een Eduframe-koppeling ook op WordPress?
Ja, op twee manieren. Met de plugin van Eduframe, wat snel klaar is en de vorm van de plugin volgt, of met de API, waarbij wij de cursussen als eigen berichttype opslaan en de pagina’s in je eigen ontwerp bouwen.
Let’s work together.
Je cursusaanbod op je eigen domein, inschrijvingen in Eduframe.