👰🏻 👩🏽‍⚖️ 🐡 Magento के लिए एक नया मेल मॉड्यूल बनाना (भाग 1) 🔫 🔛 👩🏽‍🔧

सामग्री की तालिका

Magento (भाग 1) के लिए एक नया मेल मॉड्यूल बनाएँ, जहाँ हम Magento में एक नई डिलीवरी विधि जोड़ते हैं
हम Magento (भाग 2) के लिए "नया मेल" मॉड्यूल बनाते हैं , जहाँ हम Magento को नए मेल के साथ वेयरहाउस डेटाबेस को स्टोर और सिंक्रोनाइज़ करना सिखाते हैं।

मुझे पहले से ही यूक्रेन के सबसे लोकप्रिय माल वाहक नोवाया पोच्टा के लिए एक मॉड्यूल लिखने के लिए एक से अधिक लोगों द्वारा कहा गया है। यह एक घंटे के लिए नहीं है, इसलिए हाथ नहीं पहुंचे। लेकिन हाल ही में, मैंने सोचा कि यदि कोई विचार मांग में है, तो समुदाय के लिए कुछ उपयोगी क्यों न करें, अर्थात्:
1. मुक्त मॉड्यूल "नया मेल" Magento के लिए खुले स्रोत कोड के साथ;
2. प्रक्रिया के विस्तृत विवरण के साथ कई भागों में एक लेख।

यह आलेख नए लोगों के लिए Magento के उद्देश्य से है, लेकिन यह अनुभवी डेवलपर्स के लिए भी दिलचस्प हो सकता है। GitHub पर सभी स्रोत पाए जा सकते हैं: github.com/alexkuk/Ak_NovaPoshta , वे विकास के दौरान पूरक हैं।

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

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

एक नई डिलीवरी विधि जोड़ें

इसलिए, एक नया मॉड्यूल बनाएं और एक नई डिलीवरी विधि जोड़ें। मैं Magento CE 1.7.0.2 के साथ काम करेंगे। मॉड्यूल को Ak_NovaPoshta कहा जाता है। Magento में मॉड्यूल की संरचना के बारे में बहुत सारे लेख पहले ही लिखे जा चुके हैं, इसलिए मैं इस बिंदु को छोड़ दूंगा।

यह ध्यान देने योग्य है कि Magento दो संस्थाओं पर काम करती है, जब हम वितरण विधि के बारे में बात करते हैं, तो ये शिपिंग कैरियर (वाहक) और शिपिंग तरीके (शिपिंग तरीके जो वाहक द्वारा प्रदान किए जाते हैं) हैं। हमारे मामले में, वाहक न्यू मेल है, हम विधियों के रूप में न्यू मेल डिपो का उपयोग करेंगे।

वाहक को जोड़ने के लिए, आपको तीन काम करने होंगे:
1. system.xml मॉड्यूल में हमारे वाहक के सेटिंग फ़ील्ड जोड़ें;

2. डिफ़ॉल्ट सेटिंग्स मान जोड़ें, साथ ही वाहक मॉडल वर्ग का एक लिंक, मॉड्यूल config.xml में जोड़ें:

<config> … <default> <carriers> <novaposhta> <!--  -,        --> <active>0</active> <!-- ,      ,    shipping address    --> <sallowspecific>1</sallowspecific> <!--    --> <specificcountry>UA</specificcountry> <!--      --> <model>novaposhta/carrier_novaPoshta</model> <!--   --> <title> </title> <!--    --> <specificerrmsg>       .   ,      ,    -.</specificerrmsg> </novaposhta> </carriers> </default> … </config>

