Install Guide for Noodlemans Tax_Exempt_Customers Plugin for CubeCart 5

This install guide has been written for version 5.2.2 of CubeCart, if you are installing in another version the line numbers referenced may be slightly different. If there is any doubt open a support ticket for assistance. You will need a demo license key to be able to use this plugin, please request one from support if you do not have one.

SUPPORT IS AVAILABLE FROM http://www.noodleman.co.uk/support

1. Disable Store Cache

   Log into your store admin area, navigate to "Store Settings -> Advanced" and set "Enable Caching" to Disabled. Save the change

   
   
   
   
2. Extract Files

   Extract the files from the .zip file to your servers "modules/plugins" directory. The final path should be "modules/plugins/Tax_Exempt_Customers"

   
   
   
   
3. Add Items To Your Skin

   Open the file "skins//templates/content.register.php" with your favourite text editor. The code snippit below will add the extra form option to the account registration form. You can add this to any part of your registration form, its up to you where it goes.

Add in a Suitable place: {if isset($TAX_EXEMPT_CUSTOMERS_REGISTRATION)} {$TAX_EXEMPT_CUSTOMERS_REGISTRATION} {/if} {if isset($TAX_EXEMPT_CUSTOMERS_DETAILS)} {$TAX_EXEMPT_CUSTOMERS_DETAILS} {/if}



4. Add Items To Your Skin

   Open the file "skins//templates/content.product.php" with your favourite text editor. The code below allows you to highlight that a product may be tax exempt. Add this to an appropriate place in your template file and update the HTML as necessary. It is up to you how you word the messages, the code below is an example of how it can be used. In english, the code checks if the product being viewed is tax exempt for some customers, if it is then it will display your HTML code. A second template variable is also available for use if you choose, it is $PRICE_WITH_20_PERCENT_TAX. It will show the product price + 20%

Add in a Suitable place: {if isset($TAX_EXEMPT_CUSTOMERS_STATUS) && $TAX_EXEMPT_CUSTOMERS_STATUS == 1} <p><strong>This product may be tax exempt</strong></p> {/if}



5. Add Items To Your Skin

   Open the file "skins//templates/content.checkout.confirm.php" with your favourite text editor. The code snippit below will add the extra form option to the account registration form. You can add this to any part of your registration form, its up to you where it goes.

Add in a Suitable place: {if isset($TAX_EXEMPT_CUSTOMERS_REGISTRATION)} {$TAX_EXEMPT_CUSTOMERS_REGISTRATION} {/if} {if isset($TAX_EXEMPT_CUSTOMERS_DETAILS)} {$TAX_EXEMPT_CUSTOMERS_DETAILS} {/if}



6. Update Admin Customer Page

   Open the file "admin/skins/default/templates/customers.index.php" with your favourite text editor.

Around line number 134 FIND: <div><label for="cust-password">{$LANG.user.password_new}</label><span><input type="password" autocomplete="off" name="customer[password]" id="cust-password" class="textbox" /></span></div> <div><label for="cust-passconf">{$LANG.user.password_confirm}</label><span><input type="password" autocomplete="off" name="customer[passconf]" id="cust-passconf" rel="cust-password" class="textbox confirm" /></span></div> </fieldset>
AFTER ADD ON A NEW LINE: {if isset($CUSTOMER.tec_details) && $CUSTOMER.tec_details != ""} <fieldset><legend>Tax Exempt Customer Information</legend> <div><label for="cust-passconf">Customer disability information</label><span><textarea name="customer[tec_details]" style="width:350px; height:90px;">{$CUSTOMER.tec_details}</textarea></span></div> </fieldset> {/if}



7. Update Admin Order Page

   Open the file "admin/sources/orders.index.inc.php" with your favourite text editor.

Around line number 375 FIND: $GLOBALS['main']->addTabControl($lang['common']['notes'], 'order_notes', null, null, $no_notes);
AFTER ADD ON A NEW LINE: $GLOBALS['main']->addTabControl('Tax Declaration', 'customer_declaration');



8. Update Admin Order Page

   Open the file "admin/skins/default/templates/orders.index.php" with your favourite text editor.

Around line number 182 FIND: <div id="order_billing" class="tab_content">
BEFORE, ADD ON A NEW LINE: <div id="customer_declaration" class="tab_content"> {$CUSTOMER_DECLARATION} </div>



9. Add a custom hook

   Open the file "classes/user.class.php" with your favourite text editor.

Around line number 340 FIND: $data['registered'] = time(); $GLOBALS['db']->insert('CubeCart_customer', $data); $customer_id = $GLOBALS['db']->insertid();
AFTER ADD ON A NEW LINE: foreach ($GLOBALS['hooks']->load('class.user.register_user.insertedAgain') as $hook) include $hook;