Copyright © 2000, William Weiland
Displays a brief summary of items currently in each customer's basket as they shop within a Miva Merchant 2.x, 3.x or 4.x store.
Use the Merchant admin upload feature to upload the minibask.mv (minibask.mvc - compiled version) module. Once uploaded, click the Add button to add it to the mall/domain.
In admin, under your store, click on the link for Utilities Configuration Screen. Assign the module and Update it to install it in your store.
Click the link for Mini-basket Display to enter the configuration settings.
If using compiled Merchant, there is an additional module (cim_log.mvc) which allows you to record recently visited pages. This module is used by several of our modules so it may already exist in your domain. If it does, update it. If it does not, then add it like you did the minibask.mvc. It is assigned to the store under the Logging Configuration screen.
In the compiled version of merchant, you can optionally use the
minibasket on a static page if you use an iframe on the static page.
For example:
<iframe src="http://www.yourdomain.com/Merchant2/merchant.mvc?Store_Code=yourstorecode&Screen=MINI&Action=NEW" name="mini-basket" frameborder="0" style="border:2px;border-style:solid;border-color:#0000ff;width:175px;height:200px;margin:1px" align="left">
</iframe>
If you need this feature, you will install the cim_new.mvc as a system
extension module.
Enter data into the applicable input fields.
Title
At the top of the mini-basket the title will be listed. It can either be
text or a graphic. If you choose to enter a graphic url, put it in html
format and make the path virtual, i.e. under your merchant directory. Most
will put it in a directory like graphics/mmui/basket.gif where graphics is
a directory directly under your Merchant2 directory.
Column Headings
In the mini-basket you will have three columns. Enter the text you want for
the name of each column.
Text and Background Characteristics
The labels to the input fields are self explanatory.
Table Width
This determines how wide your mini-basket will be.
Checkout
The link after is the amount (cost of goods) that must be in the basket before
the checkout tag in the mini-basket appears. Keep in mind that the checkout
button on the nav bar is independent of this setting. However, you can
eliminate the nav bar checkout by changing its graphic to the blank.gif (a
transparent, small image that make the button disappear). The label for
checkout can either be text or an image. If you use an image, write it as
html and make sure the graphic is virtual, i.e. below the merchant directory.
Shipping
If you want customers to be able to run a shortcut to see what their shipping
charge is going to be, either enter text or a graphics for the link.
Recent Visit History
You can configure how many links to show in the history. Note: If you use the visit history
feature you will need to clean up the history database periodically as the log will grow
very big. Check the box and click update. If you don't want history, select no display
at "Show Recently Visit Links" and erase the input "Recently Visited Title". If the clean
up times out, we have implemented a quicker method in version 4.85 of the module. In the
admin change "Show Recently Visit Links" to No display, check the box to clean up, and then
click Update. After doing this, you can reset the "Show Recently Visit Links" selection to
your prior setting.
Location
If you are using the OpenUI, you can place the mini-basket either at the
top or bottom of the category column just by changing the setting here in
admin. If you are using the MMUI look and feel, you will use the code
discussed in editing requirements below to determine its placement.
If you are using the Miva Merchant User Interface (mmui) you will need to make some very simple edits to the core files. Be sure to do that with a text editor (NO WYSIWYG editors) such as Programmer's File Editor (PFE) so as not to damage the mv files. ALWAYS BACKUP your unmodified mv files in case you make a mistake.
1) Locate the function MMUI_Begin_Screen in the mmui.mv file. Locate the
line below that function that reads:
<MIVA STANDARDOUTPUTLEVEL = "text, html"><MvEVAL EXPR = "{ MMUI_Store.d.ctgy_head }"> <MIVA STANDARDOUTPUTLEVEL = "text, html, compresswhitespace">
On the line immediately preceding that line, enter the following line:
<MvDO FILE="{g.Module_Root$'modules/util/minibask.mv'}" NAME="l.currentbasket" VALUE="{MiniBasket()}">
2) If you want it to show at the bottom of the column, in the same
function, just above the last </TABLE> tag, enter the following three lines:
<TR><TD>
<MvDO FILE="{g.Module_Root$'modules/util/minibask.mv'}" NAME="l.currentbasket" VALUE="{MiniBasket()}">
</TD></TR>
Q: When I add a product to the shopping basket and click on "Shipping Options?" in the Minibasket window it says "Login in".
A: You have set your admin to hide one of the following customer fields (state, country, or zip code). Go to admin:stores and click on the store name to Edit the store. Click the tab for Customer Fields. You need to make sure none of them are hidden as some shipping modules require one, two or three of those elements. Hence, the minibasket requires that all be available if you want to use the shipping preview feature.