Početak rada sa Zinnector®, CLI-jem za programere

Zinnector® je besplatni alat komandne linije kompanije Zinn Digital® sa MIT licencom za WordPress programere. On priprema strukturu sajta, pokreće pravi WordPress na vašem sopstvenom računaru bez ičega instaliranog osim Node-a — bez Docker-a, bez MAMP-a, bez PHP-a na vašoj putanji (PATH) — zatim proverava ono što ste napravili u odnosu na hosting slot na koji ćete ga postaviti i otprema ga. Ovaj vodič vas vodi od nule do pokrenutog sajta za oko dva minuta i pokazuje vam kako izgleda uspešan završetak u svakom koraku, kako biste znali kada je nešto pošlo po zlu.

Šta vam je potrebno

Node 24 ili noviji. Pokrenite node --version; on mora da ispiše v24 ili noviju verziju. Instalirajte trenutnu LTS verziju sa nodejs.org — na Windowsu winget install OpenJS.NodeJS.LTS, na macOS-u brew install node@24.
npm, koji dolazi uz Node. Zinnector® ga koristi jednom, da preuzme WordPress izvršno okruženje u sopstvenu keš memoriju.
git, samo za zinnector push — primene se pokreću iz vašeg skladišta (repository).
Docker, samo ako ga zatražite sa --runtime docker. Podrazumevanom okruženju nije potreban nijedan.

Ništa u nastavku ne zahteva nalog. API ključ je potreban samo kada stignete do hosting slota, u odeljku Deploying with Zinnector®.

Korak 1 — instalirajte ga

npm install -g zinnector

Ako npm ispiše npm WARN EBADENGINE, vaš Node je stariji od verzije >=24.18.1 koju paket navodi. Instalacija se ipak završava, ali će CLI odbiti da se pokrene. Prvo nadogradite Node, a zatim ga ponovo instalirajte.

Korak 2 — proverite verziju

zinnector --version

Uspeh: broj verzije, na primer 0.1.2. Ako vidite "Zinnector® needs Node 24 or newer — this is Node 20.x", binarna datoteka je instalirana, ali je vaš Node previše star; komanda se završava sa kodom 78 umesto da bilo šta uradi.

Korak 3 — pročitajte pomoć

zinnector --help

Uspeh: baner koji navodi pet komandi ovog toka (new, dev, link, check, push) a zatim svaku komandu sa svrhom u jednoj liniji. Svaka komanda takođe prihvata sopstveni argument --help — zinnector dev --help navodi opcije za okruženje, PHP i portove. Kompletnu listu, sa primerima, možete pronaći u referenci komandi.

Korak 4 — pripremite strukturu sajta

zinnector new my-site

Uspeh: zaglavlje Created my-site i lista datoteka koje je upisao — zinnector.json, wp-content stablo sa folderima plugins/, themes/ i mu-plugins/ pomoćnikom, .gitignore i README datoteka — nakon čega sledi pokretanje sledećih komandi. Ništa u tome nije privremeni marker; projekat se pokreće takav kakav jeste. Opcije --template plugin ili --template theme kreiraju strukturu dodatka ili blok teme koja se aktivira čim postoji.

Korak 5 — pokrenite ga

cd my-site
zinnector dev

Prvi put, Zinnector® pita jednom pre preuzimanja WordPress okruženja — oko 570 MB, pošto sadrži svaku PHP verziju od 5.2 do 8.5 — u sopstveni direktorijum keša, a nikada u vaš projekat. Odgovorite sa Y, ili prosledite --yes da biste preskočili pitanje. Na Node-u 26 ili novijem, on takođe preuzima Node 24 samo za radno okruženje (oko 30 MB, verifikovano u odnosu na kontrolne sume sa nodejs.org), zato što izvorni moduli okruženja imaju unapred izgrađene binarne datoteke samo za Node 24 i 25; nisu vam potrebni kompajler ni Visual Studio.

Uspeh: blok koji navodi naziv projekta, verziju PHP-a i verziju WordPress-a, a zatim:

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

Korak 6 — otvorite ga

Posetite http://127.0.0.1:9400 u pretraživaču. Uspeh: novi WordPress sajt pod nazivom My WordPress Website, koji isporučuje ona PHP verzija koju ste zatražili. http://127.0.0.1:9400/wp-admin otvara kontrolnu tablu na kojoj ste već prijavljeni. Ubacite dodatak u wp-content/plugins/ ili temu u wp-content/themes/ i ona je tu pri sledećem učitavanju — radno okruženje isporučuje te direktorijume direktno iz vašeg projekta.

Pritisnite Ctrl-C da biste zaustavili rad. zinnector dev --once pokreće okruženje, ispisuje šta se zapravo izvršava (verziju PHP-a, verziju WordPress-a, učitane ekstenzije) i zaustavlja se — korisno kada želite dokaz umesto obećanja.

Gde dalje

Lokalni razvoj uz zinnector dev — dva radna okruženja, izbor verzija PHP-a i WordPress-a, i šta se i odakle isporučuje.
Postavljanje sa alatom Zinnector® — prijava, povezivanje projekta sa slotom, pripremne provere, otpremanje.
Referenca komandi — svaka komanda, opcija i primer.
Rešavanje problema — greške sa kojima se ljudi zaista susreću i rešenje za svaku od njih.

Ista dokumentacija se nalazi u README datoteci paketa na npm i na GitHub-u, gde su problemi (issues) i zahtevi za spajanje (pull requests) dobrodošli.