Erste Schritte mit Zinnector®, dem Entwickler-CLI

Zinnector® ist das kostenlose, MIT-lizenzierte Befehlszeilenwerkzeug von Zinn Digital® für WordPress-Entwickler. Es scaffoldet eine Website, führt ein echtes WordPress auf Ihrem eigenen Rechner aus, ohne dass außer Node etwas installiert sein muss – kein Docker, kein MAMP, kein PHP in Ihrem PATH –, prüft dann das Erstellte im Abgleich mit dem Hosting-Slot, auf den Sie deployen möchten, und pusht es. Dieser Leitfaden führt Sie in etwa zwei Minuten von Grund auf zu einer laufenden Website und zeigt Ihnen bei jedem Schritt, wie ein erfolgreiches Ergebnis aussieht, damit Sie wissen, wenn etwas schiefgegangen ist.

Was Sie benötigen

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

Für die folgenden Schritte ist kein Konto erforderlich. Ein API-Schlüssel wird erst benötigt, wenn Sie einen Hosting-Slot erreichen, siehe Deployen mit Zinnector®.

Schritt 1 — Installieren

npm install -g zinnector

Wenn npm npm WARN EBADENGINE ausgibt, ist Ihr Node älter als das vom Paket deklarierte >=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 Ihr Node ist zu alt; der Befehl beendet sich mit dem Exit-Code 78, anstatt etwas auszuführen.

Schritt 3 — Hilfe lesen

zinnector --help

Erfolg: ein Banner, das die fünf Befehle des Workflows (new, dev, link, check, push) nennt, gefolgt von jedem Befehl mit einer einzeiligen Beschreibung seines Zwecks. Jeder Befehl akzeptiert auch ein eigenes --help – zinnector dev --help listet die Flags für Laufzeitumgebung, PHP und Ports auf. Die vollständige Liste mit Beispielen finden Sie in der Befehlsreferenz.

Schritt 4 — Website scaffolden

zinnector new my-site

Erfolg: eine Überschrift Created my-site und eine Liste der geschriebenen Dateien – zinnector.json, ein wp-content-Verzeichnisbaum mit plugins/, themes/ und einem mu-plugins/-Helper, eine .gitignore und eine README – gefolgt von den nächsten auszuführenden Befehlen. Nichts darin ist ein Platzhalter; das Projekt startet im vorhandenen Zustand. --template plugin oder --template theme scaffolden 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 es die WordPress-Laufzeitumgebung – ca. 570 MB, da sie jeden PHP-Build von 5.2 bis 8.5 enthält – in sein eigenes Cache-Verzeichnis herunterlädt, niemals in Ihr Projekt. Antworten Sie mit Y oder übergeben Sie --yes, um die Frage zu überspringen. Unter Node 26 oder neuer lädt es außerdem ein Node 24 ausschließlich für die Laufzeitumgebung herunter (ca. 30 MB, verifiziert anhand der Prüfsummen von nodejs.org), da das native Modul der Laufzeitumgebung nur vorkompilierte Binärdateien für Node 24 und 25 enthält; Sie benötigen weder einen Compiler noch Visual Studio.

Erfolg: ein Block, der das Projekt, die PHP-Version und die WordPress-Version nennt, danach:

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

Schritt 6 — Öffnen

Rufen Sie http://127.0.0.1:9400 in einem Browser auf. Erfolg: eine frische WordPress-Website mit dem Titel My WordPress Website, ausgeliefert von der von Ihnen angeforderten PHP-Version. http://127.0.0.1:9400/wp-admin öffnet das Dashboard bereits angemeldet. Legen Sie ein Plugin in wp-content/plugins/ oder ein Theme in wp-content/themes/ ab, und es ist beim nächsten Neuladen verfügbar – die Laufzeitumgebung liefert diese Verzeichnisse direkt aus Ihrem Projekt aus.

Drücken Sie Strg-C, um zu stoppen. 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 zwei Laufzeitumgebungen, die Auswahl von PHP- und WordPress-Versionen und was von wo ausgeliefert wird.
• Deployen mit Zinnector® – anmelden, Projekt mit einem Slot verknüpfen, Pre-Flight-Prüfung durchführen, pushen.
• Die Befehlsreferenz – jeder Befehl, alle Flags und Beispiele.
• Fehlerbehebung – die Fehler, auf die Anwender tatsächlich stoßen, und die jeweilige Lösung.

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