د Zinnector® سره پیل کول، د پرمخ بیوونکو CLI

Zinnector® د Zinn Digital® وړيا، د MIT جواز لرونکې بولۍ کرښې (command-line) توکى دى چې د WordPress پرمخبيوونکو لپاره جوړ شوى. دا يو سايټ چوکاټوي (scaffolds)، ستاسو پر خپل ماشين باندې يو واقعي WordPress پرته له دې چې له Node پرته بل څه انسټال وي چلوي — نه کوم Docker، نه MAMP، نه پر ستاسو PATH باندې PHP — بيا هغه څه چې تاسو جوړ کړي د هغه کوربه‌توب سلاټ سره ګوري چې تاسو ورته د خپرولو اراده لرئ، او هغه خپروي (pushes). دا لارښود تاسو له هيڅ څخه په شاوخوا دوو دقيقو کې يو فعال سايټ ته رسوي، او تاسو ته ښيي چې په هر ګام کې برياليتوب څنګه ښکاري ترڅو پوه شئ چې کله کومه ستونزه رامنځته شي.

هغه څه چې تاسو ورته اړتيا لرئ

• Node 24 يا نوى. node --version وچلوئ؛ دا بايد v24 يا لوړ وښيي. اوسنى LTS له nodejs.org څخه انسټال کړئ — په Windows کې winget install OpenJS.NodeJS.LTS، په macOS کې brew install node@24.
• npm، چې له Node سره راځي. Zinnector® دا يو ځل کاروي، ترڅو د WordPress runtime په خپل کيش (cache) کې کښته کړي.
• git، يوازې د zinnector push لپاره — خپرول ستاسو له مخزن (repository) څخه پرمخ وړل کېږي.
• Docker، يوازې که تاسو د --runtime docker سره يې غوښتنه وکړئ. تلواله (default) runtime هيڅ يوه ته اړتيا نه لري.

لاندې هيڅ يو څيز حساب (account) ته اړتيا نه لري. د API کيلي يوازې هغه وخت اړينه ده کله چې تاسو د کوربه‌توب يو سلاټ ته ورسېږئ، په د Zinnector® سره خپرول کې.

لومړى ګام — دا انسټال کړئ

npm install -g zinnector

که npm متن npm WARN EBADENGINE چاپ کړي، نو ستاسو Node د هغه >=24.18.1 څخه زوړ دى چې بستې اعلان کړى. انسټال په هر حال پاى ته رسېږي، خو CLI به له چلېدو انکار وکړي. لومړى Node لوړ (upgrade) کړئ، بيا يې بيا انسټال کړئ.

دويم ګام — نسخه وګورئ

zinnector --version

برياليتوب: د نسخې يوه شمېره، د بېلګې په توګه 0.1.2. که تاسو وګورئ "Zinnector® needs Node 24 or newer — this is Node 20.x" نو بائنري (binary) انسټال شوې ده خو ستاسو Node ډېر زوړ دى؛ بولۍ د هر څه کولو پر ځای له 78 کوډ سره وځي.

درېيم ګام — مرسته (help) ولولئ

zinnector --help

برياليتوب: يو بينر چې د جريان پنځه بولۍ نوموي (new، dev، link، check، push) او بيا هره بولۍ له يوې کرښې هدف سره. هره بولۍ خپله د --help اخيستلو وړتيا هم لري — zinnector dev --help د runtime، PHP او پورټ بيرغونه (flags) ښيي. بشپړ لړليک، له بېلګو سره، په د بوليو مرجع کې دى.

څلورم ګام — يو سايټ چوکاټ کړئ

zinnector new my-site

برياليتوب: يو Created my-site سرليک او د هغو فايلونو لړليک چې دې وليکل — zinnector.json، يوه wp-content ونه له plugins/، themes/ او يو mu-plugins/ مرستندوى سره، يو .gitignore او يو README — او ورپسې راتلونکې بولۍ چې بايد وڅارل شي. په دې کې هيڅ هم د ځاى نيونې تش ډکونکى (placeholder) نه دى؛ پروژه لکه څنګه چې ده هماغسې پيلېږي (boots). بولۍ --template plugin يا --template theme يو پلګ‌ان يا بلاک بڼه (block theme) چوکاټوي چې د رامنځته کېدو په شېبه فعالېږي.

پنځم ګام — دا وچلوئ

cd my-site
zinnector dev

لومړى ځل، Zinnector® د WordPress runtime له کښته کولو دمخه — شاوخوا 570 MB، ځکه چې دا له 5.2 څخه تر 8.5 پورې د PHP هر جوړښت لري — په خپل کيش ډاريکټرۍ کې او هيڅکله ستاسو په پروژه کې نه، يو ځل پوښتنه کوي. د Y ځواب ورکړئ، يا د پوښتنې څخه د تېرېدو لپاره --yes ورکړئ. په Node 26 يا نوي کې دا د يوازې runtime لپاره يو Node 24 هم راکښته کوي (شاوخوا 30 MB، چې د nodejs.org د checksums له لارې تاييد شوى)، ځکه چې د runtime بومي ماډيول (native module) يوازې د Node 24 او 25 لپاره مخکې له مخکې جوړ شوي بائنري لري؛ تاسو کمپائلر يا Visual Studio ته اړتيا نه لرئ.

برياليتوب: يو بلاک چې د پروژې، د PHP نسخې او د WordPress نسخې نوم اخلي، بيا:

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

شپږم ګام — دا پرانيزئ

په يوه براوزر کې http://127.0.0.1:9400 ته لاړ شئ. برياليتوب: د WordPress يو نوى سايټ چې عنوان يې My WordPress Website دى، او د هغه PHP نسخې لخوا وړاندې کېږي چې تاسو غوښتې وه. پته http://127.0.0.1:9400/wp-admin ډشبورډ مخکې له مخکې دننه شوى پرانيزي. يو پلګ‌ان په wp-content/plugins/ کې واچوئ يا يوه بڼه په wp-content/themes/ کې او دا په بل بيا ريفرش کې هلته شتون لري — دا runtime هغه ډاريکټرۍ مستقيم ستاسو له پروژې وړاندې کوي.

د درولو لپاره Ctrl-C ووهئ. بولۍ zinnector dev --once runtime بوټ کوي، چاپوي چې څه په واقعيت کې روان دي (د PHP نسخه، د WordPress نسخه، بار شوي ملحقات) او درېږي — هغه مهال ګټور دي کله چې تاسو د ژمنې پر ځای ثبوت غواړئ.

بل چېرته لاړ شئ

• ځايي پرمختيا د zinnector dev سره — دوه runtimes، د PHP او WordPress نسخو ټاکل، او څه له کوم ځايه وړاندې کېږي.
• د Zinnector® سره خپرول — ننوتل، پروژه له يوه سلاټ سره تړل، مخکې تر الوتنې چک، خپرول (push).
• د بوليو مرجع — هره بولۍ، بيرغ او بېلګه.
• د ستونزو حل — هغه تېروتنې چې خلک په واقعيت کې ورسره مخامخ کېږي، او د هرې يوې حل.

همدا اسناد د بستې په README کې پر npm او پر GitHub شتون لري، چېرته چې مسئلې (issues) او د کشولو غوښتنې (pull requests) د هرکلي وړ دي.