टर्म्स क्वेरी ब्लॉक

Terms Query ब्लॉक टैक्सोनॉमी टर्म्स (जैसे कैटेगरी, टैग या कस्टम टैक्सोनॉमी) की सूची या ग्रिड प्रदर्शित करता है। यह टेम्पलेट्स में सबसे अधिक उपयोगी होता है (उदाहरण के लिए, “Categories” इंडेक्स या डायरेक्टरी पेज), जहाँ आप टर्म्स की सूची बनाना और यह डिज़ाइन करना चाहते हैं कि प्रत्येक टर्म कैसे दिखाई दे।

आवश्यकताएँ

• WordPress 6.9 या उसके बाद का संस्करण।
• साइट एडिटर में टेम्पलेट्स संपादित करने के लिए एक ब्लॉक थीम।
• जिस टैक्सोनॉमी को आप प्रदर्शित करना चाहते हैं, वह सार्वजनिक और एडिटर में उपलब्ध होनी चाहिए (show_in_rest सक्षम)।

Terms Query ब्लॉक की संरचना

ब्लॉक इंस्पेक्टर Term Query ब्लॉक की संरचना का त्वरित अवलोकन प्रदान करता है। प्रत्येक भाग आपको अलग-अलग सेटिंग्स तक पहुँच देता है:

• Terms Query: क्वेरी पैरामीटर कॉन्फ़िगर करें।
• Term Template: चुनें कि सामग्री कैसे प्रदर्शित की जाए—सूची या ग्रिड प्रारूप में।
• Term Name: टर्म का नाम दिखाएँ।
• Term Description: टर्म का विवरण दिखाएँ।
• Term Count: प्रत्येक टर्म के परिणामों की संख्या दिखाएँ।

टेम्पलेट में Terms Query ब्लॉक जोड़ें

1. Appearance > Editor पर जाएँ।
2. वह टेम्पलेट खोलें जहाँ आप टर्म्स दिखाना चाहते हैं (उदाहरण के लिए, एक कस्टम “Categories” टेम्पलेट)।
3. कर्सर को इच्छित स्थान पर रखें।
4. ब्लॉक इंसर्टर (+) खोलें, “Terms Query” खोजें और उसे चुनें।

ब्लॉक कॉन्फ़िगरेशन

Terms Query ब्लॉक जोड़ने के बाद आपको दो विकल्प दिखाई देंगे:

ये विकल्प दो अलग-अलग लेआउट विकल्प प्रदान करते हैं:

• Name: केवल टर्म का नाम दिखाता है।
• Name & Count: टर्म का नाम और उस टर्म में मौजूद आइटम्स की संख्या दिखाता है।

दिखावट को कैसे कस्टमाइज़ करें

Term Query block, को कस्टमाइज़ करने के कई तरीके हैं, आंशिक रूप से इसलिए क्योंकि यह नेस्टेड ब्लॉक्स से बना है जिन्हें आप पुनर्व्यवस्थित, जोड़ और अन्य कार्य कर सकते हैं। जब आप Term Query block में किसी एक ब्लॉक को कस्टमाइज़ करते हैं, तो बदलाव उसी प्रकार के सभी ब्लॉक्स पर लागू होंगे। इस ब्लॉक को कस्टमाइज़ करते समय, शीर्ष टूलबार में उपलब्ध List View का उपयोग करना सहायक हो सकता है। शुरू करने के लिए यहाँ कुछ सुझाव दिए गए हैं:

• आप Term Query ब्लॉक के विभिन्न पहलुओं की चौड़ाई बदल सकते हैं।
• आप Term Query block. के भीतर ब्लॉक्स का alignment बदल सकते हैं।
• आप अपनी पसंद के अनुसार ब्लॉक्स को पुनर्व्यवस्थित कर सकते हैं, इसके लिए उन्हें खींचकर छोड़ें या मूवर्स का उपयोग करें।
• आप Term Query ब्लॉक चुनकर और ब्लॉक सेटिंग्स में Max Terms विकल्प समायोजित करके सूचीबद्ध टर्म्स की संख्या बदल सकते हैं।
• आप नेस्टेड ब्लॉक्स के लिए विभिन्न रंग विकल्प सेट कर सकते हैं।
• आप Terms Number ब्लॉक चुनकर और ब्लॉक टूलबार में प्रारूप बदलकर टर्म्स की संख्या प्रदर्शित करने का तरीका बदल सकते हैं।
• आप Term Description ब्लॉक चुनकर और आवश्यकतानुसार स्टाइल समायोजित करके टर्म का विवरण दिखा सकते हैं।

ब्लॉक टूलबार

ब्लॉक टूलबार देखने के लिए ब्लॉक पर क्लिक करें; टूलबार प्रदर्शित हो जाएगा। प्रत्येक ब्लॉक में विशिष्ट टूलबार आइकन और ब्लॉक-विशिष्ट उपयोगकर्ता नियंत्रण होते हैं, जो आपको सीधे एडिटर में ब्लॉक में बदलाव करने देते हैं। Terms Query ब्लॉक में निम्नलिखित विकल्प होते हैं:

• में बदलें।
• None, wide width, full width में संरेखित करें।
• टेम्पलेट में स्थान बदलने के लिए मूव/ड्रैग करें।
• अधिक विकल्प (डुप्लिकेट, लॉक, हटाना आदि)।

में बदलें

