Početak rada s alatom Zinnector®, razvojnim CLI-jem

Zinnector® je besplatni alat naredbenog retka s MIT licencom koji nudi Zinn Digital® za WordPress programere. On priprema web-mjesto, pokreće pravi WordPress na vašem vlastitom računalu bez ičega instaliranog osim Nodea – bez Dockera, bez MAMP-a, bez PHP-a na vašem PATH-u – zatim provjerava ono što ste izgradili u odnosu na hosting utor na koji namjeravate izvršiti primjenu i šalje to. Ovaj vodič vas dovodi od ničega do pokrenutog web-mjesta u oko dvije minute i govori vam kako izgleda uspjeh u 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 trenutni LTS 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 izvođenog okruženja u vlastitu predmemoriju.
git, samo za zinnector push — primjene se pokreću iz vašeg repozitorija.
Docker, samo ako ga zatražite s --runtime docker. Zadano izvođeno okruženje ne treba ništa.

Ništa u nastavku ne zahtijeva račun. API ključ potreban je samo kada dođete do hosting utora, u odjeljku Primjena pomoću alata Zinnector®.

1. korak — instalirajte ga

npm install -g zinnector

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

2. korak — provjerite verziju

zinnector --version

Uspjeh: broj verzije, na primjer 0.1.2. Ako vidite poruku "Zinnector® treba Node 24 ili noviji — ovo je Node 20.x", binarna datoteka je instalirana, ali vaš je Node prestar; naredba se zatvara s kodom 78 umjesto da išta učini.

3. korak — pročitajte pomoć

zinnector --help

Uspjeh: natpis koji imenuje pet naredbi tijeka rada (new, dev, link, check, push) i zatim svaku naredbu s namjenom u jednom retku. Svaka naredba također prihvaća vlastiti argument --help — zinnector dev --help navodi zastavice izvođenog okruženja, PHP-a i priključka. Kompletan popis, s primjerima, nalazi se u referentnom priručniku za naredbe.

4. korak — pripremite web-mjesto

zinnector new my-site

Uspjeh: naslov Created my-site i popis datoteka koje je zapisao — zinnector.json, stablo wp-content s mapama plugins/, themes/ i pomoćnikom mu-plugins/, datoteka .gitignore i README — praćeni sljedećim naredbama koje treba pokrenuti. Ništa u njemu nije rezervirano mjesto; projekt se pokreće takav kakav jest. --template plugin ili --template theme pripremaju dodatak ili blok temu koja se aktivira čim postoji.

5. korak — pokrenite ga

cd my-site
zinnector dev

Prvi put Zinnector® pita jednom prije preuzimanja WordPress izvođenog okruženja — oko 570 MB, budući da nosi svaku PHP izgradnju od 5.2 do 8.5 — u vlastiti direktorij predmemorije, nikada u vaš projekt. Odgovorite s Y ili proslijedite --yes da biste preskočili pitanje. Na Nodeu 26 ili novijem on također dohvaća Node 24 samo za izvođeno okruženje (oko 30 MB, provjereno u odnosu na kontrolne zbrojeve na nodejs.org), budući da izvorni modul izvođenog okruženja ima unaprijed izgrađene binarne datoteke samo za Node 24 i 25; ne trebate prevoditelj koda ni Visual Studio.

Uspjeh: blok koji imenuje projekt, verziju PHP-a i verziju WordPressa, 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 upravljačku ploču na kojoj ste već prijavljeni. Ubacite dodatak u wp-content/plugins/ ili temu u wp-content/themes/ i bit će tamo pri sljedećem ponovnom učitavanju — izvođeno okruženje poslužuje te direktorije izravno iz vašeg projekta.

Pritisnite Ctrl-C za zaustavljanje. zinnector dev --once pokreće izvođeno okruženje, ispisuje ono što se stvarno 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 izvođena okruženja, odabir verzija PHP-a i WordPressa te ono što se poslužuje odakle.
Primjena pomoću alata Zinnector® — prijava, povezivanje projekta s utorom, provjera prije polijetanja, slanje.
Referentni priručnik za naredbe — svaka naredba, zastavica i primjer.
Rješavanje problema — pogreške na koje ljudi stvarno naiđu i rješenje za svaku.

Ista dokumentacija nalazi se u README datoteci paketa na platformi npm i na platformi GitHub, gdje su problemi i zahtjevi za povlačenjem dobrodošli.