🌹 ⛏️ 🧜🏿 ऑर्चर्ड सीएमएस एक्सटेंशन: मॉड्यूल बनाना 🍡 🧑🏾‍🤝‍🧑🏽 ⏲️

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

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

परिचय

ऑर्चर्ड में मॉड्यूल एक्सटेंशन सेट हैं जिन्हें ऑर्कार्ड सिस्टम चलाने वाले अन्य साइटों पर पुन: उपयोग के लिए एक विशेष तरीके से पैक किया जा सकता है। ऑर्चर्ड मॉड्यूल ASP.NET MVC फ्रेमवर्क के क्षेत्रों की अवधारणा के आधार पर कार्यान्वित किए जाते हैं। ASP.NET MVC में क्षेत्र एक प्रकार की उप-साइटें हैं जिनमें सभी कार्यों का एक पूरा सेट होता है जो उप-साइट को साइट के अन्य वर्गों या घटकों से अलग से काम करने की अनुमति देता है। ऑर्चर्ड में एक मॉड्यूल एक विशेष अभिव्यक्ति फ़ाइल के साथ एक साधारण क्षेत्र है। मॉड्यूल ऑर्चर्ड एपीआई का उपयोग कर सकता है, लेकिन ऐसा करने की आवश्यकता नहीं है।

मॉड्यूल संरचना पीढ़ी

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

एक बार जब आप अपने Orchard सिस्टम पर कोड जनरेशन सुविधा को सक्षम कर लेते हैं, तो कमांड प्रॉम्प्ट खोलें और निम्नलिखित कमांड का उपयोग करके HelloWorld मॉड्यूल बनाएं।

कोडजेन मॉड्यूल HelloWorld

प्रकट संशोधन

अब आपको Orchard साइट के साथ अपने प्रोजेक्ट के मॉड्यूल फ़ोल्डर में HelloWorld फ़ोल्डर होना चाहिए। इस फ़ोल्डर में आप मॉड्यूलटैक्स फ़ाइल पा सकते हैं, इसे खोलें और इसे निम्नानुसार भरें:

  नाम: HelloWorld
 एंटिफॉर्जरी: सक्षम
 लेखक: द ऑर्चर्ड टीम
 वेबसाइट: http://orchardproject.net
 संस्करण: 0.5.0
 ऑर्चर्डवर्सन: 0.5.0
 विवरण: हैलो वर्ल्ड मॉड्यूल दुनिया का अभिवादन कर रहा है और बहुत कुछ नहीं कर रहा है। 
 विशेषताएं:
     HelloWorld:
         विवरण: एक बहुत ही सरल मॉड्यूल।
         श्रेणी: नमूना

यह पाठ सिस्टम के लिए आपके मॉड्यूल का वर्णन करता है। उदाहरण के लिए, मॉड्यूल प्रदर्शित करते समय इस पाठ की कुछ जानकारी का उपयोग प्रशासन पैनल में किया जाएगा।

यह महत्वपूर्ण है। रिक्त स्थान का उपयोग करें, लेकिन टैब का उपयोग न करें।

एक मार्ग जोड़ना

एक उदाहरण के रूप में, मान लें कि आपका मॉड्यूल ऑर्चर्ड साइट के सापेक्ष / HelloWorld पते को संभालने में सक्षम होना चाहिए। यह निर्धारित करने के लिए कि उपयोगकर्ता को निर्दिष्ट पते पर नेविगेट करने की आवश्यकता है, तो आपको मार्ग निर्धारित करना होगा। ऐसा करने के लिए, HelloWorld फ़ोल्डर में Routes.cs फ़ाइल बनाएँ, जो निम्नानुसार है:

using System.Collections.Generic; using System.Web.Mvc; using System.Web.Routing; using Orchard.Mvc.Routes; namespace HelloWorld { public class Routes : IRouteProvider { public void GetRoutes(ICollection<RouteDescriptor> routes) { foreach (var routeDescriptor in GetRoutes()) routes.Add(routeDescriptor); } public IEnumerable<RouteDescriptor> GetRoutes() { return new[] { new RouteDescriptor { Priority = 5, Route = new Route( "HelloWorld", new RouteValueDictionary { {"area", "HelloWorld"}, {"controller", "Home"}, {"action", "Index"} }, new RouteValueDictionary(), new RouteValueDictionary { {"area", "HelloWorld"} }, new MvcRouteHandler()) } }; } } }

एक मार्ग URL और नियंत्रक क्रियाओं के बीच संबंध का वर्णन है। उपरोक्त कोड एक HelloWorld पते को एक HelloWorld क्षेत्र के साथ जोड़ता है जिसमें एक इंडेक्स एक्शन के साथ एक होम कंट्रोलर है।

नियंत्रक निर्माण

बनाए गए मॉड्यूल में कंट्रोलर फ़ोल्डर है, जो नए नियंत्रक बनाने के लिए तैयार है। इस फ़ोल्डर में निम्न फ़ाइल बनाएँ और इसे नाम दें HomeController.cs:

 using System.Web.Mvc; using Orchard.Themes; namespace HelloWorld.Controllers { [Themed] public class HomeController : Controller { public ActionResult Index() { return View("HelloWorld"); } } }

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

नियंत्रक की थीम्ड विशेषता पर ध्यान दें। यह विशेषता आपको वर्तमान कस्टम थीम के साथ डेटा प्रदर्शित करने की अनुमति देती है।

दृश्य बनाएँ

दृश्य फ़ोल्डर में, होम फ़ोल्डर बनाएँ, और इसमें HelloWorld.cshtml नामक निम्न फ़ाइल जोड़ें:

 <h2>@T("Hello World!")</h2>

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

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

प्रोजेक्ट में नई फाइलें जोड़ना

हम पहले मॉड्यूल के निर्माण को पूरा करने के लिए लगभग तैयार हैं। अंतिम शेष कार्य डायनामिक संकलन के दौरान मॉड्यूल बनाने के लिए आवश्यक फाइलों के सेट के बारे में सिस्टम को बताना है।

किसी भी टेक्स्ट एडिटर में HelloWorld.csproj प्रोजेक्ट फ़ाइल खोलें और एक </ ItemGroup> टैग के बाद निम्न पंक्तियाँ जोड़ें।

 <ItemGroup> <Compile Include="Routes.cs"/> <Compile Include="Controllers\HomeController.cs"/> </ItemGroup>

इसके अलावा, निम्न सामग्री को आइटम समूह अनुभाग में जोड़ें, जिसमें पहले से ही कई सामग्री टैग हैं:

 <Content Include="Views\Home\HelloWorld.cshtml" />

मॉड्यूल सक्रियण

अंत में, आपको अपने नए मॉड्यूल को सक्रिय करना होगा। कमांड प्रॉम्प्ट पर, टाइप करें:

  सुविधा HelloWorld सक्षम करें

आप ऑर्चर्ड वेबसाइट के प्रशासन पैनल में मॉड्यूल अनुभाग के माध्यम से भी सक्रिय कर सकते हैं।

मॉड्यूल का उपयोग

अब आप अपनी साइट के संबंध में लिंक / हैलोवर्ल्ड का अनुसरण कर सकते हैं और देख सकते हैं कि हमारा मॉड्यूल काम कर रहा है और एक संदेश के साथ हमारा स्वागत करता है।

निष्कर्ष

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

निम्नलिखित लेखों में, हम ऑर्चर्ड सीएमएस में मॉड्यूल के साथ काम करने के कुछ अन्य पहलुओं पर ध्यान देंगे: मॉड्यूल की पैकेजिंग, वितरण, स्थापना और प्रबंधन।

ऑर्चर्ड सीएमएस एक्सटेंशन: मॉड्यूल बनाना