نوی zinnector
د داسې سایټ، پلګ ان یا بلاک تھیم بنسټیز جوړښت رامنځته کړئ چې سمدستي فعالېږي. هیڅ ځای لرونکي فایلونه نشته، هیڅ TODOs نشته — پلګ ان فعالېږي او تھیم د رامنځته کېدو سره سم ټاکل کېدی شي.
Zinnector®
Zinnector® له Node پرته د بل هیڅ شي له نصبولو پرته WordPress په سیمه ییزه توګه جوړوي — نه Docker، نه MAMP — بیا هغه څه چې تاسو جوړ کړي د هغه کوربه توب سلاټ سره پرتله کوي چې تاسو یې د پلي کولو په حال کې یاست او تاسو ته وایي چې له push کولو مخکې به څه شی سمون ونه خوري. دا د npm install -g zinnector په مرسته نصب کړئ. دا وړیا دی، د MIT جواز لرونکی دی او دلته د نورو ټولو شیانو په څېر په ورته عامه API جوړ شوی دی.
ډیری د کوربه توب CLI ګانې په ډیپلوى (deploy) کې پیل کیږي. Zinnector® له هغه وړاندې پیل کیږي — دا ستاسو سره یوځای سایټ جوړوي، او بیا ستاسو کار د هغه ماشین سره پرتله او ګوري چې تاسو یې ورته د لیږلو په حال کې یاست. د "دا زما په لپ ټاپ کې کار کاوه" او "دا په سرور کې چلیږي" ترمنځ واټن هغه ځای دی چې ماسپښینونه په کې ضایع کیږي، او دا واټن د اندازه کولو وړ دی.
د داسې سایټ، پلګ ان یا بلاک تھیم بنسټیز جوړښت رامنځته کړئ چې سمدستي فعالېږي. هیڅ ځای لرونکي فایلونه نشته، هیڅ TODOs نشته — پلګ ان فعالېږي او تھیم د رامنځته کېدو سره سم ټاکل کېدی شي.
ستاسو په کمپیوټر کې په څو ثانیو کې یو ریښتینی WordPress، چې ستاسو خپل پلګ انونه او تیمونه چلوي، پرته له Docker او ستاسو په PATH کې له PHP پرته. د پراختیا لپاره له 5.2 څخه تر 8.5 پورې هر PHP وټاکئ.
د الوتنې دمخه کتنه. هغه څه چې تاسو جوړ کړي له هغه سلاټ سره پرتله کوي چې تاسو یې ځای پرځای کولو ته چمتو یاست او له پش کولو دمخه هر ډول نابرابري — او هر هغه چک چې ترسره نشو — په ګوته کوي.
مخکنۍ کتنه ترسره کړئ، خپل کمټونه واستوئ، ځای پرځای کول پیل کړئ او تر بشپړېدو پورې یې وڅارئ. که دا ناکام شي، د جوړولو راپور یوازې په یوه قومانده ترلاسه کېدای شي.
د ټرمینل څخه د خپلې پروژې او سایټ په شالید کې له مرستیال څخه وپوښتئ. دا په پلیټفارم کې ستاسو د خپل حساب له لارې چلیږي، نو ستاسو په ماشین کې هیڅکله د ماډل کیلي نه خوندي کیږي.
شپږ حکمونه، په ترتیب سره، او دا چې په هر یوه کې بریا څنګه ښکاري. دلته هر څه ستاسو په خپل ماشین چلیږي؛ د API کلي یوازې هغه وخت اړینه ده کله چې تاسو د کوربه توب یوې خالي ځای ته ورسیږئ.
په Node 24 یا نوي کې npm install -g zinnector چل کړئ. که چیرې npm د EBADENGINE متن وښيي، نو ستاسو Node له 24 څخه زوړ دی — له nodejs.org څخه اوسنی LTS انسټال کړئ او انسټالشن بیا چل کړئ.
د zinnector --version د نسخې یوه شمېره لکه 0.1.2 چاپوي. له 24 څخه په زاړه Node کې دا یو پیغام چاپوي چې وايي Node 24 یا نوې نسخې ته اړتیا ده، او وځي.
د zinnector --help لاندې هر فرمان د یوې کرښې هدف سره لیست کوي. هر فرمان د خپل ځانګړي --help اختیار هم مني.
د zinnector new my-site یوه پروژه جوړوي چې سمدلاسه بوټ کیږي — یو zinnector.json، د wp-content ونې او یو README — او د چلولو لپاره راتلونکي کمانډونه چاپوي.
cd my-site، بیا zinnector dev. لومړی ځل چلول یو ځل د WordPress رنټایم ډاونلوډ غوښتنه کوي (شاوخوا 570 MB، د CLI په خپل کیش کې ساتل کیږي، هیڅکله ستاسو په پروژه کې نه). بریا داسې ښکاري: “running at http://127.0.0.1:9400”.
http://127.0.0.1:9400 یو نوی WordPress سایټ دی؛ /wp-admin ډشبورډ دمخه ننوتلی پرانیزي. په wp-content/plugins کې یو پلگ ان واچوئ او دا به په راتلونکي بیا پورته کولو کې هلته شتون ولري.
zinnector login، zinnector link، zinnector check، zinnector push — هغه څه چې تاسو جوړ کړي دي د سلاټ په وړاندې مخکې له مخکې وګورئ، بیا یې ځای پر ځای کړئ او د بشپړیدو ننداره یې وکړئ.
تاسو په PHP 8.3 کار کړی دی. سلاټ 8.1 چلوي. تر هغه وخته چې سایټ سپین شوی نه وي، هیڅ شی تاسو ته نه وایي. دا هغه ستونزه ده چې دا کمانډ یې لپاره شتون لري، او دا هغه څه دي چې د دې پلاتفورم مالک یې په نوم غوښتنه کړې ده. Zinnector® دواړه چاپیریالونه لولي او هغه څنګ په څنګ ږدي — بیا هم تاسو ته د پلي کولو اجازه درکوي، ځکه چې ممکن تاسو یو دلیل ولرئ.
د اصلي نسخې تشه په لوړه کچه نښه کیږي ځکه چې دا په باوري توګه یو سایټ خرابوي؛ یوه کوچنۍ تشه ټیټه نښه کیږي. د هرڅه بحراني ګڼل یوازې خلکو ته زده کوي چې خبرداری له پامه وغورځوي.
د WordPress ونه له لسګونو زرو کوچنیو فایلونو څخه جوړه ده، او یوه وېبپاڼه کولی شي خپله د inode اجازه پای ته ورسوي پداسې حال کې چې د خپل ډیسک له حد څخه خورا ټیټه وي. دواړه د هغه څه په مقابل کې کتل کیږي چې په حقیقت کې په سلاټ کې پاتې دي، نه د پلان په مقابل کې.
هغه ارزونه چې خپله موضوع نشي لیدلی، د نه ارزول شوي راپور ورکوي، نه د بریالي شوي. یو بشپړ بهیر ښیي چې څومره شیان یې نشو تاییدولی، ځکه چې هیڅوک د هر څه سم والي جعلي راپور ته بیا نه ګوري.
هر موندنه د --force سره باطله کیدی شي، او لنډیز دا وایي. په CI کې د وتلو کوډ د دروازې په توګه کار کوي، نو یو پایپ لاین سخت کیدی شي پداسې حال کې چې یو شخص په کنټرول کې پاتې کیږي.
د WordPress Playground تلوالیز دی: PHP چې وېب اسمبلۍ ته کمپایل شوی، د Node دننه چلیږي، نو یو لیپ ټاپ چې یوازې Node پرې انسټال وي، د دې جملې لوستلو په موده کې له هیڅ څخه تر یوه فعال WordPress پورې رسیږي.
کله چې تاسو اصلي PHP ته اړتیا لرئ — لکه د imagick توسیع، یو اصلي MySQL — نو --runtime docker ولېږئ او په بدل کې یې د php-fpm او MariaDB کانټینرونه ترلاسه کړئ. دواړه د ورته پروژې څخه ورته فایلونه وړاندې کوي، نو د دوی ترمنځ بدلول یوازې انجن بدلوي او بل هیڅ نه.
Zinnector® د ډشبورډ په څېر په ورته عامه API جوړ شوی، نو هر هغه څه چې پینل یې کولی شي، دا یې هم کولی شي — او هر کمانډ د شخصي پای ټکي پرځای په OpenAPI مشخصاتو کې یو مستند شوی عملیات دی.
د سایټونو لیست وګورئ، هر هغه څه ولولئ چې پلتفارم یې د یو سایټ په اړه پوهیږي، بیا ځای پر ځای کړئ، او د ځای پر ځای کولو تاریخچه او د جوړولو لاګونه ولولئ.
ډومینونه لیست کړئ، د DNS ریکارډونه ولولئ او بدل یې کړئ پداسې حال کې چې ریکارډ د لیکلو دمخه ښودل کیږي، او خپل د بریښنالیک خدمتونه ولولئ.
د PHP بڼې بدلې کړئ، د خپل پلان د ورکړل شوو حدودو پر وړاندې د ډیسک او inode کارول وګورئ، phpMyAdmin ته یو ځل کارېدونکي لینکونه ترلاسه کړئ، او د لاسرسي او تېروتنو لاګونه په ژوندۍ بڼه وڅارئ.
په یو سایټ کې اجازه ورکړل شوي WP-CLI امرونه چل کړئ، او د هر سایټ لپاره د جلا کولو پرځای په یو کال کې د بشپړ انتخاب په کچه کیشونه پاک کړئ یا د مالویر سکینونه پیل کړئ.
بشپړ لست، هر یو په یوه کرښه کې. بشپړه مرجع — هر بیرغ، د چلولو وړ بېلګه او هغه څه چې هر کمانډ یې چاپوي — پخپله له CLI څخه جوړیږي او د پراختیا کونکي په اسنادو او د پوهې په اساس کې شتون لري، نو دا نشي کولی د هغه وسیلې څخه توپیر ولري چې تاسو نصب کړې ده.
د WordPress پروژې بنسټ جوړ کړئ چې تاسو یې سمدلاسه پرمخ بیولی شئ.
دا پروژه په محلي ډول پرمخ بوځئ — هېڅ Docker ته اړتیا نشته.
د Zinn Digital® API کیلي سره ننوتل.
زېرمه شوې API کيلۍ هېره کړئ.
وښایاست چې دا CLI د چا په توګه تصدیق شوی دی.
هغه سایټونه لست کړئ چې دا کیلي یې لیدلی شي.
هر هغه څه چې پلاتفورم یې د یو سایټ په اړه پوهیږي.
یو کس ته یوازې یو سایټ ته لاسرسی ورکړئ — یو پراختیا ورکوونکی، یو ډیزاینر، یو پیرودونکی — د یوې دندې او یو دلیل سره.
وګورئ چې چا ته د یو سایټ لاسرسی ورکړل شوی، د دوی رول، او ایا دوی تر اوسه منلی دی که نه.
د بریښنالیک یا د ورکړې پېژند له لارې د یو کس لاسرسی بېرته واخلئ.
هغه بلنې چې ستاسو په تمه دي، او یوه قبوله کړئ.
دا پروژه کوربه توب ته واستوئ (او د هغې ذخیره وصل کړئ).
د سیمهييزې پراختیا لپاره د کوربه توب شوي سایټ فایلونه دې پروژې ته راکش کړئ، او د بیا همغږۍ لپاره یې بیا پرمخ بوځئ. کله چې سایټ خپل ذخیرې ته همغږي کیږي چټکه لار غوره کوي، که نه نو له وروستي بیک اپ څخه کار کوي.
د کوربه توب شوي سایټ د ژوندیو فایلونو او د هغې د زیرمې (repository) ترمنځ دوه اړخیز همغږۍ: وضعیت وګورئ، دا فعال کړئ، د سایټ بدلونونه ثبت کړئ، یا وټاکئ چې کوم اړخ لومړیتوب لري.
د Claude Desktop او نورو AI پیرودونکو لپاره د Zinn Digital® MCP سرور ته یو پل چې یوازې محلي سرورونه پیلوي.
له کوربه شوي سایټ څخه په یوه مرحله کې یوه محلي پروژه جوړه کړئ: د هغې مخزن کلون کړئ یا د هغې فایلونه راوباسئ، د پروژې فایل ولیکئ، او د zinnector dev چلولو لپاره چمتو اوسئ.
دا پروژه له هغه سلاټ سره پرتله کړئ چې تاسو یې د ځای پرځای کولو په حال کې یاست.
مخکینی معاینه ترسره کړئ، خپل بدلونونه واستوئ، او ځای پر ځای کړئ.
هغه څه چې پلیټفارم یې دمخه لري له پش کولو پرته، بیا ځای پرځای کړئ.
د یو سایټ د ځای پر ځای کولو تاریخچه.
د یو سایټ د PHP نسخه ښودل یا بدلول.
د پلټفارم له خوا د ټاکل شوې کچې په پرتله د ډیسک، فایلونو او ډیټابیس کارول.
د ډیټابیس کچه، او phpMyAdmin او د فایل مدیر ته د یو ځل کارولو لینکونه.
د یو سایټ د لاسرسي او تېروتنو لاګونه په ژوندۍ بڼه وڅارئ.
په یو سایټ کې اجازه ورکړل شوی د WP-CLI امر چلول.
د سایټ بیک اپونه لیست او واخلئ. فرعي فرمانونه: list، now.
هغه ډومینونه لېست کړئ چې دا کیلي یې لیدلی شي.
د DNS ریکارډونه ولولئ او بدل یې کړئ. فرعي کمانډونه: list، add، rm.
د برېښنالیک خدمتونه لیست کړئ.
په څو سایټونو کې یو عملیات ترسره کړئ (cache_purge، malware_scan، sitemap، block_ip).
د دې پروژې په سياق کې، د Zinn Digital® مرستيال څخه وپوښتئ.
نه. `zinnector new` او `zinnector dev` هیڅ حساب ته اړتیا نلري — د پلګ ان، بڼې یا بشپړ سایټ جوړښت رامنځته کړئ او په محلي توګه یې وړیا، د تل لپاره پرمخ بوځئ. د API کیلي یوازې د هغو امرونو لپاره اړینه ده چې ستاسو له کوربه توب سره اړیکه نیسي.
د ډیفالټ runtime لپاره نه دی. WordPress Playground د PHP کوډ WebAssembly ته کمپایل کوي او د Node دننه چلیږي، نو `zinnector dev` له کوم بل شي نصبولو پرته په څو ثانیو کې یو ریښتینی WordPress روښانه کوي. که تاسو اصلي PHP ته اړتیا لرئ — د یو اضافي توسیع لکه imagick یا ionCube ازمویلو لپاره — د دې پر ځای `--runtime docker` تاسو ته php-fpm او MariaDB کانټینرونه چمتو کوي. دواړه ملاتړ کیږي؛ هیڅ یو یې کوم ریزرفي (شاته تګ) انتخاب نه دی.
ستاسو محلي PHP نسخه د سلاټ د نسخې په مقابل کې، ایا سلاټ حتی کولی شي هغه نسخې ته واوړي چې تاسو پرې کار کړی، ایا د سلاټ PHP د خپل ژوند پای ته رسیدلی او ایا ماشین په حقیقت کې هغه پلي کړی دی، ستاسو د پروژې کچه او د فایلونو شمیر د ډیسک او inode پاتې خالي ځای په مقابل کې، په هر لوري کې د WordPress نسخې، ایا د سلاټ چمتو کول بشپړ شوي، او ایا د ځای پرځای کولو لپاره د git مخزن تړل شوی دی که نه. هر هغه څه چې دا یې نشي کتلای د بریالي ګڼلو پرځای د نه کتل شوي په توګه راپور کیږي.
نه، او دا قصدي ده. مخکینی چک خبرداری ورکوي او تاسو پریږدي چې پرمخ لاړ شئ — `--force` د هرې موندنې څخه تیر او ځای پرځای کوي. تاسو د خپل سایټ په اړه داسې شیان پوهیږئ چې یو چک کوونکی پرې نه پوهیږي، او هغه وسیله چې د ځای پرځای کولو څخه انکار کوي هغه وسیله ده چې خلک یې غیر نصبوي.
کیلي هیڅکله د کمانډ لاین څخه نه لوستل کیږي — یوازې له یوه پرامپټ یا پایپ شوي stdin څخه — نو دا نشي کولی ستاسو د شیل په تاریخچه یا د پروسو په لیست کې پای ته ورسیږي. دا ستاسو په خپل تشکیلاتي ډایرکټرۍ کې د 600 د فایل حالت سره زیرمه کیږي، او Zinnector® هر ځل چې لیکل کوي، دا اجازې بیا تاییدوي.
هو. `ZINNECTOR_TOKEN` وټاکئ، او هر کمانډ `--json` اخلي. انساني محصول stderr ته او ډاټا stdout ته ځي، نو پائپونه پاک پاتې کیږي. `zinnector check` کله چې یو څه ومومي غیر صفر وځي، نو دا د پایپ لاین دروازې په توګه کار کوي، او `--strict` هم ناکامیږي کله چې پرتله کول ونشي کولی.
npm install -g zinnector چلول، یا دا یو ځل د npx zinnector new my-site سره و ازموئ. وړیا، د MIT لایسنس لرونکی او په عامه API باندې جوړ شوی. یوه پروژه چوکاټ کړئ، پرته له Docker څخه یې په محلي توګه چل کړئ، او مخکې له دې چې تاسو یې ځای پر ځای کړئ، مخکینۍ معاینه یې ترسره کړئ.
اسناد ولولئ