Copyright © 2000, William Weiland
The purpose of this module is to allow a customer to rate and write a review about products in your store.
Use the Merchant admin upload feature to upload the 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.
FTP the two included gif files, whole.gif and half.gif to the graphics/ directory under your Merchant directory. The images are of a heart. If you want to use other images, eg. stars or half stars, simply FTP them to the server and change the URL settings in admin.
Click the link for Rate This to enter the configuration settings from the Utilities Configuration screen.
In admin, under the store, select the Utilities link. Then select the link for Rate This so that you can configure your rating system.
Email
Email address to send ratings to: If you do not want to be notified
every time a rating is made, leave this blank.
Scope
Select which system you want to use and display in your store.
Whole Image URL
The URL should be virtual under your Merchant store.
Half Image URL
The URL should be virtual under your Merchant store.
Image Display
When using the ratings image display (hearts, stars, etc) they will display
at the bottom of each product's screen. This setting allows you to also
display the ratings on the category listing screen.
Prompt Location
The submission prompt can either be in the category tree or at the bottom
of the product screen.
Button
You can change the rating/review submission button to a graphic button by
including a virtual URL.
Separator
If you include a virtual URL for a line image, it will appear between each
customer's review.
Footer
You can include a footer message under the rating/review prompts.
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) In the mmui.mv file you insert the following line in the
MMUI_Begin_Screen function. It is inserted on the line immediately before
the last </TABLE> tag. It goes between the lines marked with * below.
*</TD></TR>
<MvDO FILE = "{g.Module_Root$'modules/util/ratethis.mv'}" NAME = "l.ratee" VALUE = "{RateThis_Prompt()}">
*</TABLE>
Note: the rate this prompt will not display unless a customer is logged in.
2) In the mmui.mv file you insert the following line in the
MMUI_ProductDisplay function. It is inserted on the line immediately before
the next to the last </TABLE> tag. This table tag follows the cell
which contains Products.d.desc The code goes between the lines marked with
* below.
*</TD></TR>
<MvDO FILE = "{g.Module_Root$'modules/util/ratethis.mv'}" NAME = "l.rating" VALUE = "{RateThis_Get_Rating(Products.d.code)}">
*</TABLE>
Alternatively, you can include the first insert above immediately
after the second. This would put the rater input below the rater display
and on the product screen vs the category column.
3) If you want to also include the graphic image rating display on the
category listing of products (in addition to the product screen), add the
following line just below the product description (desc) cell in the
mmui.mv Display_Product_ScreenExpand function. Many people have already
modified their category display screen, so you may find it necessary to
change slightly the table cells surrounding the line below for better
alignment. That can be done by editing the RateThis_Short_Rating function
within the ratethis.mv file.
<MvDO FILE = "{g.Module_Root$'modules/util/ratethis.mv'}" NAME = "l.rating" VALUE = "{RateThis_Short_Rating(Products.d.code)}">