Je kunt op verschillende manieren gebruik maken van het product Club.Dataservice. Je kunt de webservices en data helemaal zelf toepassen op de manier die het beste bij jouw vereniging past.

Het product Club.Dataservice is opgebouwd uit een lijst van artikelen (webservices). Deze artikelen leveren informatie vanuit de eigen ledenadministratie van je vereniging. Voor een overzicht van deze artikelen klik hier. Je kunt de lijst met artikelen rechtstreeks benaderen via https://data.sportlink.com/list. De teams van je vereniging haal je bijvoorbeeld op met de aanroep https://data.sportlink.com/teams?client_id=<uw_ClientID>

Om het product toegankelijk(er) te maken heeft Sportlink een Javascript-Library ontwikkeld.

Let op!

De Javascript-Library is niet het product dat je aanschaft. Het is slechts een simpele tool om snel en eenvoudig een artikel op je website te zetten. Wil je meer dan dat, bijvoorbeeld dynamische menu's of webpagina's aanmaken, dan zul je dan zelf moeten programmeren. Zie ook de informatie op de pagina Is Club.Dataservice iets voor mijn vereniging?.

Via de Javascript-Library kun je eenvoudig inzien:

  • welke webservices er zijn,
  • welke parameters er zijn,
  • of parameters verplicht zijn,
  • welke velden in het resultaat zitten

Via de Javascript-Library kun je ook HTML-code genereren die je kunt opnemen in jullie website. Deze HTML-code wordt samengesteld aan de hand van gekozen argumenten en parameters (zie afbeelding hieronder). Hoe dit gebeurt wordt op deze pagina verder uitgelegd.


Parameters

Op een pagina van een specifieke webservice zie je de parameters onder Arguments staan. Indien je Arguments niet ziet staan bij een webservice betekent dit dat er voor deze webservice geen input parameters aanwezig zijn en deze webservice gedraaid kan worden zonder parameters op te geven. Tevens is aangegeven of parameters verplicht zijn. Indien het verplicht is een parameter op te geven staat in de kolom Required een vinkje

Standaard waarde

Bij veel parameters is een standaard waarde ingesteld. Het is dan niet vereist bij deze parameter een waarde op te geven. Bij het uitvoeren van de webservice zal de standaard waarde gebruikt worden. Het is wel mogelijk een afwijkende waarde op te geven als je dat wilt. Dit kun je dan doen via de kolom value.

Bij de webservice Verjaardagen is de standaard waarde bijvoorbeeld 14. Dit betekent dat er wordt gekeken naar personen die in de aankomende 14 dagen jarig zijn. Verander de waarde van de parameter aantal dagen naar 7 en in het resultaat zul je dan alle personen vinden die de aankomende week jarig zijn.

Privacy

Let op! Leden van wie het privacyniveau op Afgeschermd staat ingesteld zullen niet opgenomen worden in het resultaat van deze webservice. Niet-leden verschijnen sowieso niet op de lijst.

Output

De output van de artikelen is als volgt te sturen:

  • Je kunt bij een webservice via het plaatsen van vinkjes in de kolom Enabled aangeven welke velden je in het resultaat wilt zien. Tevens zie je in de kolom type welk datatype de kolom bevat.
  • Via de kolom label kun je het veld een (afwijkende) naam meegeven.
  • Bij de webservice Verjaardagen zijn bijvoorbeeld 2 output velden. Als je bij de regel met verjaardag in het veld Label de waarde Datum invult, wordt het resultaat Datum en Naam (i.p.v. Verjaardag en Naam).
  • Je kunt zelf de volgorde van de kolommen aanpassen door deze te slepen in het overzicht.
  • Je kunt testen wat voor output er gegenereerd wordt door op de knop Run te klikken (rechtsonder).

"Meer" velden

Bij enkele webservices kun je een link naar een detail pagina opgeven. Deze links werken niet binnen de Javascript-Library. Voor een voorbeeld kun je kijken naar Demo met teamindeling op de pagina met voorbeelden.

HTML

Onderaan de pagina bij een webservice zie je de code staan die je kunt gebruiken om data uit Sportlink systemen op te nemen in je verenigingswebsite. Onderstaande code moet je in de head-sectie van de website te plakken.

Head

<!-- This should be pasted once in the <head> for the best performance -->
<script src="https://code.jquery.com/jquery-1.11.3.min.js">
</script>
<script src="https://sportlinkservices.github.io/navajofeeds-json-parser/js/dist/feed-0.0.1.js">
</script>

<script>
feed.init({
clientId: "xxxxxxxxxx"
});
</script>

In dit voorbeeld staat clientId: "xxxxxxx". Hierbij moet je de xxxxxxx te vervangen door de ClientID van de vereniging.

Onderstaande code kun je in de body-sectie van een pagina plaatsen.

Article

<!-- Paste this where you want the article to appear -->

<div
data-article="verjaardagen"
data-fields="verjaardag,volledigenaam"
data-label-volledigenaam="naam"
>
</div>

Je kunt zelf bepalen waar in jullie website je deze gegevens opneemt.

Een aantal voorbeelden van pagina's vind je op de pagina Voorbeelden op basis van Club.Dataservice.

CMS

Het is ook mogelijk deze webservices binnen een CMS te gebruiken. Het is wel vereist dat het CMS Javascript ondersteunt.

JQuery

CMS-systemen (Joomla, Wordpress, Drupal etc.) doen meestal zelf al een aanroep van een jquery library. Laat in dat geval de aanroep weg uit het script dat de Javascript-Library genereert.

Javascript ondersteuning

Voor het gebruik van code in je website via de Javascript-Library dient de bezoeker Javascript geactiveerd te hebben in zijn browser (standaard aan). Anders wordt er geen data getoond.

Je kunt een <noscript> tag opnemen in de website die een melding geeft als Javascript-ondersteuning uit staat. Bijvoorbeeld:

<noscript>
Je hebt JavaScript ondersteuning nodig op deze website.
Deze browser ondersteunt JavaScript niet of er worden scripts geblokkeerd.
</noscript>