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

Zinnector® ለ WordPress አልሚዎች የተዘጋጀ የ Zinn Digital® ነፃ፣ የ MIT ፈቃድ ያለው የትዕዛዝ-መስመር (command-line) መሣሪያ ነው። ጣቢያን ያዋቅራል፣ ከ Node በስተቀር ምንም ሳይጫን — Docker የለም፣ MAMP የለም፣ በእርስዎ PATH ላይ PHP የለም — በእራስዎ መሣሪያ ላይ ትክክለኛ የ WordPress ስራን ያስኬዳል፤ ከዚያም የገነቡትን ሊዘረጉበት ካሰቡት የሆስቲንግ ማስቀመጫ ጋር አነጻጽሮ በመፈተሽ ይልከዋል። ይህ መመሪያ ከባዶ ተነስተው በሁለት ደቂቃ ውስጥ ወደሚሰራ ጣቢያ ያደርስዎታል፣ እንዲሁም የሆነ ችግር ሲፈጠር እንዲያውቁት በእያንዳንዱ ደረጃ ላይ የስኬት ውጤቱ ምን እንደሚመስል ያሳይዎታል።

የሚያስፈልጉዎት ነገሮች

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

ከታች ከተዘረዘሩት ውስጥ አንዳቸውም መለያ አያስፈልጋቸውም። የኤፒአይ (API) ቁልፍ የሚያስፈልገው የሆስቲንግ ማስቀመጫ ላይ ሲደርሱ ብቻ ነው፣ በ በ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 በጣም አሮጌ ነው፤ ትዕዛዙ ምንም ከማድረግ ይልቅ በኮድ 78 ይቋረጣል።

ደረጃ 3 — እገዛውን ያንብቡ

zinnector --help

ስኬት፦ የአሰራር ሂደቱን አምስት ትዕዛዞች (new፣ dev፣ link፣ check፣ push) የሚገልጽ እና ከዚያም እያንዳንዱን ትዕዛዝ በአንድ መስመር ዓላማ የሚያሳይ ባነር። እያንዳንዱ ትዕዛዝ የራሱ የሆነ --help አለው — zinnector dev --help የማስኬጃውን፣ የ PHP እና የ port ባንዲራዎችን ይዘረዝራል። ሙሉው ዝርዝር ከምሳሌዎች ጋር በ የትዕዛዝ ማጣቀሻ ውስጥ ይገኛል።

ደረጃ 4 — ጣቢያን ያዋቅሩ

zinnector new my-site

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

ደረጃ 5 — ያስኪዱት

cd my-site
zinnector dev

በመጀመሪያው ጊዜ Zinnector® የ WordPress ማስኬጃውን — ወደ 570 ሜባ አካባቢ፣ ከ 5.2 እስከ 8.5 ያሉትን ሁሉንም የ PHP ግንባታዎች ስለሚይዝ — ወደራሱ መሸጎጫ ማውጫ ከማውረዱ በፊት አንድ ጊዜ ይጠይቃል፣ ወደ እርስዎ ፕሮጀክት በጭራሽ አይገባም። Y ብለው ይመልሱ፣ ወይም ጥያቄውን ለማለፍ --yesን ያስገቡ። በ Node 26 ወይም አዲስ ላይ ለማስኬጃው ብቻ Node 24ንም ያወርዳል (ወደ 30 ሜባ አካባቢ፣ ከ nodejs.org ቼክሰሞች ጋር የተረጋገጠ)፣ ምክንያቱም የማስኬጃው ቤተኛ ሞጁል አስቀድመው የተገነቡ ባይነሪዎች ያሉት ለ 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 — ይክፈቱት

በአሳሽ ውስጥ http://127.0.0.1:9400ን ይጎብኙ። ስኬት፦ My WordPress Website የሚል ርዕስ ያለው፣ በጠየቁት የ PHP ሥሪት የቀረበ አዲስ የ WordPress ጣቢያ። http://127.0.0.1:9400/wp-admin ቀድሞውኑ ገብተው ዳሽቦርዱን ይከፍታል። ፕለጊን ወደ wp-content/plugins/ ወይም ገጽታን ወደ wp-content/themes/ ያስገቡ እና በሚቀጥለው ዳግም መጫን ላይ እዚያው ያገኙታል — ማስኬጃው እነዚያን ማውጫዎች በቀጥታ ከእርስዎ ፕሮጀክት ያቀርባል።

ለማቆም Ctrl-Cን ይጫኑ። zinnector dev --once ማስኬጃውን ያስነሳል፣ በትክክል እየሰራ ያለውን ያትማል (የ PHP ሥሪት፣ የ WordPress ሥሪት፣ የተጫኑ ቅጥያዎች) እና ይቆማል — ከተስፋ ይልቅ ማረጋገጫ ሲፈልጉ ጠቃሚ ነው።

ቀጥሎ የት መሄድ እንዳለብዎት

• አካባቢያዊ ልማት ከ zinnector dev ጋር — ሁለቱ ማስኬጃዎች፣ የ PHP እና የ WordPress ሥሪቶችን መምረጥ፣ እና ምን ከየት እንደሚቀርብ።
• በZinnector® መዘርጋት — ይግቡ፣ ፕሮጀክቱን ከማስቀመጫ ጋር ያገናኙ፣ የቅድመ-በረራ ፍተሻ ያድርጉ፣ ይላኩ።
• የትዕዛዝ ማጣቀሻው — እያንዳንዱ ትዕዛዝ፣ ባንዲራ እና ምሳሌ።
• ችግሮችን መፍታት — ሰዎች በተጨባጭ የሚያጋጥሟቸው ስህተቶች፣ እና ለእያንዳንዳቸው መፍትሄው።

ተመሳሳዩ ሰነድ በ npm እና በ GitHub ላይ ባለው የጥቅሉ README ውስጥ ይገኛል፣ እዚያም ችግሮች (issues) እና የለውጥ ጥያቄዎች (pull requests) በደስታ ይቀበላሉ።