Drupal 8: एक Twig विषय प्राप्त करना

पिछले कुछ महीनों में अपने खाली समय में, मैं अपने Drupal विषय, Gratis ( मेरे द्वारा दिए गए लिंक ), Drupal 8 में बहुत व्यस्त रहा हूं। प्रक्रिया अच्छी तरह से चल रही है, और ज्यादातर चीजें पहले से ही काम करती हैं क्योंकि वे Drupal 7 में लागू होती हैं, लेकिन यह प्रक्रिया विफल हो गई दो मुख्य कारणों के लिए विषय वास्तुकला का एक कट्टरपंथी ओवरहाल:

1. Twig अब Drupal 8 के लिए थीमिंग का आधार है, PHP टेम्पलेट हैंडलर, जो कई वर्षों से Druapl के लिए मुख्य विषयों में से एक रहा है, छोड़ दिया है।
2. Drupal के हाल के प्रमुख संस्करणों की तरह, Drupal 8 के लिए एपीआई फिर से बदल गया है और यह सीधे प्रभावित करता है कि आप थीम के संदर्भ में कुछ कैसे करते हैं।

गोधूलि और टहनी

इस सब का क्या मतलब है? सबसे पहले, आप अब विषय में PHP कोड का उपयोग नहीं कर सकते हैं, यह सभी Twig है। टहनी थीमिंग को सरल बनाता है और समझने की सुविधा देता है। Drupal 8 में, पुराना टेम्प्लेट .php फ़ाइल अब आपकी थीम की .theme फ़ाइल बन जाती है, जिसमें विशेष PHP कोड होता है जो Twig वेरिएबल्स से ट्विग टेम्पलेट में प्रदान किया जाता है। ट्विग सिंटैक्स को समझना आसान है।
उदाहरण के लिए, page.tpl.php Drupal 7 में हमारे पास एक आधार कोड है जो एक क्षेत्र में एक ब्लॉक प्रदर्शित करता है:

<?php if (!empty($page['preface_first'])): ?> <?php print render($page['preface_first']); ?> <?php endif; ?> 

Twig और Drupal 8 के साथ, हमारे पेज. html.twig टेम्पलेट में, हम इसे इस तरह से कर सकते हैं:

 {% if page.preface_first %} {{ page.preface_first }} {% endif %} 

तो, जैसा कि आप देख सकते हैं, ट्विग के साथ "अधिक निप्पल कूल्हे" ( .tpl.php फाइलें) नहीं हैं। नाम .html.twig अब सभी थीम टेम्प्लेट के लिए स्थायी है। सामान्य तौर पर, टहनी चर को संसाधित करने के तरीके को बहुत सरल करती है। तो अब आपने कहाँ प्रयोग किया

 print render($page['some_var']) 

या

 print render($content['some_var']) 

अब बस उपयोग करें

 {{ page.some_var }} 

या बस

 {{ some_var }} 

उपयोग और स्थान के आधार पर।
यहाँ Drupal 8 में बदले गए प्रमुख फ़ाइल नामकरण परंपराएँ हैं:
Drupal 7> Drupal 8

• MYTHEME.info> MYTHEME.info.yml
• template.php> MYTHEME.theme
• template_name.tpl.php> template_name.html.twig

मुझे आश्चर्य हुआ कि थीम-सेटिंग्स। एफपी का नाम नहीं बदला गया था और यह किस तरह से हाथ से काम करता है। इसके अलावा, विषय-सेटिंग में बहुत ज्यादा बदलाव नहीं हुआ है। पीपीपी , यह आमतौर पर Drupal 7 से बिना बदलाव के काम करता है, हालांकि मुझे Drupal 8 के लिए API फ़ंक्शन system_theme_settings के विवरण के साथ एक पृष्ठ नहीं मिला।

टेम्प्लेट्स में एक और बड़ा बदलाव यह है कि एट्रिब्यूट्स ऑफ़ एट्रिब्यूट्स और क्लासेस को एक साथ मिलकर एक ऑब्जेक्ट ऑब्जेक्ट में मिला दिया गया है। शरीर, नोड्स और टिप्पणियों के लिए वैश्विक कक्षाओं और विशेषताओं को प्रस्तुत करने से पहले:

 class="<?php print $classes; ?>"<?php print $attributes; ?> 

... यदि आप शब्द को शब्द को ट्विग के लिए रूपांतरित करते हैं, तो आपको मिलता है:

 class="{{ classes }}"{{ attributes }} 

