Everybody's Changing

and I don't feel the same.

Tag: HowTo

fvReVolusion : Volusion plugin for Power Reviews

There were some misunderstandings about Volusion ftp service on my previous post. Please forgive me. ๐Ÿ™‚
I finally made a simple javascript which enables us to integrate with Power Reviews easily.
I named it “fvReVolusion.”

Let me explain how it works briefly.

Volusion has the unique URL patterns on displaying pages.
If you are a web developer, you may notice that it has several URL patterns.

Pages URL Patterns
Index http://YOURSTORE.COM
Category http://YOURSTORE.COM/NAME-s/XXXX.htm
Search http://YOURSTORE.COM/SearchResults.asp?Search=XXXX
Detail http://YOURSTORE.COM/ProductDetails.asp?ProductCode=XXXX

Basically, fvRevolusion parses the requested URL upon finishing loading HTML. And, it will execute the coressponding function in order to display snippets and reviews.

I used jQuery to manipulate DOM which are generated by Volusion.

Installation Instructions
1. Create a directory inside the “/v” directory.
  Let’s assume that you created a directory named “revolusion” inside “/v”
2. Upload three files into “/v/revolusion” directory on your Volusion by using FTP
3. Make sure that you can access three files by web browser.
  For example, http://YOURSTORE.COM/v/revolusion/fvSettings.js
4. Edit “fvSettings.js”
  You might want to change few values such as MERCHANT_ID, MERCHANT_CSS and CATEGORY_NO_WRITE.
5. Add the initializing javascript codes to template_xx.html

<script type=”text/javascript” src=”/v/revolusion/jquery-1.3.2.min.js”></script>
<script type=”text/javascript” src=”/v/revolusion/fvRevolusion.js”></script>
<script type=”text/javascript” src=”/v/revolusion/fvSettings.js”></script>
<script type=”text/javascript”>

That’s it. Now you can see the Power Reviews snippets and reviews!

Download files




How to add Review Reviews Express on Volusion 5

Volusion is one of popular E-commerce Software Solution. Although Volusion has its own review system, people are more likely to use better review system which are more flexible and powerful. Recently I was involved in Volusion + Power Reviews project. I thought I could add Power Reviews Express on Volusion easily and quickly. Because I have some experiences about OSCommerce and Magento. I am also familiar with a few E-commerce related APIs such as eBay, PayPal, Shopzilla, FeDex, UPS, Endicia(USPS) and so forth. However, I was wrong, it took more time than I expected.

The steps involved in the integration are really simple, however, there was no resources about Volusion and Power Reviews since Volusion forums are open to only customers and Power Reviews doesn’t have the information about Volusion integration. Therefore, I had struggled with finding solutions when I faced problems. Fortunately, I found Volusion Live Chat Support and they gave me the answer right after asking. I love Volusion Live Chat Support. Thanks to them.

This document explains how to display Power Reviews on a single product and assumes that you have finished Power Review settings until “Step 4. Get Code” in Power Reviews Integration Wizard.

I recommend you to use two web browsers in order to access Volusion and Power Reviews at the same time.

Step 1. Turn off built-in customer reviews

Turn off built-in customer review system if you are currently using it.

User image1) Go to “Inventory” -> “Products” -> “Products Settings”
2) Uncheck on “EnableCustomerReviews” if it is checked.
3) Click on “save changes”

Step 2. Rename the tab name, “Extended Information” to “Reviews”

I use Extended Information field for Power Reviews. Of course, you can choose a different field like Technical Spec. Just rename it for displaying the correct field name on the front site.

User image1) Fill out any character in “Extended Information” field for testing.
2) Click on “Save Changes”
3) Click on the yellow pencil next to “Extended Information” field.

User image– ConfigSetup window will be opend.
1) Put “Reviews” in DataValue.
2) Click on “Save Changes.”

User image1) Open your store with your preferred browser.
2) You will be able to see the renamed tab.

Step 3. Create two necessary categories on Volusion

Power Reviews requires me to put two URLs which will interact with Power Reviews.

Two required URLs are “Write Review URL” and “Resize URL”.
There is no way to put any files into Volusion, I add two categories and put the codes that Power Reviews provided into description field instead of putting files.

User image1) Add a category for “Write Review URL”
2) Put Power Reviews codes (from Step 4) into “Category Description”
3) Remember the CategoryID

User image1) Add a category for “Resize URL”
2) Put Power Reviews codes (from Step 4) into “Category Description”
3) Rembmer the CategoryID

Step 4. Finish Power Reviews Integration Wizard

Let’s move to Power Reviews Integration Wizard.

