نوی zinnector
یو سایټ، یو پلګ ان یا د بلاک تیم جوړ کړئ چې سمدلاسه پیل شي. هیڅ د ځای پرځای کولو فایلونه نشته، هیڅ TODOs نشته — پلګ ان فعال کیږي او تیم د هغې د شتون په شېبه کې ټاکل کیدی شي.
Zinnector®
د WordPress کوربه توب لپاره د پرمختلونکي CLI
Zinnector® د WordPress لپاره په محلي توګه د Node په مرسته پرته له کوم بل نصب شوي شي — لکه Docker یا MAMP — جوړوي، بیا هغه څه چې تاسو جوړ کړي د هغې کوربه توب سلاټ سره پرتله کوي چې تاسو یې د خپرولو په حال کې یاست، او مخکې له دې چې تاسو یې پش کړئ، تاسو ته وایي چې څه شی به ورسره سمون ونه لري. دا د npm install -g zinnector په کارولو سره نصب کړئ. دا وړیا دی، د MIT جواز لري، او دلته د نورو ټولو شیانو په څیر په ورته عامه API جوړ شوی دی.
پنځه کمانډونه، او منځنی یې نقطه ده
د هسټنګ ډېرې CLIs د ډیپلای په وخت پیل کیږي. Zinnector® له هغه مخکې پیل کیږي—دا ستاسو سره یوځای سایټ جوړوي، او بیا ستاسو کار د هغه ماشین په وړاندې څېړي چې تاسو یې ورته د لېږلو په حال کې یاست. هغه واټن چې د «زما په لپ ټاپ کې چلېده» او «په سرور کې چلېږي» ترمنځ دی، هماغه ځای دی چې ماسپښینونه پکې تېرېږي، او دا واټن د اندازه کولو وړ دی.
zinnector dev
د ډوکر او ستاسو په PATH کې له PHP پرته، په څو ثانیو کې ستاسو په کمپیوټر کې یو اصلي WordPress، چې ستاسو خپل پلګ انونه او تېمونه چلوي. د پراختیا لپاره له 5.2 څخه تر 8.5 پورې کومه PHP وټاکئ.
د زينيکتور چک
د الوتنې دمخه معاینه. هغه څه چې تاسو جوړ کړي د هغه ځای سره پرتله کوي چیرې چې تاسو یې ځای پرځای کوئ او د پش کولو دمخه هر ناانډالتوب - او هره هغه معاینه چې دا نشي کولی - نوموي.
د zinnector پش
د پرواز څخه مخکې، خپل کمټونه (commits) ولیږئ، ځای پر ځای کول (deploy) پیل کړئ او تر پایه یې وګورئ. که دا ناکام شي، د بلډ لاګ (build log) یوازې یو قوماندې لرې دی.
zinnector ai
د خپلې پروژې او سایټ په توګه د محتوا په کارولو سره، د ټرمینل له لارې له مرستیال څخه پوښتنه وکړئ. دا په پلاتفورم کې ستاسو د خپل حساب پر بنسټ کار کوي، نو په ستاسو په کمپیوټر کې هیڅکله کوم ماډل کیلي نه ساتل کیږي.
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.
دوتنې ته د چمتووالي بشپړ جزیات
تاسو په PHP 8.3 کې جوړ کړی دی. سلاټ په 8.1 چلېږي. تر هغه پورې چې وېبپاڼه سپینه شي, هیڅ شی تاسو ته نه وایي. دا هغه ستونزه ده چې د دې قوماندې د شتون لامل دی، او دا هغه ده چې د دې پلاتفورم خاوند په نوم غوښتې وه. Zinnector® دواړه چاپیریالونه لولي او یو د بل تر څنګ یې دروي — بیا تاسو ته اجازه درکوي چې په هر حال کې خپرونه (ډپلای) ترسره کړئ، ځکه چې ممکن تاسو کوم دلیل ولرئ.
PHP، په صادقانه توګه درجه بندي شوی
د لویې نسخې تشه په لوړ ډول په نښه شوې ځکه چې دا په ډاډه توګه یوه سایټ ماتوي؛ یوه کوچنۍ تشه په ټیټه توګه په نښه شوې. د هرڅه بحراني په توګه درجه بندي کول یوازې خلکو ته درس ورکوي چې خبرداری پریږدي.
د ډیسک او فایل شمیرنه، په جلا توګه
د WordPress یوه ونکه په زرګونو کوچني فایلونه دي، او یو سایټ کولی شي د خپل ډیسک حد څخه ښکته پاتې کیدو سره سره خپل د انوډ (inode) اجازه پای ته ورسوي. دواړه د پلان پر ځای د هغه څه په وړاندې چیک کیږي چې په حقیقت کې په سلاټ کې پاتې دي.
«نش شوای کتلی» خپله ځواب دی
یوه ارزونه چې خپل موضوع نه شي لیدلی، بېارزونه راپور ورکوي، هېڅکله نه تېرېږي. یوه پاکه اجرا وايي چې څومره شیان یې نشول تاییدولی، ځکه چې درواغجن بشپړ پاکوالی هغه دی چې هېڅوک ورته دوهم ځل نه ګوري.
خبرداری ورکوي، هېڅکله نه بندوي
هرې موندنې ته د --force په کارولو سره سرغړونه کېدی شي، او لنډیز هم همدغه شان وایي. په CI کې د وتلو کوډ د دروازې په توګه کار کوي، ترڅو یو پایپ لاین کلک پاتې شي په داسې حال کې چې یو کس په واک کې پاتې کیږي.
دوه ځایی رن ټایمونه، دواړه ریښتیني
د WordPress Playground ډیفالټ دی: PHP چې په WebAssembly کې تالیف شوی، د Node دننه روان دی، نو یو لپ ټاپ چې پرته له Node بل څه نه لري، د دې جملې لوستلو په شاوخوا وخت کې له صفر څخه یو روان WordPress ته رسي.
کله چې تاسو اصلي PHP ته اړتیا لرئ - د imagick په څیر یو توسیع، یو اصلي MySQL — `--runtime docker` پاس کړئ او پرځای یې د php-fpm او MariaDB کانتینرونه ترلاسه کړئ. دواړه د ورته پروژې څخه ورته فایلونه خدمت کوي، نو د دوی ترمنځ بدلول یوازې انجن بدلوي او بل هیڅ نه.
هر څه چې تاسو مخکې په پینل کې کوئ
Zinnector® د ډشبورډ په څیر په همدې عامه API جوړ شوی دی، نو هر هغه څه چې پینل یې تر سره کولی شي، دا یې هم کولی شي — او هر قومانده د خصوصي پای ټکي پر ځای په OpenAPI مشخصاتو کې یو ثبت شوی عملیات دی.
سایټونه او خپرونې
سایتونه وښایاست، هر هغه څه ولولئ چې پلاتفورم یې په اړه یو پوهیږي، بیا ځلي ځای پر ځای یې کړئ، او د ځای پر ځای کولو تاریخچه او د بلډ لاګونه ولولئ.
ډوټونه، DNS او برېښنالیک
د ډومینونو لېست کول، د DNS ریکارډونه لوستل او بدلول د هغو د لیکلو څخه وړاندې د ښودل شوي ریکارډ په واسطه، او ستاسو د برېښنالیک خدمتونو لوستل.
PHP، کوټه، ډیټابیس او لاګونه
د PHP نسخه بدل کړئ، د خپل پلان په پرتله د ډیسک او انوډ کارول وګورئ، phpMyAdmin ته یو ځل کارېدونکي لینکونه ترلاسه کړئ، او د لاسرسي او تېروتنې لاګونه وڅارئ.
WP-CLI او عمده عملياتونه
په یوه غوښتنه کې د سایټ پر وړاندې د اجازه ورکړل شویو WP-CLI کمانډونو اجرا کول، او د یو سایټ پر ځای د ټټو ټاکل شوې ټولګې په اوږدو کې د کېش پاکول یا د مالویر سکین پیل کول.
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.
پوښتنې
آیا د دې کارولو لپاره زه باید د Zinn Digital® پیرودونکی اوسم؟
نه. `zinnector new` او `zinnector dev` هېڅ حساب ته اړتیا نه لري — یو پلګ ان، یوه تمه یا ټول سایټ جوړ کړئ او په سیمه ایز ډول یې په وړیا او تل لپاره وکاروئ. د API کیلي یوازې د هغو کمانډونو لپاره اړینه ده چې ستاسو له هوسټینګ سره خبرې کوي.
آیا ډوکر ته اړتیا لري؟
د ډیفولټ رن ټایم لپاره نه. WordPress Playground پي ایچ پی (PHP) په WebAssembly کې تالیف کوي او د Node دننه چلېږي، نو `zinnector dev` د بل څه نصبولو پرته په څو ثانیو کې یو اصلي WordPress پیلوي. که تاسو اصلي پي ایچ پی (PHP) ته اړتیا لرئ — ترڅو د ایکسټینشن لکه imagick یا ionCube ازموینه وکړئ — `--runtime docker` د هغې پر ځای تاسو ته د php-fpm او MariaDB کانټینرونه درکوي. دواړه ملاتړ کېږي؛ هېڅ یو یې بدیل نه دی.
د الوتنې دمخه معاینه په حقیقت کې څه پرتله کوي؟
ستاسو د ځايي PHP نسخه د سلاټ له نسخې سره پرتله کول، ایا سلاټ حتی هغه نسخې ته بدلېدای شي چې تاسو پرې جوړه کړې ده، ایا د سلاټ PHP د خپل کاري عمر له پای ته رسېدو وروسته ده او ایا ماشین په حقیقت کې هغه تطبیق کړې ده، ستاسو د پروژې اندازه او د فایلونو شمیر د ډیسک او انوډ (inode) د پاتې ځای په پرتله، په دواړو غاړو کې د WordPress نسخې، ایا سلاټ خپل چمتووالی پای ته رسولی دی، او ایا د ځای پرځای کولو لپاره د git مخزن (repository) وصل دی. هر هغه څه چې دا یې نشي چک کولی، د تېرېدو په توګه د شمېرلو پر ځای د نه چک شوي په توګه راپور کېږي.
آیا دا کولی شي زما د ځای پر ځای کولو مخه ونیسي؟
نه، او دا په پوهه توګه دی. مخکې له پرواز (Pre-flight) خبرداری درکوي او مخ ته مو پرېږدي — `--force` د هرې موندنې هاخوا ځای پر ځای کوي. تاسو د خپل سایټ په اړه هغه څه پوهېږئ چې یو څارونکی یې نه پوهېږي، او یو داسې وسیله چې د ځای پر ځای کولو څخه ډډه کوي هغه وسیله ده چې خلک یې لرې کوي.
آیا زما د API کليمه خوندي ده؟
کیلي کله هم د کمانډ لاین څخه نه لوستل کیږي — یوازې د پرامپټ یا پایپ شوي stdin څخه — نو دا نشي کولی ستاسو د شل په تاریخچه کې یا د پروسې په لست کې پای ته ورسیږي. دا ستاسو په خپل تشکیلاتو لارښود کې د فایل حالت 600 سره ساتل کیږي، او Zinnector® هرکله چې دا ولیکي دا اجازه لیکونه بیا پلي کوي.
آیا زه کولی شم دا په CI کې وکاروم؟
هو. `ZINNECTOR_TOKEN` تنظیم کړئ، او هر قومانده `--json` اخلي. انساني محصول stderr ته او ډاټا stdout ته ځي، نو پائپونه پاک پاتې کیږي. `zinnector check` د یو څه موندلو په وخت کې غیر صفر ته وځي، نو دا د پایپ لاین دروازې په توګه کار کوي، او `--strict` هم پاتې راځي کله چې د پرتله کولو توان ونلري.
اړوند
دا نصب کړئ او په راتلونکې یوه دقیقه کې یوه پاڼه پرمخ بوځئ
npm install -g zinnector اجرا کړئ، یا یې یوځل د npx zinnector new my-site په کارولو سره و ازموئ. دا وړیا دی، د MIT جواز لري او په عامه API جوړ شوی دی. یوپروژه جوړه کړئ، پرته له Docker څخه یې په محلي توګه پرمخ بوځئ، او د ځای پر ځای کولو دمخه یې ازموینه وکړئ.
اسناد ولولئ