Maakt u gebruik van een bestaande website en wilt u telegolf.nl integreren met uw
website, dan kunt u gebruik maken van onderstaande informatie.
U kunt de pagina's blijven maken zoals u gewent bent om html pagina's te maken. Op de plaats waar
informatie van telegolf.nl moet worden weergegeven kunt u gebruik maken van zogenaamde parameters,
zoals verderop in dit document wordt beschreven.
Wanneer de pagina gereed is bewaart u deze op uw eigen site. Vervolgens geeft u bij paginainstellingen
van de NGPIP module aan, dat u voor de betreffende pagina gebruik maakt van een template. U kunt hierbij
de naam van het bestand aangeven, welke u eerder heeft bewaart op uw eigen site. U geeft hierbij dus de
volledige URL aan.
Op bovenstaande wijze weet onze server dat er gebruik wordt gemaakt van een template en zal deze
kopieren naar onze eigen server. Het bestand wordt gekopieerd om snelheid te kunnen waarborgen. Dit
noemen we cache geheugen.
Wanneer u het template aanpast en bewaart op uw server zal u telegolf.nl ook moeten laten weten dat
de pagina is aangepast, om zodoende het cache geheugen te verversen. Dit kunt u doen door opnieuw de
gegevens te versturen in de paginainstellingen van de NGPIP module. Onze server zal dan opnieuw het
template kopieren naar onze server. U kunt het cache geheugen eventueel ook vanaf de
beheerpagina verversen.
Wanneer u op uw pagina gebruik maakt van gegevens op uw eigen site (links, plaatjes, style sheets e.d.),
dan dient u hiervoor de volledige URL naar uw site aan te geven. Dit komt omdat de pagina naar onze
server is gekopieerd (cache). Deze wordt dus ook vanaf onze server gehost. De bestanden waar u naar
verwijst komen niet op onze server voor. Zodoende is de volledige URL noodzakelijk.
Voor het aanroepen van diverse pagina's kan men de volgende URL's gebruiken,
waarbij u CLUBNR vervangt door uw clubnummer:
| Pagina | URL |
|---|
| Startpagina | http://www.telegolf.nl/club/club.shtml?clubnr=CLUBNR |
| Baangegevens | http://www.telegolf.nl/club/club.shtml?clubnr=CLUBNR&page=20 |
| Mededelingen | http://www.telegolf.nl/club/club.shtml?clubnr=CLUBNR&page=60 |
| Ledengegevens | http://www.telegolf.nl/club/club.shtml?clubnr=CLUBNR&page=40 |
| Handicap | http://www.telegolf.nl/club/club.shtml?clubnr=CLUBNR&page=50 |
| Gebruikersinstellingen | http://www.telegolf.nl/club/club.shtml?clubnr=CLUBNR&page=90 |
| Wedstrijdagenda | http://www.telegolf.nl/club/club.shtml?clubnr=CLUBNR&page=30 |
| Scorekaart invoer | http://www.telegolf.nl/club/club.shtml?clubnr=CLUBNR&page=70 |
| Opnieuw inloggen | http://www.telegolf.nl/club/club.shtml?clubnr=CLUBNR&page=85 |
| Vrije pagina's | http://www.telegolf.nl/club/club.shtml?clubnr=CLUBNR&page=99
(Zie extra uitleg) |
| Vrije pagina's met sessie | http://www.telegolf.nl/club/club.shtml?clubnr=CLUBNR&page=98
(Zie extra uitleg) |
Zoals eerder besproken dient u in de pagina's gebruik te maken van parameters. Hiervoor in de plaats zal
de informatie uit telegolf.nl gepubliceerd worden. Hieronder treft u een opsomming aan van de parameters welke voor
de specifieke pagina's noodzakelijk zijn.
| Pagina | Parameter | Omschrijving |
|---|
| Startpagina | {%TABELHOME%} | Geeft alle informatie van de voorpagina weer. |
| Baangegevens | {%TABELTEES%} | Geeft de hoofdtabel van alle tees weer. |
| {%TABELHOLES%} | Gegevens per hole van een geselecteerde tee. |
| Mededelingen | {%TABELMEDEDELING%} | Geeft alle mededelingen vanuit NGP weer. |
| Ledengegevens | {%TABELZoekLid%} | Mogelijkheid om adresgegevens in ledenbestand te zoeken. (Instelbaar via NGP of dit toegestaan wordt.) |
| Handicapgegevens | {%TABELLID%} | Geeft handicapgegevens en laatste vijf mutaties van de ingelogde gebruiker. |
| Scorekaart invoer | {%KAARTINVOER%} | Geeft de mogelijkheid om leden q-kaarten in te voeren. |
| Wedstrijdagenda | {%TABELAGENDA%} | Volledige wedstrijdagenda van betreffend jaar. |
| In de wedstrijdagenda kan iedere wedstrijd aangeklikt worden, waarna de details van de wedstrijd worden
getoond. Vervolgens kan voor een wedstrijd de startlijst of resultaat weergegeven worden. Wanneer u tevens beschikt over de module telegolf
inschrijven, dan wordt voor leden tevens de mogelijkheid geboden om in te schrijven voor een wedstrijd. Dit alles wordt op aparte pagina's
weergegeven. In deze pagina's kan gebruik worden gemaakt van onderstaande parameters. |
| Wedstrijddetails | {%TABELDETAILS%} | Geeft details van de wedstrijd weer, zoals deze ook in het briefhoofd van de inschrijflijsten is opgenomen. |
| Inschrijven | {%TABELINSCHRIJVEN%} | Biedt de mogelijkheid om in te schrijven op een wedstrijd. |
| Inschrijflijst | {%TABELINSCHRIJFLIJST%} | Geeft alle deelnemers die tot zover hebben ingeschreven. |
| Startlijst | {%TABELSTARTLIJST%} | Geeft alle deelnemers alfabetisch weer. |
| Uitslagen | {%TABELRESULTAAT%} | Geeft de uitslagenlijst van geselecteerde wedstrijd. |
Wanneer u een eigen site heeft en u wilt eigen pagina's weergeven maar tevens gebruik maken van de beveiliging van
Telegolf.nl dan hebben we daar de volgende oplossingen voor.
1. Zonder gebruik van template
U gebruikt in dit geval de eerder aangegeven link voor een vrije pagina met daaraan toegevoegd de URL, van de pagina
welke werkelijk gestart moet worden. Bijvoorbeeld:
http://www.telegolf.nl/club/club.shtml?clubnr=899&page=99&url=http://www.mms.nl/geheim.html
Gebruikers worden eerst naar onze site geleid waar, na een correcte aanmelding, de vervolg site wordt opgestart.
In de vervolg site sturen wij de lidcode mee, dus deze wordt dan in dit voorbeeld:
http://www.mms.nl/geheim.html?Lidcode=JANS1
Deze lidcode zou men in een eigen script weer kunnen opvangen.
2. Met gebruik van template
Een meer veilige methode is door het gebruik van een template te realiseren. U kunt een pagina maken als template
waarin verschillende parameters zijn opgenomen. Deze parameters kunnen bij ons vandaan komen, maar u kunt ook zelf
parameters maken, welke u in de op te geven url gaat afhandelen. Voorbeeld html van template:
<html>
<body>
Uw lidcode = <b>{%Lidcode%}</b>
Mijn parameter 'a' = <b>{%a%}</b>
Mijn parameter 'b' = <b>{%b%}</b>
</body>
</html>
Deze pagina kan als volgt aangeroepen worden:
http://www.telegolf.nl/club/club.shtml?clubnr=899&page=99&a=123&b=345
Resultaat zal zijn:
Uw lidcode = JANS1
Mijn parameter 'a' = 123
Mijn parameter 'b' = 345
Er is weinig fantasie voor nodig om te bedenken, dat er nu een script is te maken, waarbij de vervolgpagina op basis
van de mee te gegeven paramaters is te genereren.
In het template kan gebruik worden gemaakt van de volgende paramaters van Telegolf.nl.
| Parameter | Omschrijving |
|---|
| {%Lidcode%} | Geeft de lidcode van de ingelogde gebruiker. |
| {%email%} | Geeft het e-mailadres van de ingelogde gebruiker. |
3. Met gebruik van sessie
De meest veilige methode kunt u doen door gebruik te maken van een sessie controle. Deze methode is echter alleen
mogelijk wanneer u gebruik maakt van een server welke Serverscripting toelaat, zoals PHP, Perl of ASP. Het gaat
erom dat de server controleert of de gebruiker een sessie met telegolf.nl heeft.
Bijvoorbeeld:
http://www.telegolf.nl/club/club.shtml?clubnr=899&page=98&url=http://www.mms.nl/geheim.php
Onze server zal de volgende redirect genereren:
http://www.mms.nl/geheim.php?userid=453623&sessieid=OBP929MGJ82TYDL8UWTREOWLQ&lidid=4536&user=JANS%201&clubnr=888&email=J.Jansen@domain.com&hcp=24,5
Op basis van deze aanvraag op uw server kunt u uw serverscript de volgende url bij ons laten controleren:
http://www.telegolf.nl/validate.shtml?userid=453623&sessieid=OBP929MGJ82TYDL8UWTREOWLQ&lidid=4536&user=JANS%201&clubnr=888
Onze server geeft als resultaat 'TRUE' of 'FALSE'. Op basis van dit resulttaat kunt u verder reageren in uw script, door wel of niet uw gegevens te tonen aan de gebruiker.
In de verschillende pagina's wordt gebruikt gemaakt van classes. Deze classes kunnen weer beschreven worden in css,
waarin lettertype en kleur bepaald kunnen worden. Eventueel kan ook gebruik worden gemaakt van de standaard stylesheets,
zoals door telegolf.nl worden gebruikt. De URL hiervoor is:
<link href="{%Clubnr%}style.css" rel="stylesheet" type="text/css" />
wilt u zelf een stylesheet maken, wij maken gebruik van onderstaande classes.
| Classe | Omschrijving |
|---|
| .standard | Standaard font op de pagina |
| .header | Titels op pagina's |
| td.rg1 | oneven regels in tabellen |
| td.rg2 | even regels in tabellen |
| .rg1 | fake waar oneven regel gesugereerd wordt |
| .rg2 | fake waar even regel gesugereerd wordt |