Naar hoofdinhoud

KoppelingenEversports Manager

Eversports Manager op je website, met widgets of de API.

Eversports Manager zet je rooster, prijzen en cadeaubonnen met widgets op je eigen site, en met de Eversports Provider API haal je het lesaanbod op om er zelf pagina’s van te bouwen. Het is de software van ruim negenduizend studio’s en sportlocaties in Europa: yoga, pilates, fitness, dans, tennis en padel.

Vertrouwd door

200+ bedrijven en webshops

Dux
Swim Essentials
Vouwwagenspecialist
Fit Preps
Fysio Moov
Mörgenn
MBST
Sunwave Brands
Flaske
Boumij Makelaars

Wat het oplevert

Wat een koppeling met Eversports Manager je oplevert.

Je rooster op je eigen site. Bezoekers zien het lesaanbod en boeken direct, zonder eerst naar een ander adres te gaan.

Geen iframe meer. De nieuwe widgets laden met een script, dus ze schalen mee op een telefoon en botsen niet met browserupdates.

Vijf soorten, één script. Rooster, prijzen, activiteiten, video’s en cadeaubonnen op één pagina, met het script er één keer in.

Technisch

De koppeling in het kort.

Vorm van de koppeling
Widgets: een script van widget-static.eversports.io en per widget een div met het widget-id. Daarnaast de Provider API, een alleen-lezen GraphQL-API voor rooster en lessen
Authenticatie
Voor de widgets geen sleutel: het widget-id staat in de pagina. Voor de Provider API toegangsgegevens die je bij Eversports aanvraagt
Richting
Van het systeem naar de site
Verversing
De widget haalt zijn gegevens zelf op bij het laden van de pagina
Wij bouwen het op
WordPress, Next.js, Maatwerk

Waar het misgaat

  • Eversports heeft een Provider API, maar die is alleen-lezen: je haalt er het rooster en de lessen mee op, geen klanten, boekingen of financiële gegevens. Het boeken zelf loopt via de widgets of via de checkoutlink van Eversports. Dat bepaalt wat er kan: met de widgets staan het rooster, de prijzen en het boeken op je site, maar zijn de lessen geen pagina’s van jou. Wil je per lessoort een eigen adres met eigen tekst en gestructureerde data, dan bouw je die pagina’s zelf op de Provider API.
  • Er zijn een oude en een nieuwe generatie widgets. De oude werkt met een iframe, de nieuwe met een script en een div. Eversports zegt zelf dat je de iframe moet vermijden en noemt daar twee redenen voor: de bediening op een telefoon, en aankomende browserupdates die iframes strenger behandelen. Staat er nog een oude op je site, vervang hem dan; dat is een kwestie van minuten en het scheelt een storing op een moment dat je er niet op rekent.
  • Het script hoort één keer op de pagina, de div zo vaak als je widgets wilt. Dat klinkt vanzelfsprekend en gaat in de praktijk mis op een site waar elke sectie zijn eigen stukje code meekrijgt: dan staat het script er vier keer en laadt de pagina merkbaar trager.
  • De widget tekent zich in zijn eigen opmaak. Je kunt de achtergrond laten aansluiten op je site, maar de rest van de vorm ligt bij Eversports. Op een site met een eigen ontwerp is dat het punt waar het zichtbaar wordt dat dit een ingevoegd blok is; reken erop bij het ontwerp van de pagina en zet de widget niet midden tussen je eigen componenten.

Bron: documentatie van Eversports, Wenen

Wat is Eversports Manager?

Eversports Manager is beheersoftware voor studio’s en sportlocaties: lesroosters, klantbeheer, boekingen, lidmaatschappen, facturatie en marketing in één pakket. Ruim negenduizend partners in Europa gebruiken het, van yoga- en pilatesstudio’s tot vechtsport, dans, indoor cycling en banenverhuur voor tennis en padel.

Daarnaast is Eversports een marktplaats: sporters zoeken er lessen in de buurt en boeken via de app. Dat is een verschil met een systeem dat alleen achter de schermen draait, en het is meteen de reden om goed na te denken over wat er op je eigen site hoort te staan.

Fitmanager is hierin opgegaan

Gebruikte je Fitmanager, dan kom je hier uit. De twee zijn samengegaan; nieuwe klanten werken in Eversports Manager en bestaande klanten zijn gemigreerd. De domeinnaam fitmanager.nl is inmiddels niet meer van het bedrijf.

Voor je website betekent dat iets praktisch: een integratie die ooit op Fitmanager is gebouwd, werkt straks niet meer op de gegevens waar hij voor is gemaakt. Staat er nog zo’n koppeling op je site, laat hem dan nakijken voordat je erachter komt doordat het rooster leeg is.

Zo werken de widgets

Je zet één script op de pagina en daarna per widget een div met het id dat je in Eversports Manager vindt. Het script laadt de widget en de instellingen die je daar hebt gezet; je hoeft in de pagina zelf niets te configureren.

Er zijn er vijf: het rooster, de prijzen inclusief cadeaubonnen, de bijzondere activiteiten zoals cursussen, workshops en retreats, de videobibliotheek en de cadeaubonnen apart. Ze mogen naast elkaar op dezelfde pagina staan.

Voor banenverhuur is er daarnaast een eigen boekingswidget, met een adres dat je in de instellingen vindt. Je kunt zo’n adres filteren, bijvoorbeeld om alleen de workshops te tonen.

Wat op je eigen site hoort en wat in de widget

