zinnector cusub
Dhis barnaamij, furaha ama mowduuca baloogga ah oo bilaabmaya isla markaaba. Ma jiro faylal meel-ku-gaar ah, ma jiraan TODOs — furuhu wuu shaqaynayaa oo mowduuca waa la dooran karaa isla marka uu jiro.
Zinnector®
Soosaaraha CLI ee martigelinta WordPress
Zinnector® wuxuu WordPress maxalli ahaan u dhisaa iyada oo aan waxba la rakibin oo Node ah mooyaane - ma jiro Docker, ma jiro MAMP - ka dib wuxuu hubiyaa waxaad dhistay ka dhanka ah booska martigelinta ee aad qarka u saaran tahay inaad geyso oo kuu sheegaya waxa aan waafaqsanayn, ka hor inta aadan riixin. Ku rakib adigoo adeegsanaya npm install -g zinnector. Waa bilaash, shati MIT leh oo lagu dhisay isla API-ga dadweynaha sida wax kasta oo kale oo halkan ku jira.
Shan amar, oo midka dhexe waa bisha
Inta badan CLI-yada martigelinta waxay ka billowdaan geynta (deploy). Zinnector® waxay ka billowdaa ka hor taas — waxay kula dhistaa bogga, ka dibna waxay hubisaa shaqadaada iyadoo la eegaysa mashiinka aad ku dhowdahay inaad u dirto. Farqiga u dhexeeya "wuxuu ka shaqeeyay laptop-kayga" iyo "wuxuu ka shaqeeyaa adeerka" waa halka ay galabnimadu tagto, farqigaasna waa la cabbiri karaa.
zinnector dev
WordPress dhab ah oo ku yaal mashiinkaaga ilbiriqsiyo gudahood, adoo u adeegsanaya plugins iyo mawduucyadaada, adoon lahayn Docker iyo PHP oo ku jira PATH-kaaga. Dooro PHP kasta oo ka bilaabma 5.2 ilaa 8.5 si aad uga shaqeyso.
hubinta zinnector
Diyaar-garowga duullimaadka kahor. Wuxuu barbar dhigayaa waxa aad dhistay iyo booska aad ku dhowdahay inaad geyso wuxuuna magacaabayaa khilaaf kasta - iyo jeeg kasta oo uusan samayn karin - intaanad riixin.
zinnector push
Duulimaadka ka hor, riix is-beddelkaaga (commits), kici hawsha soo gelinta oo daawado ilaa ay ka dhamaato. Haddii ay guuldarraysato, diiwaanka dhismaha (build log) waa amar keliya.
zinnector ai
Ka codso kaaliyaha boosteejada (terminal), adoo adeegsanaya mashruucaaga iyo boggaaga tixraac ahaan. Wuxuu ka shaqeeyaa madasha isagoo ku salaysan akoonkaaga, markaa wax furaha tusaalaha ah (model key) laguma kaydiyo mashiinkaaga.
Test it works in two minutes, no account needed
Six commands, in order, and what success looks like at each one. Everything here runs on your own machine; an API key is only needed when you reach a hosting slot.
Install it
Run npm install -g zinnector on Node 24 or newer. If npm prints EBADENGINE, your Node is older than 24 — install the current LTS from nodejs.org and run the install again.
Check the version
zinnector --version prints a version number such as 0.1.2. On a Node older than 24 it prints a message saying Node 24 or newer is needed, and exits.
Read the help
zinnector --help lists every command below with a one-line purpose. Every command also takes --help of its own.
Scaffold a site
zinnector new my-site creates a project that boots immediately — a zinnector.json, a wp-content tree and a README — and prints the next commands to run.
Run it
cd my-site, then zinnector dev. The first run asks once to download the WordPress runtime (about 570 MB, kept in the CLI’s own cache, never in your project). Success looks like “running at http://127.0.0.1:9400”.
Open it in a browser
http://127.0.0.1:9400 is a fresh WordPress site; /wp-admin opens the dashboard already signed in. Drop a plugin into wp-content/plugins and it is there on the next reload.
Then, with a hosting slot
zinnector login, zinnector link, zinnector check, zinnector push — pre-flight what you built against the slot, then deploy and watch it finish.
The pre-flight, in detail
Waxaad ku dhistay PHP 8.3. Goobtu waxay ku shaqaysaa 8.1. Ma jiro wax kuu sheegaya ilaa inta boggagu caddaado. Taasi waa dhibaatada uu amarkani u jiro, waana midda uu mulkiilaha madashani magaca ku weydiiyay. Zinnector® waxay akhrisaa labada deegaan waxayna dhigtaa dhinac iyo dhinac — kadibna waxay kuu oggolaaneysaa inaad soo geliso si kastaba ha ahaatee, maxaa yeelay waxaa laga yaabaa inaad sabab leedahay.
PHP, oo si daacad ah loo qiimeeyay
Farqiga nooca weyn waxaa loo calaamadeeyay mid sarreeya sababtoo ah si lagu kalsoonaan karo ayuu u jebiyaa barta; farqiga yar waxaa loo calaamadeeyay hoose. Qiimaynta wax walba inay muhiim yihiin waxay dadka baraysaa oo keliya inay ka boodaan digniinta.
Disk iyo tirada faylasha, si gooni ah
Geedka WordPress wuxuu ka kooban yahay tobanaan kun oo faylal yar yar ah, goobna waxay isticmaali kartaa gunnada inode iyada oo si fiican ugu jirta xadka saxanka. Labadaba waxaa lagu hubiyaa waxa dhab ahaantii uga haray booska, ee ma aha qorshaha.
“Ma hubin karo” waa jawaabteeda
Hubinta aan arki karin mowduuceeda waxay soo sheegtaa inaan la hubin, waligeedna lama ansixin. Socod nadiif ah wuxuu sheegaa inta shay ee aysan xaqiijin karin, sababtoo ah marin-habaabin nadiif ah waa midda aan qofna laba jeer eegin.
Wuu digayaa, waligama xiro
Dhammaan natiijooyinka waxaa lagu dulmari karaa --force, oo soo koobitaankuna waa uu sheegayaa sidaas. CI-ga dhexdiisa, koodka bixitaanka ayaa halkii ah albaabka xakamaynta, markaa dhuumuhu waxay noqon karaan kuwo adag iyadoo qofku uu maamulka haysto.
Labada runtime ee maxaliga ah, labaduba waa kuwo dhab ah
WordPress Playground waa caadiga: PHP oo loo ururiyey WebAssembly, oo ka dhex shaqaynaysa Node, markaa laptop aan haysan wax aan ahayn Node oo kaliya ayaa ka tagaya eber ilaa WordPress shaqaynaysa inta u dhaxaysa wakhtiga ay qaadanayso in la akhriyo jumladan.
Markaasaad u baahan tahay PHP asal ah — kordhin sida imagick, MySQL dhab ah — gudbi --runtime docker oo hel weelasha php-fpm iyo MariaDB beddelkeeda. Labaduba waxay u adeegaan faylasha isku midka ah mashruuca isku midka ah, markaa u beddelashada u dhexeeya waxay beddeshaa mashiinka mana aha wax kale.
Wax kasta oo kale oo aad horey uga qabatay guddiga
Zinnector® waxaa lagu dhisay API-ga dadweynaha ee la mid ah kan dashboard-ka, markaa wax kasta oo uu guddigu sameyn karo, wuu sameyn karaa - amar walbana waa hawl la dokumenteeyay oo ku jirta OpenAPI spec halkii uu ahaan lahaa barta dhammaadka ee gaarka loo leeyahay.
Goobaha iyo geynta
Liis garee mareegaha, akhri wax kasta oo madalku ka ogyahay mid ka mid ah, dib u daabac, oo akhri taariikhda daabacaadda iyo diiwaannada dhismaha.
Domain-yada, DNS iyo iimaylka
Liis garee domain-yada, akhri oo beddel diiwaannada DNS iyadoo diiwaanku uu muuqdo intaan la qorin, oo akhri adeegyadaada iimeejka.
PHP, kootada, keydka xogta iyo diiwaannada
Beddel noocyada PHP, akhriso isticmaalka diskiga iyo inode-ka ee ka dhanka ah waxa qorshahaagu ku siinayo, hel xiriiriyeyaal hal-mar ah oo galaya phpMyAdmin, oo la soco gelitaanka iyo diiwaannada khaladaadka.
WP-CLI iyo hawlgallada tirada badan
Ka dhex wad amarada WP-CLI ee liiska-ogolaansho ku jira bogga, oo nadiifi keshiga ama bilow iskaanka malware-ka ee xulasho dhan hal wicitaan halkii ay ka noqon lahayd mid boggiiba ah.
Every command, exactly as --help lists it
The full list, one line each. The complete reference — every flag, a runnable example and what each command prints — is generated from the CLI itself and lives in the developer docs and the knowledge base, so it cannot drift from the tool you have installed.
zinnector new
Scaffold a WordPress project you can run immediately.
zinnector dev
Run this project locally — no Docker required.
zinnector login
Sign in with a Zinn Digital® API key.
zinnector logout
Forget a stored API key.
zinnector whoami
Show who this CLI is authenticated as.
zinnector sites
List the sites this key can see.
zinnector status
Everything the platform knows about one site.
zinnector share
Give one person access to a single site — a developer, a designer, a client — with a role and a reason.
zinnector collaborators
See who has been given access to a site, their role, and whether they have accepted yet.
zinnector unshare
Take a person's access back, by email or grant id.
zinnector invitations
The invitations waiting for you, and accept one.
zinnector link
Point this project at a hosting slot (and connect its repository).
zinnector pull
Pull a hosted site's files into this project for local development, and re-run to re-sync. Takes the fast path when the site syncs to its own repository, otherwise works from the latest backup.
zinnector clone
Make a local project from a hosted site in one step: clone its repository or pull its files, write the project file, and leave you ready to run zinnector dev.
zinnector check
Compare this project against the slot you are about to deploy to.
zinnector push
Pre-flight, push your commits, and deploy.
zinnector deploy
Redeploy what the platform already has, without pushing.
zinnector deploys
A site's deploy history.
zinnector php
Show or switch a site's PHP version.
zinnector quota
Disk, files and database usage against what the plan grants.
zinnector db
Database size, and single-use links into phpMyAdmin and the file manager.
zinnector logs
Tail a site's access and error logs.
zinnector wp
Run an allow-listed WP-CLI command on a site.
zinnector backup
List and take site backups. Subcommands: list, now.
zinnector domains
List the domains this key can see.
zinnector dns
Read and change DNS records. Subcommands: list, add, rm.
zinnector mail
List mail services.
zinnector bulk
Run one operation across many sites (cache_purge, malware_scan, sitemap, block_ip).
zinnector ai
Ask the Zinn Digital® assistant, with this project as context.
Su'aalo
Ma u baahanahay inaan noqdo macaamiisha Zinn Digital® si aan u isticmaalo?
Maya. `zinnector new` iyo `zinnector dev` haba yaraatee uma baahna akoon — samee wax soo saar plugin, mawduuc ama bog dhan oo maxalli ah u maamul, si bilaash ah, weligeedba. Furaha API waxaa kaliya loogu baahan yahay amarrada la hadlaya martigelintaada.
Ma u baahan yahay Docker?
Loogu talagalin ma ahan xilliga shaqada ee caadiga ah. WordPress Playground waxay u ururisaa PHP-ga WebAssembly waxayna ku shaqaysaa gudaha Node, markaa `zinnector dev` waxay bilowdaa WordPress dhab ah ilbiriqsiyo gudahood iyada oo aan wax kale la rakibin. Haddii aad u baahan tahay PHP asal ah — si aad u tijaabiso kordhinta sida imagick ama ionCube — `--runtime docker` waxay ku siinaysaa weelasha php-fpm iyo MariaDB halkii. Labadaba waa la taageeray; midkoodna ma aha mid dib-u-gurasho ah.
Maxay tahay waxa uu hubinta ka hor duullimaadku uu dhab ahaantii isbarbar dhigayaa?
Nooca maxalliga ah ee PHP ee aad isticmaasho marka loo eego kan booska, haddii boosku xitaa u bedeli karo nooca aad ku dhistay, haddii PHP-ga booska uu dhaafay waqtigii loogu talagalay iyo in mashiinku uu dhab ahaantii adeegsaday, cabbirka mashruucaaga iyo tirada faylasha marka loo eego diskiga iyo booska inode ee haray, noocyada WordPress ee dhinac kasta, haddii boosku dhammeeyay diyaarinta, iyo in kaydka git uu ku xiran yahay si laga soo geeyo. Wax kasta oo aan la hubin karin waxaa loo soo sheegaa sidii aan la hubin halkii loo tirin lahaa sidii mid saxan.
Ma joojin kartaa inaan soo geliyo?
Maya, taasina waa mid ula kas ah. Duulimaadka ka hor waxa uu bixiyaa digniin oo uu kuu ogolaanayaa inaad gudubto — `--force` waxa ay geyneysa marka ay dhaafto natiijo kasta. Waxaad ogtahay waxyaabo ku saabsan goobtaada oo uusan ogayn hubiyahu, qalab diida inuu wax geyyo waa qalab ay dadku ka saaraan kombuyuutarka.
Furaha igu ah ee API-gagu ma badbaadsan yahay?
Furaha hizi hazisomwi kamwe kutoka kwenye mstari wa amri - bali ni kutoka kwa kidokezo au stdin iliyoelekezwa - ili isiweze kuishia katika historia ya ganda lako au katika orodha ya michakato. Imehifadhiwa kwenye saraka yako ya usanidi yenye hali ya faili 600, na Zinnector® huthibitisha tena ruhusa hizo kila wakati inapoandika.
Ma isticmaali karaa CI?
Haa. Hagaaji `ZINNECTOR_TOKEN`, oo amar kastaa wuxuu qaataa `--json`. Soo-saarka bini'aadamka wuxuu aadayaa stderr iyo xogta stdout, markaa dhuumuhu way nadiif yihiin. `zinnector check` waxay ka baxdaa eber aan ahayn marka ay wax hesho, markaa waxay u shaqaysaa sidii albaabka dhuumaha, iyo `--strict` sidoo kale way guuldarraysataa marka aan la samayn karin isbarbardhig.
La xiriira
Ku rakib oo ku wad shabakad daqiiqadda xigta
Kuni `npm install -g zinnector`, ama hal mar ku tijaabi `npx zinnector new my-site`. Waa lacag la'aan, shati MIT leh oo lagu dhisay API-ga dadweynaha. Samee mashruuc, maxalli ahaan u wado adigoon isticmaalin Docker, oo horay u hubi ka hor inta aanad hawlgelin.
Akhriso dukumiintiyada