Zinnector® सँग सुरुवात गर्दै, विकासकर्ता CLI

Zinnector® भनेको WordPress विकासकर्ताहरूका लागि Zinn Digital® को नि:शुल्क, MIT-अनुज्ञापत्र प्राप्त आदेश-पंक्ति (command-line) उपकरण हो। यसले साइट स्केफोल्ड गर्छ, Node बाहेक अरू केही स्थापना नगरी (Docker छैन, MAMP छैन, तपाईँको PATH मा PHP छैन) तपाईँको आफ्नै मेसिनमा वास्तविक WordPress चलाउँछ — त्यसपछि तपाईँले पठाउन (deploy) लागेको होस्टिङ स्लटसँग तपाईँले बनाएको कुरा जाँच गर्छ र यसलाई पुस (push) गर्छ। यस मार्गदर्शिकाले तपाईँलाई शून्यबाट करिब दुई मिनेटमा चलिरहेको साइटसम्म पुर्याउँछ, र प्रत्येक चरणमा सफलता कस्तो देखिन्छ भनी बताउँछ ताकि केही गडबड हुँदा तपाईँलाई थाहा होस्।

तपाईँलाई के आवश्यक छ

• 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 मार्फत अनुरोध गर्नुभयो भने मात्र। पूर्वनिर्धारित रनटाइमलाई यसको आवश्यकता पर्दैन।

तलका कुनै पनि कुराको लागि खाताको आवश्यकता पर्दैन। 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

सफलता: प्रवाहका पाँच आदेशहरूको नामकरण गर्ने ब्यानर (new, dev, link, check, push) र त्यसपछि एक-पंक्ति उद्देश्य सहितको प्रत्येक आदेश। प्रत्येक आदेशले आफ्नो --help पनि लिन्छ — zinnector dev --help ले रनटाइम, PHP र पोर्ट फ्ल्यागहरू सूचीबद्ध गर्दछ। कमाण्ड सन्दर्भ मा उदाहरणहरू सहितको पूर्ण सूची छ।

चरण ४ — साइट स्केफोल्ड गर्नुहोस्

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 मा जानुहोस्। सफलता: तपाईँले अनुरोध गर्नुभएको 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 संस्करण, लोड गरिएका विस्तारहरू) प्रिन्ट गर्छ र रोकिन्छ — जब तपाईँलाई प्रतिज्ञा भन्दा प्रमाण चाहिन्छ तब यो उपयोगी हुन्छ।

अर्को कहाँ जाने

• Local development with zinnector dev — दुई रनटाइमहरू, PHP र WordPress संस्करणहरू छनौट गर्दै, र कहाँबाट के सेवा दिइन्छ।
• Deploying with Zinnector® — साइन इन गर्नुहोस्, परियोजनालाई स्लटमा लिङ्क गर्नुहोस्, प्रिफ्लाइट गर्नुहोस्, पुस गर्नुहोस्।
• The command reference — प्रत्येक आदेश, फ्ल्याग र उदाहरण।
• Troubleshooting — मानिसहरूले वास्तवमै सामना गर्ने त्रुटिहरू, र प्रत्येकका लागि समाधान।

उही कागजात npm मा र GitHub मा प्याकेजको README मा छ, जहाँ मुद्दाहरू र पुल अनुरोधहरू स्वागत छ।