CMS: टेक्स्ट स्ट्रिंग्स को बदलने के लिए CMS एक्सप्रेशन्स का इस्तेमाल करना
Velo या JS कोड का इस्तेमाल किए बिना अपने CMS की पूरी क्षमता का लाभ उठाने के लिए CMS एक्सप्रेशन्स का इस्तेमाल करें।
एक्सप्रेशन्स आपको एक ही टेक्स्ट स्ट्रिंग में कई कलेक्शन फील्ड्स की डायनेमिक वैल्यूज़ के साथ स्टैटिक टेक्स्ट को जोड़ने की सुविधा देते हैं। डायनेमिक तारीखों, समय और नंबरों को अपनी ज़रूरत के अनुसार दिखाने के लिए उन पर फॉर्मेटिंग लागू करें। ऐसी गणितीय इक्वेशन (mathematical equations) बनाएँ जो अपनी कैलकुलेशन में नंबर फील्ड्स का इस्तेमाल करती हों। आप अंतहीन संभावनाओं के लिए एक ही एक्सप्रेशन में कई फंक्शन्स को भी मिला सकते हैं।
इस प्रोसेस के ओवरव्यू के लिए, हमारा
अल्टीमेट CMS गाइड वीडियो देखें।
CMS एक्सप्रेशन फंक्शन्स के बारे में
एक CMS एक्सप्रेशन आपकी साइट पर डेटा को नए तरीकों से पेश करने के लिए फंक्शन्स, लिटरल वैल्यूज़ और कलेक्शन फील्ड वैल्यूज़ को जोड़ता है।
सपोर्टेड पेज एलिमेंट को डेटासेट से कनेक्ट करने के बाद, आप इसकी टेक्स्ट वैल्यू(s) को CMS एक्सप्रेशन से कनेक्ट कर सकते हैं। इसके बाद आप फंक्शन्स, फील्ड IDs, स्ट्रिंग्स, नंबरों और अन्य सिंटैक्स से बना एक एक्सप्रेशन बनाते हैं। आपके कनेक्टेड एलिमेंट का टेक्स्ट फिर एक्सप्रेशन को कैलकुलेट करने के परिणाम दिखाता है।
एक्सप्रेशन्स का स्ट्रक्चर इस प्रकार होता है:
- फंक्शन्स: यह तय करें कि फंक्शन के बाद कोष्ठक (parentheses) में आने वाली वैल्यूज को कैसे कैलकुलेट करना है, जहाँ वैल्यूज को कॉमा से अलग किया जाता है (जैसे MULTIPLY(price, count), DAYS(_createdDate, NOW()), CONCAT("Created on ", _created Date))।
- फील्ड IDs: हर कलेक्शन फील्ड के यूनिक आइडेंटिफायर्स (जैसे title, _createdDate, clientName)।
- स्ट्रिंग्स: कैरेक्टर्स का एक क्रम जिसमें अक्षर, नंबर, सिंबल और स्पेस शामिल हो सकते हैं।
- स्ट्रिंग लिटरल्स: कोट्स में बंद कैरेक्टर्स का एक क्रम जिसका इस्तेमाल स्टैटिक टेक्स्ट दिखाने के लिए किया जाता है (जैसे "Hello", 'Hello', '"Errata" by Kevin Young', "\"Errata\" by Kevin Young", "backslash is \\, forward slash is /")।
- नंबर लिटरल्स: फंक्शन द्वारा इस्तेमाल की जाने वाली न्यूमेरिक वैल्यूज (जैसे 123, 1000, 3.14)।
- एरे लिटरल्स: एरे को एक्सप्रेस करने का एक तरीका, जो वैल्यूज का एक व्यवस्थित कलेक्शन होता है, आमतौर पर एक ही प्रकार का, जो स्क्वायर ब्रैकेट्स में बंद होता है (जैसे [1,2,3], ["cat", "dog", "mouse"])।
- स्पेशल कॉन्स्टेंट्स: पहले से तय वैल्यूज जिनका फंक्शन के दायरे में एक खास मतलब होता है (जैसे true, false, undefined, null)।
ध्यान रखें कि एक्सप्रेशन्स केस-सेंसिटिव (case-sensitive) होते हैं। एक्सप्रेशन्स के अंदर फ़ील्ड्स का इस्तेमाल करते समय, फ़ील्ड नामों के बजाय फ़ील्ड ID का इस्तेमाल करें, और याद रखें कि फ़ील्ड ID भी केस-सेंसिटिव होती हैं।
जैसे ही आप अपने एक्सप्रेशन्स टाइप करेंगे, आपको फ़ंक्शन्स और फ़ील्ड ID का सही ढंग से इस्तेमाल करने में मदद के लिए सुझाव मिलेंगे। अपने एडिटर में फ़ील्ड ID को आसानी से देखने के लिए,
Dev mode इनेबल करें।
एक्सप्रेशन्स लिखने के बारे में ज़रूरी जानकारी:
- कलेक्शन फील्ड्स का रेफरेंस देते समय फील्ड नामों के बजाय फील्ड IDs दर्ज करें। फील्ड नामों के विपरीत, फील्ड IDs हर कलेक्शन फील्ड के लिए यूनिक आइडेंटिफायर होते हैं।
- फंक्शन्स और फील्ड IDs केस-सेंसिटिव होते हैं। दोनों में इस्तेमाल किए गए कैपिटलाइजेशन (बड़े और छोटे अक्षरों) पर ध्यान दें।
- CONCAT फंक्शन्स के लिए, 'स्टैटिक' स्ट्रिंग लिटरल वैल्यूज को कोटेशन मार्क्स में रखें। इसमें स्टैटिक विराम चिह्न और रेफरेंस दिए गए फील्ड्स के बीच के स्पेस भी शामिल हैं।
- अगर फंक्शन काम नहीं करता है, तो समस्या को ठीक करने के तरीके जानने के लिए Expression फील्ड के नीचे दिया गया एरर मैसेज देखें।
डेटासेट में एलिमेंट्स को एक्सप्रेशन्स से कनेक्ट करना
शुरू करने के लिए, संबंधित एलिमेंट को CMS से कनेक्ट करें और Expression कनेक्शन विकल्प चुनें। फिर वह एक्सप्रेशन दर्ज करें जिसे आप इस्तेमाल करना चाहते हैं। अपना एक्सप्रेशन बनाने में मदद के लिए अगले सेक्शन देखें।
Wix एडिटर
Studio एडिटर
- अपने एडिटर में, उस एलिमेंट पर क्लिक करें जिसे आप CMS से कनेक्ट करना चाहते हैं (जैसे टेक्स्ट, बटन, गैलरी)।
- कनेक्ट टू CMS आइकन
पर क्लिक करें। - Choose a dataset ड्रॉप-डाउन पर क्लिक करें और एक मौजूदा डेटासेट चुनें जो आपके कलेक्शन से कनेक्ट होता हो। वैकल्पिक रूप से, Create a New Dataset पर क्लिक करें, फिर वह कलेक्शन चुनें जिसे आप कनेक्ट करना चाहते हैं।
- Connection options के तहत संबंधित ड्रॉप-डाउन पर क्लिक करें और Expression चुनें।
- Expression फ़ील्ड पर क्लिक करें।
- उस फ़ंक्शन का नाम डालें जिसे आप इस्तेमाल करना चाहते हैं (जैसे CONCAT, DATE, TEXT)।
टिप: टाइप करना शुरू करने के बाद, आप इस्तेमाल किए जा सकने वाले फ़ंक्शन की लिस्ट में से चुनाव कर सकते हैं।
- एक ओपनिंग पैरेंट्थीसिस (opening parenthesis) टाइप करें: (
- वे फील्ड IDs या वैल्यूज़ दर्ज करें जिन्हें आप एक्सप्रेशन में इस्तेमाल करना चाहते हैं। जैसे ही आप टाइप करेंगे, मैचिंग फील्ड IDs की एक लिस्ट दिखाई देगी जिसे आप चुन सकते हैं।
- एक क्लोजिंग पैरेंट्थीसिस (closing parenthesis) टाइप करें: )
एक्सप्रेशन के उदाहरण
अलग-अलग प्रकार के एक्सप्रेशन्स लिखने के उदाहरणों के लिए नीचे दिए गए सेक्शन देखें।
स्ट्रिंग कॉनकेटिनेशन (string concatenation) का उपयोग करके कई फील्ड्स की वैल्यूज को कंबाइन करना
कई अलग-अलग कलेक्शन फील्ड्स की वैल्यूज को एक ही टेक्स्ट फील्ड में जोड़ने के लिए
CONCAT फंक्शन का इस्तेमाल करें। स्टैटिक कैरेक्टर्स को डायनेमिक वैल्यूज के साथ जोड़ने के लिए फंक्शन में अपना टेक्स्ट जोड़ें। स्टैटिक कैरेक्टर्स नहीं बदलते हैं, जबकि डायनेमिक वैल्यूज डेटासेट द्वारा रिट्रीव किए गए आइटम के आधार पर बदलती रहती हैं। सुनिश्चित करें कि सभी स्टैटिक टेक्स्ट को कोट्स में रखा गया है, जिसमें स्पेस और विराम चिह्न भी शामिल हैं (जैसे
" " या
",")।
आप एक जैसे काम करने के लिए अलग-अलग फंक्शन्स का इस्तेमाल कर सकते हैं, और एडवांस टास्क के लिए फंक्शन्स के अंदर फंक्शन्स को कंबाइन भी कर सकते हैं। अगर एक्सप्रेशन में कोई समस्या है, तो उसे हल करने के तरीके जानने के लिए एरर मैसेज चेक करें।
CONCAT फंक्शन का इस्तेमाल करने का एक उदाहरण डायनेमिक आइटम पेज के इंट्रोडक्शन के लिए कस्टम टेक्स्ट बनाना है। यह टेक्स्ट हर मेंबर का नाम बता सकता है, उनके जॉब टाइटल का जिक्र कर सकता है, और यह भी कि वे कंपनी के साथ कितने समय से हैं। वह एक्सप्रेशन कुछ ऐसा दिखेगा:
1CONCAT("Our ",jobTitle,", ",title,", has worked here since ",date,".")इस उदाहरण में:
jobTitle फील्ड ID उस कलेक्शन फील्ड को दर्शाती है जिसमें हर मेंबर का जॉब टाइटल है।
title फील्ड ID उस फील्ड के लिए है जिसमें हर मेंबर का नाम है।
hireDate की (key) उस फील्ड से है जिसमें हर कर्मचारी की जॉइनिंग डेट है। ध्यान दें कि कैसे सभी स्टैटिक टेक्स्ट और विराम चिह्नों (punctuation) को कोट्स (quotes) में रखा गया है।
मुझे दिखाएं कि फ़ंक्शन्स को कैसे कंबाइन करें और महीने या दिन के बिना केवल साल कैसे डिस्प्ले करें
CONCAT फंक्शन का उपयोग करने के और भी बेसिक उदाहरणों के लिए नीचे दी गई टेबल देखें:
| यूज़ केस | एक्सप्रेशन | उदाहरण | रिजल्ट |
|---|---|---|---|
बिना स्पेस या विराम चिह्नों के फील्ड वैल्यूज को कंबाइन करें
|
CONCAT(value,value)
|
CONCAT(title,jobTitle)
|
ब्रायन चांग, VP प्रोडक्ट
|
कॉमा और स्पेस के साथ फील्ड वैल्यूज को कंबाइन करें
|
CONCAT(value,", ",value)
|
CONCAT(title,", ",jobTitle)
|
ब्रायन चांग, VP प्रोडक्ट
|
स्टैटिक टेक्स्ट को फील्ड वैल्यूज के साथ कंबाइन करें
|
CONCAT("नमस्ते, ",value)
|
CONCAT("नमस्ते, ",title)
|
नमस्ते, Brian Chang
|
शुरुआत और अंत में स्टैटिक टेक्स्ट के साथ फील्ड वैल्यूज को कंबाइन करें
|
CONCAT("नमस्ते, ",value,", आपका स्वागत है।")
|
CONCAT("नमस्ते, ",title,", आपका स्वागत है।")
|
नमस्ते, Brian Chang, आपका स्वागत है।
|
डेट/टाइम फॉर्मेटिंग
जब आप यह कंट्रोल करना चाहते हैं कि आपकी लाइव साइट पर तारीख और समय कैसे फ़ॉर्मेट हों, या तारीखों से वैल्यू कैलकुलेट करनी हो, तो date/time फ़ंक्शन्स का इस्तेमाल करें। ये फ़ंक्शन्स Date, Time और Number फ़ील्ड टाइप के साथ काम करते हैं।
ऊपर दिए गए उदाहरण में:
DAYS फंक्शन डायनेमिक
dueDate फील्ड और आज की तारीख के बीच के दिनों की संख्या बताता है। ध्यान दें कि यह
DAYS फंक्शन को
TODAY फंक्शन के साथ जोड़ता है, साथ ही इसमें स्टैटिक और डायनेमिक टेक्स्ट को मिलाने के लिए
CONCAT फंक्शन का भी इस्तेमाल किया गया है।
किसी फंक्शन के बारे में अधिक जानने के लिए नीचे उससे संबंधित फंक्शन पर क्लिक करें:
DATE
DATEVALUE
YEAR
महीना
दिन
घंटा
मिनट
सेकंड
दिन
DAYS360
EDATE
EOMONTH
NETWORKDAYS
NETWORKDAYSINTL
अभी
आज
TIME
TIMEVALUE
WEEKDAY
ISOWEEKNUM
WEEKNUM
WORKDAY
WORKDAYINTL
YEARFRAC
TEXT फंक्शन के साथ नंबर फॉर्मेटिंग
नंबरों पर फ़ॉर्मेटिंग लागू करने के लिए
TEXT फ़ंक्शन का उपयोग करें। उदाहरण के लिए, आप Number फ़ील्ड टाइप की वैल्यू को करेंसी या पर्सेंटेज के रूप में फ़ॉर्मेट कर सकते हैं।
ऊपर दिए गए उदाहरण में:
TEXT फंक्शन नंबर फील्ड टाइप (
price) को डॉलर अमाउंट के रूप में फॉर्मेट करता है। ध्यान दें कि कैसे
TEXT फंक्शन को
CONCAT फंक्शन के अंदर इंसर्ट किया गया है, जो प्राइस से पहले स्टैटिक टेक्स्ट जोड़ता है।
TEXT फंक्शन का उपयोग करने के उदाहरणों के लिए नीचे क्लिक करें:
नंबर को करेंसी फॉर्मेट में बदलें
नंबर को पर्सेंटेज (%) फॉर्मेट में बदलें
मैथमेटिकल फंक्शन्स
आप अलग-अलग Number फ़ील्ड टाइप और/या स्टैटिक नंबरों के आधार पर कैलकुलेशन करने के लिए मैथमेटिकल फ़ंक्शन्स का इस्तेमाल कर सकते हैं।
ऊपर दिए गए उदाहरण में:
MINUS फंक्शन 20-11=9 कैलकुलेट करता है। यहाँ 20 वैल्यू स्टैटिक है, जबकि नंबर फील्ड वैल्यू (
rewardPoints) डायनेमिक है। ध्यान दें कि एक्सप्रेशन कैसे
CONCAT फंक्शन के अंदर
MINUS फंक्शन को इंसर्ट करता है, जो स्टैटिक टेक्स्ट को डायनेमिक वैल्यूज के साथ जोड़ता है।
मैथमेटिकल एक्सप्रेशन्स का उपयोग करने के और भी उदाहरणों के लिए नीचे दी गई टेबल देखें:
| यूज़ केस | एक्सप्रेशन | उदाहरण | रिजल्ट |
|---|---|---|---|
2 नंबरों के जोड़ (sum) को कैलकुलेट करें
|
ADD(value,value)
|
ADD(number1,number2)
ADD(4,20) |
24
|
2 नंबरों के बीच का अंतर कैलकुलेट करें
|
MINUS(value,value)
|
MINUS(number1,number2)
MINUS(100,1) |
99
|
2 नंबरों को मल्टीप्लाई (गुणा) करना कैलकुलेट करें
|
MULTIPLY(value,value)
|
MULTIPLY(number1,number2)
MULTIPLY(2,4) |
6
|
एक नंबर को दूसरे नंबर से डिवाइड (भाग) करने की कैलकुलेशन करें
|
DIVIDE(value,value)
|
DIVIDE(number1,number2)
DIVIDE(10,2) |
5
|
अगर 2 वैल्यू बराबर हैं तो "true" रिटर्न करें, वरना "false" रिटर्न करें
|
EQ(value,value)
|
EQ(number1,number2)
EQ(200,200) |
सही (true)
|
एक नंबर ('x') को दूसरे नंबर ('y') की पावर तक बढ़ाएं
|
POW(x,y)
|
POW(2,3)
POW(3,3)
|
8
27
|
चेक करता है कि क्या दो वैल्यू बराबर हैं
|
EQ (इक्वल)
|
EQ(5,5)
|
सही (true)
|
चेक करता है कि क्या दो वैल्यू बराबर नहीं हैं
|
NE (नॉट इक्वल)
|
NE(5,7)
|
सही (true)
|
चेक करता है कि क्या एक वैल्यू दूसरी वैल्यू से बड़ी है
|
GT (ग्रेटर दैन)
|
GT(7,5)
GT(7,7) |
सही (true)
गलत (false) |
चेक करता है कि क्या एक वैल्यू दूसरी वैल्यू से छोटी है
|
LT (लेस दैन)
|
LT(5,7)
LT(7,5) |
सही (true)
गलत (false) |
चेक करता है कि क्या एक वैल्यू दूसरी वैल्यू से बड़ी है या उसके बराबर है
|
GTE (ग्रेटर दैन या इक्वल)
|
GTE(7,5)
GTE(5,5) GTE(5,4) |
सही (true)
सही (true) गलत (false) |
चेक करता है कि क्या एक वैल्यू दूसरी वैल्यू से छोटी है या उसके बराबर है
|
LTE (लेस दैन या इक्वल)
|
LTE(5,7)
LTE(5,5) LTE(5,4) |
सही (true)
सही (true) गलत (false) |
अक्सर पूछे जाने वाले सवाल (FAQs)
एक्सप्रेशन्स के उपयोग से जुड़े सामान्य सवालों के जवाब के लिए नीचे क्लिक करें।
मैं किन एलिमेंट्स के साथ एक्सप्रेशन्स का इस्तेमाल कर सकता हूँ?
मुझे फील्ड ID (IDs) कहाँ मिल सकते हैं?
पर क्लिक करें। वहां से, आप संबंधित कलेक्शन को एक्सपैंड करने के लिए क्लिक कर सकते हैं और हर फील्ड के बगल में पैरेंट्थीसिस में फील्ड IDs देख सकते हैं।
