Erste Schritte mit Zinnector®, der Entwickler-CLI

Zinnector® ist das kostenlose, unter der MIT-Lizenz stehende Befehlszeilentool von Zinn Digital® für WordPress-Entwickler. Es erstellt ein Projektgerüst, führt ein echtes WordPress auf Ihrem eigenen Computer aus, ohne dass außer Node etwas installiert ist – kein Docker, kein MAMP, kein PHP in Ihrem PATH –, überprüft dann das von Ihnen Erstellte anhand des Hosting-Slots, in den Sie bereitstellen möchten, und überträgt es. Dieser Leitfaden führt Sie in etwa zwei Minuten von Nichts zu einer laufenden Website und zeigt Ihnen bei jedem Schritt, wie ein Erfolg aussieht, damit Sie wissen, wenn etwas schiefgegangen ist.

Was Sie benötigen

• Node 24 oder neuer. Führen Sie node --version aus; es muss v24 oder höher ausgegeben werden. Installieren Sie die aktuelle LTS-Version von nodejs.org – unter Windows winget install OpenJS.NodeJS.LTS, unter macOS brew install node@24.
• npm, das zusammen mit Node geliefert wird. Zinnector® verwendet es einmal, um die WordPress-Laufzeitumgebung in seinen eigenen Cache herunterzuladen.
• git, nur für zinnector push – Bereitstellungen werden über Ihr Repository gesteuert.
• Docker, nur wenn Sie dies mit --runtime docker anfordern. Die Standard-Laufzeitumgebung benötigt keins.

Nichts davon erfordert ein Konto. Ein API-Schlüssel wird erst benötigt, wenn Sie einen Hosting-Slot erreichen, wie unter Bereitstellung mit Zinnector® beschrieben.

Schritt 1 – Installation

npm install -g zinnector

Wenn npm npm WARN EBADENGINE ausgibt, ist Ihre Node-Version älter als das im Paket angegebene >=24.18.1. Die Installation wird dennoch abgeschlossen, aber die CLI verweigert die Ausführung. Aktualisieren Sie zuerst Node und installieren Sie es dann erneut.

Schritt 2 – Version prüfen

zinnector --version

Erfolg: Eine Versionsnummer, zum Beispiel 0.1.2. Wenn Sie „Zinnector® needs Node 24 or newer — this is Node 20.x“ sehen, ist die Binärdatei zwar installiert, aber Ihre Node-Version ist zu alt; der Befehl wird mit dem Code 78 beendet, ohne etwas auszuführen.

Schritt 3 – Hilfe lesen

zinnector --help

Erfolg: Ein Banner, das die fünf Befehle des Ablaufs nennt (new, dev, link, check, push) und anschließend jeden Befehl mit einer einzeiligen Beschreibung des Zwecks. Jeder Befehl akzeptiert auch ein eigenes --help – zinnector dev --help listet die Laufzeit-, PHP- und Port-Flags auf. Die vollständige Liste mit Beispielen finden Sie in der Befehlsreferenz.

Schritt 4 – Projektgerüst erstellen

zinnector new my-site

Erfolg: Eine Überschrift Created my-site und eine Liste der geschriebenen Dateien – zinnector.json, ein wp-content-Baum mit plugins/, themes/ und einem mu-plugins-Helfer, eine .gitignore und eine README –, gefolgt von den nächsten auszuführenden Befehlen. Nichts darin ist ein Platzhalter; das Projekt startet so, wie es ist. --template plugin oder --template theme erstellen ein Grundgerüst für ein Plugin oder ein Block-Theme, das in dem Moment aktiviert wird, in dem es existiert.

Schritt 5 – Ausführen

cd my-site
zinnector dev

Beim ersten Mal fragt Zinnector® einmal nach, bevor die WordPress-Laufzeitumgebung heruntergeladen wird – ca. 570 MB, da sie jeden PHP-Build von 5.2 bis 8.5 enthält –, und zwar in sein eigenes Cache-Verzeichnis, niemals in Ihr Projekt. Antworten Sie mit Y oder übergeben Sie --yes, um die Frage zu überspringen. Unter Node 26 oder neuer wird zudem ein Node 24 ausschließlich für die Laufzeitumgebung abgerufen (ca. 30 MB, verifiziert anhand der Prüfsummen von nodejs.org), da die nativen Module der Laufzeitumgebung vorgefertigte Binärdateien nur für Node 24 und 25 enthalten; Sie benötigen keinen Compiler und kein Visual Studio.

Erfolg: Ein Block, der das Projekt, die PHP-Version und die WordPress-Version nennt, gefolgt von:

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

Schritt 6 – Öffnen

Besuchen Sie http://127.0.0.1:9400 in einem Browser. Erfolg: Eine frische WordPress-Site mit dem Titel My WordPress Website, bereitgestellt von der von Ihnen angeforderten PHP-Version. http://127.0.0.1:9400/wp-admin öffnet das Dashboard, in dem Sie bereits angemeldet sind. Legen Sie ein Plugin in wp-content/plugins/ oder ein Theme in wp-content/themes/ ab, und es ist beim nächsten Neuladen da – die Laufzeitumgebung stellt diese Verzeichnisse direkt aus Ihrem Projekt bereit.

Drücken Sie Ctrl-C zum Beenden. zinnector dev --once startet die Laufzeitumgebung, gibt aus, was tatsächlich läuft (PHP-Version, WordPress-Version, geladene Erweiterungen), und stoppt – nützlich, wenn Sie einen Beweis statt eines Versprechens möchten.

Nächste Schritte

• Lokale Entwicklung mit zinnector dev – Die beiden Laufzeitumgebungen, Auswahl der PHP- und WordPress-Versionen und was von wo aus bereitgestellt wird.
• Bereitstellung mit Zinnector® – Anmelden, Projekt mit einem Slot verknüpfen, Pre-Flight-Prüfung durchführen, übertragen.
• Die Befehlsreferenz – Jeder Befehl, jedes Flag und jedes Beispiel.
• Fehlerbehebung – Die Fehler, auf die Anwender tatsächlich stoßen, und die jeweiligen Lösungen.

Dieselbe Dokumentation befindet sich im README des Pakets auf npm und auf GitHub, wo Issues und Pull Requests willkommen sind.