=== KNZB Competitiestand ===
Contributors: Jeroen Dellebeke, KNZB taakgroep Competities & Circuits
Requires at least: 5.8
Tested up to: 7.1.3
Requires PHP: 7.4
Stable tag: 1.4.2
License: GPL-2.0-or-later

Toont de KNZB-zwemcompetitiestanden, de competitieanalyse, de club-MVP's en de vergelijkende uitslag van een vereniging op de eigen website, via de publieke API van de KNZB Competitiemodule.

== Installatie ==
1. Plugins → Nieuwe plugin → Plugin uploaden → kies knzb-competitiestand.zip → Activeren.
2. Controleer onder Instellingen → Competitiestand het depotnummer van de vereniging in (bijv. 05-014) en kies eventueel de clubkleuren.
3. Plaats de shortcode op een pagina of de widget in een zijbalk/footer.

== Shortcode: stand ==
[competitiestand]                                  Per team de volledige poulestand
[competitiestand weergave="overzicht"]             Compact: alle teams met klasse, positie, punten
[competitiestand weergave="team" team="2"]         Poulestand van één team
[competitiestand weergave="klasse" klasse="E"]     Stand van een klasse (E, 1A, 1B, A1 … C5)

Extra opties: rondes="nee", titel="nee", bron="nee", depotnr="05-014".

== Shortcode: competitieanalyse ==
[competitieanalyse]                                       Profiel van het team: punten, plaats en verschil met het klassegemiddelde per leeftijdsgroep, plus ontwikkelpunten
[competitieanalyse depotnr="05-014" team="1" ronde="totaal"]   Profiel over alle verwerkte rondes
[competitieanalyse weergave="matrix"]                     Krachtenmatrix: plaats per leeftijdsgroep van alle teams in de klasse van het team
[competitieanalyse weergave="matrix" klasse="E"]          Krachtenmatrix van een klasse

Opties: weergave="profiel|matrix", depotnr, team (0 = enig team zonder nummer), klasse, ronde="1"–"5" of "totaal" (leeg = laatst verwerkte ronde), titel="nee", bron="nee".
De analyse bevat alleen geaggregeerde cijfers (geen zwemmersnamen).

== Shortcode: competitiemvp ==
[competitiemvp]                                     Club-MVP's: top 3 zwemmers van het team met de hoogste gemiddelde punten per start, met knoppen samen/heren/dames
[competitiemvp maat="boven_veld"]                   Rangschikken op punten boven het veld in plaats van gemiddeld per start
[competitiemvp depotnr="05-014" team="2"]           Ander team of andere vereniging
[competitiemvp geslacht="dames" geslachtkeuze="nee"]   Alleen de dames, zonder knoppen

Opties: team (leeg = eerste team), geslacht="samen|heren|dames" (startkeuze), geslachtkeuze="ja|nee", ronde="1"–"5" of "seizoen" (leeg = laatst verwerkte ronde), aantal (1–10, standaard 3), min_starts (standaard 2), maat="gemiddeld|boven_veld" (standaard gemiddeld), toon_starts="nee", titel="nee", bron="nee".
Gemiddeld per start (standaard): de gemiddelde basistijdpunten van de tellende individuele starts; altijd positief, ook voor zwemmers in een sterke klasse.
Punten boven het veld: per start het verschil met de mediaan van dat programmanummer in de klasse, opgeteld; kan negatief zijn. Estafettes tellen in beide niet mee.

== Shortcode: competitieuitslag ==
[competitieuitslag]                                  Vergelijkende uitslag van de eigen klasse: per programmanummer de top 3, eigen vereniging gemarkeerd (ook als die buiten de top 3 valt)
[competitieuitslag alleen="ja"]                      Alleen de nummers waarin de eigen vereniging staat
[competitieuitslag programma="3,4,5" aantal="5"]    Bepaalde nummers, top 5

Opties: team (bepaalt de klasse; leeg = eerste team), klasse (bijv. "B2", in plaats van de klasse van het team), ronde="1"–"5" (leeg = laatst verwerkte ronde), aantal (1–25), programma, alleen="ja", starts="tellend|alle", titel="nee", bron="nee".

== Namen van zwemmers ==
De MVP's en de vergelijkende uitslag tonen namen volgens de instelling "Namen op MVP-stories" van de KNZB Competitiemodule. Mogen namen van (jeugd)zwemmers niet getoond worden, dan staat er "Zwemmer" of "Zwemster" met vereniging en geboortejaar. Startnummers worden nooit getoond.

== Updates ==
Vanaf versie 1.4.0 meldt WordPress zelf wanneer er een nieuwe versie is, net als bij andere plugins: bij Plugins en onder Dashboard → Updates. Met "Nu bijwerken" wordt de nieuwe versie van zwemcompetitie.knzb.nl geïnstalleerd; automatische updates kun je per site aanzetten bij Plugins.
* WordPress controleert twee keer per dag; de plugin vraagt het releasebestand hoogstens eens per 12 uur op (bij "Opnieuw controleren" direct).
* De controle is anoniem: er gaat geen site-adres of andere sitegegevens mee.
* Is de KNZB-server niet bereikbaar, dan gebeurt er niets; de site merkt er niets van.
* Versies vóór 1.4.0 moeten nog één keer handmatig worden bijgewerkt (zip uploaden).

== Werking ==
* De gegevens worden server-side opgehaald en minimaal 5 minuten gecachet (gelijk aan de API-cache).
* Is de API onbereikbaar, dan worden de laatst bekende gegevens getoond.
* Via Instellingen → Competitiestand → "Cache legen" haal je direct verse gegevens op.
* Primaire kleur en accentkleur zijn instelbaar; overige CSS-variabelen (--knzbcs-*) zijn via Extra CSS te overschrijven.

== Contact ==
Auteur: Jeroen Dellebeke, KNZB taakgroep Competities & Circuits
Contact: competities@knzb-wedstrijdzwemmen.nl
Website: https://zwemcompetitie.knzb.nl

== Changelog ==
= 1.4.2 =
* Getest met WordPress 7.1.2 en 7.1.3. De updatemelding toont nu de geteste WordPress-versie ("Tested up to: 7.1.3") in plaats van "compatibiliteit onbekend".

= 1.4.1 =
* Auteur, contactadres en website bijgewerkt (pluginlijst, "Details bekijken", instellingenpagina en readme).

= 1.4.0 =
* Nieuw: updatemelding in WordPress. Nieuwe versies verschijnen bij Plugins en onder Dashboard → Updates en zijn met één klik (of automatisch) te installeren. De controle is anoniem.

= 1.3.0 =
* [competitiemvp] en de widget "KNZB Club-MVP's" rangschikken standaard op gemiddelde punten per start (geen negatieve scores meer). Met maat="boven_veld" de oude weergave.

= 1.2.0 =
* Nieuw: shortcode [competitiemvp] en widget "KNZB Club-MVP's" (top 3 met geslachtskeuze).
* Nieuw: shortcode [competitieuitslag] en widget "KNZB Vergelijkende uitslag" (top per programmanummer van de eigen klasse, eigen vereniging gemarkeerd).
* Namen van zwemmers volgen de naaminstelling van de KNZB Competitiemodule.

= 1.1.0 =
* Nieuw: shortcode [competitieanalyse] en widget "KNZB Competitieanalyse" (sterkte per leeftijdsgroep, ontwikkelpunten, krachtenmatrix).

= 1.0.0 =
* Eerste versie: standen per team, vereniging en klasse.