“Transform” बटन पर क्लिक करके Query Loop ब्लॉक को “Group” या “Columns” ब्लॉक में बदलें।  

खींचने का आइकन

ब्लॉक को किसी नए स्थान पर खींचकर छोड़ने के लिए, बिंदुओं वाले आयत पर क्लिक करके दबाए रखें, फिर उसे नए स्थान तक खींचें। नीली विभाजक रेखा बताती है कि ब्लॉक कहाँ रखा जाएगा। नया स्थान मिलने पर ब्लॉक रखने के लिए बायाँ माउस बटन छोड़ दें।

मूव एरो

ऊपर और नीचे दिए गए तीर आइकन का उपयोग पेज पर ब्लॉक को ऊपर और नीचे ले जाने के लिए किया जा सकता है।

एडिटर के भीतर ब्लॉक को स्थानांतरित करने के विस्तृत निर्देश यहाँ मिल सकते हैं।

संरेखित करें

Terms Loop ब्लॉक को संरेखित करने के लिए alignment बदलने वाले टूल का उपयोग करें। निम्नलिखित विकल्पों में से एक चुनें:

• None – ब्लॉक को उसके वर्तमान आकार में रखता है।
• Wide width – ब्लॉक की चौड़ाई को सामग्री के आकार से अधिक बढ़ाता है।
• Full width – ब्लॉक को स्क्रीन की पूरी चौड़ाई तक विस्तृत करता है।

“Wide width” और “Full width” alignment सेटिंग्स आपके WordPress थीम द्वारा सक्षम की जानी चाहिए। 

सूची दृश्य (डिफ़ॉल्ट)

आपके टर्म्स को एक के नीचे एक सूची में प्रदर्शित करता है। इसे संपादित करने के लिए Term Template ब्लॉक चुनें।

ग्रिड दृश्य

आपके टर्म्स को ग्रिड दृश्य में प्रदर्शित करता है। इसे संपादित करने के लिए Term Template ब्लॉक चुनें।

विकल्प

ब्लॉक टूलबार में Options बटन आपको ब्लॉक को कस्टमाइज़ करने के लिए अधिक सुविधाएँ देता है। 

इन और अन्य सेटिंग्स के बारे में पढ़ें।

ब्लॉक सेटिंग्स

इनर ब्लॉक्स सामग्री की चौड़ाई का उपयोग करते हैं

यह विकल्प आपको QueryLoop ब्लॉक के भीतर सभी नेस्टेड ब्लॉक्स के लिए justification, content और wide width सेटिंग्स कॉन्फ़िगर करने देता है।

क्रमबद्ध करें

• Name: A > Z
• Name: Z > A
• Count: High to Low
• Count: Low to High

चयनित टर्म्स

यह विकल्प आपको दिखाने के लिए विशिष्ट टैक्सोनॉमी चुनने देता है। जिसे जोड़ना है, उसे बस खोजें और चुनें।

खाली टर्म्स दिखाएँ

यह विकल्प आपको टर्म्स को खाली होने पर भी प्रदर्शित करने देता है। यह डिफ़ॉल्ट रूप से बंद होता है।

नेस्टेड टर्म्स दिखाएँ

यह विकल्प आपको नेस्टेड टर्म्स प्रदर्शित करने देता है। यह डिफ़ॉल्ट रूप से बंद होता है।

अधिकतम टर्म्स

यह विकल्प आपको दिखाए जाने वाले टर्म्स की संख्या सीमित करने देता है। सभी टर्म्स दिखाने के लिए 0 (शून्य) का उपयोग करें।

उन्नत सेटिंग्स

उन्नत टैब आपको अपने ब्लॉक में CSS क्लास जोड़ने देता है, जिससे आप कस्टम CSS लिखकर ब्लॉक को अपनी आवश्यकता के अनुसार स्टाइल कर सकते हैं। यह आपको एक HTML एलिमेंट असाइन करने की सुविधा भी देता है।

डेमो

सुझाव

• पदानुक्रमित टैक्सोनॉमी के लिए List का उपयोग करें; बहुत सारे टर्म्स को तेज़ी से देखने के लिए Grid का उपयोग करें।
• Term Name को प्रमुख रखें; लैंडिंग पेजों पर संदर्भ के लिए Term Description जोड़ें।
• खाली आर्काइव से बचने और सूची को प्रासंगिक बनाए रखने के लिए Hide empty का उपयोग करें।
• कॉन्फ़िगर किए गए Terms Query सेक्शन को Pattern के रूप में सहेजकर विभिन्न टेम्पलेट्स में फिर से उपयोग करें।

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

क्या मैं केवल शीर्ष-स्तरीय टर्म्स दिखा सकता हूँ?

• हाँ। Parent को अनसेट छोड़ें और Include subterms को बंद कर दें।

क्या मैं कस्टम टैक्सोनॉमी प्रदर्शित कर सकता हूँ?

• हाँ, यदि वह सार्वजनिक है और एडिटर में दिखाने के लिए पंजीकृत है (show_in_rest true)।

क्या मैं टर्म के नाम को उसके आर्काइव से लिंक कर सकता हूँ?

• Term Name आमतौर पर डिफ़ॉल्ट रूप से टर्म आर्काइव से लिंक होता है। आप इसकी ब्लॉक सेटिंग्स में अतिरिक्त लिंक (जैसे Term Count) नियंत्रित कर सकते हैं।