HTML अनुभाग टेम्पलेट को व्यक्तिगत रूप से अनुकूलित करें

ट्यूटोरियल की आवश्यकताएँ और लक्ष्य

आपको HTML-Editor और Datei-Manager के साथ bluetronix CMS पर पहुँच की आवश्यकता है और टेम्पलेट फ़ोल्डर के लिए उपयुक्त डेवलपर अधिकार हैं। इस ट्यूटोरियल में आप सीखेंगे कि आप मौजूदा पृष्ठ अनुभागों को कैसे समायोजित करते हैं, अपने स्वयं के HTML सेक्शन टेम्पलेट्स कैसे बनाते हैं और आवश्यकता पड़ने पर अपने संपादकों को केवल अनुमोदित टेम्पलेट्स प्रदान करते हैं।

हम उदाहरण टेम्पलेट Clients और Banner के साथ काम कर रहे हैं। मानक फ़ाइलें अपरिवर्तित रहती हैं; व्यक्तिगत परिवर्तन _own चिह्न के माध्यम से किए जाते हैं।

1. संपादक में पृष्ठ अनुभाग टेम्पलेट्स ढूंढें

एक मौजूदा CMS पृष्ठ खोलें, संपादित करें चुनें और संविधान → पृष्ठ अनुभाग के माध्यम से टेम्पलेट चयन खोलें। संदर्भ मेनू में छोटे पुन: प्रयोग करने योग्य सामग्री के लिए टेक्स्ट-ब्लॉक का विकल्प भी है। यह ट्यूटोरियल पहले पृष्ठ अनुभागों को कवर करेगा।

पृष्ठ अनुभाग विंडो में उपलब्ध टेम्पलेट्स का पूर्वावलोकन दिखाया जाता है।

उदाहरण के लिए Clients श्रेणी का चयन करें। वहाँ विभिन्न लेआउट विकल्प उपलब्ध हैं।

2. टेम्पलेट्स कहां सहेजे जाते हैं

टेम्पलेट फ़ाइलें डेवलपर फ़ोल्डर /bx_Layout/ में हैं। Datei-Manager में इस फ़ोल्डर को खोलें। वहाँ आप पृष्ठ अनुभागों के लिए फ़ाइलें (Section*.txt) और टेक्स्ट ब्लॉक (Tag*.txt) सहित अन्य फ़ाइलें पाएंगे।

फ़ाइल का नाम चयन के साथ असाइनमेंट निर्धारित करता है। एक पृष्ठ अनुभाग टेम्पलेट हमेशा Section से शुरू होता है; इसके बाद उसका व्यक्तिगत नाम आता है। अपने संस्करणों के लिए फ़ाइल एक्सटेंशन से पहले _own उपसर्ग का उपयोग किया जाता है।

आप पूरी तरह से नया टेम्पलेट भी बना सकते हैं। इसके लिए आप Section के पीछे एक अपना नाम चुनते हैं। यदि समान नाम की कोई मानक फ़ाइल मौजूद नहीं है, तो नया टेम्पलेट अतिरिक्त रूप से प्रकट होता है, बजाय इसके कि कोई मौजूदा टेम्पलेट को बदल सके।

3. क्यों आपको मानक फ़ाइलों में सीधे संपादन नहीं करना चाहिए

CMS के साथ वितरित मानक फ़ाइलें /bx_Layout/ में सिस्टम अपडेट के दौरान ओवरराइट हो जाती हैं। इसीलिए SectionClients.txt या SectionBanner.txt पर सीधे परिवर्तन स्थायी नहीं होते। इच्छित मानक फ़ाइल की कॉपी करें और अपने संस्करण को _own के साथ चिह्नित करें। संबंधित _own संस्करण आपकी व्यक्तिगत, अद्यतन-सबूत समायोजन के लिए हैं।

SectionClients.txt
        ↓ kopieren
SectionClients_own.txt

यदि दोनों फ़ाइलें मौजूद हैं, तो CMS उपयुक्त SectionClients_own.txt का उपयोग मानक टेम्पलेट SectionClients.txt के बजाय करेगा। इसके लिए आपको संपादक में Clients श्रेणी का नाम बदलने की आवश्यकता नहीं है।

हालांकि, यदि आप एक नए नाम के तहत अपना फ़ाइल बनाते हैं, जैसे SectionMyTemplate_own.txt, तो मानक टेम्पलेट Clients भी उपलब्ध रहेगा।

4. HTML सेक्शन टेम्पलेट का ढांचा: विभाजन चिन्ह

एक सेक्शन फ़ाइल एक ही श्रेणी के लिए कई लेआउट विकल्प रख सकती है। ताकि CMS संपादक अलग-अलग विकल्पों को पहचान सके, उन्हें निम्नलिखित विभाजन चिह्न द्वारा अलग किया जाता है:

<!--__SP_SectionTemplate__-->

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

मानक टेम्पलेट SectionBanner.txt इस सिद्धांत को कई अलग-अलग बैनर लेआउट के साथ दिखाता है। आप इसे अपने सरल सेक्शन के लिए आधार के रूप में उपयोग कर सकते हैं।

<!--__SP_SectionTemplate__-->
<Section class="section py-5 py-lg-6">
   <div class="container py-3">
      <div class="row align-items-center g-4">
         <div class="col-lg-8 wow fadeInLeft">
            <span class="badge text-bg-warning mb-3">&#x00AD;New&#x00AD;</span>
            <h2 class="mb-2">&#x00AD;Designed for everyday success&#x00AD;</h2>
            <p class="mb-0">&#x00AD;Explore practical solutions created to make everyday work easier, clearer and more effective.&#x00AD;</p>
         </div>
         <div class="col-lg-4 text-lg-end wow fadeInRight">
            <a href="#"><button class="btn btn-light btn-lg">&#x00AD;Learn more&#x00AD;</button></a>
         </div>
      </div>
   </div>
</Section>
<!--__SP_SectionTemplate__-->

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

कक्षा sectionAll को आपको स्वयं जोड़ने की आवश्यकता नहीं है: bluetronix संपादक इसे पृष्ठ अनुभाग सम्मिलित करते समय स्वचालित रूप से जोड़ता है।

5. ग्राहकों का टेम्पलेट कॉपी करें और शीर्षक बदलें

फाइल प्रबंधक में मौजूदा SectionClients टेम्पलेट खोलें और इसके HTML कोड को देखें। हमारे उदाहरण में, इसमें एक शीर्षक, एक वर्णन और कई भागीदार टाइलें शामिल हैं।

उपयुक्त टेम्पलेट को SectionClients_own.txt के रूप में कॉपी करें और कॉपी को संपादित करें के जरिए खोलें। हमारे परीक्षण के लिए शीर्षक में NEW!!!! चिन्ह जोड़ें। आप टेक्स्ट, कार्ड की संख्या, प्रतीक या CSS को भी व्यक्तिगत रूप से बदल सकते हैं।

<!-- Vorher -->
<h2>&#x00AD;Trusted by growing organizations&#x00AD;</h2>

<!-- Nachher in SectionClients_own.txt -->
<h2>&#x00AD;NEW!!!! Trusted by growing organizations&#x00AD;</h2>

सहेजें पर क्लिक करें और फिर पुनः सम्मिलित करें → पृष्ठ-सेक्शन → Clients चयन को खोलें। वहां आप बदले गए शीर्षक से अपनी संस्करण को पहचान सकते हैं। दूसरी Clients-विकल्प का चयन और संपादन स्वतंत्र रूप से किया जा सकता है।

6. नए नाम से अपना टेम्पलेट पेश करें

आप एक समान नाम की प्रतिस्थापन फ़ाइल के बजाय एक अलग टेम्पलेट भी बना सकते हैं। इसके लिए एक Clients विकल्प की कॉपी करें और इसे SectionMyTemplate_own.txt के रूप में सहेजे। Section के पीछे वाला भाग आपका टेम्पलेट नाम है; यह संपादक में नए चयन को निर्धारित करता है। मूल Clients टेम्पलेट एक अन्य नाम के साथ प्रतिस्थापित नहीं किया जाएगा।

SectionClients.txt          → Standard: Clients
SectionClients_own.txt      → eigene Version von Clients
SectionMyTemplate_own.txt   → zusätzliche eigene Vorlage MyTemplate

इस प्रकार आप एक ग्राहक के लिए विशिष्ट पृष्ठ प्रकारों के लिए निर्धारित अनुभाग विकसित कर सकते हैं, बिना सभी प्रदान किए गए टेम्पलेट्स की सामग्री को बदलने की आवश्यकता के।

7. Only_own.txt के साथ केवल अपने स्वयं के टेम्पलेट दिखाएं

यदि अंतिम ग्राहक को केवल आपके अनुमोदित टेम्पलेट्स का उपयोग करना चाहिए, तो /bx_Layout/ फ़ोल्डर में Only_own.txt फ़ाइल बनाएं। प्रदर्शित टेम्पलेट कॉन्फ़िगरेशन के अनुसार, केवल उसी प्रकार की स्वच्छ फ़ाइलें पेश की जाएंगी जिनका उपसर्ग _own है। इस फ़ाइल के लिए इस कार्यक्षमता में कोई HTML कोड की आवश्यकता नहीं होती है।

/bx_Layout/Only_own.txt

उदाहरण: यदि SectionClients.txt, SectionBanner.txt और SectionMyTemplate_own.txt फ़ोल्डर में हैं, तो इस सेटिंग को सक्रिय करने के बाद चयन केवल उपयुक्त अपना टेम्पलेट होना चाहिए। इससे आप ग्राहक को एक लक्षित, परियोजना-आधारित चयन प्रदान कर सकते हैं।

8. टेक्स्ट ब्लॉक के लिए अपने टैग टेम्पलेट्स बनाएं

समान _own सिद्धांत छोटे पाठ-कट्स के लिए भी लागू होता है। उनकी फ़ाइलें Tag से शुरू होती हैं। TagTemplate.txt से TagTemplate_own.txt बनता है। इस विकल्प को आप संपादक में पाठ-कट प्रविष्टि के माध्यम से उपलब्ध करा सकते हैं।