हालाँकि, यह काफी कारगर विकल्प नहीं है, वास्तव में, एक नए तरीके से इसे इस तरह घोषित किया जाता है:

 class="{{ attributes.class }}" {{ attributes }} 

संक्षिप्तता के लिए, आप बस यह कर सकते हैं:

 {{ attributes }} 

... विशिष्ट कक्षाओं के आउटपुट के बिना, यह एक चर सब कुछ करता है। मैं पहली विधि पसंद करता हूं, क्योंकि यह आपको अपनी खुद की थीम कक्षाएं टैग में सेट करने की अनुमति देता है, अगर आपको पसंद है, जैसे कि स्पष्ट या जो भी हो।

जानकारी विषय फ़ाइल

Drupal 8 में थीमिंग से संबंधित एक और महत्वपूर्ण परिवर्तन जानकारी फ़ाइल का डिज़ाइन है। अब इसे YAML शैली में डिज़ाइन किया गया है और सिम्फनी YAML घटक द्वारा विश्लेषण किया गया है। Drupal 7 के लिए जानकारी फ़ाइल बदलना बहुत मामूली था। मैंने बार्टीक में कार्यान्वयन पर एक नज़र डाली और इसे ग्रैटिस को बदलने के लिए पर्याप्त सीखने के लिए एक मार्गदर्शक के रूप में उपयोग किया। उदाहरण के लिए, पहले क्या हुआ था:

 ; Stylesheets stylesheets[all][] = css/style.css 

अब इस तरह दिखेगा:

 stylesheets: all: - css/style.css 

एक और समस्या जिसका मुझे सामना करना पड़ा जब ग्रैटीस को पोर्ट करना यह था कि नए ड्रुपल 8 व्यवस्थापक पैनल और ग्रैटिस के बीच बहुत सारे परस्पर विरोधी वर्ग मैच थे। ऐसा लगता है कि व्यवस्थापक पैनल थीमिंग के लिए कुछ बहुत ही सामान्य वर्गों का उपयोग करता है, जैसे कि ul.menu । अंत में, मैंने संघर्षों से बचने के लिए अपने विषय में अधिक विशिष्ट कक्षाएं बताईं।
सामान्य तौर पर, मुझे Drupal 8 में थीमिंग पर पूर्ण प्रलेखन नहीं मिला, मुझे यह समझने के लिए Drupal 8 के मुख्य विषयों की फाइलों में तल्लीन करना पड़ा कि यह सब कैसे काम करता है।

एपीआई बदल जाता है

Twig के लिए थीम टेम्प्लेट को बदलना बहुत तुच्छ है, कस्टम टेम्पलेट को अपडेट करना। MYTHEME.theme को कोड बहुत नहीं है। इन कार्यों के रूपांतरण का आधार यह है कि उनमें से कुछ की सिफारिश नहीं की जाती है, वे अभी भी काम करते हैं, लेकिन अंत में वे इसे छोड़ देंगे। अन्य फ़ंक्शन केवल काम नहीं करेंगे और त्रुटियों को फेंक देंगे, क्योंकि एपीआई उनके लिए बदल गया है - पूरी तरह से या नए कार्य हैं जिनके लिए उन्हें प्रतिस्थापित करने की आवश्यकता है। PhpStorm के Drupal 8 में चित्रित कार्यों का एक अच्छा दृश्य संकेतक है, यह वास्तव में बहुत सुविधाजनक है।

उदाहरण के लिए, drupal_add_js और drupal_add_css को पदावनत किया जाता है, इसलिए आपको अपने विषय के लिए कोई भी कस्टम JS जोड़ने के लिए #attached विधि का उपयोग करना होगा। ड्रुपल 8 अब बहुत "पतला" है, जिसका अर्थ है कि डिफ़ॉल्ट रूप से यह गुमनाम उपयोगकर्ताओं के लिए बहुत सारे जावास्क्रिप्ट को लोड नहीं करता है, इसलिए अब आपको jQuery.onon या यहां तक ​​कि drupal.js जैसी चीजों को लोड करने के लिए निर्भरता बनाने के लिए hook_library_info का उपयोग करना होगा।

पुनश्च
यह डैनी इंग्लैंडर के एक लेख का मेरा मुफ्त अनुवाद है - ड्रुपल 8 के लिए एक कंट्रीब्यूट थीम को पोर्ट करना: गेट ट्विग-गेटिंग विथ इट