Noțiuni introductive despre Zinnector®, interfața în linie de comandă pentru dezvoltatori

Zinnector® este instrumentul în linie de comandă gratuit, sub licență MIT, oferit de Zinn Digital® pentru dezvoltatorii WordPress. Acesta generează scheletul unui site, rulează o instanță reală de WordPress pe propriul dumneavoastră computer fără nimic altceva instalat în afară de Node — fără Docker, fără MAMP, fără PHP în PATH — apoi verifică ceea ce ați creat în raport cu slotul de găzduire pe care urmează să îl implementați și efectuează trimiterea. Acest ghid vă conduce 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 mai recent. Rulați node --version; trebuie să afișeze v24 sau o versiune 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 este inclus cu Node. Zinnector® îl folosește o singură dată, pentru a descărca mediul de execuție WordPress în propriul său cache.
• git, doar pentru zinnector push — implementările sunt realizate pornind din depozitul dumneavoastră.
• Docker, doar dacă îl solicitați explicit prin --runtime docker. Mediul 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 slot 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 >=24.18.1, cerință declarată de pachet. Instalarea se finalizează oricum, dar CLI-ul va refuza să ruleze. Faceți mai întâi upgrade la 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 „Zinnector® needs Node 24 or newer — this is Node 20.x”, binarul este instalat, dar versiunea dumneavoastră de Node este prea veche; comanda se încheie cu codul 78 în loc să execute ceva.

Pasul 3 — citirea instrucțiunilor de ajutor

zinnector --help

Succes: un banner care listează cele cinci comenzi ale fluxului (new, dev, link, check, push), urmat de fiecare comandă însoțită de o scurtă descriere pe o singură linie. Fiecare comandă acceptă, de asemenea, propriul parametru --help — zinnector dev --help listează flagurile pentru mediul de execuție, PHP și porturi. Lista completă, împreună cu exemple, este disponibilă în referința comenzilor.

Pasul 4 — generarea scheletului unui site

zinnector new my-site

Succes: un titlu Created my-site și o listă a fișierelor create — zinnector.json, o structură wp-content cu directoarele plugins/, themes/ și un utilitar în mu-plugins/, un fișier .gitignore și un fișier README — urmate de următoarele comenzi de executat. Nimic din interior nu este un substituent; proiectul pornește exact așa cum este. --template plugin sau --template theme generează scheletul pentru un modul sau o temă bazată pe blocuri care se activează în momentul în care este creată.

Pasul 5 — rularea

cd my-site
zinnector dev

La prima rulare, Zinnector® solicită o singură dată confirmarea înainte de a descărca mediul de execuție WordPress — aproximativ 570 MB, deoarece conține fiecare versiune compilată de PHP de la 5.2 la 8.5 — în propriul său director cache, niciodată în proiectul dumneavoastră. Răspundeți cu Y sau adăugați parametrul --yes pentru a omite întrebarea. Pe Node 26 sau o versiune mai recentă, acesta descarcă, de asemenea, o versiune de Node 24 destinată exclusiv mediului de execuție (aproximativ 30 MB, verificată pe baza sumelor de control de pe nodejs.org), deoarece modulul nativ al mediului de execuție oferă binare precompilate doar pentru Node 24 și 25; nu aveți nevoie de un compilator sau de Visual Studio.

Succes: un bloc care indică numele proiectului, versiunea de 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 cu titlul My WordPress Website, deservit de versiunea de PHP solicitată. http://127.0.0.1:9400/wp-admin deschide panoul de control fiind deja conectat. Adăugați un modul în wp-content/plugins/ sau o temă în wp-content/themes/, iar acestea vor fi disponibile la următoarea reîncărcare a paginii — mediul de execuție servește acele directoare direct din proiectul dumneavoastră.

Apăsați Ctrl-C pentru a opri execuția. zinnector dev --once pornește mediul de execuție, afișează ce anume rulează în mod real (versiunea PHP, versiunea WordPress, extensiile încărcate) și se oprește — util atunci când doriți o confirmare certă în locul unei presupuneri.

Pașii următori

• Dezvoltarea locală cu zinnector dev — cele două medii de execuție, selectarea versiunilor de PHP și WordPress și ce anume este servit de unde.
• Implementarea cu Zinnector® — autentificarea, asocierea proiectului cu un slot, verificarea preliminară, trimiterea.
• Referința comenzilor — toate comenzile, flagurile și exemplele asociate.
• Depanare — erorile întâlnite în mod frecvent și soluțiile pentru fiecare dintre acestea.

Aceeași documentație este disponibilă și în fișierul README al pachetului pe npm și pe GitHub, unde tichetele de eroare și pull request-urile sunt binevenite.