अक्सर पूछे जाने वाले प्रश्न

अवधारणा

headless CMS क्या है?

headless CMS एक ऐसा कंटेंट प्रबंधन सिस्टम है जिसमें कंटेंट को प्रबंधित करने की जगह और कंटेंट को दिखाने वाली स्क्रीन को अलग कर दिया जाता है। यहाँ "headless" का मतलब है कि इसके साथ कोई तयशुदा स्क्रीन (UI) जुड़ी हुई नहीं होती।

पारंपरिक तरीके में कंटेंट को प्रबंधित करने की जगह और उसे दिखाने वाली वेबसाइट स्क्रीन एक साथ बँधी होती है। headless CMS इन दोनों को एक-दूसरे से अलग कर देता है। कंटेंट को एक ही जगह प्रबंधित किया जाता है, और उस कंटेंट को एक तय रास्ते (API, यानी तय किए गए नियमों के अनुसार पते से डेटा का आदान-प्रदान करने का तरीका) से भेजा जाता है। इसीलिए एक ही कंटेंट को वेबसाइट और मोबाइल ऐप जैसी अलग-अलग कई स्क्रीनों पर लाकर इस्तेमाल किया जा सकता है।

WEEGLOO यही headless CMS है। कंटेंट को कंटेंट स्टूडियो में बनाकर प्रकाशित करते ही, वेबसाइट या ऐप उस प्रकाशित रूप को लाकर स्क्रीन पर दिखा देता है। WEEGLOO का पूरा संचालन यह कैसे काम करता है में बताया गया है।

कंटेंट किस तरीके से उपलब्ध कराया जाता है?

WEEGLOO कंटेंट को JSON (डेटा के आदान-प्रदान में इस्तेमाल होने वाला अक्षर-आधारित डेटा प्रारूप) आधारित RESTful API से उपलब्ध कराता है। API वह रास्ता है जिससे तय किए गए नियमों के अनुसार पते से डेटा का आदान-प्रदान होता है।

उपयोग के अनुसार कई API बँटे हुए हैं।

• प्रकाशित कंटेंट को पढ़ने वाला CDA (Content Delivery API): वेबसाइट या ऐप जब कंटेंट लाकर आगंतुकों को दिखाते हैं, तब इसका उपयोग होता है।
• कंटेंट बनाने और प्रबंधित करने वाला CMA (Content Management API): कंटेंट स्टूडियो में किए जाने वाले लेखन, संपादन और प्रकाशन जैसे काम कोड से करते समय इसका उपयोग होता है।

इस तरह पढ़ने और प्रबंधन के अलग होने से, अलग-अलग वातावरणों में सिर्फ़ ज़रूरी रास्ता चुनकर कंटेंट का उपयोग किया जा सकता है। किस स्थिति में कौन-सा API इस्तेमाल करें, यह API रेफ़रेंस में बताया गया है।

कंटेंट प्रबंधन

कई भाषाओं में कंटेंट वितरित करने के लिए क्या करना होगा?

Content या Media को कई भाषाओं में उपलब्ध कराने के लिए, पहले Space में भाषा (Locale) जोड़नी होगी।

1. बाईं ओर के मेन्यू से Space सेटिंग्स के Locale प्रबंधन स्क्रीन पर जाएँ।
2. ऊपर दाईं ओर + जोड़ें बटन दबाएँ, और ड्रॉपडाउन से अपनी मनचाही भाषा चुनें।
3. (वैकल्पिक) Fallback Locale निर्दिष्ट करें। यह वह भाषा है जो उस भाषा का मान खाली होने पर बदले में दिखाई जाती है।
4. सहेजें दबाएँ।

Locale जोड़ने के बाद, हर उस Field के लिए बहुभाषी चालू करना होगा जिसका मान भाषा के अनुसार अलग रखना है। Content Type संपादन स्क्रीन में उस Field की Field विस्तृत सेटिंग्स खोलें, और सेटिंग्स टैब में इस Field के लिए बहुभाषी अनुमति दें चालू है या नहीं, यह जाँच लें।

विस्तृत विवरण बहुभाषी प्रबंधन में दिया गया है।

Content की वैधता जाँच कैसे करें?

वैधता जाँच एक ऐसी सुविधा है जो Field पर "इस खाने में आ सकने वाले मान" की शर्त लगाती है। शर्त से मेल न खाने वाले मान सहेजे नहीं जाते, इसलिए गलत Content जमा होने से रुक जाता है।

लगाई जा सकने वाली शर्तें हर Field प्रकार के अनुसार अलग होती हैं। उदाहरण के लिए Media जोड़ने वाले Field में अपलोड की जा सकने वाली फ़ाइल के प्रकार को सीमित करने वाली या फ़ाइल के आकार व image के आकार को सीमित करने वाली शर्त होती है, और संख्या वाले Field में मान की सीमा तय करने वाली शर्त होती है।

Field में वैधता जाँच जोड़ने के लिए निम्नलिखित चरण करें।

1. Content Type संपादन स्क्रीन पर जाएँ, और जिस Field पर शर्त लगानी है उसे दबाएँ।
2. Field विस्तृत सेटिंग्स में वैधीकरण टैब पर जाएँ।
3. उस Field प्रकार पर इस्तेमाल हो सकने वाली शर्तें दिखाई देती हैं। ज़रूरी शर्त चुनकर सेट करें।

विस्तृत विवरण वैधता जाँच में दिया गया है।

Content का शीर्षक कैसे सेट करें?

Content का शीर्षक वह नाम है जिससे Content सूची में हर आइटम को पहचाना जाता है। ShortText प्रकार का कोई भी Field शीर्षक के रूप में इस्तेमाल किया जा सकता है।

