MODx: संसाधन, विखंडू और कुछ टीवी

मेरे एक दोस्त ने मुझसे पूछा कि टेम्प्लेट में किस तरह के टेलीविज़न का उपयोग किया जाता है, मैंने शाम तक सभी चीजों को स्थगित करने और इस लेख को लिखने का फैसला किया।
यह इस बारे में होगा कि MODx में क्या है, "कुक", "सेवा" और "उपभोग" कैसे बेहतर है।

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

लेख मुख्य रूप से क्रांति पर केंद्रित है और इसके सिंटैक्स में इसके पूर्ववर्ती से मुख्य अंतर को दर्शाता है, लेकिन पिछड़े संगतता के लिए मैं कभी-कभी विकास के साथ एनालॉग्स सम्मिलित करूंगा।

संसाधन (संसाधन)

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

4 प्रकार के संसाधन हैं:

• एक दस्तावेज़ सबसे आम संसाधन है, अनिवार्य रूप से एक वेबसाइट पेज है। बल्क में एक शीर्षक, एनोटेशन, लंबा पाठ, विभिन्न तिथियां, मेटा टैग और अतिरिक्त क्षेत्र (टीवी पैरामीटर) शामिल हैं;
• वेब-लिंक - एक बाहरी संसाधन या वेब पेज का लिंक;
• एक प्रतीकात्मक लिंक दूसरे संसाधन के लिए एक आंतरिक लिंक है;
• स्टेटिक रिसोर्स एक फाइल है।

प्रत्येक संसाधन में एक विशिष्ट पहचानकर्ता या "संसाधन पहचानकर्ता" भी होता है। यदि आप दो संसाधनों को लिंक करना चाहते हैं, तो आपको आईडी का उपयोग करना चाहिए। इस तरह, MODx एक लिंक जेनरेट करेगा, और आपको पेज का पता या एड्रेसिंग के प्रकार बदलने की चिंता नहीं करनी होगी।
इसके अलावा, एक टेम्पलेट प्रत्येक संसाधन को सौंपा जा सकता है; एक टेम्पलेट इस संसाधन के अतिरिक्त क्षेत्रों को परिभाषित कर सकता है।
संसाधन कंटेनर के रूप में कार्य कर सकते हैं और अन्य संसाधन शामिल कर सकते हैं। इस प्रकार साइट संरचना बनती है।

टेम्पलेट (टेम्पलेट)

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

2. < html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
3. < html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
4. < html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
5. < html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
6. < html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
7. < html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
8. < html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
9. < html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
10. < html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
11. < html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
12. < html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
13. < html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
14. < html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >
15. < html > < head > < title > [[*pagetitle]] < / title > < meta name = "description" content = "[[*description]]" / > < / head > < body > < h1 > [[*longtitle]] < / h1 > ID : [[*id]] < br / > : [[*introtext]] < br / > : [[*menutitle]] < hr / > [[*content]] < / body > < / html >

मापदंडों

संसाधन फ़ील्ड मान प्रदर्शित करने के लिए उपयोग किया जाता है।
कॉल निम्नानुसार किया जाता है:

विकास	क्रांति
[* क्षेत्र *]	[[* क्षेत्र]]

यहां प्रलेखन में खेतों की पूरी सूची पाई जा सकती है ।

टीवी मापदंडों

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

विकास	क्रांति
[* टीवी *]	[[* टीवी]]

टीवी मापदंडों का उपयोग उनके साथ मापदंडों को जोड़ने वाले विखंडू के रूप में किया जा सकता है। उदाहरण के लिए, यदि मान के साथ एक टीवी पैरामीटर 'इंट्रॉम्स' है:

1. हाय [[+ नाम]], आपके पास [[संदेश संदेश]] अपठित है।

तब आप कॉल करते समय इसे डेटा से भर सकते हैं:

