Step 1 - Run the setup using the reviewsetup token. See the reviewsetup paragraph at http://www.emporiumplus.com/1AA00223.html Important: Make sure you do NOT already have the custom product fields "rating" or "reviews". Step 2 - Create all 5 pages listed below. Step 3 - FTP tkwhole.gif, tkhalf.gif, and tkzero.gif images to the mm5/graphics/ directory Step 4 - Put the render token on the product page at the location where you want to see the rating/review inputs. Go to admin > pages > PROD. Click edit. Click product layout tab at the top. Insert Click "Items" at the top of the PROD page template and make sure the toolkit item is assigned to the PROD page. Step 5 - If you are using Power Search module, rebuild the mirror database. Step 6 - To facilitate login and return to the product page, insert the following line inside the form on the LOGN page template. This will put the product code in that form if it is passed from the login link on the product page. Then determine which page is the landing page after a customer successfully logs in. It will probably be ACED or ACLN, depending on if you have MMUI or CSSUI. At the very top (before any other lines), put the following code on that page. This code will return the customer to the correct product if the variable Product_Code exists. Page 1 ************************************************************************************************ RRPROD Create a new page with the code RRPROD and name Ratings and Reviews. Copy and paste the contents in this page 1 section. Do not put html, body, head or other tags in this page. Add the page. IMPORTANT: Click Items and assign "product" to the items list of this page as it is not automatically assigned. There are a few comment tags which you could remove if you want to allow non-logged in (anonymous) customers to rate and review. Wait until after successfully creating the new page before you remove those comment tags. remove comment tags if you are going to allow non-logged in customers to rate
(&mvt:global:rating:average;) &mvte:global:rating:count; rater raters
&mvte:global:briefreview; &mvte:briefreviews:rater:ship_fname; Anonymous
Read All Reviews

Login and be the first to write a review Write a review write a review
or Write an anonymous review
Thank you. Check your email for a valuable coupon. Thank you. We check for spam and then approve legitimate reviews. Your review should be visible later today.

remove comment tags if you want non-logged in customers to review
Show my first name and home state with my review
I would recommend this product to a friend
Let others know you bought the item you are reviewing

I would recommend this product to a friend
&mvte:global:verifyA;   +   &mvte:global:verifyB;   =      &mvte:global:tryagain;   

Page 2 ************************************************************************************************** RRLIST Create a new page with the code RRLIST and name Ratings and Reviews List. Copy and paste the contents in this page 2 section. This example is for CSSUI and MMUI (if using css) stores. If you have an old MMUI without css, remove the line before clicking the Add button. After the page is saved, you will need to put your fonts throughout the page if you are not using css. Also, if you are not using CSSUI, remove the div tags near the beginning and end as they will have no affect. You can do that before or after the page addition. &mvt:store:name;: Product Reviews

&mvt:key_product:name;

Average Rating (&mvte:global:rating:average;)
&mvte:global:friends:percent; of those who responded said they would recommend this to a friend

&mvte:review:rater:ship_fname; from &mvte:review:rater:ship_statename; Anonymous &mvt:global:ndayofmonth;, &mvt:global:nyear; Verified Buyer  
"&mvte:review:tagline;"
&mvte:review:review;
I would recommend this product to my friends

I would not recommend this product to my friends

Store note: &mvte:review:storenote;


Show All or just   5 hearts   4 hearts   3 hearts   2 hearts   1 heart  
Page 3 ******************************************************************************************************** RRCUST Create a new page with the code RRCUST and name Ratings and Reviews Individual. Copy and paste the contents in this page 3 section. This example is for CSSUI and MMUI (if using css) stores. If you have an old MMUI without css, remove the line before clicking the Add button. After the page is saved, you will need to put your fonts throughout the page if you are not using css. Also, if you are not using CSSUI, remove the div tags near the beginning and end as they will have no affect. You can do that before or after the page addition. There is a sorting drop down in this example. You'll need Tool Kit version 5.198 or newer for that option to work correctly. &mvt:store:name;: Product Reviews

Reviews posted by &mvt:toolkit:reviews[1]:rater:ship_fname;

Return to All  

&mvt:review:product:name;
&mvte:review:rater:ship_fname; from &mvte:review:rater:ship_statename; Anonymous &mvt:global:ndayofmonth;, &mvt:global:nyear; Verified Buyer  
"&mvte:review:tagline;"
&mvte:review:review;
I would recommend this product to my friends

I would not recommend this product to my friends

Store note: &mvte:review:storenote;

Page 4 *********************************************************************************************** RR_ALERT Create a new page with the code RR_ALERT and name Ratings and Reviews Alert Email. Copy and paste the contents in this page 4 section. This is the email sent if you are requiring approval of reviews before they are displayed publically. You will probably do this if you are allowing non-logged in customers to post ratings and reviews. Save the page. After successfully saved, you can edit the email as needed. Change the link to the product to match your link style in your store. %subject|Product Review Needs Approval% %from|g.store:email% %to|g.store:email% The product &mvt:product:name; was rated and needs approval before public display.

Rating: &mvte:global:product_rating;

Review: &mvte:global:product_review;


