Početak rada sa Zinnector®, CLI alatom za razvojne inženjere

Zinnector® je besplatan alat naredbenog retka s licencom MIT tvrtke Zinn Digital® namijenjen programerima za WordPress. Postavlja strukturu web-mjesta, pokreće stvarni WordPress na Vašem računalu bez ičega instaliranog osim Nodea — bez Dockera, bez MAMP-a, bez PHP-a na Vašoj varijabli PATH — zatim provjerava ono što ste izradili u odnosu na hosting slot na koji ćete izvršiti implementaciju te ga šalje. Ovaj Vas vodič vodi od nule do operativnog web-mjesta u oko dvije minute i govori Vam kako izgleda uspjeh na svakom koraku kako biste znali kada je nešto pošlo po zlu.

Što Vam je potrebno

• Node 24 ili noviji. Pokrenite node --version; mora ispisati v24 ili noviju verziju. Instalirajte trenutnu LTS verziju s nodejs.org — na sustavu Windows winget install OpenJS.NodeJS.LTS, na sustavu macOS brew install node@24.
• npm, koji dolazi s Nodeom. Zinnector® ga koristi jednom, za preuzimanje WordPress runtimea u vlastiti predmemorijski prostor.
• git, samo za zinnector push — implementacije se pokreću iz Vašeg repozitorija.
• Docker, samo ako ga zatražite pomoću --runtime docker. Zadani runtime ne zahtijeva ništa.

Ništa od navedenog u nastavku ne zahtijeva račun. API ključ potreban je tek kada dođete do hosting slota, u Implementacija pomoću Zinnector® alata.

1. korak — instalirajte ga

npm install -g zinnector

Ako npm ispiše npm WARN EBADENGINE, Vaš je Node stariji od >=24.18.1 koliko paket navodi. Instalacija svejedno završava, ali CLI će se odbiti pokrenuti. Prvo nadogradite Node, a zatim ponovno instalirajte.

2. korak — provjerite verziju

zinnector --version

Uspjeh: broj verzije, na primjer 0.1.2. Ako vidite "Zinnector® needs Node 24 or newer — this is Node 20.x", binarna datoteka je instalirana, ali Vaš je Node prestari; naredba završava s kodom 78 umjesto da učini bilo što.

3. korak — pročitajte pomoć

zinnector --help

Uspjeh: naslov koji navodi pet naredbi ovog tijeka rada (new, dev, link, check, push), a zatim svaku naredbu s jednolinijskim opisom svrhe. Svaka naredba također ima vlastiti --help — zinnector dev --help navodi oznake za runtime, PHP i priključke. Cijeli popis, s primjerima, nalazi se u pregledu naredbi.

4. korak — postavite strukturu web-mjesta

zinnector new my-site

Uspjeh: naslov Created my-site i popis datoteka koje je zapisao — zinnector.json, stablo wp-content s direktorijima plugins/, themes/ i pomoćnim modulom mu-plugins/, .gitignore i README — nakon čega slijede sljedeće naredbe za pokretanje. Ništa u njemu nije zamjenski tekst; projekt se pokreće takav kakav jest. --template plugin ili --template theme postavljaju strukturu dodatka ili teme blokova koja se aktivira onog trenutka kada nastane.

5. korak — pokrenite ga

cd my-site
zinnector dev

Prvi put Zinnector® jednom zatraži potvrdu prije preuzimanja WordPress runtimea — oko 570 MB, jer sadrži svaku verziju PHP-a od 5.2 do 8.5 — u vlastiti predmemorijski direktorij, nikada u Vaš projekt. Odgovorite s Y ili proslijedite --yes kako biste preskočili pitanje. Na Nodeu 26 ili novijem također dohvaća Node 24 samo za runtime (oko 30 MB, provjereno u odnosu na kontrolne zbrojeve stranice nodejs.org), jer izvorni modul runtimea ima unaprijed izgrađene binarne datoteke samo za Node 24 i 25; ne trebate prevodilac niti Visual Studio.

Uspjeh: blok koji navodi naziv projekta, verziju PHP-a i verziju WordPressa, a zatim:

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

6. korak — otvorite ga

Posjetite http://127.0.0.1:9400 u pregledniku. Uspjeh: novo WordPress web-mjesto pod nazivom My WordPress Website, koje poslužuje verzija PHP-a koju ste zatražili. http://127.0.0.1:9400/wp-admin otvara nadzornu ploču s već izvršenom prijavom. Ispustite dodatak u wp-content/plugins/ ili temu u wp-content/themes/ i tamo je pri sljedećem ponovnom učitavanju — runtime poslužuje te direktorije izravno iz Vašeg projekta.

Pritisnite Ctrl-C za zaustavljanje. zinnector dev --once pokreće runtime, ispisuje ono što se zapravo izvodi (verzija PHP-a, verzija WordPressa, učitana proširenja) i zaustavlja se — korisno kada želite dokaz umjesto obećanja.

Kamo dalje

• Lokalni razvoj uz zinnector dev — dva runtimea, odabir verzija PHP-a i WordPressa te što se odakle poslužuje.
• Implementacija pomoću Zinnector® alata — prijavite se, povežite projekt sa slotom, izvršite pripremnu provjeru, pošaljite.
• Pregled naredbi — svaka naredba, zastavica i primjer.
• Rješavanje problema — pogreške na koje korisnici zapravo nailaze i rješenje za svaku od njih.

Ista dokumentacija nalazi se u README datoteci paketa na servisima npm i GitHub, gdje su prijave problema i pull requestovi dobrodošli.