CMS-मॉड्यूल को शामिल करना और अनुकूलित करना

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

इस ट्यूटोरियल के लिए आपको bluetronix CMS पर डेवलपर एक्सेस की आवश्यकता है। आपको पहले से ही जानना चाहिए कि डेवलपर फ़ोल्डर कैसे काम करते हैं और क्यों अपने फ़ाइलों को सिस्टम फ़ोल्डरों में _own के साथ चिह्नित किया जाता है।

हम मौजूदा समाचार - ब्लॉग मॉड्यूल का उदाहरण लेते हैं। आप मॉड्यूल सक्रिय करते हैं, इसकी सूची दृश्य को CMS-पृष्ठ में शामिल करते हैं और फिर एक लक्षित अपने मॉड्यूल फ़ाइल और कॉन्फ़िगरेशन को अनुकूलित करते हैं। इस प्रक्रिया में मूल फ़ाइलें अपरिवर्तित रहती हैं।

1. ब्लॉग-मॉड्यूल सक्रिय करें

CMS में मॉड्यूल खोलें और समाचार - ब्लॉग चुनें।

ब्लॉग मॉड्यूल सक्रिय करें विकल्प को सक्रिय करें और सुरक्षा प्रश्न का उत्तर OK के साथ पुष्टि करें।

इसके बाद आपको मॉड्यूल कॉन्फ़िगरेटर उपलब्ध होगा। बाईं ओर तकनीकी सेटिंग्स हैं, दाईं ओर भाषा-निर्भर मॉड्यूल पाठ।

2. CMS पृष्ठ में ब्लॉग सूची को सम्मिलित करना

पृष्ठ /Blog/index.html खोलें और HTML कोड चुनें। ब्लॉग-पृष्ठ को एक संक्षिप्त CMS-मिश्रण के माध्यम से शामिल किया जाएगा।

<!--bx_Mod/Blog/Modul-Blog-List-->

यह मिश्रण ब्लॉग-मॉड्यूल और इसकी सूची दृश्य पर संदर्भित करता है। CMS इस स्थान पर मॉड्यूल का उत्पादन आउटपुट डालता है।

3. फ़ाइल प्रबंधक में केंद्रीय मॉड्यूल फ़ाइलें खोलें

मॉड्युल की वास्तविक PHP और HTML लॉजिक पृष्ठ-HTML में सीधे नहीं है, बल्कि केंद्रीय सिस्टम फ़ोल्डर bx_Mod में है। पहले इस फ़ोल्डर को फ़ाइल प्रबंधक में खोलें और फिर उप-फ़ोल्डर ब्लॉग खोलें।

ब्लॉग फ़ोल्डर में आप उदाहरण के लिए Modul-Blog-List.php, Modul-Blog-ShowCase.php, config.php, अन्य मॉड्यूल फ़ाइलें और उप-फ़ोल्डर languages पाएँगे।

4. ब्लॉग सूची की मानक फ़ाइल देखें

Modul-Blog-List.php का चयन करें और इसे संपादित करें के माध्यम से खोलें।

डिफ़ॉल्ट फ़ाइल में सूचियों के दृश्य के लिए प्रोग्राम लॉजिक है। दिखाए गए कोड में, अन्य चीजों के अलावा, मॉड्यूल कॉन्फ़िगरेशन और, यदि उपलब्ध हो, परियोजना-विशिष्ट config_own.php शामिल हैं।

इससे एक ही मॉड्यूल इंक्लूज़न विभिन्न पृष्ठों पर समान केंद्रीय प्रोग्राम लॉजिक का उपयोग कर सकता है। जो प्रोजेक्ट डिफ़ॉल्ट मॉड्यूल का उपयोग करते हैं, उनके लिए बाद के CMS अपडेट इस फ़ाइल में परिवर्तन उपलब्ध कराते हैं।

मूल Modul-Blog-List.php को सीधे संपादित न करें। यह सिस्टम का हिस्सा है और CMS अपडेट होने पर यह अधिलेखित हो सकता है।

5. _own के साथ अपनी सूची का दृश्य बनाएं

आउटपुट को स्वयं बदलने के लिए, आप डिफ़ॉल्ट फ़ाइल की कॉपी बनाते हैं। अपनी कॉपी को बिल्कुल सही _own टैग प्राप्त होता है:

Modul-Blog-List.php
        ↓ kopieren
Modul-Blog-List_own.php

नई फ़ाइल Modul-Blog-List_own.php खोलें। इस परियोजना-विशिष्ट संस्करण में, आप PHP लॉजिक और HTML आउटपुट को बदल सकते हैं, बिना डिफ़ॉल्ट फ़ाइल को छुए।

हमारे परीक्षण में, हम शीर्षक में स्पष्ट रूप से दिखाई देने वाला स्ट्रिंग NEW!!!! जोड़ते हैं। शेष सूची का दृश्य सुरक्षित रहता है।

