👴 👩‍❤️‍👩 👲🏾 इवेंट हैंडलर्स का उपयोग करके UMI.CMS में अपनी कार्यक्षमता जोड़ना 📨 👍🏼 🦃

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

हालाँकि, अपनी साइट को विकसित करते समय, ऐसी परिस्थितियाँ होती हैं जब आपको किसी मौजूदा साइट की कार्यक्षमता बदलने की आवश्यकता होती है:

XML से डेटा आयात करने के लिए अपना तर्क जोड़ें;
डेटा आयात करते समय कुछ क्रियाएं करें;
आदेश बनाते या संशोधित करते समय कुछ क्रियाएं करें;
कुछ अनुसूचित क्रियाएं करें;
... और इसी तरह।

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

UMI.CMS में प्रलेखन के अनुसार दो प्रकार के ईवेंट हैंडलर हैं:

प्रणाली - ये पूर्वनिर्धारित हैंडलर हैं जो मॉड्यूल विकास के दौरान निर्धारित हैं। ये हैंडलर इवेंट.php फ़ाइल में लिखे गए हैं, जो मॉड्यूल डायरेक्टरी में है। UMI.CMS पैकेज में शामिल मॉड्यूल के लिए, यह फ़ाइल नहीं बदली जा सकती।
कस्टम - ये हैंडलर मॉड्यूल निर्देशिका में custom_events.php फ़ाइल में होना चाहिए।

जब कोई घटना होती है, तो उसे (सिस्टम और उपयोगकर्ता दोनों) को सौंपे गए सभी हैंडलर कहलाते हैं। इसके अलावा (यह दस्तावेज में नहीं लिखा गया है), सिस्टम इवेंट हैंडलर को उपयोगकर्ता-परिभाषित लोगों के बाद निष्पादित किया जाता है। अपनी कार्यक्षमता को विकसित करते समय इसे ध्यान में रखा जाना चाहिए।

ऑब्जेक्ट के परिवर्तन (मोड से पहले तथाकथित) और ऑब्जेक्ट के परिवर्तन (मोड के बाद) से पहले घटनाओं को उठाया जा सकता है। सभी घटनाएं या तो "पहले" या "बाद" नहीं हो सकती हैं, जो कि, नीचे दिए गए लिंक को देखना आवश्यक है।

प्रलेखन में आंतरिक घटनाओं की एक सूची पाई जा सकती है। यह याद रखना चाहिए कि अलग-अलग स्थानों पर एक ही वस्तु पर कार्रवाई के दौरान अलग-अलग घटना संचालकों को बुलाया जाएगा। यह कुछ असुविधा का कारण बनता है:

मान लीजिए, उदाहरण के लिए, हम यूएमआई पर आधारित एक ऑनलाइन स्टोर विकसित कर रहे हैं, और हमें ऑर्डर की स्थिति बदलते समय कुछ क्रियाएं करने की आवश्यकता है (उदाहरण के लिए, अतिरिक्त ईमेल भेजें, आदेश के आधार पर कुछ अन्य फ़ील्ड्स, आदि, स्थिति के आधार पर)। हम देखते हैं कि हम ऑर्डर स्थिति के परिवर्तन की घटनाओं को "पकड़" कहाँ सकते हैं:

जब साइट उपयोगकर्ता द्वारा ऑर्डर बनाया जाता है तो स्थिति में परिवर्तन होता है - ऑर्डर-स्टेटस-बदला हुआ ईवेंट का मॉड्यूल;
आदेश विवरण पृष्ठ पर व्यवस्थापक पैनल से स्थिति परिवर्तन - systemModifyObject प्रणाली घटना;
सभी आदेश पृष्ठ की सूची में व्यवस्थापक पैनल से स्थिति का परिवर्तन - सिस्टम ईवेंट systemModifyPropertyValue ;
XML के माध्यम से आयात करते समय स्थिति में बदलाव (उदाहरण के लिए, जब 1 सी से उतारना) - ExchangeOnUpdateObject इवेंट।

इस प्रकार, उन सभी स्थानों को ध्यान में रखने के लिए जहां ऑर्डर की स्थिति बदल जाती है, आपको 4 हैंडलर लिखना होगा।

सिस्टम ईवेंट सिस्टम पर अधिक विस्तार से रहने दें ।ModifyPropertyValue मुझे दस्तावेज़ीकरण में इसका कोई उल्लेख नहीं मिला, मैंने इसकी कॉल केवल सिस्टम कोड का विश्लेषण करते समय देखी थी, लेकिन इसे वर्णित स्थिति में इसके बिना प्रबंधित करना काफी मुश्किल है, क्योंकि साइट व्यवस्थापक (प्रबंधक) दो तरीकों से आदेश डेटा को बदल सकता है:

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

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

SystemModifyPropertyValue सिस्टम इवेंट में निम्न पैरामीटर हैं:

