ऑर्चर्ड सीएमएस एक्सटेंशन: विजेट बनाना

यह ऑर्चर्ड सीएमएस सामग्री प्रबंधन प्रणाली के आधार पर अपनी स्वयं की साइटों के विकास पर लेखों की एक श्रृंखला की एक निरंतरता है। इस श्रृंखला के पहले लेख निम्नलिखित लिंक पर देखे जा सकते हैं:

• Orchard CMS का उपयोग करके अपनी वेबसाइट को स्क्रैच से कैसे बनाएं। भाग 1. ऑर्चर्ड सीएमएस का परिचय
• Orchard CMS का उपयोग करके अपनी वेबसाइट को स्क्रैच से कैसे बनाएं। भाग 1. ऑर्चर्ड सीएमएस का परिचय (प्रतियोगिता)
• आर्किटेक्चर ऑर्चर्ड सीएमएस। मूल अवधारणाएँ
• आर्किटेक्चर ऑर्चर्ड सीएमएस। मूल अवधारणाएँ। लेआउट अवधारणाओं (प्रतियोगिता)
• आर्किटेक्चर ऑर्चर्ड सीएमएस। मूल अवधारणाएँ। सुरक्षा और विकास अवधारणा (प्रतियोगिता 2)
• ऑर्चर्ड सीएमएस एक्सटेंशन: सामग्री प्रकार बनाना

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

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

सामग्री निर्माण

सामग्री कार्यक्षमता या उपयोगकर्ता इंटरफ़ेस का एक छोटा सा टुकड़ा है जिसे ऑर्चर्ड में किसी भी प्रकार की सामग्री में जोड़ा जा सकता है। ऐसे भागों के उदाहरण: सामग्री आइटम तक पहुंचने की क्षमता के लिए एक मार्ग, सामग्री आइटम को टैग करने के लिए टैग, उपयोगकर्ता मेनू में सामग्री आइटम जोड़ने की क्षमता के लिए एक मेनू।

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

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

मैप के साथ एक नया कंटेंट पार्ट बनाना शुरू करने के लिए, ऑर्चर्ड प्रोजेक्ट डाउनलोड करें और इसे विजुअल स्टूडियो में खोलें।

Orchard कमांड प्रॉम्प्ट पर "codegen मॉड्यूल मैप्स / इनक्लूडिंग: ट्रू" टाइप करें। "इनकॉरसोल्यूशन" पैरामीटर ऑर्चर्ड को ऑर्चर्ड प्रोजेक्ट सूची में एक नया मॉड्यूल प्रोजेक्ट जोड़ने के लिए कहता है।



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

प्रोजेक्ट रूट में Module.txt फ़ाइल खोलें, इस फ़ाइल में आपके मॉड्यूल के बारे में कुछ जानकारी होती है, जैसे कि नाम, विवरण, संस्करण, लेखक और इस मॉड्यूल द्वारा प्रदान किए गए फ़ंक्शन का एक सेट। इस फ़ाइल में अतिरिक्त जानकारी भी होती है, जैसे कि निर्भरता जानकारी। डिफ़ॉल्ट रूप से बनाया गया मॉड्यूल बहुत सरल है और इसमें केवल एक फ़ंक्शन है, अतिरिक्त निर्भरता के बिना। मॉड्यूल को संपादित करें। इस प्रकार है:

 नाम: मैप्स 
 एंटीफॉगररी: सक्षम 
 लेखक: ऑर्चर्ड टीम 
 वेबसाइट: http://orchardproject.net 
 संस्करण: 1.0.0 
 OrchardVersion: 1.0.0 
 विवरण: देशांतर और अक्षांश के आधार पर, सामग्री वस्तुओं के लिए एक मानचित्र छवि जोड़ता है। 
 विशेषताएं: 
     मानचित्र: 
         विवरण: देशांतर और अक्षांश के आधार पर, सामग्री वस्तुओं के लिए एक मानचित्र छवि जोड़ता है। 
         श्रेणी: जियोलोकेशन </ span> 

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



ऑर्चर्ड में, सामग्री भाग को रिकॉर्ड क्लास द्वारा दर्शाया जाता है, जिसमें डेटाबेस और कॉन्टेंटपार्ट क्लास में संग्रहीत डेटा फ़ील्ड होते हैं, जो स्टोरेज के लिए रिकॉर्ड का उपयोग करता है। नीचे दिखाए अनुसार MapRecord (ContentPartRecord) और MapPart (ContentPart) कक्षाओं को जोड़ें:

  System.ComponentModel.DataAnnotations का उपयोग करना;
 Orchard.ContentManagement का उपयोग करना;
 Orchard.ContentManagement.Records का उपयोग करना;

 नेमस्पेस मैप्स.मॉडल्स {
     सार्वजनिक वर्ग MapRecord: ContentPartRecord {
         सार्वजनिक आभासी डबल अक्षांश {प्राप्त करें;  सेट;  }
         सार्वजनिक आभासी डबल देशांतर {प्राप्त करें;  सेट;  }
     }

     सार्वजनिक वर्ग MapPart: ContentPart <MapRecord> {
         [आवश्यक]
         सार्वजनिक डबल अक्षांश
         {
             {रिटर्न रिकॉर्ड प्राप्त करें। आभार;  }
             सेट {रिकॉर्ड.अनुपात = मान;  }
         }

         [आवश्यक]
         सार्वजनिक डबल देशांतर
         {
             {return record.ongitude प्राप्त करें;  }
             सेट {रिकॉर्ड.भारत = मान;  }
         }
     }
 } 

