Fara aiki da Zinnector®, CLI na masu haɓakawa

Zinnector® kayan aiki ne na layin umarni (command-line) kyauta mai lasisin MIT daga Zinn Digital® don masu haɓaka WordPress. Yana gina tsarin shafi, yana kunna ainihin WordPress a kwamfutarka ba tare da an girka komai ba sai Node — babu Docker, babu MAMP, babu PHP a kan PATH ɗinka — sannan ya duba abin da ka gina idan ya dace da mazaunin karɓar baƙuncin yanar gizo da kake shirin tura shi zuwa gare shi kuma ya tura shi. Wannan jagorar za ta ɗauke ka daga babu komai zuwa shafin da ke aiki a cikin kusan minti biyu, kuma tana gaya maka yadda nasara take a kowane mataki domin ka san lokacin da wani abu ya ɓaci.

Abin da kake buƙata

• Node 24 ko wanda ya fi sabo. Buga node --version; dole ne ya nuna v24 ko sama da haka. Girka LTS na yanzu daga nodejs.org — a kan Windows winget install OpenJS.NodeJS.LTS, a kan macOS brew install node@24.
• npm, wanda ke zuwa tare da Node. Zinnector® yana amfani da shi sau ɗaya, don sauke yanayin gudanarwa na WordPress zuwa ma'ajiyar kansa ta musamman (cache).
• git, don zinnector push kawai — ana tura ayyuka ne daga ma'ajiyar kundinka (repository).
• Docker, idan har ka neme shi ne kawai da --runtime docker. Yanayin gudanarwa na asali ba ya buƙatar komai.

Babu wani abu a ƙasa da ke buƙatar asusu. Ana buƙatar maɓallin API ne kawai lokacin da ka isa mazaunin karɓar baƙunci, a cikin Tura aiki tare da Zinnector®.

Mataki na 1 — girka shi

npm install -g zinnector

Idan npm ya nuna npm WARN EBADENGINE, to Node ɗinka ya girmi >=24.18.1 da fakitin ya ayyana. Girka ɗin zai ƙare dai, amma CLI ɗin zai ƙi aiki. Haɓaka Node tukunna, sannan ka sake girkawa.

Mataki na 2 — duba lamba/sigar

zinnector --version

Nasara: lambar siga, misali 0.1.2. Idan ka ga "Zinnector® needs Node 24 or newer — this is Node 20.x" an riga an girka binary ɗin amma Node ɗinka ya tsufa da yawa; umarnin yana fita ne da lambar 78 maimakon ya yi wani abu.

Mataki na 3 — karanta taimako

zinnector --help

Nasara: allon sanarwa mai ambaton umarni biyar na tsarin (new, dev, link, check, push) sannan kowane umarni tare da manufarsa a layi ɗaya. Kowane umarni kuma yana ɗaukar --help na kansa — zinnector dev --help yana lissafin alamomin yanayin gudanarwa, PHP da na mashiga (port). Cikakken jerin, tare da misalai, yana cikin bayanin umarni.

Mataki na 4 — gina tsarin shafi

zinnector new my-site

Nasara: babban kan magana na Created my-site da jerin fayilolin da ya rubuta — zinnector.json, bishiyar wp-content mai ɗauke da plugins/, themes/ da mataimakin mu-plugins/, wani .gitignore da README — tare da umarni na gaba da za a kunna. Babu wani abu a ciki da yake alamar maye gurbi (placeholder); aikin yana farawa ne yadda yake. --template plugin ko --template theme suna gina tsarin manhaja ko jigon tubali (block theme) wanda ke aiki a daidai lokacin da aka ƙirƙire shi.

Mataki na 5 — kunna shi

cd my-site
zinnector dev

A karon farko, Zinnector® yana tambaya sau ɗaya kafin ya sauke yanayin gudanarwa na WordPress — kimanin MB 570, saboda yana ɗauke da kowane tsarin PHP daga 5.2 zuwa 8.5 — zuwa cikin kundin ma'ajiyar kansa ta musamman (cache), ba zai taɓa zuwa cikin aikinka ba. Amsa Y, ko bayar da --yes don tsallake tambayar. A kan Node 26 ko wanda ya fi sabo yana kuma ɗauko Node 24 don yanayin gudanarwar shi kaɗai (kusan MB 30, wanda aka tabbatar da shi ta lambobin checksums na nodejs.org), saboda ɓangaren asali na yanayin gudanarwar yana da binaries da aka riga aka gina kawai don Node 24 da 25; ba kwa buƙatar compiler ko Visual Studio.

Nasara: wani ɓangare da ke ambaton sunan aikin, sigar PHP da sigar WordPress, sannan:

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

Mataki na 6 — buɗe shi

Ziyarci http://127.0.0.1:9400 a cikin burauza. Nasara: sabon shafin WordPress mai taken My WordPress Website, wanda sigar PHP da ka nema take bayarwa. http://127.0.0.1:9400/wp-admin yana buɗe allon kula da shafi an riga an shiga ciki. Sanya plugin a cikin wp-content/plugins/ ko jigo a cikin wp-content/themes/ kuma zai kasance a can a sake lodawa na gaba — yanayin gudanarwa yana bayar da waɗancan kundayen kai tsaye daga aikinka.

Danna Ctrl-C don tsayawa. zinnector dev --once yana kunna yanayin gudanarwar, ya nuna abin da ke aiki a zahiri (sigar PHP, sigar WordPress, ƙarin kayan aikin da aka loda) sannan ya tsaya — yana da amfani lokacin da kake son tabbaci maimakon alƙawari.

Inda za a je na gaba

• Haɓaka na gida tare da zinnector dev — yanayin gudanarwa guda biyu, zaɓin sigogin PHP da na WordPress, da abin da ake bayarwa daga ina.
• Tura aiki tare da Zinnector® — shiga ciki, haɗa aikin zuwa mazaunin karɓar baƙunci, duba shi kafin tura, sannan tura.
• Bayanin umarni — kowane umarni, alama da misali.
• Maganin matsaloli — kuskuren da mutane ke fuskanta a zahiri, da gyaran kowannensu.

Wannan bayanin yana nan a cikin README na fakitin a kan npm da kuma a kan GitHub, inda ake maraba da batutuwa (issues) da buƙatun tura sauye-sauye (pull requests).