अपनी मॉड्यूल फ़ाइल को सहेजें और ब्लॉग पृष्ठ को फिर से लोड करें। CMS उपयुक्त _own संस्करण का उपयोग करता है, जबकि /Blog/index.html में प्लेसहोल्डर अपरिवर्तित रहता है। आप परिवर्तन किए गए शीर्षक NEW!!!! न्यूज़ आर्टिकल से सक्रिय अपनी फ़ाइल को पहचानते हैं।

6. मॉड्यूल सेटिंग्स और अपनी कॉन्फ़िगरेशन

HTML आउटपुट के साथ-साथ, आप मॉड्यूल की कॉन्फ़िगरेशन भी बदल सकते हैं। स्क्रीनशॉट में उदाहरण के लिए Modul-Blog-ShowCase के लिए कॉन्फ़िगरेटर में DS Repeats = 3 दिखाया गया है।

मान को 2 पर बदलें और सेटिंग को सहेजें। इससे इस शोकेस क्षेत्र के लिए वांछित संख्या निर्धारित होती है। यह सेटिंग Modul-Blog-ShowCase पर लागू होती है और इसे ब्लॉग सूची दृश्य के सभी लेखों की संख्या के समान नहीं माना जाना चाहिए।

अपनी कॉन्फ़िगरेशन bx_Mod/Blog/config_own.php के तहत है। फ़ाइल प्रबंधक में इस फ़ाइल का चयन करें।

दिखाई गई config_own.php मूल्य को केवल तभी अधिलेखित करती है जब संबंधित मॉड्यूल क्षेत्र Modul-Blog-ShowCase लोड किया जाता है:

if($ModulNameGB == "Modul-Blog-ShowCase") {
   $CF_DS_Repeats = 2;
}

डिफ़ॉल्ट मान अभी भी config.php से आते हैं। इसलिए एक अपनी कॉन्फ़िगरेशन फ़ाइल में सभी डिफ़ॉल्ट मानों को पुनः अपेक्षित नहीं है, बल्कि केवल वांछित भिन्नताएँ होनी चाहिए।

7. डेटाबेस तालिका और मॉड्यूल पृष्ठ निर्धारित करें

डिफ़ॉल्ट कॉन्फ़िगरेशन bx_Mod/Blog/config.php में आपको उपयोग की गई डेटाबेस तालिका और विवरण और सूची दृश्य के पथ मिलेंगे। दिखाए गए उदाहरण में मान इस प्रकार हैं:

$CF_DatabaseTable = "Blog";

$CF_DetailPage = "/Blog/Detail.html";
$CF_ListPage = "/Blog/index.html";

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

8. मॉड्यूल की भाषा फ़ाइलें

bx_Mod/Blog/languages के तहत ब्लॉग मॉड्यूल की भाषा फ़ाइलें हैं। मौजूदा भाषाओं के लिए अलग PHP फ़ाइलें हैं, जैसे de.php, en.php और fr.php।

यहाँ भाषाई मॉड्यूल टेक्स्ट प्रबंधित किए जाते हैं। परियोजना-विशिष्ट परिवर्तनों के लिए अपनी मॉड्यूल संस्करण द्वारा समर्थित अपनी फ़ाइल प्रारूप का उपयोग करें, बजाय मूल भाषा फ़ाइलों को सीधे अधिलेखित करने के।

9. मानक मॉड्यूल और अपनी संस्करण में अंतर करें

_own नियम आपकी समायोजनों को नियमित अपडेट के माध्यम से अधिलेखित होने से बचाता है। इसी समय, आप इस व्यक्तिगत संस्करण के रखरखाव के लिए स्वयं जिम्मेदार हैं। बाद के CMS अपडेट के दौरान जांचें कि क्या मानक फ़ाइल में महत्वपूर्ण परिवर्तन आपकी अपनी फ़ाइल के लिए भी प्रासंगिक हैं।

10. संक्षेप में

आप ब्लॉग मॉड्यूल को Module → News - Blog के तहत सक्रिय करते हैं, सूची दृश्य को CMS मार्किंग के माध्यम से शामिल करते हैं और वास्तविक प्रोग्राम लॉजिक को bx_Mod/Blog के तहत केंद्रीय रूप से प्रबंधित करते हैं। अपनी परिवर्तनों के लिए, आप Modul-Blog-List.php को Modul-Blog-List_own.php में कॉपी करते हैं। जो सेटिंग मानक से भिन्न होती हैं, उन्हें आवश्यकता होने पर config_own.php में रखा जाता है।

CMS-Seite /Blog/index.html
        ↓ Modul-Markierung
bx_Mod/Blog/Modul-Blog-List.php
        ↓ passende _own-Datei vorhanden?
Modul-Blog-List_own.php
        ↓ Konfiguration und Datenbank
HTML-Ausgabe innerhalb der CMS-Seite

इस तरह एक मौजूद मॉड्यूल को लक्षित रूप से विस्तार किया जा सकता है, बिना मूल सिस्टम फ़ाइलों को बदले।