Pagsisimula sa Zinnector®, ang CLI ng developer

Ang Zinnector® ay ang libre at may lisensyang MIT na command-line tool ng Zinn Digital® para sa mga developer ng WordPress. Bumubuo ito ng balangkas ng site, nagpapatakbo ng totoong WordPress sa sarili ninyong makina nang walang naka-install maliban sa Node — walang Docker, walang MAMP, walang PHP sa inyong PATH — pagkatapos ay sinusuri ang inyong binuo laban sa hosting slot kung saan kayo magde-deploy at pino-push ito. Dadalhin kayo ng gabay na ito mula sa wala patungo sa isang tumatakbong site sa loob ng humigit-kumulang dalawang minuto, at ipinapaalam sa inyo kung ano ang hitsura ng tagumpay sa bawat hakbang upang malaman ninyo kung may nagkamali.

Ang inyong kailangan

• Node 24 o mas bago. Patakbuhin ang node --version; dapat itong magpakita ng v24 o mas mataas. I-install ang kasalukuyang LTS mula sa nodejs.org — sa Windows winget install OpenJS.NodeJS.LTS, sa macOS brew install node@24.
• npm, na kasama ng Node. Ginagamit ito ng Zinnector® nang isang beses, upang i-download ang WordPress runtime sa sarili nitong cache.
• git, para lamang sa zinnector push — ang mga pag-deploy ay pinapagana mula sa inyong repositoryo.
• Docker, kung hihilingin lamang ninyo ito gamit ang --runtime docker. Walang kailangan ang default na runtime.

Walang anuman sa ibaba ang nangangailangan ng account. Ang isang API key ay kailangan lamang kapag narating na ninyo ang isang hosting slot, sa Pag-deploy gamit ang Zinnector®.

Hakbang 1 — i-install ito

npm install -g zinnector

Kung mag-print ang npm ng npm WARN EBADENGINE, ang inyong Node ay mas luma kaysa sa >=24.18.1 na idinedeklara ng package. Matatapos pa rin ang pag-install, ngunit tatangging tumakbo ang CLI. I-upgrade muna ang Node, pagkatapos ay mag-install muli.

Hakbang 2 — suriin ang bersyon

zinnector --version

Tagumpay: isang numero ng bersyon, halimbawa 0.1.2. Kung makakita kayo ng "Zinnector® needs Node 24 or newer — this is Node 20.x" naka-install ang binary ngunit masyadong luma ang inyong Node; lalabas ang command na may code 78 sa halip na gumawa ng anuman.

Hakbang 3 — basahin ang tulong

zinnector --help

Tagumpay: isang banner na nagpapangalan sa limang command ng proseso (new, dev, link, check, push) at pagkatapos ay ang bawat command na may isang linyang layunin. Ang bawat command ay tumatanggap din ng sarili nitong --help — inililista ng zinnector dev --help ang mga flag ng runtime, PHP at port. Ang kumpletong listahan, na may mga halimbawa, ay nasa sanggunian ng command.

Hakbang 4 — magbalangkas ng isang site

zinnector new my-site

Tagumpay: isang pamagat na Created my-site at isang listahan ng mga file na isinulat nito — zinnector.json, isang wp-content tree na may plugins/, themes/ at isang mu-plugins/ helper, isang .gitignore at isang README — na sinusundan ng mga susunod na command na dapat patakbuhin. Walang placeholder sa loob nito; magsisimula ang proyekto kung ano ito. Ang --template plugin o --template theme ay nagbabalangkas ng isang plugin o isang block theme na nag-a-activate sa sandaling umiral ito.

Hakbang 5 — patakbuhin ito

cd my-site
zinnector dev

Sa unang pagkakataon, magtatanong ang Zinnector® nang isang beses bago i-download ang WordPress runtime — humigit-kumulang 570 MB, dahil dala nito ang bawat PHP build mula 5.2 hanggang 8.5 — sa sarili nitong cache directory, hindi kailanman sa inyong proyekto. Sumagot ng Y, o ipasa ang --yes upang laktawan ang tanong. Sa Node 26 o mas bago, kukuha rin ito ng Node 24 para sa runtime lamang (humigit-kumulang 30 MB, napatunayan laban sa mga checksum ng nodejs.org), dahil ang native module ng runtime ay may mga prebuilt binary para lamang sa Node 24 at 25; hindi ninyo kailangan ng compiler o Visual Studio.

Tagumpay: isang block na nagpapangalan sa proyekto, sa bersyon ng PHP at sa bersyon ng WordPress, pagkatapos ay:

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

Hakbang 6 — buksan ito

Bisitahin ang http://127.0.0.1:9400 sa isang browser. Tagumpay: isang bagong WordPress site na may pamagat na My WordPress Website, na pinagsisilbihan ng bersyon ng PHP na inyong hiniling. Binubuksan ng http://127.0.0.1:9400/wp-admin ang dashboard na naka-sign in na. Maglagay ng plugin sa wp-content/plugins/ o ng tema sa wp-content/themes/ at naroon na ito sa susunod na reload — direktang pinagsisilbihan ng runtime ang mga direktoryong iyon mula sa inyong proyekto.

Pindutin ang Ctrl-C upang huminto. Ang zinnector dev --once ay nagpapasimula ng runtime, nagpi-print ng kung ano talaga ang tumatakbo (bersyon ng PHP, bersyon ng WordPress, mga na-load na extension) at humihinto — kapaki-pakinabang kapag nais ninyo ng patunay sa halip na pangako.

Saan susunod na pupunta

• Lokal na development gamit ang zinnector dev — ang dalawang runtime, pagpili ng mga bersyon ng PHP at WordPress, at kung ano ang pinagsisilbihan mula saan.
• Pag-deploy gamit ang Zinnector® — mag-sign in, i-link ang proyekto sa isang slot, suriin bago lumipad, mag-push.
• Ang sanggunian ng command — bawat command, flag at halimbawa.
• Pag-troubleshoot — ang mga error na totoong nararanasan ng mga tao, at ang solusyon para sa bawat isa.

Ang parehong dokumentasyon ay nasa README ng package sa npm at sa GitHub, kung saan malugod na tinatanggap ang mga isyu at pull request.