Viking Coders Miva Merchant Module Support and FAQ - Is it possible to enter items into the basket which are not in Merchant's databases, such as auction items?

Miva Merchant 4 Module FAQs » Phone Order Manager (BROK_PHONEORDERS)

{docurl}

Is it possible to enter items into the basket which are not in Merchant's databases, such as auction items?

Yes, there are tokens that can be used in the "main template" so that a "section" of the Phone Order Manager page can be dedicated to entering these "special" items. Each of these tokens can be used to collect the data needed by the module to add the product to the basket:

%special_code#% (the product code. A required field)
%special_name#% (the prdouct name or description. if not entered or the token isn't used, the code will be used instead)
%special_quantity#% (the quantity of that product to add to the basket; required)
%special_price#% (the price; not required)
%special_weight#% (the weight of a single one of the items; not required but may be needed by your shipping module)
%special_attr#|x|yyy|% (can be used to collect additioanl data about the product which will be saved as an attribute when the product is added to the basket. The x, is the # of the attribute, up to 5 can be added for each product. The yyy is the length of the text field to display to prompt for the attribute. So to prompt, for the first product, for 3 attributes in a field 20 characters long you would have:

 %special_attr1|1|020|%
 %special_attr1|2|020|%
 %special_attr1|3|020|%)

The # can be any number from 1 to 9 (i.e. you can have a form to enter up to 9 special items at a time; %special_code1% would prompt for the code for item 1, %special_code2% would prompt for the code for item 2, etc.).

Using the above tokens (other than the %special_attr# tokens), the field length will have default lengths. In addition to these forms of the tokens, you can also specify a particular field length by using the tokens in the form (where xxx is the field length):

%special_code#|xxx|%
%special_name#|xxx|%
%special_quantity#|xxx|%
%special_price#|xxx|%
%special_weight#|xxx|%

Here is a bit of example code which will add a "special items" section to the Phone Order Manager page to collect data for 2 items. In my test store, I put this in the "main template" right below the end of the little table which displays the payment method (i.e. the table that the %paymentlist% token is in):

<hr>
<center><h2>Special Items</h2></center>
<TABLE BORDER="0" CELLPADDING="2" CELLSPACING="0" WIDTH="100%">
<TR>
<TD ALIGN="left" VALIGN="middle" BGCOLOR="#000080">

</TD>
<TD ALIGN="left" VALIGN="middle" BGCOLOR="#000080">

Code

</TD><TD ALIGN="left" VALIGN="middle" BGCOLOR="#000080">

Description

</TD><TD ALIGN="left" VALIGN="middle" BGCOLOR="#000080">

Quantity

</TD><TD ALIGN="right" VALIGN="middle" BGCOLOR="#000080">

Price/Ea.

</TD><TD ALIGN="center" VALIGN="middle" BGCOLOR="#000080">

Weight

</TD><TD ALIGN="center" VALIGN="middle" BGCOLOR="#000080">

Note

</TD></TR>
<TR>
<TD ALIGN="left" VALIGN="middle" BGCOLOR="white">
</TD>
<TD ALIGN="left" VALIGN="middle" BGCOLOR="white">
%special_code1%
</TD><TD ALIGN="left" VALIGN="middle" BGCOLOR="white">
%special_name1%
</TD><TD ALIGN="left" VALIGN="middle" BGCOLOR="white">
%special_quantity1%
</TD><TD ALIGN="right" VALIGN="middle" BGCOLOR="white">
%special_price1%
</TD><TD ALIGN="center" VALIGN="middle" BGCOLOR="white">
%special_weight1%
</TD><TD ALIGN="center" VALIGN="middle" BGCOLOR="white">
%special_attr1|1|020|%
</TD></TR>
<TR>
<TD ALIGN="left" VALIGN="middle" BGCOLOR="cornsilk">

</TD>
<TD ALIGN="left" VALIGN="middle" BGCOLOR="cornsilk">
%special_code2%
</TD><TD ALIGN="left" VALIGN="middle" BGCOLOR="cornsilk">
%special_name2%
</TD><TD ALIGN="left" VALIGN="middle" BGCOLOR="cornsilk">
%special_quantity2%
</TD><TD ALIGN="right" VALIGN="middle" BGCOLOR="cornsilk">
%special_price2%
</TD><TD ALIGN="center" VALIGN="middle" BGCOLOR="cornsilk">
%special_weight2%
</TD><TD ALIGN="center" VALIGN="middle" BGCOLOR="cornsilk">
%special_attr2|1|020|%
</TD></TR>
</TABLE>
<center>%updatebutton%</center>