1. Algemene basis

Welkom in de cockpit

Deze handleiding is bedoeld voor bestuursleden die:

• de website mee beheren
• generators gebruiken
• data moeten plakken in Carrd
• liever schaken dan programmeren

Wat is Carrd?

De Krakkemat-site is gebouwd in Carrd. Wat op de site pagina’s lijken, zijn in Carrd meestal secties binnen dezelfde website.

Header, footer en logo

De header is de bovenkant van de site met logo, menu en navigatie. De footer is de onderkant van de site met extra info en links.

Overal op de site geldt: klik op het KRAKKEMAT-logo = terug naar Home.

Wat is een embedblok?

Carrd laat normaal toe om zonder programmeerkennis een website te bouwen. Dat is ideaal voor eenvoudige websites, basispagina’s, tekst, foto’s en standaardknoppen.

Krakkemat gaat ondertussen veel verder dan een gewone basiswebsite. De site bevat generators, automatische filters, een partijdatabase, een PGN Viewer, een PGN Tool, automatische koppelingen en dynamische competitiepagina’s.

Daarom werd voor grote delen van de website gewerkt met eigen code: maatwerk dat speciaal voor Krakkemat geschreven werd.

De maximale lengte voor een aangepast code-element (Embed) in Carrd is 16.384 tekens.

HTML, CSS, JS en DATA

HTML bepaalt wat er op de pagina staat.

CSS bepaalt hoe het eruit ziet.

JavaScript bepaalt wat de pagina doet.

DATA bepaalt welke inhoud getoond wordt, bijvoorbeeld kmEvents, kmBlogData, kmGalleryItems of kmShopItems.

Commentaar in code

In verschillende generators en databestanden worden commentaarregels gebruikt om aan te geven waar gegevens geplaatst mogen worden. Commentaar wordt door de browser genegeerd en heeft geen invloed op de werking van de website.

Gebruik altijd een geldige commentaarvorm:

Twijfel je? Gebruik dan liever // voor een korte opmerking op één regel.

Waarom zijn er generators gebouwd?

Generators bestaan zodat bestuursleden geen code moeten schrijven, maar gewoon gegevens invullen, een preview bekijken, HTML genereren en op een uniforme manier nieuwe inhoud toevoegen.

Wijzigingen bewaren in Carrd

Werk je ondertussen al op een openstaande pagina van de website? Refresh of herlaad die pagina dan ook. Anders zie je soms nog de oude versie.

2. Paswoorden

Twee soorten paswoorden

Krakkemat gebruikt twee soorten paswoordbeveiliging: de ledenhoek en Webadmin. Die hebben bewust niet dezelfde functie.

Ledenhoek

De ledenhoek gebruikt een eenvoudig zichtbaar paswoord in de code op Carrd. Voor een gewone gebruiker is dit ruim voldoende als basisbeveiliging.

Voor mensen met veel IT-kennis is het paswoord in theorie terug te vinden in de code. Het is dus geen zware professionele beveiliging, maar dat is aanvaardbaar omdat er geen gevoelige informatie staat.

Paswoord wijzigen

Ga naar: Carrd → #ledenpaswoord → selecteer embedblok.

Ga helemaal naar het einde van de code en zoek de regel met het paswoord.

Wijzig alleen het woord tussen de aanhalingstekens.

Webadmin

Webadmin is een afgeschermde sectie met knoppen of links naar generators en beheerfuncties. Deze sectie is eveneens niet bedoeld voor gewone leden.

Bij Webadmin zal het paswoord niet zomaar zichtbaar in gewone tekst in de code staan. Dat maakt het beter geschikt voor admin-tools.

3. Homepage

Wat doet de homepage?

De homepage is de centrale landingspagina van de website. Hier krijgen bezoekers meteen een eerste indruk van Krakkemat, belangrijke navigatie, snelle toegang tot de belangrijkste onderdelen en het eerstvolgende clubevent.

Belangrijkste dynamische onderdeel

Op de homepage is vooral Volgend event dynamisch. Dat blok toont automatisch het eerstvolgende geplande event.

Hoe werkt dat?

