QwkAdd - Mass Add Products To Basket
QwkAdd - Mass Add Products To Basket
Documentation for version 1.001001.
Copyright © 2004, QwkSoft.
Licensed to 4TheBest eCommerce Solutions.
Contents
Introduction
QwkAdd allows you to post data from your own HTML forms into Miva Merchant with the result of added multiple products to the basket at the same time. You can create as many different HTML forms as you wish using any HTML editing software that you want, and as long as the form contains the properly named fields you will be able to allow a shopper to enter quantities for as many products on the screen as they want, and submit once to add them all to the basket at the same time.
Installation
The QwkSoft Mass Add Products To Basket distribution contains 2 files: qwkadd.mvc and qwkadd.html (this documentation file). Install the *.mvc file in your domain and store as usual for Miva Merchant modules. Please refer to the documentation for your version of Miva Merchant for more information.
note: if you are using a non-compiled version of Miva Merchant you will need the non-compiled version of this module. That distribution contains *-nc.mv files in place of *.mvc files.
QwkSoft Mass Add Products To Basket is a System Extension module.
Store Screen
This module places 2 tabs on the
(Some tabs may not be visible at all times)
Tab
License Tab
Enter licensing information here. Please note that once you have entered your license information this tab will no longer be visible.
License
Enter the license number that you were issued when you purchased this software.
Check this box if you have read and and agree to the EULA. You must agree to the EULA to use this software.
Form field names and formats
Every form must use an action that is the full or relative URL to Miva Merchant, a method of POST and have various fields as defined below.
| Field Name |
Value |
Type of Data |
| Screen |
BASK |
Literal, Hidden |
| Action |
NEW |
Literal, Hidden |
| NewAction |
QWKADD |
Literal, Hidden |
| QWKADD_Prod[#]:code |
product code |
Variable, Unique, Hidden |
| QWKADD_Prod[#]:quantity |
number |
Variable, User Entered, Text Input |
Note that the "#" should be replaced with a sequential number, so that the first product woudl have a 1, the second a 2, etc. The Quantity woudl normally be a text input that the user can enter the choice of quantity. The Screen variable does have to be a literal value but it can be a different screen than the BASK screen which takes the user to the basket contents. you could for example set the screen to LOGN and then set an additional hidden field called Order to a value of 1 and that would cause the shopper to be sent to the customer login screen in the checkout mode that shows the link to proceed to checkout without creating an account.
Example HTML Page
Here is fully functional example html page that can be used to add software to your ModuleStore.com basket.
<![CDATA[
<html>
<head><title>QwkAdd software to your shopping basket</title></head>
<body>
<h1>QwkAdd software to your shopping basket</h1>
<form action="http://www.modulestore.com/Merchant2/merchant.mvc" method="post">
<input type="hidden" name="store_code" value="module-store">
<input type="hidden" name="Screen" VALUE="BASK">
<input type="hidden" name="Action" VALUE="NEW">
<input type="hidden" name="NewAction" VALUE="QWKADD">
<table border="1" cellpadding="5" cellspacing="0">
<tr>
<td>PRODUCT</td>
<td>PRICE</td>
<td>QTY.</td>
</tr>
<tr>
<td>QwkGuard</td>
<td>$179</td>
<td>
<input type="hidden" name="QWKADD_Prod[1]:code" VALUE="qwkguard">
<input type="text" name="QWKADD_Prod[1]:quantity" VALUE="" size="3">
</td>
</tr>
<tr>
<td>QwkPatch</td>
<td>$39</td>
<td>
<input type="hidden" name="QWKADD_Prod[2]:code" VALUE="qwkpatch">
<input type="text" name="QWKADD_Prod[2]:quantity" VALUE="" size="3">
</td>
</tr>
<tr>
<td>QwkPromo</td>
<td>$279</td>
<td>
<input type="hidden" name="QWKADD_Prod[3]:code" VALUE="qwkpromo">
<input type="text" name="QWKADD_Prod[3]:quantity" VALUE="" size="3">
</td>
</tr>
<tr>
<td>QwkShip</td>
<td>$179</td>
<td>
<input type="hidden" name="QWKADD_Prod[4]:code" VALUE="qwkship">
<input type="text" name="QWKADD_Prod[4]:quantity" VALUE="" size="3">
</td>
</tr>
<tr>
<td>QwkTIF</td>
<td>$39</td>
<td>
<input type="hidden" name="QWKADD_Prod[5]:code" VALUE="qwktif">
<input type="text" name="QWKADD_Prod[5]:quantity" VALUE="" size="3">
</td>
</tr>
<tr>
<td>QwkTracker</td>
<td>$379</td>
<td>
<input type="hidden" name="QWKADD_Prod[6]:code" VALUE="qwktracker">
<input type="text" name="QWKADD_Prod[6]:quantity" VALUE="" size="3">
</td>
</tr>
<tr>
<td>QwkIssue</td>
<td>$179</td>
<td>
<input type="hidden" name="QWKADD_Prod[7]:code" VALUE="qwkissue">
<input type="text" name="QWKADD_Prod[7]:quantity" VALUE="" size="3">
</td>
</tr>
<tr>
<td>QwkInventory</td>
<td>$79</td>
<td>
<input type="hidden" name="QWKADD_Prod[8]:code" VALUE="qwkinventory">
<input type="text" name="QWKADD_Prod[8]:quantity" VALUE="" size="3">
</td>
</tr>
<tr>
<td>QwkSwap</td>
<td>$79</td>
<td>
<input type="hidden" name="QWKADD_Prod[9]:code" VALUE="qwkswap">
<input type="text" name="QWKADD_Prod[9]:quantity" VALUE="" size="3">
</td>
</tr>
<tr>
<td>QwkTrigger</td>
<td>$79</td>
<td>
<input type="hidden" name="QWKADD_Prod[10]:code" VALUE="qwktrigger">
<input type="text" name="QWKADD_Prod[10]:quantity" VALUE="" size="3">
</td>
</tr>
<tr>
<td>QwkRed</td>
<td>$79</td>
<td>
<input type="hidden" name="QWKADD_Prod[11]:code" VALUE="qwkred">
<input type="text" name="QWKADD_Prod[11]:quantity" VALUE="" size="3">
</td>
</tr>
<tr>
<td>QwkAdd</td>
<td>$79</td>
<td>
<input type="hidden" name="QWKADD_Prod[12]:code" VALUE="qwkadd">
<input type="text" name="QWKADD_Prod[12]:quantity" VALUE="" size="3">
</td>
</tr>
<tr>
<td colspan="3">
<input type="submit" name="Add to basket" value="Add to basket">
</td>
</tr>
</table>
</form>
</body>
</html>
]]>
Known Limitations
The current version of QwkAdd doesn't allow for the batch adding of attributes and their options, and forms should not be created that use products that have attributes or unexpected and unpleasant results may occur. We may add the ability to proccess attributes and options in future versions depending on demand. If you have a strong desire to see the feature added, send an email to info@QwkSoft.com requesting the feature.