Content Type संपादन स्क्रीन में जिस Field को शीर्षक के रूप में इस्तेमाल करना है उसे खोलें, और उस Field को शीर्षक के रूप में इस्तेमाल करने के लिए निर्दिष्ट कर दें। शीर्षक हर Content Type में केवल एक ही Field रख सकता है, इसलिए अगर पहले से कोई दूसरा Field शीर्षक के रूप में निर्दिष्ट है, तो उसे हटाने के बाद नया निर्दिष्ट करें।

पहली बार Field बनाते समय उसे शीर्षक के रूप में निर्दिष्ट करने का तरीका Content मॉडलिंग में बताया गया है।

Organization और Space प्रबंधन

उपयोगकर्ता को आमंत्रित करने के लिए क्या करना होगा?

किसी उपयोगकर्ता को Space में लाने के लिए, उस उपयोगकर्ता का पहले Organization में होना ज़रूरी है। इसीलिए सहयोग की शुरुआत Organization में आमंत्रित करने से होती है।

Organization में उपयोगकर्ता को आमंत्रित करने का काम Owner या Admin भूमिका वाला उपयोगकर्ता कर सकता है।

1. Organization सेटिंग्स स्क्रीन पर जाएँ।
2. बाईं ओर के मेन्यू में Membership दबाएँ।
3. ऊपर दाईं ओर मौजूद आमंत्रित करें बटन दबाएँ, और ईमेल व दी जाने वाली भूमिका जैसी जानकारी दर्ज करके आमंत्रण भेजें।

आमंत्रित किया गया उपयोगकर्ता तुरंत सदस्य बन जाता है। अलग से "स्वीकार करें" चरण नहीं करना पड़ता, और आमंत्रित किए गए ईमेल पर सूचना वाला मेल भेजा जाता है।

आमंत्रण और भूमिका के बारे में विस्तृत विवरण Organization और Space में दिया गया है।

API

sys.id का मान अद्वितीय होता है क्या?

हाँ. sys.id पूरी सेवा में अद्वितीय रूप से बनाया जाता है। इसीलिए दूसरे Organization या Space से जुड़े संसाधन के मान से भी यह मेल नहीं खाता।

sys में रखी जाने वाली जानकारी सिस्टम गुण (sys) में बताई गई है।

Content के संदर्भित संसाधन कैसे लाएँ?

include पैरामीटर का उपयोग करने पर, एक ही अनुरोध से Content और उसके द्वारा संदर्भित संसाधन तक एक साथ लाए जा सकते हैं।

GET /v1/spaces/{spaceId}/contents?include=1

ऊपर वाला अनुरोध Content सूची को लाते समय एक स्तर गहराई तक जुड़े संदर्भित डेटा को साथ लाता है। मान को 2 या 3 तक बढ़ाने पर और गहरे स्तर तक खोलकर लाया जाता है।

include का उपयोग सिर्फ़ Content तक सीमित नहीं, बल्कि हर संसाधन को लाते समय इसी तरह किया जा सकता है। विस्तृत विवरण सामान्य क्वेरी पैरामीटर में दिया गया है।

क्या खोज की शर्तों में OR संक्रिया समर्थित है?

REST API में कई शर्तों को OR (दोनों में से कोई एक भी मेल खाए तो ले आना) से जोड़ने की सुविधा सीधे समर्थित नहीं है। एक अनुरोध में कई शर्तें साथ देने पर सभी से मेल खाने वाले (AND) नतीजे ही आते हैं। अगर OR चाहिए, तो हर शर्त के लिए अलग-अलग अनुरोध भेजें, और मिले नतीजों को मिलाकर इस्तेमाल करें।

शर्तों से सूची को सीमित करने का तरीका सामान्य क्वेरी पैरामीटर में दिया गया है।

भुगतान और शुल्क

क्या योजना बदली जा सकती है?

आप कभी भी अपनी योजना को ऊपर (अपग्रेड) या नीचे (डाउनग्रेड) कर सकते हैं। अपग्रेड करने पर बचे हुए बिलिंग अवधि के लिए आनुपातिक हिसाब लगाया जाता है, और डाउनग्रेड अगली बिलिंग अवधि से लागू होता है।

हर योजना की सीमा और कीमत योजना में बताई गई है।

API उपयोग की गणना कैसे होती है?

कई कंटेंट प्लेटफ़ॉर्म API कॉल की संख्या (अनुरोधों की संख्या) के आधार पर उपयोग गिनते हैं। WEEGLOO कॉल की संख्या के बजाय असल में आदान-प्रदान किए गए डेटा की मात्रा (डेटा ट्रांसफ़र मात्रा) के आधार पर उपयोग की गणना करता है। एक ही संख्या में अनुरोध होने पर भी, अगर आदान-प्रदान किया गया डेटा बड़ा हो, तो उपयोग ज़्यादा गिना जाता है।

Free, Basic, Pro योजनाएँ हर महीने तय की गई डेटा ट्रांसफ़र मात्रा को मासिक शुल्क में ही शामिल रखती हैं। इस ट्रांसफ़र मात्रा का अंदाज़ा लगाने के लिए, योजना तालिका में कॉल की संख्या में बदलकर दर्शाया गया मान भी साथ दिखाया जाता है। Advanced Search जैसे काम, जिनमें एक बार की खोज कई बार की कॉल के रूप में गिनी जाती है, वे भी इसी ट्रांसफ़र मात्रा के भीतर ही इस्तेमाल होते हैं।

अगर तय की गई ट्रांसफ़र मात्रा से ज़्यादा उपयोग की ज़रूरत हो, तो जितना इस्तेमाल हो उतना ही बिल किए जाने वाली Enterprise योजना का उपयोग किया जा सकता है। हर योजना की डेटा ट्रांसफ़र सीमा योजना में बताई गई है।