የገንቢዎች CLI ከሆነው Zinnector® ጋር መጀመር

Zinnector® ለ WordPress አልሚዎች የተዘጋጀ የ Zinn Digital® ነፃ፣ በ MIT-ፈቃድ የተሰጠ የትእዛዝ-መስመር መሣሪያ ነው። ጣቢያን ያዋቅራል፣ Node እንጂ ሌላ ምንም ነገር ሳይጫን — Docker የለም፣ MAMP የለም፣ በ PATHዎ ላይ PHP የለም — በራስዎ ኮምፒውተር ላይ እውነተኛ WordPress ያንቀሳቅሳል፣ ከዚያም የገነቡትን ነገር ወደሚጭኑበት የሆስቲንግ ቦታ በማነጻጸር ይፈትሻል እንዲሁም ይጭነዋል። ይህ መመሪያ ከምንም ተነስተው በሁለት ደቂቃዎች ውስጥ ወደሚሰራ ጣቢያ ያደርስዎታል፣ እና የሆነ ነገር ሲበላሽ ማወቅ እንዲችሉ በእያንዳንዱ ደረጃ ላይ የስኬት ምልክቱ ምን እንደሚመስል ይነግርዎታል።

የሚያስፈልግዎት ነገር

• Node 24 ወይም አዲስ። node --versionን ያን hisቁ፤ v24 ወይም ከዚያ በላይ ማሳየት አለበት። አሁን ያለውን LTS ከ nodejs.org ይጫኑ — በ Windows ላይ winget install OpenJS.NodeJS.LTS፣ በ macOS ላይ brew install node@24።
• npm፣ ከ Node ጋር አብሮ የሚመጣ። Zinnector® የ WordPress ማስመሪያውን ወደራሱ ካች ለማውረድ አንድ ጊዜ ይጠቀምበታል።
• git፣ ለ zinnector push ብቻ — ጭነቶች ከእርስዎ ማከማቻ (repository) የሚመሩ ናቸው።
• Docker፣ በ --runtime docker ከጠየቁት ብቻ። ነባሪው ማስመሪያ ምንም አያስፈልገውም።

ከታች ካሉት ውስጥ ምንም ነገር መለያ (account) አይፈልግም። የ API ቁልፍ የሚያስፈልገው ወደ ሆስቲንግ ቦታ ሲደርሱ ብቻ ነው፣ በ Deploying with Zinnector® ውስጥ።

ደረጃ 1 — መሣሪያውን መጫን

npm install -g zinnector

npm npm WARN EBADENGINE የሚል ካሳየ፣ የእርስዎ Node ፓኬጁ ከሚያውጀው >=24.18.1 ያነሰ ወይም የቆየ ነው። ጭነቱ ቢጠናቀቅም፣ CLIው ለመስራት ፍቃደኛ አይሆንም። በመጀመሪያ Nodeን ያዘምኑ፣ ከዚያ እንደገና ይጫኑ።

ደረጃ 2 — ስሪቱን ማረጋገጥ

zinnector --version

ስኬት: የስሪት ቁጥር፣ ለምሳሌ 0.1.2። "Zinnector® needs Node 24 or newer — this is Node 20.x" የሚል ካዩ ባይነሪው ተጭኗል ነገር ግን የእርስዎ Node በጣም የቆየ ነው፤ ትእዛዙ ምንም ነገር ከማድረጉ በፊት በ code 78 ይወጣል።

ደረጃ 3 — እርዳታውን ማንበብ

zinnector --help

ስኬት: የአሰራሩን አምስት ትእዛዞች (new፣ dev፣ link፣ check፣ push) እና እያንዳንዱን ትእዛዝ ከአንድ መስመር ዓላማ ጋር የሚያሳይ ባነር። እያንዳንዱ ትእዛዝ የራሱን --help ይወስዳል — zinnector dev --help የማስመሪያውን፣ የ PHP እና የ port ባንዲራዎችን ይዘረዝራል። ሙሉው ዝርዝር ከምሳሌዎች ጋር በ command reference ውስጥ ይገኛል።

ደረጃ 4 — ጣቢያ ማዋቀር

zinnector new my-site