De homepage krijgt deze informatie niet rechtstreeks. Ze leest deze info uit het datablock op Carrd dat de gegevens van de kalender bevat.

Wanneer een event voorbij is, wordt automatisch het volgende event gekozen. Daardoor hoeft de homepage normaal niet manueel aangepast te worden.

4. Kalender

Wat doet de kalender?

De kalender toont komende clubevents, eventdetails en planning van clubactiviteiten in Krakkemat-stijl.

Hoe wordt de kalender beheerd?

De kalender werkt met een Kalendergenerator . Bestuursleden hoeven dus geen code te schrijven.

Herkenbaarheid van events

De kalender werkt met kleuren en subtiele schaduwiconen. Die worden automatisch gekozen in functie van het gekozen eventtype.

Voorbeelden: competitie, les, online, tornooi, initiatie. Deze eventtypes zijn wijzigbaar en kunnen later verder uitgebreid worden.

Werkwijze

1. Vul in de generator de gegevens van het event in.
2. Bekijk de preview.
3. Klik op HTML genereren.
4. Ga naar Carrd → #homehtml → selecteer embedblok kalender DATA.

Data plakken

De link is volledig vrij te kiezen: een Krakkemat-pagina, een externe website, een inschrijvingspagina of eender welke geldige URL.

Event verwijderen

Een event verwijderen gebeurt door het volledige eventblok uit de data te verwijderen.

5. Contact

Wat doet deze pagina?

De contactpagina geeft bezoekers contactinformatie, e-mailcontact en telefooncontact.

E-mailknop

De e-mailknop werkt via het ingebouwde Carrd-formulier. Dat formulier stuurt berichten naar het e-mailadres dat in Carrd aan het formulier gekoppeld is.

E-mailadres wijzigen

Ga naar Carrd → #Contactpagina → klik op het formulier.

In het linkerpaneel zie je Recipient Email(s). Vervang daar het bestaande e-mailadres door het nieuwe gewenste bestemmingsadres.

Telefoonnummers

De getoonde telefoonnummers zijn rechtstreeks klikbaar op mobiele toestellen.

Op smartphone of tablet betekent klikken meteen bellen.

6. Blog

Wat doet de blogpagina?

De blogpagina toont nieuwsartikels, clubverslagen, aankondigingen, analyses en andere publicaties in uniforme Krakkemat-stijl met overzichtelijke artikeltegels.

Wat ziet de bezoeker?

• artikeltegels
• titel
• datum
• auteur
• categorie
• korte samenvatting
• tegelafbeelding

Automatische volgorde

Artikels worden automatisch op datum gesorteerd. Het nieuwste artikel verschijnt dus automatisch eerst.

Filteren op soort artikel

Bezoekers kunnen filteren op categorie van artikel.

Hoe worden artikels gemaakt?

De blog werkt met een Bloggenerator .

Mogelijkheden van de generator

• artikelgegevens invullen
• tekst schrijven
• maximaal 3 foto’s toevoegen
• één foto kiezen als tegelafbeelding
• een korte beschrijving toevoegen, de ideale plaats voor eventuele bronvermelding van de foto!
• interactieve schaakpartij toevoegen via Game ID
• optionele titel boven de partijviewer toevoegen
• preview bekijken
• HTML genereren

Foto's toevoegen aan een artikel

Foto's kunnen op twee manieren gebruikt worden in een blogartikel.

• via een externe afbeelding op internet
• via een afbeelding die op de Krakkemat-site staat

Een internetlink kan eenvoudig in de generator worden geplakt. De afbeelding blijft zichtbaar zolang ze online beschikbaar blijft.

Een foto in #blogfotos plaatsen

Ga naar:

De galerijcontainer is het grote groene blok rond de afbeeldingen.

• klik links op Add
• voeg de afbeelding toe
• sla op
• publiceer

1. Open vanuit de Bloggenerator de pagina Blogafbeeldingen via de knop met dezelfde naam.

• Klik met de rechtermuisknop op de gewenste afbeelding.
• Kies Afbeeldingslink kopiëren.
• Plak de link in één van de afbeeldingsvelden van de Bloggenerator.

