👏🏼 👪 🈁 डेवलपर के लिए ऑर्चर्ड सीएमएस

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

शुरुआत

इसलिए, हम Orchard CMS के लिए IE9Pins मॉड्यूल पर काम करना जारी रखेंगे। पिछली बार, हमने व्यवस्थापक भाग के साथ अंत में रोक दिया - IE9 त्वरित कूद सूची से आइटम बनाने, संपादित करने और हटाने की क्षमता को जोड़ा। वास्तव में, हमने एक ऐसी सामग्री प्रकार के लिए CRUD को लागू किया जिसमें जंप सूची आइटम डेटा संग्रहीत करने के लिए एक ही भाग शामिल है।

कूद सूची - दृष्टिकोण

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

विजेट

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

सामग्री भाग

विजेट को सामग्री के एक साधारण टुकड़े की आवश्यकता होगी - जंप लिस्टपार्ट (जम्प लिस्टइमार्ट के साथ भ्रमित नहीं होना)। कोड काफी सरल है:

public class JumpListPart : ContentPart { } * This source code was highlighted with Source Code Highlighter .

इस भाग के लिए ड्राइवर में, प्रदर्शन विधि परिभाषित करें:

public class JumpListPartDriver : ContentPartDriver<Models.JumpListPart> { IContentManager contentManager; IJumpListService jumpListService; public JumpListPartDriver(IContentManager contentManager, IJumpListService jumpListService) { this .contentManager = contentManager; this .jumpListService = jumpListService; } protected override DriverResult Display(Models.JumpListPart part, string displayType, dynamic shapeHelper) { return ContentShape( "Parts_JumpList" , () => shapeHelper.Parts_JumpList( AllItems: jumpListService.Get())); } } * This source code was highlighted with Source Code Highlighter .

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

string items = string .Empty; var itemsArray = (jumpListService.Get() as IEnumerable <JumpListItemPart>).ToArray(); items = "[" + string .Join( "," , itemsArray.Select(i => "{name: '" + i.Name + "',url: '" + i.Url + "', iconUrl: '" + i.IconUrl + "'}" )) + "]" ; * This source code was highlighted with Source Code Highlighter .

और, वास्तव में, व्यू में इस एरे के लिए लिस्ट एलिमेंट्स बनाना:

<script type= "text/javascript" > var items = @( new MvcHtmlString(Model.JsArray)) var isPinnedSiteMode = window.external && "msIsSiteMode" in window.external && window.external.msIsSiteMode(); if (isPinnedSiteMode) { window.external.msSiteModeCreateJumplist( 'Tasks' ); window.external.msSiteModeClearJumplist(); for (i = items.length - 1; i >= 0; i--) { window.external.msSiteModeAddJumpListItem(items[i].name, items[i].url, items[i].iconUrl); } window.external.msSiteModeShowJumplist(); } </script> * This source code was highlighted with Source Code Highlighter .

प्रवास

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

public int UpdateFrom1() { ContentDefinitionManager.AlterTypeDefinition( "InternetExplorerPins" , cfg => cfg .WithPart( "JumpListPart" ) .WithPart( "WidgetPart" ) .WithPart( "CommonPart" ) .WithSetting( "Stereotype" , "Widget" )); return 2; } * This source code was highlighted with Source Code Highlighter .

UpdateFrom1 - यह संस्करण 1 से अपडेट करने के लिए निर्देश है। रिटर्न 2 - माइग्रेशन के बाद किस संस्करण का मूल्य निर्धारित किया जाना चाहिए। सामग्री प्रकार का वर्णन स्वयं सरल है - हम सामग्री के कुछ हिस्सों को जोड़ते हैं जंपलिस्ट, विडगार्टपार्ट - यह हमारे विजेट को पेज पर और ब्लॉक में अपनी स्थिति को कॉन्फ़िगर करने की क्षमता को जोड़ देगा और महत्वपूर्ण बिंदु सेटिंग विस्सेटिंग ("स्टीरियोटाइप", "विजेट") है - यह सामग्री प्रकार सूची में दिखाई देगा। उपलब्ध विगेट्स।
मॉड्यूल अद्यतन
सब कुछ तैयार है - सभी का निर्माण, सफलतापूर्वक। अब हम साइट व्यवस्थापक पैनल खोलते हैं - और ऑर्चर्ड हमें एक अधिसूचना के साथ बधाई देता है कि IE9Pins मॉड्यूल के लिए अपडेट उपलब्ध हैं।

मॉड्यूल पर जाएं:

हम अपडेट का चयन करते हैं, निश्चित रूप से, और प्रतीक्षा के कुछ सेकंड के बाद हम एक संदेश देखते हैं कि सब कुछ सफलतापूर्वक अपडेट किया गया है, चीयर्स।

विजेट प्लेसमेंट

लेकिन जबकि विजेट केवल सिस्टम में पंजीकृत है, इसे अभी तक पृष्ठों में नहीं जोड़ा गया है। व्यवस्थापक पैनल में, विजेट आइटम पर जाएं, एक नया जोड़ें - और यहां यह है, हमारा InternetExplorerPins।

जोन में जोड़ें का चयन करें:

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

संदर्भ

1) लेख का पहला भाग (वहाँ आप कई उपयोगी लिंक पा सकते हैं)
2) BitBucket सोर्स कोड

डेवलपर के लिए ऑर्चर्ड सीएमएस - भाग 2