De widget is goed in wat hij doet: boeken. Waar hij niet voor is gemaakt, is vindbaarheid. Een les in een widget is geen pagina met een eigen adres, dus Google indexeert hem niet en je kunt er niet naartoe linken.

De route die wij aanhouden: de pagina’s die mensen zoeken bouw je zelf, met je eigen tekst, je eigen foto’s en je eigen vragen. Denk aan een pagina per lessoort of per locatie. De widget zet je daar onderop, op de plek waar iemand daadwerkelijk wil boeken.

Zo gebruik je allebei waar ze goed in zijn: jouw site voor het vinden en het overtuigen, Eversports voor de boeking en de administratie erachter.

De Eversports API: wat de Provider API levert en wat niet

Naast de widgets heeft Eversports Manager een Provider API. Het is een uitbreiding die je boekt in het menu Market, en hij doet één ding: het lesaanbod uitlezen. Je krijgt het rooster, per activiteit de titel, omschrijving, tijd, locatie, capaciteit, annuleringstermijn en beeld, de docent, en per les een eigen link naar de checkout om te boeken.

De API is alleen-lezen. Klantgegevens, boekingen, financiële gegevens en de beschikbaarheid van banen zitten er niet in, en je kunt er niets mee terugschrijven. Het boeken zelf blijft bij Eversports, via die checkoutlink.

Technisch is het een GraphQL-interface, met antwoorden in JSON. De toegangsgegevens krijg je van de support van Eversports, en er geldt een regel voor redelijk gebruik in plaats van een vaste limiet. Eversports rekent er per locatie per maand voor; de actuele prijs staat in hun helpcenter.

Wat je met de Eversports API bouwt dat een widget niet kan

Met het lesaanbod als gegevens kun je van elke lessoort een eigen pagina maken, met een eigen adres, eigen tekst en gestructureerde data. Het rooster op die pagina komt uit Eversports en blijft dus kloppen, en de knop om te boeken gaat naar de checkoutlink van die ene les.

Dat is de route als je gevonden wilt worden op een lessoort in je stad, of als het rooster in je eigen vormgeving moet staan in plaats van in de opmaak van de widget. Voor een studio die vooral wil dat bestaande klanten snel boeken, is de widget genoeg, en is de API extra werk en een extra maandbedrag.

Onze afweging: begin met de widgets en kies de API pas als er pagina’s nodig zijn die de widget niet kan leveren. Hoe we zulke pagina’s bouwen, staat bij design en development.

Andere koppelingen van Eversports Manager: partners en platforms

In hetzelfde menu Market staan koppelingen met platforms als Urban Sports Club, ClassPass, Wellhub, EGYM Wellpass en BODDY. Het helpcenter noemt die ook een API, maar het zijn koppelingen met één partner: je rooster gaat naar dat platform, en boekingen en annuleringen komen terug in Eversports Manager. Bij BODDY gebeurt dat ongeveer elke dertig minuten.

Voor je eigen website doen ze niets. Wie een Eversports API zoekt voor zijn site, heeft de widgets of de Provider API nodig. Werk je met een ander systeem voor je leden, kijk dan bij Virtuagym, of bekijk wat we doen voor fitness en sportcentra.

Bijgewerkt op

Specialist voor koppelingen

Portret van Jos van der Pluijm tussen de stellingen van een magazijnJosDesign & Development085 83 30 533jos@klubb.nl

Veelgestelde vragen

Kan ik mijn Eversports-rooster op mijn eigen website zetten?

Ja, met de roosterwidget. Je zet één script op de pagina en een div met je widget-id op de plek waar het rooster moet komen. Bezoekers boeken daar direct, zonder naar een ander adres te gaan.

Kan ik via de Eversports API boekingen of klantgegevens ophalen?

Nee. De Provider API is alleen-lezen en geeft het lesaanbod: rooster, activiteiten, docenten en checkoutlinks. Klantgegevens, boekingen, financiële gegevens en de beschikbaarheid van banen zitten er niet in. Wil een bezoeker boeken, dan gaat hij via de checkoutlink naar Eversports, en daar staan de boeking en de klant daarna ook.

Krijgt elke les een eigen pagina op mijn site?

Niet met de widget. Wat daarin staat is geen pagina met een eigen adres, dus Google indexeert het niet. Met de Provider API kan het wel: dan bouwen wij per lessoort of per locatie een eigen pagina, met het rooster uit Eversports erop en een knop naar de checkout van die les.

Heeft Eversports een API?

Ja, de Provider API. Het is een betaalde uitbreiding die je in het menu Market boekt, gebouwd op GraphQL, en hij is alleen-lezen: je haalt het rooster, de activiteiten, de docenten en per les een checkoutlink op. Klantgegevens en boekingen zitten er niet in. Daarnaast zijn er koppelingen met partners als ClassPass en Urban Sports Club.

Wij gebruikten Fitmanager, wat betekent dat?

Fitmanager is opgegaan in Eversports. Nieuwe klanten werken in Eversports Manager en bestaande klanten zijn overgezet. Staat er op je site nog een koppeling die op Fitmanager is gebouwd, laat die dan nakijken.

Werken de widgets ook op WordPress?

Ja. Het script gaat één keer in de pagina of in de thema-instellingen, en de div zet je in het blok waar de widget moet staan. Wij zorgen dat hij binnen de opmaak van je site valt en op een telefoon niet buiten het scherm loopt.

Let's work together.

Boeken waar het hoort, vindbaar waar het telt.