Foto invoegen in het artikel

• Plaats de cursor op een nieuwe regel waar de afbeelding moet verschijnen.
• Ga naar de gewenste afbeeldingen.
• Klik op Invoegen.

De afbeelding wordt automatisch op de positie van de cursor in het artikel geplaatst.

Interactieve schaakpartijen

Blogartikels kunnen een interactieve schaakpartij bevatten. De generator gebruikt hiervoor een Game ID.

Hoe krijg je de juiste Game ID?

De Game ID wordt opgehaald via de partijendatabase. Dit is bewust op deze manier ontworpen zodat je je niet kunt vergissen.

• Ga naar de partijdatabase.
• Zoek de partij die je in het blogartikel wil gebruiken.
• Klik op de viewknop van die partij.
• De partij opent in de viewer en kan desgewenst worden nagespeeld.
• Tegelijk wordt de juiste Game ID automatisch naar het klembord gekopieerd.
• Ga naar de Bloggenerator.
• Plak de Game ID in het veld Game ID met Ctrl + V of via Plakken.

Wanneer een bezoeker het artikel opent:

• wordt de partij automatisch opgehaald uit de partijdatabase
• verschijnt een schaakbord
• verschijnt een zettenlijst
• kan de bezoeker door de partij navigeren
• kan het bord gedraaid worden

De partij moet aanwezig zijn in de partijdatabase. Bestaat de opgegeven Game ID niet, dan kan de partij niet worden weergegeven.

Publiceren

Na HTML genereren ga je naar:

Datablock in Carrd

Artikel verwijderen

Een artikel verwijderen doe je door het volledige artikelblok uit de blogdata te verwijderen.

7. Galerij

Wat doet de galerij?

De galerij toont foto’s van clubevents, toernooien, lessen, activiteiten en andere momenten binnen Krakkemat.

Filterfunctie

De galerij bevat geen zoekfunctie, maar wel een filterfunctie.

• categorieën
• soorten activiteiten
• fotoblokken

Hoe worden foto’s toegevoegd?

De galerij werkt met een Galerijgenerator .

Mogelijkheden van de generator

• foto’s toevoegen
• titel invullen
• datum kiezen
• categorie kiezen
• korte beschrijving toevoegen, maximum 300 tekens
• HTML genereren

Foto toevoegen

Bij een foto wordt gewerkt met een URL / link naar een afbeelding.

• afbeelding op de Krakkemat-site, absolute voorkeur
• externe afbeelding op internet
• andere geldige afbeeldingslink

Foto op de Krakkemat-website plaatsen

Om foto's op de Krakkemat website te gebruiken, plaats je ze eerst op de niet-publieke fotopagina.

1. Open Carrd en ga naar #galerijfotos.
2. Voeg één of meerdere foto's toe zoals je dat normaal doet.
3. Publiceer de website.
4. Open vervolgens krakkemat.be/#galerijfotos.
5. Klik met de rechtermuisknop op de gewenste foto en kopieer de afbeeldingslink zoals je dat op elke andere website zou doen.
6. Plak deze link in de Galerijgenerator en vul titel, beschrijving, datum en categorie aan.

Publiceren

Na HTML genereren plak je de inhoud van het klembord:

Datablock in Carrd

Foto verwijderen

Een foto verwijderen doe je door het volledige fotoblok uit de data te verwijderen.

8. Shop

Wat doet de shop?

De shop toont clubartikelen, lidgeld en andere producten van Krakkemat in uniforme Krakkemat-stijl.

Hoe worden artikelen toegevoegd?

De shop werkt met een Shopgenerator .

Mogelijkheden van de generator

• titel invullen
• prijs bepalen
• beschrijving toevoegen
• afbeelding toevoegen
• betaallink invullen, creatie in Mollie
• preview bekijken
• HTML genereren

Preview

De preview toont exact hoe het artikel uiteindelijk in de shop zal verschijnen.

Belangrijk

De generator maakt alleen het shopartikel zelf. Niet de betaling, niet de betaalpagina en niet de betaallink.

