Magsimula sa Zinnector®, ang developer CLI

Ang Zinnector® ay ang libre, lisensyado sa ilalim ng MIT na command-line tool ng Zinn Digital® para sa mga developer ng WordPress. Nag-scaffold ito ng site, nagpapatakbo ng totoong WordPress sa iyong sariling makina nang walang naka-install kundi Node — walang Docker, walang MAMP, walang PHP sa iyong PATH — pagkatapos ay sinusuri nito ang iyong binuo laban sa hosting slot na iyong ide-deploy at inilalagay ito doon. Ang gabay na ito ay magdadala sa iyo mula sa wala patungo sa isang tumatakbo nang site sa loob ng humigit-kumulang dalawang minuto, at sinasabi sa iyo kung ano ang itsura ng tagumpay sa bawat hakbang upang malaman mo kung kailan may naganap na mali.

Ang iyong kailangan

• Node 24 o mas bago. Patakbuhin ang node --version; dapat itong mag-print 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 pinatatakbo mula sa iyong repository.
• Docker, para lamang kung hihilingin mo ito gamit ang --runtime docker. Ang default na runtime ay hindi nangangailangan nito.

Wala sa ibaba ang nangangailangan ng account. Ang isang API key ay kinakailangan lamang kapag naabot mo na ang isang hosting slot, sa Pag-deploy gamit ang Zinnector®.

Hakbang 1 — i-install ito

npm install -g zinnector

Kung nag-print ang npm ng npm WARN EBADENGINE, ang iyong Node ay mas luma kaysa sa >=24.18.1 na idineklara ng pakete. Matatapos pa rin ang pag-install, ngunit tatangging tumakbo ang CLI. I-upgrade muna ang Node, pagkatapos ay i-install muli.

Hakbang 2 — suriin ang bersyon

zinnector --version

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

Hakbang 3 — basahin ang tulong

zinnector --help

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

Hakbang 4 — mag-scaffold ng site

zinnector new my-site

Tagumpay: isang Created my-site na heading 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 sinundan ng mga susunod na command na tatakbuhin. Walang anuman dito ang isang placeholder; ang proyekto ay nagbo-boot kung ano ito. Ang --template plugin o --template theme ay nag-scaffold ng isang plugin o block theme na nag-a-activate sa sandaling umiral ito.

Hakbang 5 — patakbuhin ito

cd my-site
zinnector dev

Sa unang pagkakataon, nagtanong ang Zinnector® minsan bago i-download ang WordPress runtime — humigit-kumulang 570 MB, dahil dinala nito ang bawat PHP build mula 5.2 hanggang 8.5 — sa sarili nitong direktoryo ng cache, hinding-hindi sa iyong proyekto. Sagutin ang Y, o ipasa ang --yes upang laktawan ang tanong. Sa Node 26 o mas bago, kumukuha rin ito ng Node 24 para sa runtime lamang (mga 30 MB, na-verify laban sa mga checksum ng nodejs.org), dahil ang katutubong module ng runtime ay may mga prebuilt binary para lamang sa Node 24 at 25; hindi mo kailangan ng compiler o Visual Studio.

Tagumpay: isang bloke na nagpapangalan sa proyekto, bersyon ng PHP, at 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 sariwang site ng WordPress na pinamagatang My WordPress Website, na sineserbisyuhan ng bersyon ng PHP na hiniling mo. Binubuksan ng http://127.0.0.1:9400/wp-admin ang dashboard na naka-sign in na. Maghulog ng plugin sa wp-content/plugins/ o isang tema sa wp-content/themes/ at naroroon ito sa susunod na pag-reload — direktang sine-serbisyuhan ng runtime ang mga direktoryong iyon mula sa iyong proyekto.

Pindutin ang Ctrl-C upang ihinto. Ang zinnector dev --once ay nagbo-boot sa runtime, nag-i-print kung ano ang aktwal na tumatakbo (bersyon ng PHP, bersyon ng WordPress, mga na-load na extension) at humihinto — kapaki-pakinabang kapag gusto mo ng patunay sa halip na isang pangako.

Saan susunod pupunta

• Local development with zinnector dev — ang dalawang runtime, pagpili ng mga bersyon ng PHP at WordPress, at kung ano ang sineserbisyuhan mula saan.
• Deploying with Zinnector® — mag-sign in, i-link ang proyekto sa isang slot, i-pre-flight ito, i-push.
• The command reference — bawat command, flag, at halimbawa.
• Troubleshooting — ang mga error na talagang nararanasan ng mga tao, at ang pag-aayos para sa bawat isa.

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