WordPress Playground Blueprints [Handleiding 2026]
WordPress Playground laat je WordPress volledig in de browser draaien, zonder hosting, database of lokale ontwikkelomgeving. Blueprints maken Playground nog krachtiger: met één JSON-bestand zet je automatisch een complete WordPress-omgeving op, inclusief de juiste WordPress-versie, plugins, thema’s en andere instellingen.
Werk je regelmatig met WordPress, dan herken je het vast. Voor iedere nieuwe test installeer je opnieuw dezelfde plugins, activeer je hetzelfde thema en pas je steeds dezelfde instellingen aan. Dat kost tijd en levert regelmatig kleine verschillen op. Blueprints lossen dat op door die stappen vast te leggen, zodat Playground ze automatisch uitvoert.
In het kort
Een WordPress Playground Blueprint is een JSON-bestand waarin staat hoe WordPress Playground een omgeving moet opbouwen. In plaats van alles handmatig te installeren, beschrijf je één keer welke stappen uitgevoerd moeten worden. Playground leest het bestand en bouwt vervolgens automatisch de complete WordPress-installatie op.
Daardoor hoef je niet steeds opnieuw dezelfde voorbereidingen te treffen. Bovendien krijgt iedereen die dezelfde Blueprint gebruikt exact dezelfde testomgeving. Dat maakt Blueprints ideaal voor testen, ontwikkelen, documentatie en demonstraties.
Wat is een WordPress Playground Blueprint?
Zie een Blueprint als een script voor WordPress Playground. In plaats van zelf twintig handelingen uit te voeren, laat je Playground dat werk doen. Zo’n Blueprint kan bijvoorbeeld aangeven:
- welke WordPress-versie moet worden gebruikt;
- welke PHP-versie daarbij hoort;
- welke plugins geïnstalleerd moeten worden;
- welk thema actief moet zijn;
- welke bestanden moeten worden toegevoegd;
- welke pagina direct geopend moet worden.
Playground voert deze opdrachten vervolgens één voor één uit. Daardoor ontstaat iedere keer precies dezelfde WordPress-installatie.
Het grote voordeel is dat je de omgeving niet opslaat, maar de instructies om de omgeving op te bouwen. Dat maakt een Blueprint klein, eenvoudig te delen en gemakkelijk aan te passen.
Hoe voert Playground een Blueprint uit?
Wanneer je een Blueprint opent, leest Playground eerst de instellingen bovenaan het bestand. Daarin staat bijvoorbeeld welke WordPress- en PHP-versie nodig zijn.
Vervolgens worden alle stappen onder elkaar uitgevoerd. Eerst wordt WordPress gestart, daarna worden plugins geïnstalleerd, vervolgens wordt een thema geactiveerd en tenslotte kunnen nog extra bestanden worden toegevoegd of instellingen worden gewijzigd.
Je kunt dit vergelijken met een installatiewizard die je normaal gesproken handmatig doorloopt, maar dan volledig automatisch. Dat maakt Blueprints niet alleen sneller, maar ook betrouwbaarder. Iedereen werkt immers vanuit exact dezelfde uitgangssituatie.
Zelf een Blueprint maken
Een Blueprint maken is eenvoudiger dan je misschien verwacht. Je hebt geen speciale software nodig. Een gewone teksteditor is voldoende, al werkt een editor als Visual Studio Code prettiger omdat JSON automatisch wordt opgemaakt en fouten sneller opvallen.
Stap 1: maak een JSON-bestand
Maak een nieuw bestand en sla dit op als bijvoorbeeld blueprint.json.
Een Blueprint bestaat altijd uit JSON. Dat is een veelgebruikte indeling om instellingen op te slaan. Zolang je goed let op komma’s, accolades en aanhalingstekens is een Blueprint eenvoudig aan te passen.
Stap 2: begin met een bestaand voorbeeld
De snelste manier is niet om zelf vanaf nul te beginnen, maar om een bestaande Blueprint als basis te gebruiken. Op de GitHub-pagina van WordPress Playground en in de officiële documentatie vind je tientallen voorbeelden voor uiteenlopende situaties.
Kopieer een Blueprint die het dichtst bij jouw situatie ligt en pas alleen de onderdelen aan die je nodig hebt. Dat is veel sneller én voorkomt fouten.
Stap 3: begrijp de basisstructuur
Een eenvoudige Blueprint ziet er bijvoorbeeld zo uit:
{
"$schema": "https://playground.wordpress.net/blueprint-schema.json",
"landingPage": "/wp-admin/",
"preferredVersions": {
"php": "8.3",
"wp": "6.9"
},
"steps": [
{
"step": "login"
}
]
}Dit bestand doet nog niet veel, maar laat wel de belangrijkste onderdelen zien.
De regel $schema is niet verplicht, maar wordt wel aanbevolen in de officiële documentatie. Hierdoor kunnen editors zoals Visual Studio Code fouten in je Blueprint herkennen en krijg je automatische aanvulling tijdens het schrijven.
preferredVersions bepaalt welke WordPress- en PHP-versie Playground moet gebruiken. Dat is handig wanneer je wilt testen met een specifieke combinatie.
landingPage bepaalt welke pagina automatisch wordt geopend zodra de omgeving klaar is. In dit voorbeeld kom je direct uit in het WordPress-dashboard.
Onder steps staan alle acties die Playground moet uitvoeren. Iedere actie begint met "step" en wordt in volgorde uitgevoerd.
Stap 4: plugins toevoegen
Een Blueprint wordt pas echt interessant wanneer je automatisch plugins laat installeren.
Dat doe je door een extra stap toe te voegen aan de lijst met steps.
Onderstaand voorbeeld installeert automatisch Query Monitor vanuit de officiële WordPress Plugin Directory.
{
"step": "installPlugin",
"pluginData": {
"resource": "wordpress.org/plugins",
"slug": "query-monitor"
}
}In dit voorbeeld downloadt Playground de plugin rechtstreeks uit de officiële pluginbibliotheek en installeert deze automatisch.
Wil je meerdere plugins installeren? Dan voeg je eenvoudig meerdere installPlugin-stappen toe aan de lijst met steps. Playground voert deze vervolgens één voor één uit.
Gebruik je een plugin die niet in de WordPress Plugin Directory staat? Dan kun je ook een ZIP-bestand vanaf een URL of een bestand dat eerder in de Blueprint is toegevoegd installeren. Dat is bijvoorbeeld handig wanneer je een eigen plugin ontwikkelt of een nog niet gepubliceerde versie wilt testen.
Stap 5: een thema installeren
Het installeren van een thema werkt vrijwel hetzelfde als het installeren van een plugin. Ook hiervoor voeg je een extra stap toe aan de lijst met steps.
Onderstaand voorbeeld installeert automatisch het thema Twenty Twenty-Six vanuit de officiële WordPress Theme Directory en activeert het direct.
{
"step": "installTheme",
"themeData": {
"resource": "wordpress.org/themes",
"slug": "twentytwentysix"
},
"options": {
"activate": true
}
}Hier geeft themeData aan waar Playground het thema kan downloaden. Met activate: true wordt het thema direct na de installatie geactiveerd, zodat je er meteen mee kunt werken.
Gebruik je een eigen thema dat nog niet in de Theme Directory staat? Dan kun je ook een ZIP-bestand vanaf een URL of een eerder toegevoegd bestand gebruiken. Daardoor kun je eenvoudig maatwerkthema’s testen zonder ze eerst handmatig te uploaden.
Stap 6: bestanden toevoegen
Een Blueprint kan ook bestanden downloaden en op de juiste plek in de WordPress-installatie zetten. Dat is bijvoorbeeld handig voor een eigen plugin, voorbeeldafbeeldingen of een XML-export met demo-content.
In onderstaand voorbeeld downloadt Playground een ZIP-bestand vanaf GitHub.
{
"step": "writeFile",
"path": "/tmp/demo.zip",
"data": {
"resource": "url",
"url": "https://voorbeeld.nl/demo.zip"
}
}
Daarna kun je in een volgende stap dat bestand gebruiken. Zo kun je bijvoorbeeld een plugin installeren vanuit een eigen ZIP-bestand.
{
"step": "installPlugin",
"pluginZipFile": {
"resource": "vfs",
"path": "/tmp/demo.zip"
}
}
Op dezelfde manier kun je ook andere bestanden beschikbaar maken. Denk aan afbeeldingen voor een demo, een exportbestand dat je wilt importeren of een aangepast configuratiebestand. Je kunt daardoor een vrijwel complete testomgeving automatisch laten opbouwen zonder na het starten van Playground nog handmatig bestanden te uploaden.
Stap 7: test je Blueprint
Heb je alle onderdelen toegevoegd? Dan is het tijd om je Blueprint uit te proberen. Sla het JSON-bestand op en open het in WordPress Playground. Playground leest de Blueprint van boven naar beneden en voert iedere stap automatisch in de opgegeven volgorde uit.
Werkt de Blueprint niet zoals verwacht? Controleer dan eerst of de JSON geldig is. Een ontbrekende komma, verkeerd geplaatste accolade of fout gespelde eigenschap is vaak al voldoende om ervoor te zorgen dat een Blueprint niet correct wordt uitgevoerd.
Gebruik voor het testen de officiële Blueprint Validator. Met deze tool kun je je Blueprint direct valideren en zie je eventuele fouten of waarschuwingen. Daarnaast controleert de validator of de gebruikte stappen en eigenschappen overeenkomen met de huidige Blueprint-specificatie. Dat maakt het veel eenvoudiger om fouten op te sporen voordat je de Blueprint gaat gebruiken.
Omdat Playground binnen enkele seconden een nieuwe WordPress-installatie opbouwt, kun je snel wijzigingen testen. In de praktijk bouw je een Blueprint daarom meestal stap voor stap uit. Begin bijvoorbeeld met het starten van WordPress en het installeren van één plugin. Werkt dat goed, voeg dan een thema, extra plugins, site-instellingen of andere stappen toe.
Onderstaand voorbeeld laat zien hoe een complete, maar overzichtelijke Blueprint eruit kan zien.
{
"$schema": "https://playground.wordpress.net/blueprint-schema.json",
"landingPage": "/wp-admin/",
"preferredVersions": {
"php": "8.3",
"wp": "6.9"
},
"steps": [
{
"step": "installTheme",
"themeData": {
"resource": "wordpress.org/themes",
"slug": "twentytwentysix"
},
"options": {
"activate": true
}
},
{
"step": "installPlugin",
"pluginData": {
"resource": "wordpress.org/plugins",
"slug": "query-monitor"
},
"options": {
"activate": true
}
},
{
"step": "installPlugin",
"pluginData": {
"resource": "wordpress.org/plugins",
"slug": "code-snippets"
},
"options": {
"activate": true
}
},
{
"step": "installPlugin",
"pluginData": {
"resource": "wordpress.org/plugins",
"slug": "duplicate-page"
},
"options": {
"activate": true
}
},
{
"step": "setSiteOptions",
"options": {
"blogname": "Blueprint Demo",
"blogdescription": "Voorbeeldomgeving",
"permalink_structure": "/%postname%/"
}
},
{
"step": "login"
}
]
}
Deze Blueprint voert meerdere stappen automatisch uit. Eerst start Playground een WordPress 6.9-omgeving met PHP 8.3. Daarna wordt het thema Twenty Twenty-Six geïnstalleerd en direct geactiveerd. Vervolgens installeert en activeert Playground drie plugins: Query Monitor, Code Snippets en Duplicate Page. Daarna worden enkele basisinstellingen van de website aangepast, waaronder de sitenaam, slogan en permalinkstructuur. Tot slot wordt automatisch ingelogd, zodat je direct in het WordPress-dashboard terechtkomt.
Heb je deze Blueprint eenmaal werkend, dan kun je hem eenvoudig uitbreiden met extra stappen. Denk bijvoorbeeld aan het downloaden van bestanden, het installeren van een eigen plugin vanuit een ZIP-bestand, het importeren van demo-content of het uitvoeren van aanvullende configuraties. Zo bouw je stap voor stap een Blueprint op die precies aansluit bij jouw eigen workflow en die je steeds opnieuw kunt gebruiken voor nieuwe WordPress-projecten.
Wanneer gebruik je Blueprints niet?
Blueprints zijn ideaal voor tijdelijke WordPress-omgevingen, maar niet voor iedere situatie.
Werk je wekenlang aan een grote website, ontwikkel je complexe maatwerkfunctionaliteit of heb je toegang nodig tot serverinstellingen, dan is een lokale ontwikkelomgeving of een stagingwebsite meestal een betere keuze.
Ook sommige functionaliteit werkt niet hetzelfde als op een normale webserver. Denk aan e-mailverzending, achtergrondtaken, servermodules of plugins die afhankelijk zijn van specifieke hostinginstellingen. Die zijn binnen Playground soms beperkt of helemaal niet beschikbaar.
Daarnaast is de opslag in Playground in veel gevallen tijdelijk. Sluit je de sessie zonder je werk op te slaan of te exporteren, dan ben je de wijzigingen kwijt. Playground is daarom vooral bedoeld om snel iets uit te proberen, niet om maandenlang aan dezelfde website te werken.
Conclusie
Blueprints nemen een groot deel van het handmatige werk weg dat normaal nodig is om een WordPress-testomgeving op te zetten. In plaats van telkens opnieuw WordPress te installeren, plugins te activeren en instellingen aan te passen, beschrijf je deze stappen één keer in een JSON-bestand.
Juist die eenvoud maakt Blueprints zo krachtig. Heb je eenmaal een goede Blueprint gemaakt, dan kun je die onbeperkt hergebruiken, aanpassen en delen met collega’s of klanten. Voor iedereen die regelmatig met WordPress test, ontwikkelt of documentatie schrijft, levert dat direct tijdwinst op.
Voor langdurige ontwikkeling blijven lokale ontwikkelomgevingen en stagingwebsites belangrijk. Maar voor snelle tests, demo’s, trainingen en reproduceerbare WordPress-installaties zijn Blueprints een van de meest praktische onderdelen die WordPress Playground momenteel te bieden heeft.
Geef een reactie