Noțiuni introductive cu Zinnector®, CLI-ul pentru dezvoltatori

Zinnector® este unealta în linie de comandă gratuită, licențiată sub licență MIT, oferită de Zinn Digital® pentru dezvoltatorii WordPress. Aceasta creează scheletul unui site, rulează o instanță reală de WordPress pe propriul dumneavoastră computer fără a avea altceva instalat în afară de Node — fără Docker, fără MAMP, fără PHP în Calea de sistem (PATH) — apoi verifică ceea ce ați construit în raport cu spațiul de găzduire pe care urmează să îl publicați și îl trimite acolo. Acest ghid vă duce de la zero la un site funcțional în aproximativ două minute și vă arată cum arată succesul la fiecare pas, astfel încât să știți când ceva nu a funcționat corect.

De ce aveți nevoie

Node 24 sau o versiune mai nouă. Rulați node --version; acesta trebuie să afișeze v24 sau o valoare superioară. Instalați versiunea LTS actuală de pe nodejs.org — pe Windows winget install OpenJS.NodeJS.LTS, pe macOS brew install node@24.
npm, care vine împreună cu Node. Zinnector® îl folosește o singură dată, pentru a descărca motorul de execuție WordPress în propria memorie cache.
git, necesar doar pentru comanda zinnector push — implementările sunt inițiate din repository-ul dumneavoastră.
Docker, doar dacă îl solicitați prin parametrul --runtime docker. Motorul de execuție implicit nu necesită niciunul.

Nimic din cele de mai jos nu necesită un cont. O cheie API este necesară doar atunci când ajungeți la un spațiu de găzduire, în secțiunea Implementarea cu Zinnector®.

Pasul 1 — instalarea

npm install -g zinnector

Dacă npm afișează npm WARN EBADENGINE, versiunea dumneavoastră de Node este mai veche decât cea de >=24.18.1 specificată de pachet. Instalarea se va finaliza oricum, dar interfața în linie de comandă (CLI) va refuza să ruleze. Actualizați mai întâi Node, apoi instalați din nou.

Pasul 2 — verificarea versiunii

zinnector --version

Succes: un număr de versiune, de exemplu 0.1.2. Dacă vedeți mesajul "Zinnector® needs Node 24 or newer — this is Node 20.x", binarul este instalat, dar versiunea dumneavoastră de Node este prea veche; comanda se va închide cu codul 78 în loc să execute altceva.

Pasul 3 — citirea ajutorului

zinnector --help

Succes: un banner care menționează cele cinci comenzi ale fluxului (new, dev, link, check, push) și apoi fiecare comandă însoțită de o scurtă descriere a scopului său într-un singur rând. Fiecare comandă acceptă, de asemenea, propriul său parametru --help — zinnector dev --help listează opțiunile pentru motorul de execuție, PHP și porturi. Lista completă, împreună cu exemple, se află în referința comenzilor.

Pasul 4 — crearea scheletului unui site

zinnector new my-site

Succes: un titlu Created my-site și o listă cu fișierele generate — zinnector.json, un arbore wp-content care conține directoarele plugins/, themes/ și un fișier helper mu-plugins/, un fișier .gitignore și un README — urmate de următoarele comenzi pe care le puteți rula. Niciun element de aici nu este un înlocuitor temporar; proiectul pornește exact în starea în care se află. Parametrii --template plugin sau --template theme creează scheletul unui modul (plugin) sau al unei teme bazate pe blocuri care se activează imediat ce sunt create.

Pasul 5 — rularea site-ului

cd my-site
zinnector dev

La prima utilizare, Zinnector® va cere o confirmare înainte de a descărca motorul de execuție WordPress — aproximativ 570 MB, deoarece include fiecare versiune PHP de la 5.2 până la 8.5 — în propriul director cache, fără a atinge vreodată proiectul dumneavoastră. Răspundeți cu Y sau adăugați parametrul --yes pentru a trece peste această întrebare. Pe versiunile Node 26 sau mai noi, acesta va descărca suplimentar și o versiune Node 24 destinată exclusiv motorului de execuție (aproximativ 30 MB, a cărei integritate este verificată prin sumele de control de pe nodejs.org), deoarece modulul nativ al motorului de execuție dispune de binare precompilate doar pentru Node 24 și 25; nu aveți nevoie de un compilator sau de Visual Studio.

Succes: un bloc care menționează proiectul, versiunea PHP și versiunea WordPress, urmat de:

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

Pasul 6 — deschiderea site-ului

Accesați http://127.0.0.1:9400 într-un browser. Succes: un site WordPress nou-nouț intitulat My WordPress Website, rulat de versiunea PHP pe care ați solicitat-o. Adresa http://127.0.0.1:9400/wp-admin deschide panoul de control cu sesiunea deja autentificată. Adăugați un modul în wp-content/plugins/ sau o temă în wp-content/themes/, iar acestea vor fi vizibile la următoarea reîncărcare — motorul de execuție servește aceste directoare direct din proiectul dumneavoastră.

Apăsați Ctrl-C pentru a opri rularea. Comanda zinnector dev --once pornește motorul de execuție, afișează elementele care rulează efectiv (versiunea PHP, versiunea WordPress, extensiile încărcate) și se oprește — util atunci când doriți o confirmare concretă, nu doar o promisiune.

Ce urmează

Dezvoltarea locală cu zinnector dev — cele două motoare de execuție, alegerea versiunilor de PHP și WordPress, și detalii despre conținutul servit din fiecare locație.
Implementarea cu Zinnector® — autentificarea, asocierea proiectului cu un spațiu de găzduire, verificarea premergătoare și publicarea.
Referința comenzilor — toate comenzile, parametrii și exemplele.
Depanarea — erorile pe care utilizatorii le întâlnesc frecvent și soluția pentru fiecare în parte.

Aceeași documentație se află în fișierul README al pachetului pe npm și pe GitHub, unde rapoartele de probleme (issues) și cererile de fuzionare (pull requests) sunt binevenite.