3. हमारे कैरियर में एक क्लास मॉडल जोड़ें।
मालवाहक मॉडल वर्ग Mage_Shipping_Model_Carrier_Abstract और कार्यान्वयन Mage_Shipping_Model_Carrier_Interface से विरासत में मिला है। कुछ उपयोगी विधियों को पहले से ही Mage_Shipping_Model_Carrier_Abstract में परिभाषित किया गया है, जैसे कॉन्फ़िगरेशन मानों को प्राप्त करने के लिए getConfigData ($ फ़ील्ड) विधि। हमारी कक्षा में, हम मुख्य विधि collectRates (Mage_Shipping_Model_Rate_Request $ request) को परिभाषित करते हैं, जो उपलब्ध वितरण विधियों को वापस करेगा:

  public function collectRates(Mage_Shipping_Model_Rate_Request $request) { if (!$this->getConfigFlag('active')) { return false; } /** @var $result Mage_Shipping_Model_Rate_Result */ $result = Mage::getModel('shipping/rate_result'); $shippingPrice = 1.00; // dummy price $warehouseId = 1; // dummy warehouse ID $warehouseName = ' №1'; // dummy warehouse name /** @var $method Mage_Shipping_Model_Rate_Result_Method */ $method = Mage::getModel('shipping/rate_result_method'); $method->setCarrier($this->_code) ->setCarrierTitle($this->getConfigData('name')) ->setMethod('warehouse_' . $warehouseId) ->setMethodTitle($warehouseName) ->setPrice($shippingPrice) ->setCost($shippingPrice); $result->append($method); return $result; }

जब तक हमने गोदामों के सिंक्रनाइज़ेशन को लागू नहीं किया है, तब तक हम एक उदाहरण के लिए एक वितरण विधि का उपयोग करेंगे - वेयरहाउस नंबर 1। कलेक्टोरेट्स () विधि के अंदर, Mage_Shipping_Model_Rate_Result का एक उदाहरण बनाएँ, और Mage_Shipping_Model_Rate_Result :: append () पद्धति का उपयोग करके इसे_age_Shipping_Model_Rate_Result_Method इंस्टेंस जोड़ें।

अंत में, हम मूल विधि को फिर से लिखना है।

  public function isTrackingAvailable() { return true; }

इस स्तर पर, हमारी वितरण विधि पहले से ही उपयोग की जा सकती है, लेकिन, जैसा कि आप देखते हैं, वितरण की लागत हमेशा 1.00 होगी।

शिपिंग लागत का कॉन्फ़िगरेशन जोड़ें

अगला कदम कुल ऑर्डर वजन और शिपिंग लागत को जोड़ने के लिए एक कॉन्फ़िगरेशन विकल्प जोड़ना है। नतीजतन, मैं इस फॉर्म को प्राप्त करना चाहता हूं:

ऐसा करने के लिए, हमारे मॉड्यूल के system.xml में weight_price फ़ील्ड जोड़ें:

 … <weight_price translate="label"> <label>Shipping price</label> <frontend_model>novaposhta/config_field_weightPrice</frontend_model> <backend_model>adminhtml/system_config_backend_serialized_array</backend_model> <sort_order>110</sort_order> <show_in_default>1</show_in_default> <show_in_website>1</show_in_website> <show_in_store>1</show_in_store> </weight_price> …

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

 class Ak_NovaPoshta_Block_Config_Field_WeightPrice extends Mage_Adminhtml_Block_System_Config_Form_Field_Array_Abstract { public function __construct() { $this->addColumn('weight', array( 'label' => Mage::helper('novaposhta')->__('Weight upper limit'), 'style' => 'width:120px', )); $this->addColumn('price', array( 'label' => Mage::helper('novaposhta')->__('Price'), 'style' => 'width:120px', )); $this->_addAfter = false; $this->_addButtonLabel = Mage::helper('novaposhta')->__('Add rate'); parent::__construct(); } }

जैसा कि आप देख सकते हैं, सार Mage_Adminhtml_Block_System_Config_Form_Field_Array_Abstract हमारे लिए सभी काम करता है, यह कॉलम और बटन को कॉन्फ़िगर करने के लिए हमारे पास रहता है।

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

  /** * @return array */ protected function _getWeightPriceMap() { $weightPriceMap = $this->getConfigData('weight_price'); if (empty($weightPriceMap)) { return array(); } return unserialize($weightPriceMap); } /** * @param $packageWeight * * @return float */ protected function _getDeliveryPriceByWeight($packageWeight) { $weightPriceMap = $this->_getWeightPriceMap(); $resultingPrice = 0.00; if (empty($weightPriceMap)) { return $resultingPrice; } $minimumWeight = 1000000000; foreach ($weightPriceMap as $weightPrice) { if ($packageWeight <= $weightPrice['weight'] && $weightPrice['weight'] <= $minimumWeight) { $minimumWeight = $weightPrice['weight']; $resultingPrice = $weightPrice['price']; } } return $resultingPrice; }

और कलेक्टोरेट्स विधि में हम प्रतिस्थापित करते हैं

 $shippingPrice = 1.00

अधिक वास्तविक के लिए

 $shippingPrice = $this->_getDeliveryPriceByWeight($request->getPackageWeight());

हो गया

अगले भाग में मैं न्यू मेल एपीआई के साथ वेयरहाउस बेस के सिंक्रनाइज़ेशन से निपटूंगा। आपका ध्यान के लिए धन्यवाद!

Magento के लिए एक नया मेल मॉड्यूल बनाना (भाग 1)

सामग्री की तालिका

एक नई डिलीवरी विधि जोड़ें

शिपिंग लागत का कॉन्फ़िगरेशन जोड़ें

More articles: