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

Met Competitiebeheer beheer je een competitie van begin tot einde: spelers, competitie-instellingen, rondeplanning, pairing, uitslagen en rangschikking.

Het beheer bestaat uit vier onderdelen. Deze komen overeen met de vier tegels die je ziet op de pagina Competitiebeheer.

11.1 De vier onderdelen

Spelersbeheer

Hier wordt de centrale spelerslijst beheerd.

Nieuwe spelers worden hier toegevoegd. Bestaande spelers kunnen worden gewijzigd of actief/inactief worden gezet.

De andere onderdelen van Competitiebeheer gebruiken deze spelerslijst automatisch.

Competitie-instellingen

Hier wordt een competitie aangemaakt en worden de vaste spelregels ingesteld.

Daaronder vallen onder andere:

• de naam van de competitie;
• het seizoen;
• het aantal rondes;
• de puntentelling;
• de bye-instellingen;
• het competitietype;
• de instelling voor de eerste ronde.

Een competitie wordt normaal één keer correct ingesteld vóór de start. Daarna hoeven deze instellingen tijdens het seizoen meestal niet meer gewijzigd te worden.

Rondeplanning

Hier begint een nieuwe speelronde.

In Rondeplanning:

• kies je de juiste competitie;
• controleer je het rondenummer en de datum;
• duid je de aanwezige spelers aan;
• duid je de afwezige spelers aan;
• kies je indien nodig een bye-speler.

De status bovenaan helpt je controleren of alles klaar is om te pairen.

Pairing Generator

Vanuit Rondeplanning ga je naar de Pairing Generator.

Daar wordt de pairing gemaakt. Na afloop van de partijen voer je hier alle uitslagen in en controleer je de nieuwe rangschikking.

De laatste stap is bijzonder belangrijk: Exporteer rondehistoriek.

11.2 Een ronde verwerken — vaste werkwijze

Voor een gewone speelronde volg je steeds dezelfde volgorde. Deze werkwijze geldt zowel voor een lange competitie als voor een blitztoernooi.

Stap 1 — Open Rondeplanning

Open Rondeplanning.

Kies de juiste competitie en controleer het voorgestelde rondenummer en de datum.

Stap 2 — Stel de aanwezigheid in

Controleer wie aanwezig en afwezig is.

Verplaats spelers indien nodig tussen Aanwezig en Afwezig.

Controleer daarna de status bovenaan.

Stap 3 — Kies indien nodig een bye

Wanneer een oneven aantal spelers aanwezig is, moet één speler bye krijgen.

Kies de juiste bye-speler en controleer opnieuw de status.

Wanneer alles correct staat, kan je verdergaan naar de pairing.

Stap 4 — Open de Pairing Generator

Klik op Naar pairing.

Controleer de voorgestelde pairing voordat de partijen beginnen.

Stap 5 — Speel de partijen

De partijen kunnen nu worden gespeeld.

Indien gewenst kan de pairing via de projectieknop op een groter scherm worden weergegeven.

Stap 6 — Vul alle uitslagen in

Na afloop van de partijen voer je voor iedere partij het correcte resultaat in:

• 1 - 0;
• 1/2 - 1/2;
• 0 - 1.

Controleer of alle resultaten ingevuld zijn.

Stap 7 — Controleer de rangschikking

Zodra alle uitslagen ingevuld zijn, wordt de nieuwe rangschikking berekend.

Controleer deze rangschikking voordat je de ronde bewaart.

Stap 8 — Exporteer de rondehistoriek

Klik op Exporteer rondehistoriek.

De volledige afgewerkte ronde wordt nu naar het klembord gekopieerd.

Deze rondehistoriek bevat onder andere:

• de competitie en het rondenummer;
• de datum;
• aanwezige en afwezige spelers;
• de bye;
• de pairings;
• de uitslagen;
• de rangschikking na de ronde.

Stap 9 — Open het juiste blok in Carrd

Open Carrd en ga op de homepage naar de sectie #homehtml.

Voor iedere voorziene competitie en ronde is daar reeds vooraf een geschikt embedblok aangemaakt.

