Zinnector®తో ప్రారంభించడం, డెవలపర్ CLI

Zinnector® అనేది WordPress డెవలపర్ల కోసం Zinn Digital® వారి ఉచిత, MIT-లైసెన్స్ గల కమాండ్-లైన్ టూల్. ఇది ఒక సైట్‌ను స్క్యాఫోల్డ్ చేస్తుంది, మీ స్వంత యంత్రంపై Node మినహా ఏదీ ఇన్‌స్టాల్ చేయకుండానే అసలైన WordPressని రన్ చేస్తుంది — Docker లేదు, MAMP లేదు, మీ PATHలో PHP లేదు — ఆ తర్వాత మీరు డిప్లాయ్ చేయబోయే హోస్టింగ్ స్లాట్‌తో మీరు నిర్మించిన దాన్ని సరిచూసి పుష్ చేస్తుంది. ఈ గైడ్ సుమారు రెండు నిమిషాల్లో మిమ్మల్ని ఏమీ లేని స్థితి నుండి రన్ అవుతున్న సైట్‌కి తీసుకెళ్తుంది, మరియు ప్రతి దశలోనూ విజయం ఎలా ఉంటుందో మీకు తెలియజేస్తుంది, తద్వారా ఏదైనా తప్పు జరిగినప్పుడు మీకు తెలుస్తుంది.

మీకు ఏది కావాలి

• Node 24 లేదా కొత్తది. node --version రన్ చేయండి; ఇది తప్పనిసరిగా v24 లేదా అంతకంటే ఎక్కువ ప్రింట్ చేయాలి. nodejs.org నుండి ప్రస్తుత LTSని ఇన్‌స్టాల్ చేయండి — Windowsలో అయితే winget install OpenJS.NodeJS.LTS, macOSలో అయితే brew install node@24.
• npm, ఇది Node తో వస్తుంది. Zinnector® దీన్ని ఒక్కసారి ఉపయోగిస్తుంది, WordPress రన్ టైమ్‌ను దాని స్వంత కాష్‌లోకి డౌన్‌లోడ్ చేయడానికి.
• git, కేవలం zinnector push కోసం మాత్రమే — డిప్లాయ్‌లు మీ రిపాజిటరీ నుండి డ్రైవ్ చేయబడతాయి.
• Docker, మీరు --runtime dockerతో అడిగితే తప్ప అవసరం లేదు. డిఫాల్ట్ రన్ టైమ్‌కి ఏదీ అవసరం లేదు.

కిందివాటిలో దేనికీ ఖాతా అవసరం లేదు. Zinnector®తో డిప్లాయ్ చేయడంలో మీరు హోస్టింగ్ స్లాట్‌ను చేరుకున్నప్పుడు మాత్రమే API కీ అవసరమవుతుంది.

దశ 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 మరియు పోర్ట్ ఫ్లాగ్‌లను జాబితా చేస్తుంది. ఉదాహరణలతో కూడిన పూర్తి జాబితా కమాండ్ రిఫరెన్స్లో ఉంది.

దశ 4 — ఒక సైట్‌ను స్క్యాఫోల్డ్ చేయండి

zinnector new my-site

విజయం: Created my-site శీర్షిక మరియు అది వ్రాసిన ఫైల్‌ల జాబితా — zinnector.json, plugins/, themes/ మరియు mu-plugins/ సహాయకంతో కూడిన wp-content ట్రీ, .gitignore మరియు ఒక README — దాని తర్వాత రన్ చేయవలసిన తదుపరి కమాండ్‌లు ఉంటాయి. అందులో ఏదీ ప్లేస్‌హోల్డర్ కాదు; ప్రాజెక్ట్ ఉన్నట్లుగానే బూట్ అవుతుంది. --template plugin లేదా --template 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 చెక్‌సమ్‌లకు వ్యతిరేకంగా ధృవీకరించబడింది), ఎందుకంటే రన్ టైమ్ యొక్క నేటివ్ మాడ్యూల్ 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)

దశ 6 — దీన్ని తెరవండి

బ్రౌజర్‌లో http://127.0.0.1:9400 ని సందర్శించండి. విజయం: My WordPress Website పేరుతో తాజా WordPress సైట్, మీరు అభ్యర్థించిన PHP వెర్షన్ ద్వారా అందించబడుతుంది. 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లో ఉంది, ఇక్కడ సమస్యలు మరియు పుల్ రెగ్యువ్‌లు స్వాగతించబడతాయి.