🙏 🤓 📔 Magento के लिए एक नया मेल मॉड्यूल बनाना (भाग 2) 😔 👨🏼‍🏭 👨‍🔬

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

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

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

इस भाग में, हम एपीआई कुंजी प्राप्त करेंगे और नए मेल से Magento के डेटाबेस में गोदामों और शहरों के सिंक्रनाइज़ेशन को लिखेंगे।

परिणामस्वरूप, हमें व्यवस्थापक पैनल में ऐसी तालिका मिलती है:

नई मेल एपीआई

ऐसा लगता है कि न्यू मेल अपने एपीआई को जल्द से जल्द छिपा सकता है। मैंने तीसरे पक्ष के मंचों से इसके अस्तित्व के बारे में भी जाना।

पहली चीज जो आपको प्राप्त करने की आवश्यकता है, वह है न्यू पोस्ट ऑफिस में वफादारी कार्यक्रम के लिए पंजीकरण करना। नतीजतन, आपको अपने व्यक्तिगत खाते तक पहुंचने के लिए एक लॉगिन और पासवर्ड प्राप्त होगा। इस कार्यालय के पृष्ठ में API का उल्लेख नहीं है, लेकिन इंटरनेट पर अच्छे लोग निम्न पते पर इंगित करते हैं: ऑर्डर . novaposhta.ua/api.php?todo=api_form ।

हुर्रे! हमारे पास प्रलेखन और यहां तक कि अनुरोध परीक्षण प्रपत्र भी है। लेकिन आपको एक कुंजी की भी आवश्यकता है। यहाँ फिर से, अच्छे लोगों की मदद की जरूरत थी - आपकी चाबी देखने के लिए, आपको इस पते पर जाने की आवश्यकता है: ऑर्डर . novaposhta.ua/api.php?todo=api_get_key_ajax ।

एपीआई तक पहुंच मैगेंटो के लिए है।

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

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

System.xml में हम निम्नलिखित फ़ील्ड जोड़ते हैं:

<api_url translate="label"> <label>API URL</label> <frontend_type>text</frontend_type> <sort_order>120</sort_order> <show_in_default>1</show_in_default> <show_in_website>0</show_in_website> <show_in_store>0</show_in_store> </api_url> <api_key translate="label"> <label>API key</label> <frontend_type>text</frontend_type> <sort_order>130</sort_order> <show_in_default>1</show_in_default> <show_in_website>0</show_in_website> <show_in_store>0</show_in_store> </api_key> <enable_log translate="label"> <label>Enable log</label> <frontend_type>select</frontend_type> <source_model>adminhtml/system_config_source_yesno</source_model> <sort_order>140</sort_order> <show_in_default>1</show_in_default> <show_in_website>0</show_in_website> <show_in_store>0</show_in_store> </enable_log>

Config.xml में डिफ़ॉल्ट मान जोड़ें:

 <config> ... <default> <carriers> <novaposhta> ... <api_url>http://orders.novaposhta.ua/xml.php</api_url> <enable_log>0</enable_log> </novaposhta> </carriers> </default> ... </config>

सहायक में, हम कॉन्फ़िगरेशन मान और लॉगिंग विधि तक पहुंचने की विधि को लागू करते हैं। मॉड्यूल के विभिन्न भागों में उपयोग की जाने वाली ऐसी छोटी चीजें आसानी से सहायक के लिए बाहर ले जाई जा सकती हैं। आपको यह भी समझने की आवश्यकता है कि Mage :: सहायक ('novaposhta') हमारे सहायक का सिंगलटन लौटाता है।

 class Ak_NovaPoshta_Helper_Data extends Mage_Core_Helper_Abstract { protected $_logFile = 'novaposhta.log'; /** * @param $string * * @return Ak_NovaPoshta_Helper_Data */ public function log($string) { if ($this->getStoreConfig('enable_log')) { Mage::log($string, null, $this->_logFile); } return $this; } /** * @param string $key * @param null $storeId * * @return mixed */ public function getStoreConfig($key, $storeId = null) { return Mage::getStoreConfig("carriers/novaposhta/$key", $storeId); } }

