1C-Bitrix मॉड्यूल कैसे बनाएं

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

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

समाधान तकनीक
1. हम एक तत्व को संपादित करने की घटना को पकड़ने और अवरुद्ध करने के लिए हैंडलर का उपयोग करेंगे।
2. हम इन हैंडलर को एक मॉड्यूल में लपेटेंगे ताकि हमारी कार्यक्षमता किसी भी साइट पर उपयोग की जा सके।

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

कॉमिक मॉड्यूल "रूसी पोस्ट"

चरण 1: एक हैंडलर लिखना

इस कदम पर, सब कुछ सरल और अच्छी तरह से प्रलेखित किया गया है जो कि प्रतिबंध के बिंदु पर है।
OnBeforeIBlockElementAdd हैंडलर का उपयोग करना
और जो इसके करीब हैं, हम एक फ़ंक्शन बनाते हैं जो निश्चित समय पर संपादन को अवरुद्ध करता है

function lock($arParams) { if (in_array(date('w'),array(0,6) || date('H')>18 || date('H')<9) { global $APPLICATION; $APPLICATION->throwException("  ,   !"); return false; } } 

हम मॉड्यूल सेटिंग्स में शिलालेख निकालेंगे कि यह कैसे करना है।
इसलिए, मॉड्यूल सेटिंग्स को स्टोर करने के लिए एक कोऑप्शन क्लास है । इसे हमारे फंक्शन में जोड़ें:

 global $APPLICATION; $APPLICATION->throwException(COption::GetOptionString("russianpostjoke", "WE_ARE_CLOSED_TEXT", "  !")); return false; 

अनुस्मारक:
आपके द्वारा उस कोड को लिखने के बाद जिसे आप घटक में लपेटने जा रहे हैं, उसमें सेटिंग्स हाइलाइट करें।

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

चरण 2: मॉड्यूल का एक "रिक्त" बनाएं।

बिट्रिक्स / मॉड्यूल फोल्डर में रशियनपोस्टजोक फोल्डर बनाएं। यह हमारे मॉड्यूल का फ़ोल्डर होगा।
आप आधिकारिक दस्तावेज में एक फ़ोल्डर में क्या फाइलें और क्यों बनाने की आवश्यकता के बारे में पढ़ सकते हैं।
लिस्टिंग के साथ लेख को अव्यवस्थित नहीं करने के लिए, मैं गीथुब पर स्रोतों का अध्ययन करने का सुझाव देता हूं: https://github.com/may-cat/bitrix-dull-module

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

इसलिए, ऊपर दिए गए "रिक्त" में रशियनपोस्टजोक में मॉड्यूल के नाम की जगह, जहां भी इसकी आवश्यकता है, हमें अपना रिक्त स्थान मिला।
चलो इसे आवश्यक कार्यक्षमता के साथ भरने के लिए आगे बढ़ते हैं।

चरण 3: हम मॉड्यूल को कार्यक्षमता के साथ भरते हैं

चलिए cBlocker class बनाते हैं और इसे Russianpostjoke / classes / general / cMainRPJ.php फोल्डर में रखते हैं - वहाँ हम अपने हैंडलर को एक विधि के रूप में लागू करेंगे।

अनुस्मारक:
मानक Bitrix मॉड्यूल द्वारा निर्धारित मानकों का पालन करते हुए, अपने मॉड्यूल में उपयोग की जाने वाली कक्षाओं / कक्षाओं / फ़ोल्डर में रखने का प्रयास करें।

अब, हमें मॉड्यूल की स्थापना को पंजीकृत करने की आवश्यकता है। हम फाइल का उपयोग करेंगे
Russianpostjoke / install / index.php जिसमें DoInstall () और DoUninstall () मेथड हैं।
इसके अलावा, हमारे मामले में, तीन शर्तों को पूरा करना आवश्यक है:
a) हमारे हैंडलर को सिस्टम में cBlocker वर्ग से स्थापित करने के लिए RegisterModuleD dependences फ़ंक्शन का उपयोग करें, इसे मानक OnBeforeIBlockElementAdd और इसी तरह बांधें।
b) मॉड्यूल स्थापित है कि प्रणाली को सूचित करें। RegisterModule($this->MODULE_ID); हमारी सहायता करेगा RegisterModule($this->MODULE_ID);
सी) उपयोगकर्ता के लिए कॉल संदेश आउटपुट:

 $APPLICATION->IncludeAdminFile("  russianpostjoke", $DOCUMENT_ROOT."/bitrix/modules/russianpostjoke/install/step.php"); 

ध्यान दें कि वापसी के निर्माण से ठीक पहले यह कॉल किया जाना चाहिए।

परिणामस्वरूप, आपको अपने व्यवस्थापक पैनल में कुछ समान दिखना चाहिए:

प्रदर्शित मॉड्यूल स्थापित किया जा सकता है और स्थापना के तुरंत बाद हमारी घोषित कार्यक्षमता काम करेगी।

चरण 4: व्यवस्थापक

यदि आप अभी Bitrix व्यवस्थापक पैनल में सेटिंग्स / उत्पाद सेटिंग्स / मॉड्यूल सेटिंग्स /% पृष्ठ पर जाते हैं, तो हमारे मॉड्यूल% का नाम देखा जा सकता है ... कुछ भी नहीं। और इस बीच, इस पृष्ठ पर हमारे मॉड्यूल की सेटिंग्स होनी चाहिए।
जिस पेज में हम रुचि रखते हैं वह रशियनपोस्टजोक / options.php फ़ाइल द्वारा सेट किया गया है, और अच्छी और बुरी खबर इसके साथ जुड़ी हुई है।
बुरी खबर यह है कि बिट्रिक्स के विकास में इस स्तर पर बचत सेटिंग्स सहित सभी सेटिंग्स, इस फ़ाइल द्वारा निर्धारित की जाती हैं, अक्सर "शीट" के रूप में।
अच्छी खबर यह है कि आपके सामने बहुत कुछ हो चुका है, और आप मौजूदा विकास का लाभ उठा सकते हैं। मैं इस बात पर ध्यान देने की सलाह देता हूं कि "प्रदर्शन मॉनिटर" (परफॉमन) की सेटिंग्स कैसे वर्णित हैं - वे समझने में काफी सरल हैं।
हमें एक एकल फ़ील्ड WE_ARE_CLOSED_TEXT के लिए सेटिंग्स बनाने की आवश्यकता है, जिसका उपयोग हमने चरण संख्या 1 में किया था।
मॉड्यूल का पूरा स्रोत कोड github पर पोस्ट किया गया है: https://github.com/may-cat/bitrix-russianpostjoke

एक निष्कर्ष के बजाय

हमने सबसे सरल मॉड्यूल की जांच की, कम से कम 3 और लेखों के बारे में बताने के लिए कुछ है। यदि आप,% उपयोगकर्ता नाम%, इस सामग्री को उपयोगी पाते हैं, या आप, मेरी तरह, 1C-Bitrix के लिए डेवलपर्स के स्तर में सुधार करना चाहते हैं, तो लेख का समर्थन करें। आपका धन्यवाद

अद्यतन
नए कोर के लिए, D7 ने मॉड्यूल के लिए एक नया "हार्वेस्टिंग" बनाया।
आप इसे गितुब पर डाउनलोड और खोद सकते हैं: github.com/may-cat/maycat.d7dull
पुल अनुरोधों का स्वागत है।