इकाई - एक वस्तु का संदर्भ जिसकी संपत्ति बदल रही है;
संपत्ति - संपत्ति का नाम बदला जा रहा है ;
oldValue - संपत्ति का पुराना मूल्य;
newValue - संपत्ति का नया मूल्य;

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

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

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

ऐसे उत्पादों को बेचने की बारीकियां हमारे पास हैं, उदाहरण के लिए, डोल्से टी-शर्ट मॉडल, जिसमें बिक्री के लिए विशिष्ट इकाइयाँ हैं:

टी-शर्ट डोल्से व्हाइट, 40 आकार;
टी-शर्ट डोल्से व्हाइट, 48 आकार;
टी-शर्ट डोल्से रेड, 44 आकार;
... और इसी तरह।

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

1 सी के दृष्टिकोण से, सब कुछ सरल लगता है। हमने नामकरण की सेटिंग में एक चेकमार्क "विशेषताओं" को रखा। हम पहले सामान को डिस्क पर लोड करते हैं, परिणामी XML फ़ाइल (ऑफ़र.एक्सएमएल) को देखते हैं, हमारे पास ये सुझाव हैं, आनन्दित करें और साइट पर अपलोड करें। और यहाँ हम समझते हैं कि हमने जल्दी आनन्दित किया। उत्पादों को स्वयं जोड़ा गया था, लेकिन उनकी विशेषताओं (कि एक विशेष टी-शर्ट में रंगों और आकारों के विभिन्न संयोजनों के साथ एक दर्जन प्रस्ताव हैं) - नहीं।

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

1 सी से यूएमआई में आयात की विशेषताएं प्रलेखन में वर्णित हैं। डेटा आयात करते समय अपनी कार्यक्षमता जोड़ने के लिए, आपको आयात टेम्प्लेट /xsl/import/custom/commerceML2.xsl को संशोधित करना होगा, और अपने आयात इवेंट हैंडलर को भी जोड़ना होगा।

आयात टेम्पलेट संशोधित करें:

आयात टेम्पलेट

<xsl:template match=""> ... <!--        --> <type id="charateristics-kinds" title='   ""' parent-id="root-guides-type" guide="guide"> <base/> <fieldgroups> <group name="charateristics_kinds"> <field name="1c_id" title="  1" visible="visible"> <type name="" data-type="string"/> </field> <field name="color" title="" field-type-id="3" visible="visible" required="required" > <type id="3" name="" data-type="string"/> </field> <field name="size" title="" field-type-id="3" visible="visible" required="required" > <type id="3" name="" data-type="string"/> </field> </group> </fieldgroups> </type> <!--    --> <type id="shirts" title='1C: ' parent-id="root-catalog-object-type"> <base module="catalog" method="object"> </base> <fieldgroups> ... <!--   --> <group name="optioned_properties" title=" "> <field name="charateristics" title="" visible="visible" guide-id="charakteristics-kinds"> <type name="" data-type="optioned" multiple="multiple" /> </field> </group> </fieldgroups> </type> ... </xsl:template> <!--     - ,         --> <xsl:template match="/"> ... <page id="{}" parentId="{$group_id}" type-id="shirts"> ... </page> ... </xsl:template> <!--  --> <xsl:template match=""> <meta> <source-name>commerceML2</source-name> </meta> <objects> <xsl:apply-templates select="/" mode="objects"/> </objects> <pages> <xsl:apply-templates select="/" mode="items"/> </pages> </xsl:template> <!--    --> <xsl:template match="/" mode="objects"> <object id="{substring-after(,'#')}" name="{}" type-id="charakteristics-kinds"> <properties> <group name="charateristics_kinds"> <property name="1c_id" type="string" is-public="1" visible="visible"> <title>  1</title> <value><xsl:value-of select="" /></value> </property> <xsl:apply-templates select="/[ = '']" mode="color" /> <xsl:apply-templates select="/[ = '']" mode="size" /> </group> </properties> </object> </xsl:template> <xsl:template match="/" mode="color" > <property name="color" type="string" is-public="1" visible="visible"> <title><xsl:value-of select="" /></title> <value><xsl:value-of select="" /></value> </property> </xsl:template> <xsl:template match="/" mode="size" > <property name="size" type="string" is-public="1" visible="visible"> <title><xsl:value-of select="" /></title> <value><xsl:value-of select="" /></value> </property> </xsl:template> <!--  ,     --> <xsl:template match="/" mode="items"> <page id="{substring-before(,'#')}" update-only="1"> <properties> <group name="optioned_properties" title=" "> <property name="charateristics" type="optioned" is-public="1" visible="visible"> <title></title> <value> <option int="{}" float="{//}"> <object id="{substring-after(,'#')}" name="{}" type-id="charakteristics-kinds" /> </option> </value> </property> </group> </properties> </page> </xsl:template>

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