हम एक DB तैयार करते हैं

डेटाबेस में अपनी तालिकाएँ जोड़ें। ऐसा करने के लिए, हम Magento में निर्मित अद्यतन तंत्र का उपयोग करते हैं (अधिक विवरण के लिए, इस लेख में कोडमेगेंटो.कॉम/2011/02/altering-the-database-through-setup-scripts देखें)।

सबसे पहले, हम संसाधनों और संस्थाओं को जोड़ने का वर्णन करते हैं, और config.xml में novaposhta_setup संसाधन भी जोड़ते हैं:

 ... <global> <models> <novaposhta> <class>Ak_NovaPoshta_Model</class> <resourceModel>novaposhta_resource</resourceModel> </novaposhta> <novaposhta_resource> <class>Ak_NovaPoshta_Model_Resource</class> <entities> <city> <table>novaposhta_city</table> </city> <warehouse> <table>novaposhta_warehouse</table> </warehouse> </entities> <novaposhta_resource> </models> ... <resources> <novaposhta_setup> <setup> <module>Ak_NovaPoshta</module> </setup> </novaposhta_setup> </resources> </global> ...

अपग्रेड स्क्रिप्ट ऐप / कोड / समुदाय / Ak / NovaPoshta / sql / novaposhta_setup / mysql4-upgrade-1.0.0-1.0.1.php जोड़ें जिसमें हमें उन तालिकाओं का निर्माण करना होगा जिनकी हमें आवश्यकता है।

 /* @var $installer Mage_Core_Model_Resource_Setup */ $installer = $this; $installer->startSetup(); $installer->run(" CREATE TABLE {$this->getTable('novaposhta_city')} ( `id` int(10) unsigned NOT NULL, `name_ru` varchar(100), `name_ua` varchar(100), `updated_at` timestamp NOT NULL default CURRENT_TIMESTAMP on update CURRENT_TIMESTAMP, PRIMARY KEY (`id`), INDEX `name_ru` (`name_ru`), INDEX `name_ua` (`name_ua`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8; CREATE TABLE {$this->getTable('novaposhta_warehouse')} ( `id` int(10) unsigned NOT NULL, `city_id` int(10) unsigned NOT NULL, `address_ru` varchar(200), `address_ua` varchar(200), `phone` varchar(100), `weekday_work_hours` varchar(20), `weekday_reseiving_hours` varchar(20), `weekday_delivery_hours` varchar(20), `saturday_work_hours` varchar(20), `saturday_reseiving_hours` varchar(20), `saturday_delivery_hours` varchar(20), `max_weight_allowed` int(4), `longitude` float(10,6), `latitude` float(10,6), `number_in_city` int(3) unsigned NOT NULL, `updated_at` timestamp NOT NULL default CURRENT_TIMESTAMP on update CURRENT_TIMESTAMP, PRIMARY KEY (`id`), CONSTRAINT FOREIGN KEY (`city_id`) REFERENCES `{$this->getTable('novaposhta_city')}` (`id`) ON DELETE CASCADE ON UPDATE CASCADE ) ENGINE=InnoDB DEFAULT CHARSET=utf8; "); $installer->endSetup();

यह हमारे config.xml में मॉड्यूल के संस्करण को 1.0.1 तक बढ़ाता है, कैश को साफ़ करता है, Magento शुरू करता है और आप जाँच सकते हैं कि क्या डेटाबेस में तालिकाओं का निर्माण किया गया है। बनाया गया, आगे बढ़ें।

मॉडल, संसाधन और संग्रह बनाएँ