YOUR NAME
YOUR STORE NAME Page 5 *********************************************************************************************** RR_EMAIL Create a new page with the code RR_EMAIL and name Ratings and Reviews Thank You Email. Copy and paste the contents in this page 5 section. Save the page. After saving, you can edit as below. This is the email sent thanking the customer for their rating/review. It can only be sent to logged in customers since you don't have the email address of those who don't log in. Edit the email as needed. The cc is optional if you want to see what is getting rated. There is a conditional to say something different if the rating is 4 or 5 vs 1, 2, or 3. Change the link style to the product to match the link style in your store. If you have our coupon redemption module you can embed a unique, on-the-fly generated coupon to entice them to come back and buy more. See the coupon redemption module instructions on how to use that token and create the coupon templates. %subject|Product Rated% %from|g.store:email% %to|g.customer:bill_email% %cc|xxxx@YOURDOMAIN.com% Dear &mvte:global:customer:bill_fname; &mvte:global:customer:bill_lname;,

Thanks for rating the module "&mvt:product:name;". We're glad you liked the module and rated it with &mvte:global:product_rating; hearts. We continually try to improve our products and your input lets us know we are on the right track. We saw you rated it with &mvte:global:product_rating; hearts. We use customer ratings to decide if certain products need more features or whether they will continue to be sold and supported. We will review your concerns as products which score 1-3 may not worth continued investment if there are better products available.

Your review: "&mvte:global:product_review;"

If you want to change your rating or rewiew, simply return to the product page and post a new rating and review. It will overwrite and replace the one described above.


YOUR NAME
YOUR STORE NAME Page 6 *********************************************************************************************** RR_NEW IMPORTANT: The "reviewsnew" function was added in Tool Kit version 5.206. You will need to update if your version is older and you want this feature. Create a new page with the code RR_NEW and name Newest Ratings and Reviews. Copy and paste the contents in this page 6 section. Save the page. After saving, you can edit as below. In the first line, the 3rd parameter is the minimum rating to include in the list. You'll probably make that 4 or 5. The 4th parameter is the number of days to include. The maximum is 10. There are a few links, e.g. to products and the sorting selector. Change the link style to the products to match the link style in your store. The sorting selector links will probably be the same for your store. Once you have created this page, you can call it from other pages, e.g. the storefront with the line .
  What are our customers saying
&mvt:review:product:name;
&mvte:review:rater:ship_fname; from &mvte:review:rater:ship_statename; Anonymous &mvt:global:ndayofmonth;, &mvt:global:nyear; Verified Buyer  
"&mvte:review:tagline;"
&mvte:review:review;
I would recommend this product to my friends

I would not recommend this product to my friends

Store note: &mvte:review:storenote;

Other Section **************************************************************************************************** I. Understanding the data string. The data is stored in a custom product field called "reviews" for each product. Click + to the left of Utilities, then click Emporium Plus Tool Kit. Scroll down and find the form labeled "Product Reviews" to view the data, approve ratings and run lists. The one field can contain dozens of reviews, each separated with the # character. Within each review, the 12 data elements are separated with the pipe (|) character. Here is an example of two reviews for a product. They are actually in one long line but I put line breaks so you could see the data without scrolling off the page. 5|This module just keeps getting better. Saves me big bucks. |1296712105|mistert|e31067406aaa423083b992f5d54876c3|1|1|82502|Saves me big bucks||Y|1# 3|Works ok||1296713166|classy|f41088406xyz423092b992g5e64766a1|0||0||||0# 1) rating 2) review 3) time 4) login 5) cookie value 6) show my name, etc (1 = yes, 0 = no) 7) verified buyer (1 = yes, 0 = no, blank = na) 8) order number item was in (0 or blank if not found) 9) tag line can be entered by admin 10) store note (rebuttal) can be added by admin 11) would recommend to a friend (Y = yes, N = no, blank = not sure/answered) 12) approved for public view (1 = yes, 0 = no) There is an IMPORTANT difference between this custom product field and most other custom product fields. Usually the store employees put data in the custom product fields, so it is relatively safe data to display. However, this field takes input from customers who could put malicious content in the field. For that reason, customer entered data must ALWAYS be displayed using &mvte instead of &mvt. The "e" in the &mvte causes the data to be displayed with certain dangerous characters entity encoded to prevent cross scripting hacks. Do not forget this important rule. Because this data is stored in a custom product field, it may be searchable by some 3rd party search tools. You should not make this field searchable unless you are using Power Search version 5.105 or newer. That module uses a mirror database, not the original custom field. It inserts sanitized data (no login or cookie info) into the Power Search mirror database. Also, if you are using Power Search (all versions), you will need to rebuild the mirror database so that it includes the new rating and reviews fields. Just don't make them searchable unless you have Power Search version 5.105 or newer. II. Nicer popup for the list. The RRPROD page code above uses the javascript window.open popup. Make sure you have all the components of this system working before you start customizing. That includes changing the popup code. You can replace the javascript link in the RRPROD page with the line below. It uses a free javascript and css library of files from Orangoo Labs. You can get the documentation and download link at http://orangoo.com/labs/GreyBox/ New line: Read All Reviews You will need to FTP the files listed below to the location under the mm5/ directory. You will need to create the directory mm5/js/greybox/ and put the files in it. AJS.js AJS_fx.js g_close.gif gb_scripts.js gb_styles.css header_bg.gif indicator.gif loader_frame.html next.gif prev.gif w_close.gif Then in PROD page, locate the head section at the top of the page (between and . Paste the following ten lines. Change the word yourdomain to your actual domain. III. Including pro and con checkboxes. Beginning in Tool Kit version 5.208 you can include checkboxes that the customer can check to standardize data input. You would put them in the RRPROD page inside the form with the product_rating and product_review inputs. Each input that the customer checks would be included in the review insertion. They are separted from the main review with the ^ character, e.g. main^pro^con. If the customer selects more than one of each, they are separated with commas.
Pros: Easy to install Step by step instructions Excellent support Cons: Could not install it Unreadable instructions Had to pay for support