ስኬት: Created my-site የሚል ርዕስ እና የጻፋቸው ፋይሎች ዝርዝር — zinnector.json፣ የ wp-content ዛፍ ከ plugins/፣ themes/ እና ከ mu-plugins/ ረዳት ጋር፣ .gitignore እና README — በመቀጠል የሚሄዱ ቀጣይ ትእዛዞች። በእሱ ውስጥ ያለ ምንም ነገር ቦታ ያዥ (placeholder) አይደለም፤ ፕሮጀክቱ እንዳለ ይነሳል። --template plugin ወይም --template theme እንደተፈጠሩ የሚሰሩ ፕለጊን ወይም የብሎክ ጭብጥ (theme) ያዋቅራሉ።

ደረጃ 5 — ማስገኘት/ማስኬድ

cd my-site
zinnector dev

በመጀመሪያው ጊዜ፣ Zinnector® የ WordPress ማስመሪያውን — ወደ 570 MB ገደማ፣ ምክንያቱም ከ 5.2 እስከ 8.5 ያሉትን ሁሉንም የ PHP ስሪቶች ስለሚይዝ — ወደራሱ ካች ዳይሬክተሪ ከማውረዱ በፊት አንድ ጊዜ ይጠይቃል፣ ወደ እርስዎ ፕሮጀክት በፍጹም አይወርድም። Y ብለው ይመልሱ፣ ወይም ጥያቄውን ለማለፍ --yesን ያሳልፉ። በ Node 26 ወይም አዲስ ላይ ለማስመሪያው ብቻ የሚሆን Node 24 ያመጣል (ወደ 30 MB ገደማ፣ ከ nodejs.org checksums ጋር የተረጋገጠ)፣ ምክንያቱም የማስመሪያው ሀገር በቀል ሞጁል ለ 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)

ደረጃ 6 — መክፈት

በማሰሻ (browser) ውስጥ http://127.0.0.1:9400ን ይጎብኙ። ስኬት: በተጠየቀው የ PHP ስሪት የሚስተናገድ፣ My WordPress Website የሚል ርዕስ ያለው አዲስ የ WordPress ጣቢያ። http://127.0.0.1:9400/wp-admin አስቀድሞ እንደገቡ አድርጎ ዳሽቦርዱን ይከፍታል። ፕለጊንን ወደ wp-content/plugins/ ወይም ጭብጥን (theme) ወደ wp-content/themes/ ያስገቡ እና በቀጣዩ ገጽ ማደስ ላይ እዚያ ያገኙታል — ማስመሪያው እነዚያን ዳይሬክተሪዎች በቀጥታ ከእርስዎ ፕሮጀክት ያስተናግዳቸዋል።

ለማቆም Ctrl-Cን ይጫኑ። zinnector dev --once ማስመሪያውን ያስነሳል፣ በእርግጥ እየሰራ ያለውን (የ PHP ስሪት፣ የ WordPress ስሪት፣ የተጫኑ ኤክስቴንሽኖች) ያትማል እና ያቆማል — ከተስፋ ይልቅ ማስረጃ በሚፈልጉበት ጊዜ ጠቃሚ ነው።

ቀጣይ ወዴት መሄድ እንደሚቻል

• Local development with zinnector dev — ሁለቱ ማስመሪያዎች፣ የ PHP እና የ WordPress ስሪቶችን መምረጥ፣ እና ምን ከየት እንደሚስተናገድ።
• Deploying with Zinnector® — መግባት፣ ፕሮጀክቱን ከቦታ ጋር ማገናኘት፣ ቅድመ-በረራ ፍተሻ ማድረግ፣ መጫን።
• The command reference — እያንዳንዱ ትእዛዝ፣ ባንዲራ እና ምሳሌ።
• Troubleshooting — ሰዎች በእርግጥ የሚያጋጥሟቸው ስህተቶች እና ለእያንዳንዳቸው የሚሆን መፍትሔ።

ያሁኑ ሰነድ በ npm እና በ GitHub ላይ ባለው የፓኬጁ README ውስጥ ይገኛል፣ እዚያም ችግሮች እና pull requestዎች በደስታ ይስተናገዳሉ።