1 User Guide Magent Add Multiple Prducts t Cart MAGENTO ADD MULTIPLE PRODUCTS TO CART USER GUIDE BSSCOMMERCE 1
2 User Guide Magent Add Multiple Prducts t Cart Table f Cntents I. Magent Add Multiple Prducts t Cart Extensin Overview... 3 II. Hw des Magent Add Multiple Prducts t Cart Extensin wrk?... 3 III. Guidance t run Add Multiple Prducts t Cart n CMS r Static Page. 6 IV. Cntact Us... 19 BSSCOMMERCE 2
3 User Guide Magent Add Multiple Prducts t Cart I. Magent Add Multiple Prducts t Cart Extensin Overview As yu knw, default Magent des nt allw custmers t add many prducts t carts at nce in prduct list pages such as categry pages and search result page. This setting f default Magent will cmplicate their shpping prcess and waste their time by requesting them t visit each prduct page separately. Especially, fr whlesalers wh buy great variety f prducts in large quantity, dealing with that cmplex purchasing prcedure is a real challenge. Understand the difficulties custmers are facing, Magent Add Multiple Prducts t Cart is develped by BSSCmmerce t bring better shpping experience fr custmers. By allwing custmers t add multiple items t cart with varius quantities at nce, this extensin enables a quicker rder prcess and helps stre wners increase sales, especially when their target custmers are whlesalers II. Hw des Magent Add Multiple Prducts t Cart Extensin wrk? G t System > Cnfiguratin > BSS COMMERCE > Add Multiple Prducts t start making cnfiguratin. BSSCOMMERCE 3
4 User Guide Magent Add Multiple Prducts t Cart In Enable: Chse Yes t enable the mdule Chse N t disable it In Add lib jquery: Chse Yes t add Library jquery if yur site desn t have it Chse N if yur site already has it In Use Ajax Add t Cart: Chse Yes if yu allw Ajax pp-up enabling custmers t specify ptins f prducts with ptins that they frgt t while adding t cart Chse N t disable Ajax pp-up and shwing Errr Ntificatin at the tp f the page instead. In Custmer Grup: Chse custmer grup t apply this mdule t. It means nly custmers in selected grup can add multiple prducts t cart BSSCOMMERCE 4
5 User Guide Magent Add Multiple Prducts t Cart In Categry: Select categries that yu want t apply this mdule t. It means that when yu chse a categry, custmers can add multiple prducts belnging t that categry t cart In Custm Optins Prduct: Chse Yes t enable the functin f adding multiple prducts t cart fr prducts with custm ptins Chse N t disable this functin fr prducts with custm ptins. There will be n check bx and quantity bx fr this prduct type in frntend. Custmers cannt add custm ptins prducts alng with ther prduct types Similarly, yu can chse prduct types t apply this mdule: In Dwnladable Prduct: Chse Yes and custmers can add multiple dwnladable prducts t cart Chse N t disable this functin fr dwnladable prducts and hide check bx and quantity bx fr this prduct type. In Cnfigurable Prduct: Chse Yes and custmers can add multiple cnfigurable prducts t cart Chse N t disable this functin fr cnfigurable prducts and hide check bx and quantity bx fr this prduct type. In Bundle Prduct: Chse Yes and custmers can add multiple bundle prducts t cart BSSCOMMERCE 5
6 User Guide Magent Add Multiple Prducts t Cart Chse N t disable this functin fr bundle prducts and hide check bx and quantity bx fr this prduct type. Finally, yu click Save Cnfig and see changes in the frntend. Nte: This mdule nw wrks well in bth Grid and List view frm III. Guidance t run Add Multiple Prducts t Cart n CMS r Static Page There are 2 ways admin culd use Add Multiple Prducts t Cart functin n CMS r Static Page: 1. Custmize yur prduct list template accrding t the list f this mdule If yu have a cde file in frm f list.phtml, yu culd bring thse prduct t CMS Page r any page. Hwever, if yu want t apply Add Munltiple Prduct t Cart functin, yur cde file list.phtml has t be frmated accrding t the cde file list.phtml f this mdule. Step 1: back up file app/design/frntend/base/default/template/bss/addmultipleprducts/catalg/prduct/list.p html Step 2: cpy file frm yur theme app/design/frntend/theme/template/catalg/prduct/list.phtml and paste t path app/design/frntend/base/default/template/bss/addmultipleprducts/catalg/prduct/ r app/design/frntend/theme/template/bss/addmultipleprducts/catalg/prduct/ BSSCOMMERCE 6
7 User Guide Magent Add Multiple Prducts t Cart in file list *Nte: search the keywrds add multiple prducts in the ld file t bserve the changes (custm part lcating in: <!-- add muntiple prducts --> custm part <!-- end --> ) Step 3: Add frm: <frm actin="<?php ech Mage::helper("addmultipleprducts")->getFrmUrl();?>" methd="pst" id="prduct_addmuntile_frm"> <?php ech $this->getblckhtml('frmkey');?> <input type="checkbx" name="checkall" class="checkall" value="1"> <label fr="checkall">check All</label> <buttn type="buttn" title="add t Cart" class="buttn btncartall"><span><span>add All t Cart</span></span></buttn> after the tab <div class="categry-prducts"> and add <input type="checkbx" name="checkall" class="checkall" value="1"> <label fr="checkall">check All</label> <buttn type="buttn" title="add t Cart" class="buttn btncartall"><span><span>add All t Cart</span></span></buttn> </frm> BSSCOMMERCE 7
8 User Guide Magent Add Multiple Prducts t Cart r nly </frm> (if yu dn t need the belw buttn) in prir t the clsing tab f <div class="categry-prducts"> Step 4: Add the ptin: Checkbx + Qty and the buttn Add T Cart + View in prducts-list and prducts-grid a. Add ptin: Checkbx + Qty <?php $prduct = Mage::getMdel("catalg/prduct")->lad($_prduct->getId()) ;?> <?php if( $_prduct->issaleable() && Mage::helper("addmultipleprducts")- >getprductcnfig($prduct) ) :?> <?php if($_prduct->cancnfigure() $prduct->getoptins()) :?> <div class="shw-ptin"> <label class="required" fr="ptins"><em>*</em>select Optin</label> <input type="checkbx" name="shw.ptin" class="shw-ptin-ck" value="<?php ech $_prduct->getid()?>"></input> </div> <?php endif?> nne"> <div id="bss_ptin<?php ech $_prduct->getid()?>" style="display: <?php ech Mage::helper("addmultipleprducts")- >getprductoptinshtml($prduct);?> </div> BSSCOMMERCE 8
9 User Guide Magent Add Multiple Prducts t Cart <div id="bss_<?php ech $_prduct->getid()?>" style="margin: 8px 0; clear: bth;"> <input type="checkbx" name="cprduct[]" class="cprduct" id="cprduct-<?php ech $_prduct->getid()?>" value="<?php ech $_prduct->getid()?>"> <input type="text" class="quantity" name="qty_<?php ech $_prduct- >getid()?>" id="qty-<?php ech $_prduct->getid()?>" value="1" style="width: 3.2em;"> </div> <?php endif?> b. Add buttn: Add T Cart + View <?php if( $_prduct->issaleable() && Mage::helper("addmultipleprducts")- >getprductcnfig($prduct) ) :?> <buttn type="buttn" title="<?php ech $this->quteescape($this- > ('Add t Cart'))?>" class="buttn btncart" nclick="single_add(dcument.getelementbyid('qty-<?php ech $_prduct- >getid()?>').value,'<?php ech $_prduct->getid();?>','<?php ech Mage::helper('addmultipleprducts/cart')->getAddUrl($_prduct);?>') "><span><span><?php ech $this-> ('Add t Cart')?></span></span></buttn> <?php elseif($_prduct->getstckitem() && $_prduct->getstckitem()- >getisinstck()):?> BSSCOMMERCE 9
10 User Guide Magent Add Multiple Prducts t Cart <a title="<?php ech $this->quteescape($this-> ('View Details'))?>" class="buttn" href="<?php ech $_prduct->getprducturl()?>"><?php ech $this- > ('View Details')?></a> <!-- end --> Step 5: Add script <script type="text/javascript"> jquery(dcument).ready(functin() { var validate_ptin = "<?php ech Mage::helper('addmultipleprducts')- >SystemCnfig('validate_ptin')?>"; jquery('.checkall').click(functin() { if(jquery(this).is(":checked")) { jquery(".checkall").prp( "checked", true ); var len = dcument.getelementsbyclassname('cprduct').length; var i; fr(i=0;i<(len);i++) { dcument.getelementsbyclassname('cprduct')[i].checked = true; else { jquery(".checkall").prp( "checked", false ); var len = dcument.getelementsbyclassname('cprduct').length; var i; BSSCOMMERCE 10
11 User Guide Magent Add Multiple Prducts t Cart fr(i=0;i<(len);i++) { dcument.getelementsbyclassname('cprduct')[i].checked = false; ); jquery('.shw-ptin-ck').click(functin(){ var prductid = jquery(this).attr('value'); if(jquery(this).is(":checked")) { jquery('#bss_ptin'+ prductid).css('display','blck'); else{ jquery('#bss_ptin'+ prductid).css('display','nne'); ) jquery('.btn-cartall').click(functin() { var errr = false; var errr1 = true; jquery('.cprduct').each(functin() { if(jquery(this).is(':checked')) { errr1 = false; BSSCOMMERCE 11
12 User Guide Magent Add Multiple Prducts t Cart ); if(errr1 == true) { alert("n checkbx selected!"); else { jquery('.quantity').each(functin() { if(jquery(this).val() < 0 isnan(jquery(this).val()) == true) { alert("invalid Value!"); jquery(this).fcus(); errr = true; ); if(errr == false && errr1 == false) { if (validate_ptin == 1) { var dataurl = "<?php ech $this- >getbaseurl().'addmultipleprducts/cart/stpadd'?>"; var addtcartalldata = jquery("#prduct_addmuntile_frm").serialize(); jquery.ajax({ type: 'POST', BSSCOMMERCE 12
13 User Guide Magent Add Multiple Prducts t Cart url: dataurl, data: addtcartalldata, success: functin(data){ var jsn = data, bj = JSON.parse(jsn); if (bj.flag == 1) { jquery('#prduct_addmuntile_frm').submit(); else{ alert(bj.mess); ); else { jquery('#prduct_addmuntile_frm').submit(); ); ); functin single_add(qty,prid,url) { BSSCOMMERCE 13
14 User Guide Magent Add Multiple Prducts t Cart var validate_ptin = "<?php ech Mage::helper('addmultipleprducts')- >SystemCnfig('validate_ptin')?>"; var errr = false; jquery('#prduct_addmuntile_frm').attr('actin',url); var qty = jquery('#qty-'+ prid).val(); if(qty < 0 isnan(qty) == true) { alert("invalid Value!"); jquery('#qty-'+prid).fcus(); errr = true; if(errr == false) { if (validate_ptin == 1) { var dataurl = "<?php ech $this- >getbaseurl().'addmultipleprducts/cart/stpadd'?>" + '?prid=' + prid; var addtcartalldata = jquery("#prduct_addmuntile_frm").serialize(); jquery.ajax({ type: 'POST', url: dataurl, data: addtcartalldata, success: functin(data){ var jsn = data, BSSCOMMERCE 14
15 User Guide Magent Add Multiple Prducts t Cart bj = JSON.parse(jsn); if (bj.flag == 1) { jquery('#prduct_addmuntile_frm').submit(); else{ alert(bj.mess); ); else { jquery('#prduct_addmuntile_frm').submit(); </script> BSSCOMMERCE 15
16 User Guide Magent Add Multiple Prducts t Cart Screensht: BSSCOMMERCE 16
17 User Guide Magent Add Multiple Prducts t Cart BSSCOMMERCE 17
18 User Guide Magent Add Multiple Prducts t Cart 2. Use the template f this mdule If yu d nt want t edit yur cde, then yu have t use the template f this mdule when yu create list n CMS page. The simplest way t d this is t add a widget t the CMS page which allws yu t specify the template. Fr example, if yu have a cde as {{blck type="catalg/prduct_list" name="hme.catalg.prduct.list" alias="prducts_hmepage" template="catalg/prduct/list.phtml" change it int {{blck type="catalg/prduct_list" name="hme.catalg.prduct.list" alias="prducts_hmepage" template="bss/addmultipleprductscatalg/prduct/list.phtml" * Nte: Cmparing the base cde versus the cde f Add Multiple Prducts t Cart mdule, yu will easily identify different parts between tw cde fr later custmizatin. BSSCOMMERCE 18
19 User Guide Magent Add Multiple Prducts t Cart IV. Cntact Us Any questins r cncern abut us, feel free cntact: Website: http:/bsscmmerce.cm Supprt: supprt@bsscmmerce.cm Skype: supprt.bsscmmerce BSS Supprt team is always ready t aid yu with any issue referring t ur prducts. Additinally, we als give yu Website develpment and Administratin Supprt. We d ffer: 1. Free cmmercial prducts installatin services 2. Free updates within ffered supprt perid Our duties: 1. Respnsibility fr reslving prduct bugs 2. Help with technical queries 3. Technical supprt in installatin and prduct usage. BSSCOMMERCE 19