अब बिल्ड कमांड का उपयोग करके प्रोजेक्ट का निर्माण करें, ताकि यह सुनिश्चित हो सके कि कोई त्रुटि नहीं है।



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

डेटा माइग्रेशन क्लास बनाने के लिए, आप Orchard कोड जनरेशन फ़ंक्शन का उपयोग कर सकते हैं। कमांड लाइन पर कमांड "कोडजैन डेटामेन्ग्रेशन मैप्स" चलाएं।



विज़ुअल स्टूडियो फिर से आपको समाधान को फिर से लोड करने के लिए कहेगा। लोड होने के बाद, आपको प्रोजेक्ट में डेटा माइग्रेशन के लिए एक नया वर्ग मिलेगा।



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

  सिस्टम का उपयोग कर;
 System.Collections.Generic का उपयोग कर;
 System.Data का उपयोग करना;
 मैप्स का उपयोग करना।
 Orchard.ContentManagement.Drivers का उपयोग करना;
 Orchard.ContentManagement.MetaData का उपयोग कर;
 Orchard.ContentManagement.MetaData.Builders का उपयोग कर;
 Orchard.Core.Contents.Extensions का उपयोग कर;
 Orchard.Data.Migration का उपयोग करना;

 नामस्थान मैप्स। डेटाग्रिगेशन {
     सार्वजनिक वर्ग का पलायन: DataMigrationImpl {

         सार्वजनिक int बनाएँ () {
			 // तालिका MapRecord बनाना
			 SchemaBuilder.CreateTable ("MapRecord", तालिका => तालिका
				 .कंटेंटपार्टकार्ड ()
				 । कॉलम ("अक्षांश", DbType.Double)
				 । कॉलम ("देशांतर", DbType.Double)
			 );

             कंटेंटडिफाइनमेंट मैनजर। ऑल्टरपार्टडिफाइनमेंट (
                 typeof (MapPart)। नाम, cfg => cfg.Attachable ());

             वापसी 1;
         }
     }
 } 

AlterPartDefinition पर कॉल के साथ एक लाइन जोड़ी गई है ताकि हमारे द्वारा बनाई गई सामग्री का हिस्सा किसी भी प्रकार की सामग्री में शामिल हो सके। using Maps.Models; एक पंक्ति जोड़ने की आवश्यकता पर ध्यान दें using Maps.Models; विधानसभा को जोड़ने के लिए।

अब हमारे सामग्री भाग के लिए एक हैंडलर जोड़ें। एक ऑर्चर्ड हैंडलर एक ऐसा वर्ग है जो वेब पेज पर भाग को प्रस्तुत करने से पहले सामग्री भाग के व्यवहार को परिभाषित करता है, घटनाओं को संसाधित करता है, या डेटा मॉडल में हेरफेर करता है। चूँकि हमारे मानचित्र का सामग्री भाग बहुत सरल है, हमारी कक्षा डेटा तक पहुँचने के लिए संरचना के रूप में केवल IRepository <MapRecord> का उपयोग करेगी। निम्न सामग्री को हैंडलर \ MapHandler.cs फ़ाइल में जोड़ें:

  मैप्स का उपयोग करना।
 Orchard.ContentManagement.Handlers का उपयोग कर;
 Orchard.Data का उपयोग करना;

 नामस्थान मैप्सहैंडलर {
     सार्वजनिक वर्ग MapHandler: ContentHandler {
         सार्वजनिक MapHandler (IRepository <MapRecord> भंडार) {
             फिल्टर .dd (StorageFilter.For (रिपॉजिटरी));
         }
     }
 } 

