Ku bilaabashada Zinnector®, CLI-ga horumariyaha

Zinnector® waa aaladda khadka taliska ee lacag-la'aanta ah oo shatiga MIT ku shaqaysa ee Zinn Digital® u diyaarisay horumariyeyaasha WordPress. Waxay dhistaa qaab-dhismeedka goobta, waxay mashiinkaaga ku maamushaa WordPress dhab ah iyadoo aan waxba lagu rakibin marka laga reebo Node — ma jiro Docker, ma jiro MAMP, ma jiro PHP ku jira PATH-kaaga — kaddibna waxay hubisaa waxaad dhistay marka loo eego meesha martigelinta (hosting slot) ee aad qorshaynayso inaad u daabacdo waxayna u dirtaa xogta (pushes it). Tilmaamahani waxay min eber kugu gaarsiinayaan goob shaqaynaysa qiyaastii laba daqiiqo gudahood, waxayna kuu sheegayaan sida uu guushu u eeg yahay tallaabo kasta si aad u ogaato marka wax qaldamaan.

Waxaad u baahan tahay

• Node 24 ama ka cusub. Orod node --version; waa inay soo daabacdaa v24 ama ka sarreeya. Ka rakibo LTS-ka hadda jira nodejs.org — Windows ku dhex isticmaal winget install OpenJS.NodeJS.LTS, macOS-na brew install node@24.
• npm, kaas oo la socda Node. Zinnector® waxay isticmaashaa hal mar, si ay deegaanka socodsiinta ee WordPress ugu soo dejiso kaydkeeda gaarka ah (cache).
• git, kaliya loogu talagalay zinnector push — daabacaadaha waxaa laga maamulaa kaydkaaga (repository).
• Docker, kaliya haddii aad ku codsato adoo adeegsanaya --runtime docker. Deegaanka caadiga ah ee socodsiinta uma baahna waxba.

Waxba hoos ku xusan uma baahna akoon. Furaha API waxaa kaliya loo baahan yahay marka aad gaarto meel martigelin, gudaha Daabacaadda iyadoo la adeegsanayo Zinnector®.

Tallaabada 1 — rakib

npm install -g zinnector

Haddii npm ay soo qorto npm WARN EBADENGINE, Node-kaagu wuu ka da'weyn yahay >=24.18.1 ee xirmadu shaacisay. Rakibaaddu way dhammaanaysaa si kastaba, laakiin CLI-gu wuu diidi doonaa inuu shaqeeyo. Marka hore cusbooneysii Node, kaddibna mar kale rakib.

Tallaabada 2 — hubi nooca

zinnector --version

Guul: lambarka nooca, tusaale ahaan 0.1.2. Haddii aad aragto "Zinnector® needs Node 24 or newer — this is Node 20.x" binary-ga waa la rakibay laakiin Node-kaagu aad buu u duqoobay; talisku wuxuu ku baxayaa koodhka 78 halkii uu wax qaban lahaa.

Tallaabada 3 — akhri caawinta

zinnector --help

Guul: boodh magacaabaya shanta amar ee qulqulka shaqada (new, dev, link, check, push) kaddibna amar kasta oo wata ujeeddadiisa oo hal sadar ah. Amar kasta wuxuu sidoo kale leeyahay --help u gaar ah — zinnector dev --help waxay liis gareysaa calamada deegaanka socodsiinta, PHP iyo port-ka. Liiska oo dhammaystiran, oo ay ku jiraan tusaalooyin, wuxuu ku jiraa tixraaca amarka.

Tallaabada 4 — dhis qaab-dhismeedka goob

zinnector new my-site

Guul: cinwaan ah Created my-site iyo liiska faylashii ay qortay — zinnector.json, qaab-dhismeedka wp-content oo ay ku jiraan plugins/, themes/ iyo caawiyaha mu-plugins/, faylka .gitignore iyo README — oo ay ku xigaan amarrada xiga ee la socodsiinayo. Wax ku dhex jira oo ah meel-haye (placeholder) ma jiraan; mashruucu wuxuu u bilaabmayaa sida uu yahay. --template plugin ama --template theme waxay dhisaan qaab-dhismeedka plugin ama block theme oo si toos ah u hawlgalaya isla marka uu abuurmo.

Tallaabada 5 — socodsii

cd my-site
zinnector dev

Marka ugu horreysa, Zinnector® waxay hal mar ku weydiinaysaa ka hor inta aysan soo dejin deegaanka socodsiinta ee WordPress — qiyaastii 570 MB, sababtoo ah waxay sidataa dhisid kasta oo PHP ah laga bilaabo 5.2 ilaa 8.5 — oo la gelinayo galka kaydka (cache) ee u gaarka ah, waligeedna laguma dhex darayo mashruucaaga. Ka jawaab Y, ama sii --yes si aad su'aasha u dhaafto. Haddii aad isticmaalayso Node 26 ama ka cusub waxay sidoo kale u soo qaadaysaa Node 24 kaliya deegaanka socodsiinta dartiis (qiyaastii 30 MB, oo lagu xaqiijiyay checksums-ka nodejs.org), sababtoo ah qaybta asalka ah ee deegaanka socodsiinta waxay leedahay binaries hore loo dhisay oo loogu talagalay kaliya Node 24 iyo 25; uma baahnid compiler ama Visual Studio.

Guul: qayb magacawda mashruuca, nooca PHP iyo nooca WordPress, kaddibna:

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

Tallaabada 6 — fur

Ka booqo http://127.0.0.1:9400 biraawsarkaaga dhexdiisa. Guul: goob WordPress oo cusub oo cinwaankeedu yahay My WordPress Website, oo ay bixinayso nooca PHP ee aad codsatay. http://127.0.0.1:9400/wp-admin waxay furaysaa dashboard-ka adigoo horay u soo galay. Ku rid plugin gudaha wp-content/plugins/ ama theme gudaha wp-content/themes/ waxaana la heli doonaa marka xigta ee bogga dib loo cusboonaysiiyo — deegaanka socodsiinta wuxuu galalkaas si toos ah uga adeegayaa mashruucaaga.

Riix Ctrl-C si aad u joojiso. zinnector dev --once waxay bilaabaysaa deegaanka socodsiinta, waxay daabacaysaa waxa dhabta ah ee socda (nooca PHP, nooca WordPress, kordhinnada ku jira) wayna joogsanaysaa — tani waxay faa'iido leedahay marka aad rabto caddayn halkii aad ballanqaad ka sugi lahayd.

Halka xigta ee aad aadi karto

• Horumarinta maxalliga ah iyadoo la adeegsanayo zinnector dev — labada deegaan socodsiineed, doorashada noocyada PHP iyo WordPress, iyo waxa laga bixiyo meel kasta.
• Daabacaadda iyadoo la adeegsanayo Zinnector® — gal akoonkaaga, ku xir mashruuca meel martigelin, samee hubinta duulimaadka ka hor (pre-flight), daabac.
• Tixraaca amarka — amar kasta, calan kasta iyo tusaale kasta.
• Xallinta dhibaatooyinka — khaladaadka ay dadku dhab ahaan la kulmaan, iyo xalka mid kasta.

Dukumentiyadan oo kale waxay ku jiraan README-ga xirmada ee ku yaal npm iyo GitHub, halkaas oo arrimaha (issues) iyo codsiyada wax-ka-beddelka (pull requests) si diirran loogu soo dhoweynayo.