# Shortcodes KNVB API Wordpress Plugin Met deze plugin is het mogelijk om door middel van shortcodes data uit de KNVB Dataservice API op te halen. Deze shortcodes worden dan vertaalt naar een tabel in de wordpress website. Naast alle reguliere API calls, zoals die staan beschreven op http://api.knvbdataservice.nl/, zitten er in deze plugin ook een aantal extra features zoals het tonen van het clublogo, filteren op alleen thuiswedstrijden, filteren alle wedstrijden of op de volgende/vorige en huidige week. Voor meer informatie over het gebruik van de verschillende shortcodes, zie onze [handleiding](http://www.manula.com/manuals/datawiresport/knvb-dataservice-wordpress-plugin/1/nl/topic/uitgebreide-installatie) Hier volgt een lijst van de verschillende soorten shortcodes die beschikbaar zijn binnen de plugin: * Lijst tonen van alle teams * Lijst tonen met alle wedstrijden * Lijst tonen met alle competities * Lijst tonen met de uitslagen per team * Lijst tonen met het programma per team * Lijst tonen met de stand van een team * Lijst tonen met de uitslagen van een competitie * Lijst tonen met het programma van een competitie * Lijst met de standen binnen een competitie * Details van één specifieke wedstijd Naast de bovenstaande reguliere shortcodes, kunt u per shortcode extra parameters toevoegen die zorgen extra filtering of sortering: * Toon club logo bij de teams * Sorteer wedstrijden op uit en thuis wedstrijden * Toon enkel de thuis wedstrijden * Toon de wedstrijden van de huidige, vorige, volgende week, een bepaald week nummer of van alle weken. * Toon enkel de vriendschappelijke, reguliere of beker wedstrijden * Toon enkel de wedstrijden binnen een bepaalde poule * Toon enkel de veld of zaal wedstrijden * Toon enkel de wedstrijden van de 1ste, 2e, 3e of 4e periode van het seizoen. ## Installatie ### Automatisch installeren: 1. Log via uw browser in op de backend van uw wordpress website. 1. Kies voor het menu item `Plugins`. 1. Klik op de knop `Nieuwe plugin`. 1. Zoek op `Shortcodes KNVB API`. 1. Klik op `Nu installeren`. ### Handmatig installeren: 1. [Download](https://bitbucket.org/WimarSchippers/shortcodes-knvb-api/get/62b799ecfb89.zip) het .zip bestand. Alternatief kunt u deze ook hier downloaden - https://bitbucket.org/WimarSchippers/shortcodes-knvb-api/downloads. 1. Pak het zip bestand dat u net gedownload hetb uit op uw computer. 1. Hernoem de uitgepakte map naar `shortcodes-knvb-api`. 1. Log via FTP in op de server waar uw wordpress website staat en navigeer naar de `/wp-content/plugins/` map. 1. Upload de `shortcodes-knvb-api` map, op uw computer, naar de `/wp-content/plugins/` op de server. 1. Log via uw browser in op de backend van uw wordpress website. 1. Kies voor het menu item `Plugins`. 1. Activeer de `Shortcodes KNVB API` plugin. ### Instellen: 1. Log via uw browser in op de backend van uw wordpress website. 1. Ga naar `Instellingen - KNVB API`. 1. Geef de API sleutel in en de pathnaam van uw club in. Als u het veld cache niet invult of op *0* zet dan zal de plugin geen data cachen. 1. Sla de instellingen op. 1. Aan de indicatie lampjes kunt u zien wat de status van API is en of u verbonden bent. 1. Via de verschillende tabs kunt u alle beschikbare shortcodes zien. Deze kunt u simpelweg kopiëren en plakken in een webpagina om de data zichtbaar te maken op uw website. ## Changelog ### 1.14.1 Release date: April 29, 2016 Feature Improvements: * Status light: API status * Status light: API connect status * Tabs: Tabs for each type of shortcode * Tabs: Additional templates for the settings menu * Templates: Additional template for the teams call * Caching: Changed the way the caching system works * Settings: Retrieve the KNVB name through the API rather than manually setting it ## FAQ's Hoe stel ik de plugin in? * Log via uw browser in op de backend van uw wordpress website. * Ga naar `Instellingen - KNVB API`. * Geef de API sleutel in en de pathnaam van uw club in. Als u het veld cache niet invult of op *0* zet dan zal de plugin geen data cachen. * Sla de instellingen op. * Aan de indicatie lampjes kunt u zien wat de status van API is en of u verbonden bent. * Via de verschillende tabs kunt u alle beschikbare shortcodes zien. Deze kunt u simpelweg kopiëren en plakken in een webpagina om de data zichtbaar te maken op uw website. Waarom zie ik zie geen text/content op de verschillende tabbladen van het instellingen menu van de plugin? * De cache map moet 777 rechten hebben. De cache map word normaal gesproken zelf door de plugin aangemaakt maar als u geen text/content ziet op de verschillende tab bladen van het instellingen scherm van de plugin dan moet u deze rechten wellicht manueel toekennen. Op een Linux server doet u dat als volgt: * Log via ftp of ssh in op de server waar uw wordpress website staat. * Navigeer naar de uploads map van de wordpress installatie ( b.v. `cd /var/www/html/wordpress/wp-content/uploads`). * Controleer of er, in de uploads map, een map bestaat die `shortcodes-knvb-api` heet en of er in de shortcodes map een map staat de `cache` heet (`/uploads/shortcodes-knvb-api/cache`). Bestaat één van beide mappen niet dan moeten deze mappen aangemaakt worden en de 777 rechten aan de cache map worden toegekend. Dit kan allemaal via één command: `mkdir -p -m 777 shortcodes-knvb-api/cache`. * Staan zowel de `shortcodes-knvb-api` map in de `uploads` map als de `cache` map in de shortcodes map, dan moeten alleen de juiste rechten aan de cache map worden toegekend d.m.v. het volgende command `chmod 777 shortcodes-knvb-api/cache`. * Refresh het instellingen scherm van de plugin in uw browser en controleer of er text/content in de verschillende tabbladen staat. ## Bijdragen geleverd door * [hoest](https://github.com/hoest/) * [thepercival](https://github.com/thepercival) * [WimarSchippers](https://bitbucket.org/WimarSchippers/)