Aan de slag met Zinnector®, de ontwikkelaars-CLI

Zinnector® is Zinn Digital®'s free, MIT-licensed command-line tool for WordPress developers. It scaffolds a site, runs a real WordPress on your own machine with nothing installed but Node — no Docker, no MAMP, no PHP on your PATH — then checks what you built against the hosting slot you are about to deploy to and pushes it. Deze handleiding brengt u van niets naar een werkende site in ongeveer twee minuten, en vertelt u bij elke stap hoe een succesvolle uitvoering eruitziet, zodat u weet wanneer er iets mis is gegaan.

Wat u nodig hebt

• Node 24 of hoger. Voer node --version uit; dit moet v24 of hoger weergeven. Installeer de huidige LTS vanaf nodejs.org — op Windows winget install OpenJS.NodeJS.LTS, op macOS brew install node@24.
• npm, dat bij Node wordt geleverd. Zinnector® gebruikt dit eenmalig om de WordPress-runtime naar zijn eigen cache te downloaden.
• git, alleen voor zinnector push — implementaties worden aangestuurd vanuit uw repository.
• Docker, alleen als u hierom vraagt met --runtime docker. De standaardruntime heeft niets nodig.

Niets hieronder vereist een account. Een API-sleutel is alleen nodig wanneer u een hostingslot bereikt, in Implementeren met Zinnector®.

Stap 1 — installeren

npm install -g zinnector

Als npm npm WARN EBADENGINE weergeeft, is uw Node ouder dan de >=24.18.1 die het pakket vereist. De installatie wordt alsnog voltooid, maar de CLI weigert te starten. Upgrade eerst Node en installeer daarna opnieuw.

Stap 2 — de versie controleren

zinnector --version

Succes: een versienummer, bijvoorbeeld 0.1.2. Als u "Zinnector® needs Node 24 or newer — this is Node 20.x" ziet, is het binaire bestand geïnstalleerd maar is uw Node te oud; de opdracht wordt afgesloten met code 78 in plaats van iets uit te voeren.

Stap 3 — de hulp lezen

zinnector --help

Succes: een banner met de naam van de vijf opdrachten van de workflow (new, dev, link, check, push) en vervolgens elke opdracht met een doel van één regel. Elke opdracht accepteert ook een eigen --help — zinnector dev --help somt de runtime-, PHP- en poortvlaggen op. De volledige lijst, met voorbeelden, staat in de opdrachtenreferentie.

Stap 4 — een site genereren

zinnector new my-site

Succes: een koptekst Created my-site en een lijst met geschreven bestanden — zinnector.json, een wp-content-boomstructuur met plugins/, themes/ en een mu-plugins/-helper, een .gitignore en een README — gevolgd door de volgende opdrachten om uit te voeren. Niets hierin is een tijdelijke aanduiding; het project start zoals het is. --template plugin of --template theme genereert een plugin of een blokthema dat wordt geactiveerd zodra het bestaat.

Stap 5 — uitvoeren

cd my-site
zinnector dev

De eerste keer vraagt Zinnector® eenmalig voordat de WordPress-runtime wordt gedownload — ongeveer 570 MB, omdat deze elke PHP-build van 5.2 tot 8.5 bevat — in de eigen cachemap, nooit in uw project. Antwoord Y, of geef --yes op om de vraag over te slaan. Op Node 26 of hoger haalt deze ook een Node 24 op voor uitsluitend de runtime (ongeveer 30 MB, geverifieerd aan de hand van de checksums van nodejs.org), omdat de eigen module van de runtime vooraf gebouwde binaire bestanden heeft voor alleen Node 24 en 25; u hebt geen compiler of Visual Studio nodig.

Succes: een blok waarin het project, de PHP-versie en de WordPress-versie worden vermeld, gevolgd door:

✔ running at http://127.0.0.1:9400
  admin: http://127.0.0.1:9400/wp-admin  (already signed in)

Stap 6 — openen

Bezoek http://127.0.0.1:9400 in een browser. Succes: een nieuwe WordPress-site met de titel My WordPress Website, geleverd door de PHP-versie waar u om hebt gevraagd. http://127.0.0.1:9400/wp-admin opent het dashboard waarbij u al bent ingelogd. Plaats een plugin in wp-content/plugins/ of een thema in wp-content/themes/ en het is direct beschikbaar bij de volgende herlading — de runtime levert die mappen rechtstreeks vanuit uw project.

Druk op Ctrl-C om te stoppen. zinnector dev --once start de runtime op, geeft weer wat er daadwerkelijk draait (PHP-versie, WordPress-versie, geladen extensies) en stopt — handig wanneer u bewijs wilt in plaats van een belofte.

Wat te doen als volgende stap

• Lokale ontwikkeling met zinnector dev — de twee runtimes, het kiezen van PHP- en WordPress-versies, en wat er vanaf waar wordt geleverd.
• Implementeren met Zinnector® — inloggen, het project koppelen aan een slot, voorbereiden op implementatie, pushen.
• De opdrachtenreferentie — elke opdracht, vlag en voorbeeld.
• Probleemoplossing — de fouten waar mensen daadwerkelijk tegenaan lopen, en de oplossing voor elke fout.

Dezelfde documentatie bevindt zich in de README van het pakket op npm en op GitHub, waar issues en pull-requests welkom zijn.