1. [[* इंट्रोम्स? नाम = `ग्रिशा 'और संदेशकाउंट =` 123`]]

परिणाम:

1. हाय ग्रिशा, आपके पास 123 अपठित संदेश हैं।

आप आउटपुट में फ़िल्टर भी लगा सकते हैं, उदाहरण के लिए, इसलिए आप आउटपुट स्ट्रिंग की लंबाई 100 वर्णों तक सीमित कर सकते हैं:

1. [[* बायोमैसेज: लिमिट = `100`]]

फ़िल्टर की एक पूरी सूची यहां पाई जा सकती है । इसके अलावा, फिल्टर चंक्स और स्निपेट पर लागू किया जा सकता है।

टिप्पणियाँ

1. [[# टेम्प्लेट में टिप्पणियों को छोड़ने की अनुमति है, यह कोड जो उसके प्रतिपादन के बाद पृष्ठ से हटा दिया जाएगा। ]]

मात्रा (मात्रा)

चंक - स्थैतिक पाठ का एक टुकड़ा जो एक टेम्पलेट में एम्बेड किया जा सकता है, जिसे अन्य चंक में या स्निपेट में कहा जाता है। एक चंक में एक टेम्प्लेट के समान गुण होते हैं, सिवाय इसके कि इसमें टीवी पैरामीटर नहीं होते हैं और इसे सीधे एक संसाधन को नहीं सौंपा जा सकता है।
एक चंक में कोई निष्पादन योग्य कोड नहीं हो सकता है, लेकिन आप गतिशील सामग्री प्रदर्शित करने के लिए इसमें स्निपेट कह सकते हैं।
चंक को इस तरह कहा जाता है:

विकास	क्रांति
{{हिस्सा}}	[[$ चंक]]

आप पैरामीटर को चंक पर स्थानांतरित कर सकते हैं। उदाहरण के लिए, हम निम्नलिखित सामग्री के साथ एक हिस्सा बनाएंगे:

1. हाय, [[+ नाम]]। आपके पास [[messageCount]] बिना पढ़े संदेश हैं।

इस तरह के एक चाक को मापदंडों के साथ बुलाया जा सकता है जो बाद में इसके अंदर पारित हो जाएगा:

1. [[$ इंट्रो? & नाम ​​= `तुलसी` और संदेश = `12`]]

यह कोड आउटपुट करेगा:

1. हाय वसीली। आपके पास 12 अपठित संदेश हैं।

स्थिर डेटा के अलावा, अतिरिक्त और सामान्य संसाधन मापदंडों को चंक कॉल में रखा जा सकता है, उदाहरण के लिए इस तरह:

1. [[$ इंट्रो? & name = `[[* usersName]]` और संदेशकाउंट = `[[* messageCount]]`]

स्निपेट्स (स्निपेट)

स्निपेट - PHP कोड जिसे MODx टेम्पलेट के प्रसंस्करण के दौरान निष्पादित किया जाता है। उसके काम का परिणाम या तो उसके आउटपुट के स्थान पर, या प्लेसहोल्डर्स में, विशेष टैग हो सकते हैं जो यह निर्धारित करते हैं कि इन या उन परिणामों को कहां रखा जाए।

स्निपेट को इस तरह कहा जाता है:

विकास	क्रांति
[[स्निपेट]]	[[स्निपेट]]

प्लेसहोल्डर प्लेसमेंट:

विकास	क्रांति
[+ प्लेसहोल्डर +]	[[+ प्लेसहोल्डर]]

चूजों की तरह, आप स्निपेट के मापदंडों को पारित कर सकते हैं, उदाहरण के लिए इस तरह:

1. [[! वफ़ाइंडर? & startId = `0` और स्तर =` 1`]]

हस्तांतरित मापदंडों को तथाकथित डिफ़ॉल्ट मापदंडों (संपत्ति सेट) में वर्गीकृत किया जा सकता है, जो मापदंडों का एक गतिशील समूह है जिसे समूह के नाम को निर्दिष्ट करने के माध्यम से स्निपेट में स्थानांतरित किया जा सकता है।
स्निपेट की सेटिंग टैब पर प्रशासन पैनल में डिफ़ॉल्ट पैरामीटर सेट किए गए हैं। डिफ़ॉल्ट पैरामीटर भी चंक्स के लिए बनाया जा सकता है।
उदाहरण के लिए, पैरामीटर 'startId` = 0 और `level` = 1 के साथ एक समूह' मेनू 'बनाएं, फिर इस तरह से स्निपेट को कॉल करें:

1. [[! Wayfinder @ मेनू]]

यह समान होगा, क्योंकि मापदंडों को स्वचालित रूप से प्रतिस्थापित किया जाएगा:

1. [[! Wayfinder और startId = `0` और स्तर =` 1`]]

किसी भी डिफ़ॉल्ट सेटिंग को फिर से लिखा जा सकता है। निम्नलिखित उदाहरण में, `स्तर` पैरामीटर का मान, जो एक के बराबर है, 2 से बदल दिया जाएगा।

1. [[! Wayfinder @ मेनू? और स्तर = `2`]]

स्निपेट को कैश नहीं करने के लिए सिस्टम को बताने के लिए, आपको नाम के सामने एक विस्मयादिबोधक चिह्न जोड़ना होगा:

1. [ [ ! noCacheSnippet ] ]

टैग सिंटैक्स

प्रत्येक MODx क्रांति टैग में अन्य MODx टैग हो सकते हैं। कोड अधिक या कम पठनीय हो, इसके लिए इस तरह के सामान्य प्रारूप का पालन करने वाली कई पंक्तियों पर टैग कोड रखने की अनुमति है (ब्रैकेट में मेरी टिप्पणियाँ हैं जिन्हें आपको लिखने की आवश्यकता नहीं है) =):

2. [[(टैग खोलकर)
3. ! (वैकल्पिक, कैश प्रतीक को रोकते हैं)
4. एलिमेंटटोकन (वैकल्पिक, एक चरित्र जो पैरामीटर के प्रकार को निर्दिष्ट करता है, अगर यह स्निपेट नहीं है, $ = chunk, * = नियमित / अतिरिक्त संसाधन क्षेत्र, + = प्लेसहोल्डर, आदि)
5. तत्वनाम (तत्व नाम)
6. @propertyset (वैकल्पिक, संपत्तिसेट पहचानकर्ता)
7. : FilterName = `modifier`: ... (वैकल्पिक फिल्टर, एक या अधिक)
8. ? (वैकल्पिक, मापदंडों के साथ एक पंक्ति की शुरुआत को परिभाषित करता है)
9. & propertyName = `propertyValue` और ... (द्वारा अलग किए गए कोई भी वैकल्पिक पैरामीटर)
10. ]] (समापन टैग)

MODx टैग सिंटेक्स डैशबोर्ड

तत्त्व	विकास	क्रांति	उदाहरण
टीवी पैरामीटर	[* टेम्पलेटवर *]	[[* टेम्पलेट]]	[[* पगेटिल]]
टुकड़ा	{{हिस्सा}}	[[$ चंक]]	[[$ हैडर]]
स्निपेट (php कोड का एक टुकड़ा)	[[स्निपेट]]	[[स्निपेट]] या [[स्निपेट]]	[[GetResources]]
प्लेसहोल्डर	[+ प्लेसहोल्डर +]	[[+ प्लेसहोल्डर]]	[[+ modx.user.id]]
संसाधन लिंक	[~ लिंक ~]	[[~ लिंक]]	[[~ १३]]
सिस्टम सेटिंग्स	[(System_setting)]	[[++ system_setting]]	[[++ साइट_स्टार्ट]]

साधन

• MODx रूस
• आधिकारिक वेबसाइट
• प्रलेखन
• अनौपचारिक रूसी भाषी समुदाय MODx