Mollie

In de shopgenerator wordt de Mollie-link alleen ingeplakt. Het is de bestemming van de betaalknop.

Publiceren

Na HTML genereren ga je naar:

Datablock in Carrd

Opmerking over artikelafbeelding

• gebruik afbeeldingen met transparante achtergrond
• gebruik bij voorkeur een interne link op de website
• een externe link kan ook, zolang de afbeelding online blijft

Artikel verwijderen

Een artikel verwijderen doe je door het volledige artikelblok uit de data te verwijderen.

9. Ledenhoek

Wat is de ledenhoek?

De ledenhoek is het centrale toegangspunt voor ledeninformatie.

Hoofdmenu

• Competitie 2026 - ’27
• Krakkemat online
• Stappenmethode
• Initiatie 1ste jaar
• Krakkemat reglement

Competitie 2026 - ’27

Dit is het belangrijkste beheerde onderdeel binnen de ledenhoek. Hieronder vallen uitslagen, rangschikking en competitierondes.

Krakkemat online

Deze knop leidt naar de pagina Krakkemat online, waar online activiteiten en het online archief beheerd worden.

Stappenmethode

Deze knop leidt naar een pagina met links naar de oplossingen van Stappenmethode 1, 2 en 3.

Initiatie 1ste jaar

Deze knop leidt naar een pagina met externe links naar bronnen die de basisprincipes van schaken uitleggen, inclusief Mora → PDF.

Krakkemat reglement

Deze knop toont het clubreglement en de algemene afspraken.

Bewuste eenvoud

De ledenhoek werd bewust eenvoudig gehouden: snelle toegang, duidelijke navigatie en geen technische complexiteit voor gewone leden.

10. Krakkemat Online

Wat is Krakkemat Online?

Krakkemat Online verzamelt alle online activiteiten van de club op één centrale plaats.

Hoe wordt de pagina beheerd?

De onlinepagina wordt beheerd via de Online Generator .

Inhoud van de generator

• categorie kiezen
• titel invullen
• beschrijving toevoegen
• externe link invullen
• preview bekijken
• HTML genereren

Links

De link in de generator moet verwijzen naar de toernooilink op chess.com, die is gekoppeld aan de knop 'speel mee'.

Publiceren

Na HTML genereren ga je naar:

Datablock in Carrd

Item verwijderen

Een item verwijderen doe je door het volledige itemblok uit de data te verwijderen.

11. Competitiebeheer

Wat is Competitiebeheer?

Op de vroegere website werd gebruikgemaakt van Swiss Online Tournament voor het verwerken van uitslagen en rangschikkingen. Op de nieuwe website gebeurt dit volledig binnen Krakkemat.

Het nieuwe Competitiebeheer werd ontwikkeld om de webbeheerder minder manueel werk te bezorgen en om alle gegevens op een uniforme manier te verwerken.

Hierdoor vormen competitie, rangschikking, partijdatabase en viewer één geïntegreerd geheel binnen de Krakkemat-website, het Krakkemat-schaakecosysteem.

Vanuit het dashboard Competitiebeheer zijn vijf onderdelen beschikbaar:

• Spelersbeheer
• Competitie-instellingen
• Rondevoorbereider
• Pairing Generator
• Publicatieblok stand

Spelersbeheer en Competitie-instellingen worden meestal slechts af en toe aangepast. Tijdens een gewone speelavond worden doorgaans enkel de Rondevoorbereider, de Pairing Generator en het Publicatieblok stand gebruikt.

11.1 Spelersbeheer

Wat is het doel van Spelersbeheer?

Spelersbeheer bevat de lijst van alle spelers die door het Competitiebeheer gebruikt worden. Deze lijst werkt ook samen met de Livenotatie tool en de PGN tool, waar de spelers uit de lijst gekozen kunnen worden.

Deze lijst blijft normaal gedurende lange tijd ongewijzigd. Enkel wanneer gegevens aangepast moeten worden, is het nodig om dit onderdeel te openen.

Wanneer gebruik je Spelersbeheer?

Spelersbeheer wordt bijvoorbeeld gebruikt wanneer:

• een nieuw lid aansluit;
• een speler de club verlaat;
• een naam gewijzigd moet worden;
• een speler actief of niet-actief wordt;
• een bestuursfunctie aangepast moet worden;
• de eventuele speelsterkte aangepast moet worden.

Spelers toevoegen

Nieuwe spelers kunnen eenvoudig toegevoegd worden.

Vul de gevraagde gegevens in en voeg de speler toe aan de lijst.

Spelers wijzigen

Bestaande spelers kunnen op elk moment aangepast worden.

Wanneer een naam fout gespeld werd of bepaalde gegevens gewijzigd zijn, volstaat het om de speler te bewerken.

Spelers verwijderen

Spelers kunnen verwijderd worden wanneer zij niet langer deel uitmaken van de spelerslijst.

Actieve en niet-actieve spelers

Actieve spelers verschijnen in de verschillende onderdelen van het Competitiebeheer.

Niet-actieve spelers blijven bewaard, maar worden niet meer gebruikt bij nieuwe competities.

Bestuursleden

Bij spelers kan aangeduid worden of zij bestuurslid zijn.

Deze informatie wordt onder meer gebruikt wanneer gekozen wordt voor de regel Bye enkel bestuur.

Speelsterkte

Voor iedere speler kan eventueel een speelsterkte toegekend worden. Dit is niet verplicht.

Wanneer geen speelsterktes gebruikt worden, blijft het systeem volledig bruikbaar.

Detailkaart

Bij iedere speler is een detailkaart beschikbaar.

Hierin kunnen bijkomende gegevens bekeken worden zonder dat de spelerslijst onoverzichtelijk wordt.

11.2 Competitie-instellingen

Wat is het doel van Competitie-instellingen?

In dit onderdeel worden de eigenschappen van een competitie vastgelegd.

Meestal gebeurt dit slechts één keer bij het begin van een nieuwe competitie.

Daarna hoeven deze instellingen normaal niet meer gewijzigd te worden.

Naam van de competitie

Geef iedere competitie een duidelijke naam.

Bijvoorbeeld:

• Seizoen 2026-2027
• Zomercompetitie
• Blitzavond juni 2027

Aantal ronden

Hier wordt bepaald hoeveel ronden een competitie maximaal bevat.

Wanneer dit veld leeg gelaten wordt, kunnen onbeperkt ronden toegevoegd worden.

Punten voor winst, remise en verlies

Voor iedere competitie kan bepaald worden hoeveel punten toegekend worden voor:

• winst;
• remise;
• verlies.

Hierdoor kunnen verschillende puntensystemen gebruikt worden.

Aanwezigheidspunten

Naast speelpunten kunnen ook aanwezigheidspunten toegekend worden.

Op die manier kunnen spelers beloond worden voor regelmatige deelname.

Bye-regels

Er kan gekozen worden of een bye enkel aan bestuursleden toegekend mag worden of aan alle spelers.

Rangschikking enkel aanwezigen

Met deze instelling wordt bepaald welke spelers in de rangschikking opgenomen worden.

Wanneer deze optie uitgeschakeld is, bevat de rangschikking alle spelers van de competitie.

Dit is de gebruikelijke instelling voor een gewone clubcompetitie.

Wanneer deze optie ingeschakeld is, worden enkel de spelers opgenomen die effectief deelnemen aan de huidige ronde.

Dit is vooral nuttig voor een afzonderlijke blitzavond of een losstaand eendaags toernooi waarbij enkel de aanwezige spelers deel uitmaken van de rangschikking.

Indien nodig kan hiervoor vooraf een speler toegevoegd worden die enkel aan dit eenmalige evenement deelneemt.

Meerdere competities

Verschillende competities kunnen naast elkaar bestaan.

Zo kan bijvoorbeeld een seizoencompetitie gecombineerd worden met afzonderlijke blitzavonden.

11.3 Rondevoorbereider

De Rondevoorbereider vormt het begin van iedere competitieavond.

De gegevens die hier ingevoerd worden, worden later gebruikt door de Pairing Generator.

Stap 1 – Kies de competitie

Selecteer eerst de competitie waarvoor een nieuwe ronde voorbereid wordt.

Stap 2 – Kies datum en rondenummer

Controleer de datum en kies het juiste rondenummer.

Stap 3 – Duid aanwezigen en afwezigen aan

Verplaats de spelers naar de juiste lijst.

Zo wordt duidelijk wie deelneemt aan de ronde.

Stap 4 – Kies eventueel een bye

Bij een oneven aantal spelers kan een bye gekozen worden.

Afhankelijk van de instellingen kan dit beperkt zijn tot bestuursleden.

Stap 5 – Bewaar rondevoorbereiding

Klik op:

Deze knop staat bewust onderaan zodat niet per ongeluk te vroeg bewaard wordt.

11.4 Pairing Generator

Gegevens controleren

Bij het openen van de Pairing Generator worden vier databronnen gecontroleerd.

Controleer of alle bronnen correct geladen werden.

Pairings genereren

Klik op:

De pairings worden automatisch berekend.

Projectiescherm

De Pairing Generator beschikt over een projectiescherm.

Hiermee kunnen zowel de pairings als de rangschikking op een groot scherm getoond worden.

Aan het begin van de avond zullen meestal de pairings geprojecteerd worden.

Wanneer alle uitslagen ingevoerd zijn en de rangschikking berekend werd, kunnen zowel de uitslagen als de bijgewerkte stand geprojecteerd worden.

Uitslagen invullen

Na afloop van de partijen kunnen de resultaten ingevuld worden.

Mogelijke uitslagen zijn:

• 1-0
• ½-½
• 0-1

Rangschikking berekenen

Klik daarna op:

Hierdoor ontstaat de tijdelijke rangschikking van de huidige ronde.

Deze kan eventueel ook geprojecteerd worden.

Rondehistoriek kopiëren

Dit is de belangrijkste stap van het volledige proces.

Klik op:

Ga vervolgens naar:

Open het datablok:

Verwijder de volledige inhoud van dit blok en plak daarna de nieuwe rondehistoriek.

11.5 Publicatieblok stand

Wat is het Publicatieblok stand?

Met het Publicatieblok stand worden de resultaten van de gespeelde ronde omgezet naar een HTML-blok, nodig om de rondeuitslagen en rangschikking te publiceren op de website en samen te werken met de partijdatabase.

Stap 1 – Gegevens laden

Klik eerst op:

Stap 2 – Controleer de gegevens

Wanneer alles correct geladen werd, verschijnt een controlebericht.

Bijvoorbeeld:

• We publiceren het HTML-blok voor ronde 8 van datum 19 juni 2027 binnen competitie Seizoen 2026-2027.
• Er werden 6 partijen gevonden.
• De rangschikking bevat 13 spelers.

Controleer of deze gegevens overeenkomen met de ronde die gepubliceerd moet worden.

Stap 3 – Correct?

Wanneer alle gegevens correct zijn, verplaats je de schuifknop van:

naar

Het HTML-blok wordt nu automatisch aangemaakt.

Stap 4 – HTML kopiëren

Klik vervolgens op:

Ga daarna naar:

Selecteer de container waarin de verschillende rondeblokken zich bevinden.

Maak vervolgens een nieuw embedblok aan of kopieer een bestaand rondeblok en verwijder de inhoud helemaal.

Bij een nieuw embedblok is dit uiteraard nog leeg.

Plak hierin het gegenereerde HTML-blok.

Naam van het embedblok

Geef het embedblok een naam die overeenkomt met het rondenummer.

Bijvoorbeeld:

Gebruik dus enkel het rondenummer gevolgd door .html.

Publiceren

Zoals bij alle wijzigingen in Carrd moeten de aanpassingen nog gepubliceerd worden.

Klik op het diskette-icoon en daarna op:

Pas daarna worden de nieuwe uitslagen en de bijgewerkte rangschikking zichtbaar op de website (refresh).

12. PGN Tool

Wat is de PGN Tool?

De PGN Tool is een custom gebouwde Krakkemat-tool voor het invoeren van schaakpartijen.

De tool maakt deel uit van een tri-tool systeem:

• PGN Tool
• partijdatabase
• PGN Viewer

Waarom werd deze tool gebouwd?

De bedoeling is enerzijds de sectie “genoteerde partijen” gedeeltelijk te automatiseren. Anderzijds is het de tool om de Krakkemat database te voeden.

Vroeger werd een partij doorgestuurd via mail, ingegeven op Chess.com, omgezet naar een iframe en manueel in Google Sites geplakt.

Dat gaf regelmatig problemen: verkeerd PGN-formaat, syntaxfouten, analysezetten in de partij, extra verbeterwerk en veel manueel werk.

Waarom de nieuwe PGN Tool beter is

• het lid voert de partij onmiddellijk correct in
• fouten kunnen direct verbeterd worden
• de partij komt semi-automatisch in de partijdatabase
• de partij kan gekoppeld worden aan uitslagen en rangschikking
• oudere partijen blijven beschikbaar
• het iframe-tussenwerk verdwijnt

Hoe werkt de PGN Tool?

Een lid kan zetten invoeren, fouten verbeteren, zetten terugnemen, door de partij navigeren en spelersnamen, datum, ronde en resultaat invullen.

Vergevingsgezind systeem

De tool werd bewust gebruiksvriendelijk en vergevingsgezind gebouwd. Fouten zijn makkelijk te corrigeren, zetten kunnen teruggenomen worden en de partij kan gecontroleerd worden voor verzending.

Twee mogelijkheden na invoer

Optie 1 – PGN kopiëren

De PGN kan naar het klembord gekopieerd worden en daarna in Chess.com, Lichess of een analysetool gebruikt worden.

Optie 2 – Verzenden naar Krakkemat

De PGN Tool zet de partij om naar HTML, vult automatisch een formulier in en stuurt de gegevens door. Het lid vult enkel nog naam en e-mailadres in.

E-mailbestemming

Publiceren in de database

De ontvangen HTML wordt daarna in de partijdatabase geplakt.

Resultaat

Na publicatie zit de partij in de database, en kan ze door andere toepassingen worden gevonden. Zo zal er (na referesh) een view-icon verschijnen bij de bewuste partij in 'Competitie - rondeuitslagen en rangschikking' en kan de viewer de partij openen.

13. PGN Viewer

Wat is de PGN Viewer?

De PGN Viewer is een custom gebouwde inline Krakkemat-tool om partijen te bekijken.

Wat betekent inline?

Inline betekent dat de partij rechtstreeks op de website verschijnt.

• geen externe pagina
• geen nieuw tabblad
• geen iframe van een andere website

Alles is volledig geïntegreerd binnen Krakkemat zelf.

Waarom is dat belangrijk?

Dit zorgt voor uniforme Krakkemat-stijl, professionelere uitstraling, minder externe afhankelijkheden, betere gebruikservaring en snellere toegang tot partijen.

Oude werkwijze

Vroeger werden partijen vaak op Chess.com ingegeven, omgezet naar een iframe en manueel op Google Sites geplaatst.

Nieuwe werkwijze

Met de nieuwe PGN Viewer blijft alles binnen het Krakkemat-ecosysteem (eigen beheer, geen afhankelijkheid van externe diensten of toepassingen of tools).

Hoe werkt de viewer?

Wanneer een partij geopend wordt, leest de viewer automatisch de PGN uit de database.

• schaakbord
• zetlijst
• spelersinformatie
• resultaat
• eventinformatie
• navigatieknoppen

Automatische koppeling

De viewer werkt samen met het view-icon op de competitiepagina (ronde-uitslagen & rangschikking). Wanneer een bezoeker op het view-icon klikt, opent automatisch de juiste partij in de viewer.

Databasegestuurd systeem

De viewer werkt volledig op basis van databasegegevens. Daardoor moeten geen volledige pagina’s manueel worden aangepast.

Groot voordeel

De website groeit hierdoor stilaan naar een volledig eigen schaakecosysteem met eigen database, viewer, tools en publicatiesysteem.

Koppeling met blog (nodig? nuttig? te bespreken)

Ook blogartikels kunnen later automatisch partijen openen in de viewer wanneer de partij correct in de database staat en de koppeling aanwezig is.

Een handige afspraak is om in de PGN bij event in te vullen:

14. Partijdatabase

Wat is de partijdatabase?

De partijdatabase is de centrale opslagplaats van alle schaakpartijen binnen Krakkemat.

Hier worden competitiewedstrijden, blogpartijen, analyses, historische partijen en andere PGN-partijen bewaard.

Belangrijk

De database werkt rechtstreeks samen met de PGN Tool, de PGN Viewer, de competitiepagina en de blog.

Huidige werking

Momenteel staat de database rechtstreeks in de websitecode zelf. De partijen zitten dus letterlijk in de Carrd-website verwerkt.

Waarom werd hiervoor gekozen?

Omdat dit snel opstartbaar was, eenvoudig te beheren is, geen aparte serverontwikkeling vraagt en perfect bruikbaar is in de opstartfase.

Belangrijk voor bestuursleden

De huidige database is perfect geschikt voor de groeifase van Krakkemat. Tot ongeveer enkele honderden partijen vormt dit normaal geen groot probleem.

Groot verschil met een echte database

Momenteel gebeurt bij het openen van de website vaak het laden van een groot deel van de volledige websitecode, ook wanneer slechts één partij gezocht wordt.

Waarom is dat later minder ideaal?

• alles wordt zwaarder
• zoeken wordt trager
• te veel data moet geladen worden
• de websitecode groeit sterk aan

Wat gebeurt later waarschijnlijk?

Op langere termijn zal Krakkemat waarschijnlijk overschakelen naar een echte aparte database. Dat is volledig normaal en hoort bij de groei van het systeem.

Wat is SQL?

SQL is een echte aparte databankstructuur. Daarin worden partijen apart opgeslagen, apart opgevraagd en apart gefilterd.

Groot voordeel van SQL

Bij een echte SQL-database wordt alleen de gevraagde data geladen, bijvoorbeeld alleen de partijen van één speler.

Toegang tot het hostingpakket

Toegang tot het hostingpakket is zeer belangrijk, omdat daar later databanken, koppelingen, hostinginstellingen en serverfuncties beheerd worden.

Wat ontbreekt momenteel nog?

• technische creatie van de databank
• koppeling met de websitecode
• ontwikkeling van zoek- en laadstructuur

Toekomstvisie

De bedoeling is dat Krakkemat later kan beschikken over een grote eigen partijdatabase, spelerfilters, automatische koppelingen, statistieken, spelerpagina’s, uitgebreide zoekmogelijkheden en automatische publicaties.

Belangrijk inzicht

De huidige website is niet zomaar een gewone clubwebsite, maar de basis van een volledig eigen schaakplatform.

Tot slot

Deze handleiding werd opgebouwd zodat bestuursleden zelfstandig met de website kunnen werken, generators correct gebruikt worden, data uniform verwerkt wordt, de website beheersbaar blijft en toekomstige uitbreidingen mogelijk blijven.

Belangrijk inzicht

Krakkemat is ondertussen meer dan een gewone clubwebsite.

• eigen generators
• eigen partijdatabase
• eigen viewer
• eigen PGN Tool
• automatische koppelingen
• groeiende digitale structuur

Evolutie van het systeem

Het systeem zal stap voor stap blijven evolueren. Nieuwe tools, koppelingen en databankstructuren zijn geen teken dat iets fout loopt, maar juist een teken dat Krakkemat digitaal verder groeit.

Voor bestuursleden

De belangrijkste regel blijft:

• werk rustig
• wijzig alleen wat nodig is
• respecteer rode waarschuwingsblokken
• vergeet nooit op te slaan en te publiceren

Versiebeheer

Deze handleiding is versie 1.2 – compatibel met de meest recente versie van het wijzigingsbeheer.

Latere uitbreidingen kunnen extra screenshots toevoegen, Mollie integreren, nieuwe generators beschrijven, toekomstige databankstructuren documenteren en Webadmin verder uitbreiden.