इसके अलावा, हमें अपने सामग्री भाग के लिए एक ड्राइवर जोड़ने की आवश्यकता है। एक ऑर्चर्ड ड्राइवर एक ऐसा वर्ग है जो प्रत्येक संदर्भ में प्रदर्शित करने के लिए आकृतियों के रिश्तों को परिभाषित करता है जिसमें एक भाग प्रदर्शित किया जा सकता है। उदाहरण के लिए, जब कोई नक्शा किसी पृष्ठ पर प्रदर्शित होता है, तो प्रदर्शन विधि उस टेम्पलेट के नाम को निर्धारित करती है जो विभिन्न डिस्प्लेटाइप्स (उदाहरण के लिए, "विवरण" या "सारांश") के आधार पर प्रदर्शन के लिए उपयोग किया जाएगा।

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

  मैप्स का उपयोग करना।
 Orchard.ContentManagement का उपयोग करना;
 Orchard.ContentManagement.Drivers का उपयोग करना;

 नेमस्पेस मैप्सड्राइवर्स {
     सार्वजनिक वर्ग MapDriver: ContentPartDriver <MapPart> {
         संरक्षित ओवरराइड DriverResult डिस्प्ले (
             MapPart हिस्सा, स्ट्रिंग डिस्प्ले टाइप, डायनामिक शेप हेल्पर) {

             कंटेंटशैप ("Parts_Map", () => shape हेल्पर.पार्ट्स_पार्ट
                 देशांतर: भाग। देशांतर,
                 अक्षांश: भाग। अक्षांश));
         }

         // प्राप्त करें
         संरक्षित ओवरराइड DriverResult संपादक (
             MapPart हिस्सा, गतिशील आकार हेल्पर) {

             कंटेंटशैप वापस करें ("Parts_Map_Edit",
                 () => आकार
                     TemplateName: "पार्ट्स / मैप",
                     मॉडल: भाग,
                     उपसर्ग: उपसर्ग));
         }
         // पोस्ट
         संरक्षित ओवरराइड DriverResult संपादक (
             MapPart भाग, IUpdateModel updater, गतिशील आकार हेल्पर) {

             updater.TryUpdateModel (भाग, उपसर्ग, अशक्त, अशक्त);
             वापसी संपादक (भाग, आकार हेल्पर);
         }
     }
 } 

अब हम सामग्री भाग को देखने और संपादित करने के लिए दृश्य स्टूडियो का उपयोग कर सकते हैं। सबसे पहले मैप्स प्रोजेक्ट के व्यू फोल्डर में पार्ट्स और एडिटरटेम्पलेट / पार्ट्स फोल्डर जोड़ें। फिर प्रत्येक नाम / EditorTemplates / Parts फ़ोल्डर में एक ही नाम Maps.cshtml के तहत फाइलें जोड़ें:

  @model Maps

 <Fieldset>
   <किंवदंती> नक्शा फ़ील्ड </ किंवदंती>
            
   <div class = "editor-label">
     @ Html.LabelFor (मॉडल => मॉडल.लीट्यूड)
   </ Div>
   <div class = "editor-field">
     @ Html.TextBoxFor (model => model.Latitude)
     @ Html.ValidationMessageFor (model => model.Latitude)
   </ Div>

   <div class = "editor-label">
     @ Html.LabelFor (मॉडल => मॉडल। लॉन्गिट्यूड)
   </ Div>
   <div class = "editor-field">
     @ Html.TextBoxFor (model => model.Longitude)
     @ Html.ValidationMessageFor (model => model.Longitude)
   </ Div>
            
 </ Fieldset> 

और दृश्य / भागों निम्नलिखित सामग्री के साथ:

  <img alt = "स्थान" बॉर्डर = "1" src = "http://maps.google.com/maps/api/staticmap? 
      & ज़ूम = 14
      और आकार = 256x256
      & maptype = रोडमैप
      & मार्कर = रंग: नीला | @ Model.Latitude, @ Model.Longitude
      & सेंसर = गलत "/> 

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

  <प्लेसमेंट>
     <प्लेस Parts_Map = "सामग्री: 10" />
     <Place Parts_Map_Edit = "सामग्री: 7.5" />
 </ प्लेसमेंट> 

यह परिभाषा सिस्टम को बताती है कि Parts_Map आकृति (जो दृश्य / भाग / Maps.cshtml का उपयोग करके प्रदर्शित होती है) सामग्री क्षेत्र में प्रदर्शित होनी चाहिए, यदि यह मौजूद है, तो 10 स्थिति पर। इसके अलावा, यह संकेत दिया जाता है कि संपादक को दूसरी स्थिति में प्राथमिक क्षेत्र में प्रदर्शित किया जाना चाहिए।

मानचित्र के हमारे सामग्री भाग को सक्रिय करने के लिए, ऑर्चर्ड एडमिन पैनल में मॉड्यूल अनुभाग पर जाएं और इसे सक्षम करें।



आप ऑर्चर्ड एडमिन पैनल में "सामग्री प्रकार" अनुभाग का उपयोग करके सिस्टम में किसी भी प्रकार की सामग्री को जोड़कर सामग्री भाग का परीक्षण कर सकते हैं। आइए अपने कंटेंट पार्ट को एक मौजूदा कंटेंट टाइप में जोड़ते हैं, उदाहरण के लिए, इवेंट टाइप जिसे हमने पिछले आर्टिकल Orchard CMS एक्सटेंशन में बनाया था : कंटेंट टाइप्स बनाना ।