User image1) There are 3 steps involved in “4. Get Code”
2) Copy & Paste all codes that Power Reviews provided into notepad or something like text editor.
3) The last step requires you to put two URLs.
4) Put the URL like
  xxx is the CategoryID (from Step 3)

Finish the Integration Wizard by getting “Customize Review Display” done.
The “Go Live” button will be appeared when you are done.
DO NOT Click on The “Go Live” BUTTON.
In Live mode, you will not able to see reviews right after submitting. Because all testing reviews are sent to 1st level moderation.

Step 5. Put common javascript into template_xx.html

You might notice that there are common Initialize Code while working on Power Reviews Integration Wizard. I put these codes between <head> and </head> in order to minimize javascript codes which I will fill out in Product Descriptions. In addition, these codes below will parse a product code from the URL. Therefore, I will not need to put each product code in Product Descriptions.
xx in template_xx.html is the template number that you are currently using.
Go to “Design” -> “Choose Template”, you will be able to find it. (xx – Template Name)

Go to “Design” -> “LiveEdit File Editor”, there is the template_xx.html file on Shortcuts.
Just click on it, then LiveEdit will be appeared with loading template_xx.html.
Copy the codes below by clicking on the second icon on the top right side. And replace WRITE_REVIEW_CATEGORY_ID with your category id (Review Write URL from Step 3). Also replace -FROM_PR- with your corresponding Initialize Code.

[code:js]<SCRIPT language=Javascript type=text/javascript>
function parseProductCode() {
var pathName = window.location.pathname;
if (pathName.indexOf(“/ProductDetails.asp”) != -1) {
var params = window.location.search.substr(1).split(“&”);
for (var i=0; i<params.length; i++) {
var values = params[i].split(“=”);
if (values[0] == “ProductCode”) return unescape(values[1]);
} else if (pathName.indexOf(“-p/”) != -1 || pathName.indexOf(“_p/”) != -1) {
var pos = pathName.lastIndexOf(“/”) + 1;
var workStr = pathName.substr(pos);
return unescape(workStr.substr(0, workStr.lastIndexOf(“.”)));
} else if (pathName.indexOf(“/articles.asp”) != -1) {
var params = window.location.search.substr(2).split(“&”);
for (var i=0; i<params.length; i++) {
var values = params[i].split(“=”);
if (values[0] == “pageID”) return unescape(values[1]);
} else
return “”;

<SCRIPT language=Javascript type=text/javascript>
var pr_pn = parseProductCode().toUpperCase();
var pr_write_review=”/SearchResults.asp?Cat=WRITE_REVIEW_CATEGORY_ID&pr_page_id=” + pr_pn + “”;
var pr_read_review=”/ProductDetails.asp?ProductCode=” + pr_pn + “&Show=ExtInfo”;
var pr_style_sheet=”http://cdn.powerreviews.com/aux/-FROM_PR-/css/powerreviews_express.css”;
<SCRIPT type=text/javascript src=”http://cdn.powerreviews.com/repos/-FROM_PR-/pr/pwr/engine/js/full.js”></SCRIPT>

Make sure that “Config_Enable_Publish_Always_By_Default” is checked in Config Variables. Otherwise, you should click on “Publish” on the top of Admin Area.

User image1) Go to “Settings” -> “Config Variables”
2) Check on “Config_Enable…By_Default”
3) Click on “Save Changes”

Step 6. Put Power Reviews javascript in a product!

Let’s apply Power Reviews to a product!

User image

For the “Reviews” field, fill out with the code below.
When you click on “Reviews” tab (from Step 2) on the front site, reviews will be displayed.

[code:js]<DIV class=pr_review_summary>
<script type=”text/javascript”>
POWERREVIEWS.display.engine(document, { pr_page_id : pr_pn });
For both the “Product Description Above Pricing” field and the “Photo_SubText” field, fill out with the code below.
You may want to display only one review snippet. Put the code in both places, and make a decision where you want to display it.

[code:js]<DIV class=pr_snippet_product>
<script type=”text/javascript”>
POWERREVIEWS.display.snippet(document, { pr_page_id : pr_pn });
For the “Product Description Short” field, fill out with the code below.
The review snippet will be displayed on search result and category browsing.
Be aware that you should replace PRODUCT_NO with the real product code.

[code:js]<DIV class=pr_snippet_category>
<script type=”text/javascript”>
var pr_snippet_min_reviews=1;
POWERREVIEWS.display.snippet(document, { pr_page_id : “PRODUCT_NO” });

You are ready to use Power Reviews now!

To Do list

Run .snippet .engine depending on request URL

Parse each html document and display Power Reviews widget on appropriate location

– Write the document how to use Power Reviews without putting javascript

Powered by WordPress & Theme by Anders Norén