Ratings & Reviews /
Installation
Installation
1. Add Module
Skip to the next section if you are familiar with this step.
Open the Global Settings area in the left admin menu and click on the Add link next to Modules
Click on the upload button to open an upload box. Find the file and upload it. If you're upgrading, be sure to check the overwrite option.
After the module has been uploaded, click the Add button to add it to your store.
To activate the module, click on the Utilities link in your left menu and then check the box next to Scot's Scripts Ratings and Reviews and update the page.
Go to the module administration by clicking on the Ratings and Reviews tab.
2. Configuration
Click on the configuration link at the top of the module screen to upload the stars sprite file: star_matrix.gif
Set tracking: should the customer should be logged in (recommended) to rate and review, or can anyone? Customers can always review through email reminders
Decide how many reviews to display on initial page load.
Set the rest of the options later.
3. Add SMR_REVIEWS page Item to select pages.
Open the pages screen by clicking on Pages in the left menu, then click on the Items tab and find the smr_reviews item.
Click on the edit button.
Select the checkboxes next to the PROD and CTGY pages. If you want to use email reminders (a great feature) also select the SFNT and INVC pages.
Click on the update button.
4. Setting up the Product and Category pages.
We'll start with the Product and Category pages. This way you'll see ratings in your store for a category product list and on the product page.
You can also add reviews to your Search and Product List pages for total immersion.
CSS Template (important!)
Put this line in the HEAD/CSS area of the pages you activated the smr_reviews page item on.
select
<mvt:item name="smr_reviews" param="head_css" />
Stars and Reviews
The page code below loads the stars and reviews data, then displays it. When the page item is used like this, the reviews will default to whatever the current product is. For placement and more details, see the Example Page Code entry.
Briefly, on the CTGY page, a good place for this is under the Quantity In Basket line. On the PROD page, on the product display tab, put the code anywhere you want. Web consensus is that it should be somewhere near the add to basket/cart button.
select
<mvt:item name="smr_reviews" param="load" />
&mvt:smr_reviews:template;
The code above is the most basic that you can get away with and still have reviews showing up. It loads the default number of reviews that you set in the configuration. It's very easy to change the number of reviews that it loads up: load:[num]
The following example overrides the default setting and loads up five reviews.
select
<mvt:item name="smr_reviews" param="load:5" />
&mvt:smr_reviews:template;
Email Reminders
Turn these on by adding the page item below to your store and then save your email reminder preferences in the module configuration.
Use email reminders. Next to handing out cash, it's the easiest way to get your customers to come back and review. You can set it for as many days after the sale as you want, then the system will send them an email with star links ready to click. Put this page item in your global footer somewhere near the bottom of the page
select
<mvt:item name="smr_reviews" param="email_reminder" />
The way email reminders work is when a review page is loaded, at the end of the page this page item will tell the module to check if there are any email reminders to send out, and if so, send one out. The system will then wait a minimum of 10 seconds (or whatever throttling you set in the configuration) before another reminder will be sent out.
updated April 12, 2013