हम शहर और गोदाम संस्थाओं को जोड़ते हैं। उनके साथ काम करने के लिए, हमें संबंधित मॉडल Ak_NovaPoshta_Model_City और Ak_NovaPoshta_Model_Warehouse बनाने की आवश्यकता है। डेटाबेस में उन्हें बचाने के लिए हम Ak_NovaPoshta_Model_Resource_City और Ak_NovaPoshta_Model_Resource_Warehouse संसाधन बनाएंगे। छद्म-निर्माता में मॉडल वर्ग में संसाधन के साथ मॉडल को जोड़ने के लिए, _init () विधि को संसाधन वर्ग के उपनाम के साथ एक पैरामीटर के रूप में कॉल करें:

 class Ak_NovaPoshta_Model_City extends Mage_Core_Model_Abstract { public function _construct() { $this->_init('novaposhta/city'); } … }

संसाधन में, संसाधन पर _init () कॉल करें, जिसमें हम डेटाबेस तालिका के उपनाम और प्राथमिक प्राथमिक क्षेत्र का नाम देते हैं।

 class Ak_NovaPoshta_Model_Resource_City extends Mage_Core_Model_Resource_Db_Abstract { public function _construct() { $this->_init('novaposhta/city', 'id'); } }

इसके अलावा Ak_NovaPoshta_Model_Resource_City_Collection और Ak_NovaPoshta_Model_Resource_Warehouse_Collection संग्रह जोड़ें। _Init () विधि के लिए कॉल में, हम मॉडल उर्फ पास करते हैं। उदाहरण Ak_NovaPoshta_Model_Resource_City_Collection:

 class Ak_NovaPoshta_Model_Resource_City_Collection extends Mage_Core_Model_Resource_Db_Collection_Abstract { public function _construct() { $this->_init('novaposhta/city'); } }

एपीआई क्लाइंट मॉडल

आइए Ak_NovaPoshta_Model_Api_Client मॉडल बनाएं, जो एपीआई के साथ काम करने के तर्क को छिपाएगा। ग्राहक कोड: github.com/alexkuk/Ak_NovaPoshta/blob/master/app/code/community/Ak/NovaPoshta/Model/Api/Client.php
हमारे नए बने ग्राहक के पास दो सार्वजनिक तरीके हैं: getCityWarehouses () उन शहरों को लौटाता है जहां न्यू मेल के कार्यालय हैं, getWarehouses () पूरे यूक्रेन में गोदामों की एक सूची देता है। डेटा को SimpleXMLElement ऑब्जेक्ट के रूप में लौटाया जाता है।

आयात

Ak_NovaPoshta_Model_Import मॉडल जोड़ें: github.com/alexkuk/Ak_NovaPoshta/blob/master/app/code/community/Ak/NovaPoshta/Model/Import.php । आयात प्रक्रिया के बारे में विस्तार से बताने का कोई मतलब नहीं है। मैं केवल कुछ चीजों पर ध्यान केन्द्रित करूंगा।

मैंने दो सरणियों $ _dataMapCity और $ _dataMapWarehouse को जोड़ा, जो हमारे डेटाबेस में फ़ील्ड नामों के साथ API द्वारा लौटाए गए फ़ील्ड नामों को जोड़ते हैं। एपीआई से प्रतिक्रिया प्राप्त करने के बाद, हम उस फ़ॉर्म की प्रतिक्रिया लाते हैं जिसे हमें _applyMap () विधि का उपयोग करना चाहिए:

 $cities = $this->_applyMap($cities, $this->_dataMapCity);

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

  /** * @return Varien_Db_Adapter_Interface */ protected function _getConnection() { return Mage::getSingleton('core/resource')->getConnection('core_write'); }

आयात मॉडल का परीक्षण करने के लिए, मैंने Magento की जड़ में test.php स्क्रिप्ट को गिरा दिया। इसमें, हम Mage :: app () विधि को कॉल करके Magento को इनिशियलाइज़ करते हैं, जिसके बाद आप Mage factory का उपयोग कर सकते हैं:

 require 'app/Mage.php'; Mage::app('default'); Mage::getModel('novaposhta/import')->runWarehouseAndCityMassImport();

CRON द्वारा आयात शुरू करें

आयात तैयार है और डीबग किया गया है, अब अच्छा होगा कि इसे समय-समय पर CRON के अनुसार चलाया जाए। Magento का अपना CRON सबसिस्टम है। आप उदाहरण के लिए, यहां पढ़ सकते हैं : www.magentocommerce.com/wiki/1_-_installation_and_configuration/how_to_setup_a_cron_job । संक्षेप में: परिचित यूनिक्स क्रोन में, क्रॉन जॉब जोड़ें, जो क्रोन.एफ़पी या क्रोन.श स्क्रिप्ट चलाएगा, जो बदले में क्रोन मैगेंटो सबसिस्टम शुरू करता है। इस कॉल के भाग के रूप में, config.xml के माध्यम से मॉड्यूल द्वारा जोड़े गए सभी कार्य किए जाते हैं।

तो, हमारे कार्य को config.xml में जोड़ें:

  <crontab> <jobs> <novaposhta_import_city_and_warehouse> <schedule> <cron_expr>1 2 * * *</cron_expr> </schedule> <run> <model>ak_novaposhta/import::runWarehouseAndCityMassImport</model> </run> </novaposhta_import_city_and_warehouse> </jobs> </crontab>

गोदाम तालिका को व्यवस्थापक पैनल में जोड़ें

ऊपर की तस्वीर की तरह एक ग्रिड बनाने के लिए, हमें ब्लॉक के दो वर्गों की आवश्यकता है: ग्रिड के कंटेनर का वर्ग और ग्रिड का वर्ग। Mage_Adminhtml_Block_Widget_Grid_Container से विरासत में मिला बटन का स्वरूप और व्यवहार निर्धारित करता है और Mage_Adminhtml_Block_Widget_Grid ग्रिड को भी प्रदर्शित करता है।

अरे हाँ, आपको अभी भी एक नियंत्रक की आवश्यकता है :)

अतः Ak_NovaPoshta_Block_Adminhtml_Warehouses:

 class Ak_NovaPoshta_Block_Adminhtml_Warehouses extends Mage_Adminhtml_Block_Widget_Grid_Container { public function __construct() { // $this->_blockGroup  $this->_controller   ,   _prepareLayout()     (novaposhta/adminhtml_warehouses).      _prepareLayout(). $this->_blockGroup = 'novaposhta'; $this->_controller = 'adminhtml_warehouses'; this->_headerText = $this->__('Manage warehouses'); parent::__construct(); //   add,    ,         $this->_removeButton('add'); //   ,     $this->_addButton('synchronize', array( 'label' => $this->__('Synchronize with API'), 'onclick' => 'setLocation(\'' . $this->getUrl('*/*/synchronize') .'\')' )); } }

ग्रिड वर्ग:

 class Ak_NovaPoshta_Block_Adminhtml_Warehouses_Grid extends Mage_Adminhtml_Block_Widget_Grid { public function __construct() { parent::__construct(); $this->setDefaultSort('city_id'); $this->setId('warehousesGrid'); $this->setDefaultDir('asc'); $this->setSaveParametersInSession(true); } protected function _prepareCollection() { /** @var $collection Ak_NovaPoshta_Model_Resource_Warehouse_Collection */ $collection = Mage::getModel('novaposhta/warehouse') ->getCollection(); $this->setCollection($collection); return parent::_prepareCollection(); } protected function _prepareColumns() { //    $this->addColumn('id', array( 'header' => $this->__('ID'), 'align' =>'right', 'width' => '50px', 'index' => 'id' ) ); $this->addColumn('address_ru', array( 'header' => $this->__('Address (ru)'), 'index' => 'address_ru' ) ); $this->addColumn('city_id', array( 'header' => $this->__('City'), 'index' => 'city_id', 'type' => 'options', //      City      “”  'options' => Mage::getModel('novaposhta/city')->getOptionArray() ) ); $this->addColumn('phone', array( 'header' => $this->__('Phone'), 'index' => 'phone' ) ); $this->addColumn('max_weight_allowed', array( 'header' => $this->__('Max weight'), 'index' => 'max_weight_allowed' ) ); return parent::_prepareColumns(); } //  false -         public function getRowUrl($row) { return false; } }

अब नियंत्रक। चूंकि नियंत्रक व्यवस्थापक पैनल के लिए है, इसलिए हमें Mage_Adminhtml_Controller_Action से विरासत में मिला है।

 class Ak_NovaPoshta_WarehousesController extends Mage_Adminhtml_Controller_Action { /** *        */ public function indexAction() { $this->_title($this->__('Sales'))->_title($this->__('Nova Poshta Warehouses')); $this->_initAction() ->_addContent($this->getLayout()->createBlock('novaposhta/adminhtml_warehouses')) ->renderLayout(); return $this; } /** *    */ public function synchronizeAction() { try { Mage::getModel('novaposhta/import')->runWarehouseAndCityMassImport(); // ,  success message    $this->_getSession()->addSuccess($this->__('City and Warehouse API synchronization finished')); } catch (Exception $e) { // ,  error message    $this->_getSession()->addError($this->__('Error during synchronization: %s', $e->getMessage())); } //       $this->_redirect('*/*/index'); return $this; } /** * Initialize action * * @return Ak_NovaPoshta_WarehousesController */ protected function _initAction() { $this->loadLayout() ->_setActiveMenu('sales/novaposhta/warehouses') ->_addBreadcrumb($this->__('Sales'), $this->__('Sales')) ->_addBreadcrumb($this->__('Nova Poshta Warehouses'), $this->__('Nova Poshta Warehouses')) ; return $this; } }

लेकिन यह सब नहीं है। सबसे पहले, हमें config.xml के लिए एक मार्ग जोड़ना होगा ताकि Magento हमारे नियंत्रक को ढूंढ सके।

 <config> ... <admin> <routers> <novaposhta> <use>admin</use> <args> <module>Ak_NovaPoshta</module> <frontName>novaposhta</frontName> </args> </novaposhta> </routers> </admin> ... </config>

दूसरे, हमें एक आइटम को व्यवस्थापक मेनू में जोड़ने और इसे एसीएल में जोड़ने की आवश्यकता है। हम यह सब adminhtml.xml में दर्ज करते हैं:

 <?xml version="1.0"?> <config> <menu> <sales> <children> <novaposhta translate="title" module="novaposhta"> <sort_order>200</sort_order> <title>Nova Poshta</title> <children> <warehouses translate="title" module="novaposhta"> <sort_order>10</sort_order> <title>Warehouses</title> <action>novaposhta/warehouses/</action> </warehouses> </children> </novaposhta> </children> </sales> </menu> <acl> <resources> <admin> <children> <sales> <children> <novaposhta translate="title" module="novaposhta"> <title>Nova Poshta</title> <sort_order>200</sort_order> <children> <warehouses translate="title" module="novaposhta"> <sort_order>10</sort_order> <title>Warehouses</title> </warehouses> </children> </novaposhta> </children> </sales> </children> </admin> </resources> </acl> </config>

हो गया

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

मुझे टिप्पणियों, प्रश्नों, सुझावों पर खुशी होगी :)

PS एक उपयोगी टिप्पणी के लिए उपयोगकर्ता कोको के लिए धन्यवाद। डेटाबेस तालिकाओं की संरचना के साथ काम करने के लिए, नवीनीकरण स्क्रिप्ट में Varien_Db_Ddl_Table का उपयोग करना बेहतर है। मैं बहुत आलसी था और गर्म पकड़ा गया था :) SQL क्वेरी के रूप में रिकॉर्डिंग मुझे अधिक पठनीय लगती है, लेकिन अमूर्तता अधिक महत्वपूर्ण है।

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