Zoek het blok dat overeenkomt met de juiste competitie én de juiste ronde.

Bij een lange competitie kan de naamgeving er bijvoorbeeld zo uitzien:

Bij een blitztoernooi kunnen vooraf bijvoorbeeld blokken voorzien zijn zoals:

De exacte naam kan per competitie verschillen. Controleer daarom altijd goed dat je het blok van de juiste competitie en de juiste ronde opent.

Stap 10 — Plak de rondehistoriek

Open het vooraf aangemaakte embedblok voor deze ronde.

Selecteer en wis de begeleidende tekst die in het blok staat, die is louter informatief. Plak de rondehistoriek die je zonet vanuit de Pairing Generator naar het klembord hebt gekopieerd in het nu LEGE blok.

Stap 11 — Publiceer de website

Publiceer daarna de website.

Pas na het publiceren is de afgewerkte ronde permanent beschikbaar voor het competitiebeheer én voor de weergave van resultaten en rangschikking.

11.3 Lange competitie

Bij een lange competitie wordt meestal één ronde per speelavond gespeeld.

Je volgt volledig de vaste werkwijze uit hoofdstuk 11.2.

Na het publiceren van de ronde is het werk voor die speelavond klaar. Bij de volgende speelavond open je opnieuw Rondeplanning.

De website gebruikt de reeds gepubliceerde rondehistoriek om de competitie correct verder te zetten en de volgende ronde te bepalen.

11.4 Blitz / ééndagscompetitie

Ook bij een blitztoernooi volg je voor iedere ronde dezelfde vaste werkwijze: pairing, uitslagen, rangschikking, exporteren, plakken en publiceren.

Het verschil is dat meerdere rondes tijdens dezelfde speeldag kort na elkaar worden gespeeld.

Na iedere blitzronde

Na iedere blitzronde:

1. vul je alle uitslagen in;
2. controleer je de rangschikking;
3. klik je op Exporteer rondehistoriek;
4. plak je de export in het juiste vooraf aangemaakte blok in #homehtml;
5. publiceer je de website.

Daarna kan je terugkeren en doorgaan naar de volgende ronde.

Volgende ronde

Gebruik Volgende ronde om onmiddellijk verder te gaan met de volgende blitzronde.

Tijdens een blitztoernooi houdt de browser de afgewerkte rondes ook tijdelijk lokaal bij. Daardoor kan de volgende ronde onmiddellijk worden opgebouwd.

De lokale opslag is bedoeld om tijdens het toernooi snel van ronde naar ronde te kunnen gaan.

De permanente bewaring gebeurt echter op dezelfde manier als bij een lange competitie: na iedere ronde de rondehistoriek exporteren, in het juiste blok plaatsen en de website publiceren.

11.5 Resultaten en rangschikking

De website leest de opgeslagen rondehistoriek automatisch en gebruikt die gegevens om de juiste uitslagen en rangschikking weer te geven.

Dezelfde rondehistoriek wordt gebruikt om:

• de competitie bij een volgende ronde verder te zetten;
• de uitslagen van gespeelde rondes weer te geven;
• de rangschikking na iedere ronde weer te geven.

11.6 Snelle checklist

Voor iedere ronde

1. Open Rondeplanning.
2. Kies de juiste competitie.
3. Controleer ronde en datum.
4. Stel aanwezigen en afwezigen in.
5. Kies indien nodig een bye.
6. Ga naar de Pairing Generator.
7. Controleer de pairing.
8. Speel de partijen.
9. Vul alle uitslagen in.
10. Controleer de rangschikking.
11. Klik op Exporteer rondehistoriek.
12. Open Carrd → homepage → #homehtml.
13. Open het vooraf aangemaakte blok van de juiste competitie en ronde.
14. Plak de export.
15. Publiceer de website.

Alleen bij blitz

Na het bewaren en publiceren van de ronde ga je terug naar de competitie en gebruik je Volgende ronde.

Daarna herhaal je exact dezelfde procedure voor de volgende blitzronde.

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.