व्यवस्थापन पैनल के सामग्री प्रकार प्रबंधित करें पृष्ठ पर, सामग्री प्रकार परिभाषा को संपादित करने के लिए संपादित करें पर क्लिक करें।



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



अब, सामग्री अनुभाग प्रबंधित करें पर जाएं और सामग्री आइटम डेटा संपादित करें। कृपया ध्यान दें कि मानचित्र के सामग्री भाग ने स्वयं को मापदंडों की सूची में जोड़ दिया: अक्षांश और देशांतर। वर्तमान स्थान निर्देशांक दर्ज करें और सामग्री आइटम को पुनः प्रकाशित करें।



अब आपकी साइट के पृष्ठ पर आप किसी विशिष्ट घटना के लिए प्रदर्शित मानचित्र देख सकते हैं।

आप इस लिंक पर मैप के सामग्री भाग के साथ तैयार पैकेज डाउनलोड कर सकते हैं: Orchard.Module.Maps.1.0.0.nupkg । यह पैकेज स्थापित करने और उपयोग करने के लिए तैयार है और इसमें पूर्ण स्रोत कोड हैं।

सामग्री भाग को विजेट में बदलना

सामग्री भाग से तैयार विजेट प्राप्त करने के लिए, आपको अपने विजेट के विवरण के साथ डेटाबेस को अपडेट करना होगा। ऐसा करने के लिए, आपको Migrations.cs की सामग्री भाग की विशेष फ़ाइल में UpdateFrom<version#> विधि जोड़ना होगा ।

निम्न कोड अपडेट की गई विधि के साथ मैप सामग्री भाग के लिए इस तरह की फ़ाइल दिखाता है:

  System.Data का उपयोग करना;
 मैप्स का उपयोग करना।
 Orchard.ContentManagement.MetaData का उपयोग कर;
 Orchard.Core.Contents.Extensions का उपयोग कर;
 Orchard.Data.Migration का उपयोग करना;

 नाम स्थान के नक्शे
 {
     सार्वजनिक वर्ग का पलायन: डेटा माइग्रेशन
     {
         सार्वजनिक int बनाएँ ()
         {
             // तालिका MapRecord बनाना
             SchemaBuilder.CreateTable ("MapRecord", तालिका => तालिका
                 .ContentPartRecord ()
                 । कॉलम ("अक्षांश", DbType.Single)
                 । कॉलम ("देशांतर", DbType.Single)
             );

             ContentDefinitionManager.AlterPartDefinition (टाइपोफ़ (MapPart)। नाम, cfg => cfg
                 .Attachable ());

             वापसी 1;
         }

         सार्वजनिक int UpdateFrom1 ()
         {
             // हमारे नक्शे के साथ एक नया विजेट कंटेंट टाइप बनाएं
             ContentDefinitionManager.AlterTypeDefinition ("MapWidget", cfg => cfg
                 .WithPart ("मैपपार्ट")
                 .WithPart ("विजेटगार्ट")
                 .WithPart ("कॉमनपार्ट")
                 .WithSetting ("स्टीरियोटाइप", "विजेट"));

             वापसी 2;
         }
     }
 } 

इस उदाहरण में, UpdateFrom1 विधि MapPart, WidgetPart और CommonPart को मिलाकर एक MapWidget बनाता है और फिर विजेट के विशेष प्रकार (स्टीरियोटाइप) को सेट करता है। WidgetPart और CommonPart ऑब्जेक्ट्स को Orchard में बनाया गया है। विधि 2 लौटाती है, जिसका अर्थ है संस्करण संख्या।

अब सामग्री भाग एक विजेट में तब्दील हो गया है।

विजेट प्रदर्शन

एक बार जब आप विजेट बना लेते हैं, तो प्रशासन पैनल खोलें और विजेट टैब पर जाएं। यहां आप अपने विजेट के स्थान के लिए परत और क्षेत्र का चयन कर सकते हैं।

निष्कर्ष

इस लेख में, हमने एक सामग्री भाग बनाकर और इसे विजेट में परिवर्तित करके, ऑर्चर्ड सीएमएस की कार्यक्षमता का विस्तार करने के लिए विकल्पों में से एक की जांच की, जो बाद में साइट के किसी भी पृष्ठ पर, किसी भी स्तर पर, किसी भी क्षेत्र में स्थित हो सकता है।

निम्नलिखित लेखों में, हम विजेट प्रबंधन के मुद्दों और विजेट को अलग मॉड्यूल के रूप में पैक करने और वितरित करने की संभावना पर विचार करेंगे।