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

Zinnector® د WordPress پرمخوونکو لپاره د Zinn Digital® وړیا او په MIT جواز لرونکي کمانډ-لاین وسیله ده. دا یو سایت چمتو کوي، په خپل کمپیوټر کې د Node پرته له بل څه نصبولو څخه یو ریښتینی WordPress چلوي — نه Docker، نه MAMP، نه ستاسو په PATH کې PHP — بیا هغه څه چې تاسو جوړ کړي د هاسټینګ سلاټ په وړاندې چک کوي چې تاسو یې ځای پر ځای کولو ته چمتو کوئ او پرمخ یې بیايي. دا لارښود تاسو له صفر څخه په شاوخوا دوو دقیقو کې د چلیدونکي سایت تر حده رسوي، او په هر پړاو کې تاسو ته وایي چې بریا څنګه ښکاري ترڅو پوه شئ چې کله یو څه غلط شوي دي.

څه شی ته اړتیا لرئ

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

لاندې هیڅ شی حساب ته اړتیا نلري. د API کلي یوازې هغه وخت اړینه ده کله چې تاسو د هاسټینګ سلاټ ته ورسیږئ، په Deploying with Zinnector® کې.

لومړی ګام — دا نصب کړئ

npm install -g zinnector

که npm npm WARN EBADENGINE چاپ کړي، ستاسو Node د >=24.18.1 څخه زوړ دی چې بسته یې اعلانوي. نصب کول په هرحال پای ته رسیږي، مګر CLI به د چلیدو ډډه وکړي. لومړی Node تازه کړئ، بیا یې بیا نصب کړئ.

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

zinnector --version

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

دریم ګام — مرسته ولولئ

zinnector --help

Zinnector® بنر چې د جریان پنځه کمانډونه نوموي (new، dev، link، check، push) او بیا هر کمانډ د یوې کرښې موخې سره. هر کمانډ خپل --help هم اخلي — zinnector dev --help د رن ټایم، PHP او پورټ بیرغونه لیست کوي. بشپړ لیست، د مثالونو سره، په command reference کې دی.

څلورم ګام — یو سایت چمتو کړئ

zinnector new my-site

بریا: یو Created my-site سرلیک او د هغو فایلونو لیست چې دې لیکلي دي — zinnector.json، د plugins/، themes/ او یو mu-plugins/ مرستیال سره د wp-content ونه، یو .gitignore او یو README — چې د چلولو لپاره د راتلونکو کمانډونو په واسطه تعقیب کیږي. پدې کې هیڅ شی د ځای پر ځای کیدو وړ ندی؛ پروژه لکه څنګه چې ده پیل کیږي. --template plugin یا --template theme یو پلگ ان یا د بلاک تیم چمتو کوي چې د شتون په شیبه کې فعال کیږي.

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

cd my-site
zinnector dev

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

بریا: یو بلاک چې پروژه، د 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 وګورئ. بریا: یو تازه د وردپریس سایت چې سرلیک یې My WordPress Website دی، د هغه PHP نسخې لخوا خدمت شوی چې تاسو غوښتل. http://127.0.0.1:9400/wp-admin ډشبورډ لا دمخه لاسلیک شوی پرانیزي. یو پلگ ان په wp-content/plugins/ کې یا یو تیم په wp-content/themes/ کې واچوئ او دا په راتلونکي بار کولو کې هلته دی — رن ټایم دا لارښودونه مستقیم ستاسو له پروژې څخه خدمت کوي.

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

بل چیرې لاړ شئ

• Local development with zinnector dev — دوه رن ټایمونه، د PHP او وردپریس نسخو غوره کول، او له کوم ځای څخه څه خدمت کیږي.
• Deploying with Zinnector® — لاسلیک کول، پروژې ته د سلاټ تړل، د الوتنې دمخه چک کول، فشار ورکول.
• The command reference — هر کمانډ، بیرغ او مثال.
• Troubleshooting — هغه تېروتنې چې خلک یې په حقیقت کې سره مخ کیږي، او د هر یو لپاره اصلاح.

همدا لاسوند په npm او GitHub کې د بستې په README کې دی، چیرې چې مسلې او د غوښتنې راښکته کول ښه راغلاست دي.