Primi passi con Zinnector®, la CLI per sviluppatori

Zinnector® è lo strumento da riga di comando gratuito e con licenza MIT di Zinn Digital® per gli sviluppatori WordPress. Esegue lo scaffolding di un sito, avvia un vero WordPress sulla Sua macchina senza nient'altro installato oltre a Node — niente Docker, niente MAMP, nessun PHP nel Suo PATH — quindi verifica ciò che ha creato rispetto allo slot di hosting su cui sta per effettuare il deploy e lo invia. Questa guida La condurrà da zero a un sito funzionante in circa due minuti, indicandoLe cosa aspettarsi ad ogni passaggio per capire se qualcosa è andato storto.

Cosa Le serve

• Node 24 o successivo. Esegua node --version; deve mostrare v24 o superiore. Installi l'attuale versione LTS da nodejs.org — su Windows winget install OpenJS.NodeJS.LTS, su macOS brew install node@24.
• npm, incluso con Node. Zinnector® lo usa una volta sola, per scaricare il runtime di WordPress nella propria cache.
• git, solo per zinnector push — i deploy vengono gestiti dal Suo repository.
• Docker, solo se richiesto esplicitamente con --runtime docker. Il runtime predefinito non ne ha bisogno.

Nulla di quanto riportato di seguito richiede un account. Una chiave API è necessaria solo quando raggiunge uno slot di hosting, descritto in Eseguire il deploy con Zinnector®.

Passaggio 1 — installazione

npm install -g zinnector

Se npm mostra npm WARN EBADENGINE, la Sua versione di Node è precedente a >=24.18.1 dichiarata dal pacchetto. L'installazione terminerà comunque, ma la CLI rifiuterà di avviarsi. Aggiorni prima Node, poi esegua di nuovo l'installazione.

Passaggio 2 — verifica della versione

zinnector --version

Esito positivo: un numero di versione, ad esempio 0.1.2. Se visualizza "Zinnector® needs Node 24 or newer — this is Node 20.x", l'eseguibile è installato ma la Sua versione di Node è troppo datata; il comando terminerà con codice 78 senza fare nulla.

Passaggio 3 — consultare la guida

zinnector --help

Esito positivo: un banner che elenca i cinque comandi del flusso (new, dev, link, check, push) e ciascun comando accompagnato da una riga con il suo scopo. Ogni comando supporta anche l'opzione --help specifica — zinnector dev --help elenca i flag per il runtime, PHP e la porta. L'elenco completo, con esempi, è disponibile nella guida di riferimento ai comandi.

Passaggio 4 — scaffolding di un sito

zinnector new my-site

Esito positivo: un'intestazione Created my-site e un elenco dei file scritti — zinnector.json, una struttura wp-content con plugins/, themes/ e un helper mu-plugins/, un file .gitignore e un README — seguiti dai comandi successivi da eseguire. Nulla al suo interno è un placeholder; il progetto si avvia così com'è. --template plugin o --template theme eseguono lo scaffolding di un plugin o di un tema a blocchi che si attiva non appena creato.

Passaggio 5 — esecuzione

cd my-site
zinnector dev

La prima volta, Zinnector® chiederà conferma prima di scaricare il runtime di WordPress — circa 570 MB, poiché include tutte le build di PHP dalla 5.2 alla 8.5 — nella propria directory di cache, mai all'interno del Suo progetto. Risponda Y, oppure passi --yes per saltare la domanda. Su Node 26 o successivo scarica inoltre un Node 24 dedicato esclusivamente al runtime (circa 30 MB, verificati rispetto ai checksum di nodejs.org), poiché il modulo nativo del runtime dispone di binari precompilati solo per Node 24 e 25; non è necessario alcun compilatore né Visual Studio.

Esito positivo: un blocco che specifica il progetto, la versione di PHP e la versione di WordPress, quindi:

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

Passaggio 6 — apertura del sito

Visiti http://127.0.0.1:9400 in un browser. Esito positivo: un sito WordPress nuovo intitolato My WordPress Website, servito dalla versione di PHP richiesta. http://127.0.0.1:9400/wp-admin apre la bacheca con l'accesso già effettuato. Inserisca un plugin in wp-content/plugins/ o un tema in wp-content/themes/ e sarà disponibile al ricaricamento successivo — il runtime serve tali directory direttamente dal Suo progetto.

Prema Ctrl-C per interrompere. zinnector dev --once avvia il runtime, mostra ciò che è effettivamente in esecuzione (versione di PHP, versione di WordPress, estensioni caricate) e si arresta — utile quando desidera una prova concreta anziché una semplice promessa.

Risorse successive

• Sviluppo locale con zinnector dev — i due runtime, la scelta delle versioni di PHP e WordPress e cosa viene servito da dove.
• Eseguire il deploy con Zinnector® — accedere, collegare il progetto a uno slot, effettuare le verifiche preliminari, procedere con il push.
• Guida di riferimento ai comandi — tutti i comandi, i flag e gli esempi.
• Risoluzione dei problemi — gli errori comunemente riscontrati e la relativa soluzione per ciascuno.

La medesima documentazione è presente nel README del pacchetto su npm e su GitHub, dove segnalazioni di problemi e pull request sono benvenute.