6.7. Drupal में क्षेत्रों (Regions) और ब्लॉक्स (Blocks) के साथ काम करना

यदि आप अपनी थीम में एक नया क्षेत्र (Region) बनाना चाहते हैं, जिसके माध्यम से आप ब्लॉक्स प्रदर्शित कर सकें, तो इसके लिए आपको निम्नलिखित करना होगा:

• theme.info.yml फ़ाइल में क्षेत्र (region) की जानकारी जोड़ें
• page.html.twig को संपादित करें और उसमें नए क्षेत्र का आउटपुट जोड़ें

drupalbook.info.yml फ़ाइल में क्षेत्र (Region) डेटा जोड़ें

सभी क्षेत्र (regions) को regions कुंजी के अंतर्गत परिभाषित किया जाता है:

# Regions
regions:
  header: 'Header'
  content: 'Content'
  footer: 'Footer'

क्षेत्र का मशीन नाम (machine name) केवल अक्षरों और अंकों से बना होना चाहिए — आप अंडरस्कोर (_) का उपयोग भी कर सकते हैं, जैसे PHP वेरिएबल्स में किया जाता है। पठनीय नाम (readable name) को उद्धरण चिह्नों (" ") में या बिना लिख सकते हैं (यदि उसमें स्पेस नहीं है), लेकिन एक समानता बनाए रखने के लिए हमेशा उद्धरण चिह्नों का उपयोग करना बेहतर होता है।

पठनीय नाम एडमिन पैनल में प्रदर्शित होता है, जबकि मशीन नाम page.html.twig टेम्पलेट में उपयोग किया जाता है।

page.html.twig में क्षेत्र का आउटपुट जोड़ें

सभी क्षेत्रों का आउटपुट page वेरिएबल में होता है। किसी विशेष क्षेत्र को प्रदर्शित करने के लिए, आपको page वेरिएबल का वह भाग प्रदर्शित करना होगा जो उस क्षेत्र से संबंधित है। उदाहरण के लिए, हमारे पास एक header क्षेत्र है:

header: 'Header'

इसलिए, हम इसके मशीन नाम header का उपयोग करते हैं:

{{ page.header }}

आप अपनी theme.info.yml फ़ाइल में दिए गए किसी भी क्षेत्र को page.html.twig टेम्पलेट में कहीं भी आउटपुट कर सकते हैं।

Drupal के मानक क्षेत्र (Standard Drupal Regions)

आप हमेशा आधिकारिक दस्तावेज़ का संदर्भ ले सकते हैं: page.html.twig

page.header: आपकी साइट का हेडर प्रदर्शित करता है।
page.primary_menu: साइट का मुख्य मेनू प्रदर्शित करता है।
page.secondary_menu: अतिरिक्त मेनू प्रदर्शित करता है।
page.highlighted: कंटेंट के ऊपर जानकारी प्रदर्शित करता है।
page.help: सहायता जानकारी प्रदर्शित करता है।
page.content: साइट सामग्री प्रदर्शित करने के लिए आवश्यक क्षेत्र।
page.sidebar_first: पहला साइडबार।
page.sidebar_second: दूसरा साइडबार।
page.footer: साइट का फुटर।
page.breadcrumb: साइट के नेविगेशन ब्रेडक्रंब्स।

आप Drupal के मानक क्षेत्रों का उपयोग कर सकते हैं या अपने खुद के क्षेत्र जोड़ सकते हैं। सबसे महत्वपूर्ण बात यह है कि क्षेत्र का नाम page.html.twig में उसके स्थान से मेल खाना चाहिए।