TagTemplate.txt
        ↓ kopieren
TagTemplate_own.txt

9. संपाद्य स्तंभों को colAll के साथ डुप्लिकेट करें

यदि एक सेक्शन में कई पुनरावृत्त स्तंभ हैं, तो एक स्तंभ कक्षा colAll के साथ एक व्यक्तिगत खंड के रूप में पहचाना जा सकता है। इससे संदर्भ मेनू में लेख-स्तंभ → दोहराएँ कार्यक्षमता उपलब्ध है।

<div class="colAll col-md-6">
   <h2>&#x00AD;Hello world&#x00AD;</h2>
   <p>&#x00AD;Writing&#x00AD;</p>
</div>

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

10. टेक्स्ट मार्कअप और बहुभाषी टेम्पलेट्स

प्रदान किए गए मानक सेक्शन में उदाहरण पाठ के भीतर ­ स्ट्रिंग होती है, उदाहरण के लिए शीर्षकों से पहले और बाद में। ये पाठ चिह्न नहीं होते हैं जो विभाजन चिह्न <!--__SP_SectionTemplate__--> के साथ भ्रमित हो सकते हैं। मौजूदा टेम्पलेट को कॉपी करते समय, यदि पहले से मौजूद संपादक व्यवहार को बनाए रखना है, तो ऐसी CMS चिह्नों को पहले बनाए रखना चाहिए।

<h2>&#x00AD;Designed for everyday success&#x00AD;</h2>

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

11. अपने फ़ंक्शन और आवश्यक शामिल करें

यदि आप एक टेम्पलेट को PHP फ़ंक्शन या मोड्यूल के आउटपुट से विस्तारित करते हैं, तो अपनी फ़ंक्शनों के लिए अद्वितीय नामों का उपयोग करें। एक मौजूदा फ़ंक्शन को उसी नाम से फिर से घोषित नहीं किया जा सकता है। आप उदाहरण के लिए function_exists() के साथ घोषणा की सुरक्षा कर सकते हैं:

if(!function_exists("MyTestFunction")) {
   function MyTestFunction($Test) {
      return $Test;
   }
}

आवश्यक शामिल को प्रत्येक अनुभाग में कम से कम एक बार शामिल किया जाना चाहिए। एक संबंधित शामिल मार्कर को संपादक के माध्यम से कॉपी किया जा सकता है:

<!--bxInclude--/bx_Mod/Blog_Detail-->

आंतरिक टेम्पलेट फ़ाइलें जिनकी समाप्ति .txt या .bx है, निर्धारित सीएमएस सर्वर कॉन्फ़िगरेशन में सार्वजनिक HTTP/HTTPS URL के माध्यम से सीधा पुकारने के लिए नहीं बनाई गई हैं। इन्हें सर्वर द्वारा पढ़ा और संसाधित किया जाता है।

12. क्यों सीमित टेम्पलेट संपादकीय टीमों के लिए उपयोगी होते हैं

अपने अनुभागों और Only_own.txt के साथ आप यह निर्धारित करते हैं कि अंतिम उपयोगकर्ता कौन से तैयार लेआउट घटक चुन सकता है। इसके अलावा उपयोगकर्ता सेटिंग में संपादक की सुविधाओं जैसे फ़ॉन्ट या रंग परिवर्तन को सीमित किया जा सकता है। संपादक फिर विशेष रूप से निर्दिष्ट अनुभाग डाल सकते हैं, टेक्स्ट संपादित कर सकते हैं और छवियों को बदल सकते हैं, बिना निर्धारित पृष्ठ डिज़ाइन को स्वतंत्र रूप से बनाए बिना।

यह कार्यप्रणाली विशेषकर बड़े ग्राहक परियोजनाओं,企业 पोर्टल और कई संपादकों वाली टीमों के लिए उपयुक्त है। डिज़ाइन समान रहता है, जबकि सामग्री लचीले ढंग से रखी जा सकती है।

13. परिणाम और सारांश

आप /bx_Layout/ खोलते हैं, एक मौजूदा अनुभाग फ़ाइल की नकल करते हैं, _own जोड़ते हैं, HTML कोड को समायोजित करते हैं और डालें → पृष्ठ- अनुभाग के अंतर्गत आउटपुट की जांच करते हैं। नई चयन श्रेणियों के लिए, आप एक स्वयं के फ़ाइल नाम का उपयोग करते हैं, जो Section से शुरू होता है।

SectionClients.txt
       ↓ kopieren
SectionClients_own.txt
       ↓ HTML und Texte bearbeiten
<!--__SP_SectionTemplate__-->
       ↓ Varianten im Editor
Einfügen → Seiten-Abschnitt → Clients

यदि आप Only_own.txt को सक्रिय करते हैं और संपादक की अधिकारों को उचित रूप से सीमित करते हैं, तो आपके संपादक लक्षित रूप से उपलब्ध HTML अनुभाग टेम्पलेट्स के साथ काम कर सकते हैं।