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

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తో అడిగితే మాత్రమే. డిఫాల్ట్ రన్‌టైమ్‌కు ఏదీ అవసరం లేదు.

దిగువన ఉన్న దేనికీ ఖాతా అవసరం లేదు. మీరు ఒక హోస్టింగ్ స్లాట్‌ను చేరుకున్నప్పుడు మాత్రమే Deploying with 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 కోసం మాత్రమే ముందస్తుగా నిర్మించిన బైనరీలను కలిగి ఉంది; మీకు కంపైలర్ లేదా 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 ను సందర్శించండి. విజయం: మీరు అడిగిన PHP వెర్షన్ ద్వారా అందించబడిన, My WordPress Website పేరుతో ఉన్న ఒక కొత్త 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లో ఉంది, ఇక్కడ సమస్యలు మరియు పుల్ రిక్వెస్ట్‌లు స్వాగతించబడతాయి.