अपने ईवेंट हैंडलर को जोड़ें। ऐसा करने के लिए, / क्लासेस / मॉड्यूल / एक्सचेंज फ़ोल्डर में कोड के साथ एक custom_events.php फ़ाइल बनाएं

 <?php new umiEventListener("exchangeOnUpdateElement", "exchange", "onImportElement"); new umiEventListener("exchangeOnAddElement", "exchange", "onImportElement"); ?>

इस प्रकार, हम यह निर्धारित करते हैं कि किसी तत्व (उत्पाद पृष्ठ) को अपडेट करते समय और बनाते समय, आयात पर ऑनइमपोर्टमेंट विधि को बुलाया जाएगा। हम इस विधि के लिए __custom.php फ़ाइल में कोड लिखेंगे:

इवेंट हैंडलर कोड

  /** *       1 * @param e -     */ public function onImportElement($e) { if($e->getMode() == "after") { //   $this->addOptionedProperties($e); } } /** *      .      *  UMI * @param e -     */ function addOptionedProperties($e) { $hierarchy = umiHierarchy::getInstance(); $element = $e->getRef('element'); if (!$element instanceof umiHierarchyElement || $element->getMethod() != 'object') { //    return false; } $object_id = $element->objectId; //XML DOM node     $element_info = $e->getParam('element_info'); $properties = $element_info->getElementsByTagName('property'); $propertiesSize = $properties->length; $types = umiObjectTypesCollection::getInstance(); //     XML foreach($properties as $key => $info) { $old_name = $info->getAttribute('name'); //    $name = self::translateName($old_name); $nl = $info->getElementsByTagName("value"); if (!$nl->length) { //     XML continue; } $value_node = $nl->item(0); //          $type_id = ($element instanceof umiHierarchyElement) ? $element->getObjectTypeId() : $element->getTypeId(); $type = umiObjectTypesCollection::getInstance()->getType($type_id); $field_id = $type->getFieldId($name, false); $field = umiFieldsCollection::getInstance()->getField($field_id); if (!$field instanceof umiField) { continue; } switch($field->getDataType()) { //     ,       UMI case "optioned": //storing old settings $oldForce = umiObjectProperty::$USE_FORCE_OBJECTS_CREATION; umiObjectProperty::$USE_FORCE_OBJECTS_CREATION = false; // ,     $objectsCollection = umiObjectsCollection::getInstance(); $guideItems = $objectsCollection->getGuidedItems($field->getGuideId()); $options = $value_node->getElementsByTagName("option"); $items = Array(); foreach($options as $option) { //  int            $int = $option->hasAttribute("int") ? $option->getAttribute("int") : null; //  float      $float = $option->hasAttribute("float") ? $option->getAttribute("float") : null; $objects = $option->getElementsByTagName("object"); foreach($objects as $object) { $objectId = $object->hasAttribute("id") ? $object->getAttribute("id") : null; $objectName = $object->hasAttribute("name") ? $object->getAttribute("name") : null; $objectTypeId = $object->hasAttribute("type-id") ? $object->getAttribute("type-id") : null; //   $item = Array(); $item["int"] = (int)$int; $item["float"] = (float)$float; $item["varchar"] = $objectName; // ,    property foreach($guideItems as $key => $value) { if($value == $objectName) { //  id       int,    $item["rel"] = (int)$key; break; } } $items[] = $item; } } //   $entityId = $element->getId(); if($element instanceof umiHierarchyElement) { $entityId = $element->getObject()->getId(); } $pageObject = $objectsCollection->getObject($entityId); //      ,    $existingItems = $pageObject->getValue($name); $newItems = Array(); if($existingItems) { //    ,     foreach($existingItems as $existingItem) { $found = false; foreach($items as $item) { if($item["rel"] == $existingItem["rel"]) { $found = true; break; } } if(!$found) { $newItems[] = $existingItem; } } } //    foreach($items as $item) { $newItems[] = $item; } $pageObject->setValue($name, $newItems); $pageObject->commit(); //restoring settings umiObjectProperty::$USE_FORCE_OBJECTS_CREATION = $oldForce; break; } } } /** *  UMI-       */ protected static function translateName($name) { $name = umiHierarchy::convertAltName($name, "_"); $name = umiObjectProperty::filterInputString($name); if(!strlen($name)) $name = '_'; $name = substr($name, 0, 64); return $name; }

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

निर्दिष्ट कोड जोड़ने और साइट पर सामानों को फिर से अपलोड करने के बाद, हम देखते हैं कि प्रत्येक उत्पाद में स्थान हैं, प्रत्येक का अपना रंग और आकार है। यही है, संकेतित कार्य उपलब्ध है, और अब हमारे पास UMI.CMS प्रणाली है जो 1C से माल के वैकल्पिक गुणों को आयात करने में सक्षम है।

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

इवेंट हैंडलर्स का उपयोग करके UMI.CMS में अपनी कार्यक्षमता जोड़ना

More articles: