एक टोकरी के साथ काम करें। ImageCMS कार्ट एपीआई

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

टोकरी की कार्यक्षमता पर काम क्यों किया गया था?

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

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

विकास के स्तर पर, हमने पिछड़ी अनुकूलता के मुद्दे का सामना किया। चूंकि नए दृष्टिकोण में पूरी तरह से नया कार्यान्वयन था, इसलिए हमें इस्तेमाल किए गए तरीकों के लिए एक स्पष्ट सूचक बनाना होगा। पुराने दृष्टिकोण का उपयोग करने के लिए, विशेषता $config['use_deprecated_cart_methods'] = TRUE; डालें $config['use_deprecated_cart_methods'] = TRUE; config में $config['use_deprecated_cart_methods'] = TRUE; नए दृष्टिकोण के लिए, मान FALSE , या फ़ाइल से निर्देश हटाएं।

जहां एपीआई को देखना है, साथ ही इसके प्रलेखन और कार्यान्वयन भी हैं

टोकरी के साथ काम करने के लिए सभी उपलब्ध तरीके दस्तावेज़ीकरण के विशेष रूप से बनाए गए अनुभाग में वर्णित हैं: http://docs.imagecms.net/api-docs Classes Cart\Api



यहां आप विधि का संक्षिप्त विवरण, साथ ही आवश्यक इनपुट पा सकते हैं। यह ImageCMS में इस तरह का पहला प्रलेखन है, इसलिए हम अधिक विवरण जोड़ने और इस खंड के विकास को जारी रखने की योजना बनाते हैं।

उदाहरण

उत्पाद को कार्ट में जोड़ें

निम्न उदाहरण कार्ट में एक आइटम जोड़ता है। ऐसा करने के लिए, addProductByVariantId विधि का उपयोग करें।



इसका उपयोग टोकरी में उत्पाद जोड़ने के लिए भी किया जा सकता है। ऐसा करने का सबसे आसान तरीका AJAX अनुरोध का उपयोग करना है, लेकिन विविधताएं हर स्वाद के लिए अलग हो सकती हैं।

 <a class=”buy” data-variantId=”198” href=”#”></a> $('.buy').on('click', function() { var variantId = $(this).attr('data-variantId'); $.ajax({ url: '/shop/cart/api/addProductByVariantId/'+ variantId, dataType: 'json', success: function() { } }); }) 

इस तरह का एक सरल उदाहरण टोकरी में सामान जोड़ने की सीधी क्षमता दर्शाता है। संकेतित उदाहरण को /shop/cart/api/addProductByVariantId/198 , हम कहते हैं कि यह अनुरोध भेजने के लिए नीचे आया: सर्वर पर /shop/cart/api/addProductByVariantId/198 । उसके बाद, वर्तमान उपयोगकर्ता के लिए टोकरी में ID 19 8, (या बल्कि उत्पाद विकल्प) वाला उत्पाद जोड़ा जाएगा।

टोकरी में वस्तुओं की संख्या

अंतरिक्ष विधि उपयोगकर्ता द्वारा कार्ट में जोड़े गए उत्पादों की संख्या के लिए ज़िम्मेदार है: Cart/Api getTotalItemsCount । सर्वर अनुरोध इस प्रकार है: /shop/cart/api/getTotalItemsCount । लेकिन मान लीजिए कि इस जानकारी को एक टेम्पलेट में या आपके मॉड्यूल के उद्देश्यों के लिए प्रदर्शित करने की आवश्यकता है।

विधि नाम स्थान पथ द्वारा पहुँचा है: \Cart\Api । " create() " श्रृंखला में पहली विधि अनिवार्य है, जो एपीआई के कई समान उदाहरणों के निर्माण को रोक देगा।

व्यवसाय के लिए:

 \Cart\Api::create()->getTotalItemsCount() 

हम प्राप्त करते हैं: {"success":true,"errors":false,"data":1}

JSON प्रारूप json_decode के साथ कार्य करने के लिए फ़ंक्शन का उपयोग करना, हम प्राप्त डेटा को ऑब्जेक्ट के रूप में दर्शा सकते हैं:

 $result = json_decode(\Cart\Api::create()->getTotalItemsCount()); $count = $result->data; //      

हम आगे क्या योजना बनाते हैं?

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

इसके अलावा, आप सिस्टम के डेवलपर संस्करण http://www.imagecms.net/developers को डाउनलोड करके इस दस्तावेज़ के स्थानीय संस्करण को सहेज सकते हैं। प्रलेखन site_name.loc / डॉक्स पर उपलब्ध होगा

हमारे अपडेट के लिए बने रहें; प्रश्नों के मामले में - उन्हें टिप्पणियों में पूछें।