Aan de slag met Zinnector®, de CLI voor ontwikkelaars

Zinnector® is de gratis, onder MIT gelicentieerde opdrachtregeltool van Zinn Digital® voor WordPress-ontwikkelaars. Het scaffoldt een site, draait een echte WordPress op uw eigen machine met niets anders geïnstalleerd dan Node — geen Docker, geen MAMP, geen PHP op uw PATH — controleert vervolgens wat u hebt gebouwd met het hostingslot waarnaar u op het punt staat te implementeren, en pusht het. Deze handleiding brengt u van niets naar een draaiende site in ongeveer twee minuten, en vertelt u bij elke stap hoe succes eruitziet, zodat u weet wanneer er iets is misgegaan.

Wat u nodig hebt

• Node 24 of nieuwer. 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 het eenmalig om de WordPress-runtime naar zijn eigen cache te downloaden.
• git, uitsluitend voor zinnector push — implementaties worden aangestuurd vanuit uw repository.
• Docker, uitsluitend als u daarom vraagt met --runtime docker. De standaardruntime vereist er geen.

Niets hieronder vereist een account. Een API-sleutel is pas 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 declareert. De installatie wordt toch voltooid, maar de CLI zal weigeren te draaien. Werk eerst Node bij en installeer vervolgens opnieuw.

Stap 2 — controleer de versie

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 sluit af met code 78 in plaats van iets uit te voeren.

Stap 3 — lees de help

zinnector --help

Succes: een banner die de vijf opdrachten van het proces (new, dev, link, check, push) noemt en vervolgens elke opdracht met een doel van één regel. Elke opdracht accepteert ook een eigen --help — zinnector dev --help toont de runtime-, PHP- en poortvlaggen. De volledige lijst, met voorbeelden, staat in de opdrachtreferentie.

Stap 4 — scaffold een site

zinnector new my-site

Succes: een kop Created my-site en een lijst van de bestanden die zijn geschreven — zinnector.json, een wp-content-structuur met plugins/, themes/ en een mu-plugins/-helper, een .gitignore en een README — gevolgd door de volgende uit te voeren opdrachten. Niets daarin is een tijdelijke aanduiding; het project start zoals het is. --template plugin of --template theme scaffolden een plugin of een blokthema dat activeert zodra het bestaat.

Stap 5 — start het

cd my-site
zinnector dev

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

Succes: een blok dat het project, de PHP-versie en de WordPress-versie noemt, vervolgens:

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

Stap 6 — open het

Ga naar http://127.0.0.1:9400 in een browser. Succes: een verse WordPress-site genaamd My WordPress Website, geserveerd door de PHP-versie die u hebt opgevraagd. http://127.0.0.1:9400/wp-admin opent het dashboard, reeds ingelogd. Plaats een plugin in wp-content/plugins/ of een thema in wp-content/themes/ en het is er bij de volgende herlaadbeurt — de runtime serveert die mappen rechtstreeks vanuit uw project.

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

Waar nu naartoe

• Lokale ontwikkeling met zinnector dev — de twee runtimes, het kiezen van PHP- en WordPress-versies, en wat van waaruit wordt geserveerd.
• Implementeren met Zinnector® — inloggen, het project koppelen aan een slot, pre-flight uitvoeren, pushen.
• De opdrachtreferentie — elke opdracht, vlag en elk voorbeeld.
• Probleemoplossing — de fouten waar mensen daadwerkelijk tegenaan lopen, en de oplossing voor elk ervan.

Dezelfde documentatie is te vinden in de README van het pakket op npm en op GitHub, waar issues en pull requests welkom zijn.