User Manual

How to install DC Feefo

Having a Feefo account is necessary for this plugin. We are a registered Feefo Partner, speak to us if you would like an account set up.

Installing the plugin

Upload the plugin to the /plugins folder in your nopCommerce directory.

Restart your application (or click 'Reload list of plugins' button).

Scroll down through the list of plugins to find the newly installed plugin.

Click on the 'Install' link to install the plugin.

Note: If you're running nopCommerce in medium trust, then it's recommended to clear your \Plugins\bin\ directory

Configuring the plugin

Click the configure button on the plugin.

You will come to the configuration page.

You'll find that some of the inputs are already filled in. These are the default values for Feefo.

Firstly you'll need to fill in the licence key to activate the plugin. We would have sent you the licence key separately.

The licenced host will change to your url if the key is successful.

The ID is your Feefo account ID eg. dynamics-consultants

The FTP inputs are used to upload order details to Feefo, so that reviews can be sent out by Feefo.

The FTP details are the details you used when setting up your ftp configuration in Feefo.

How to use DC Feefo

Feefo Product Reference Override

By default the Product Reference Override is set to the SKU.

The Product Reference Override allows you to override the reviews for that product, If you change the SKU of your product from 'ABC123' to 'XYZ789' you can still get reviews for 'XYZ789' by using the product override to receive the reviews from 'ABC123'

This can be done by going to a product and navigating to the Feefo Tab.

The XYZ789 will now receive the reviews from ABC123

Add to feefo

The Add To Feefo button submits an order to feefo, for it to then be sent to the customer.

If you navigate to an order and then the 'Add to Feefo' tab you can submit the order to Feefo.

The order will be added to the database and the scheduled task will then pick up that order and send it to Feefo.

The status of the order will change depending on how far along the process is.

Scheduled task

The scheduled task looks for all orders that you have submitted to send to feefo,

The scheduled task then picks them up and sends the orders to Feefo's FTP.

Feefo then sends out emails to your customers asking for feedback

Product reviews

Reviews are displayed in widget zones.

Reviews in the product detail pages are reviews based on that product.

There is a review overview featured on the page which gives a star rating of the reviews. This is also featured in a product overview box.

Grouped Product Reviews

For a grouped product, we get all of the reviews that belong to the associated products of the parent.

We display these all together on the page and also calculate the review overview based on the value of the associated products.

Service reviews

The service reviews are shown on the homepage.

They represent reviews of the company as a whole.

Widget Zones

We have created some custom widget zones to place the Feefo widgets around the page.

These widget zones are: 

• feefo_producttemplate_reviewoverview
• feefo_producttemplate_reviews
• feefo_servicereviews
• feefo_productbox_reviews
• feefo_serviceimage

If you are using the default theme for nopCommerce, we have provided updated views that already include this extra code. You will find these views in the themes folder of the downloaded plugin.

The Feefo Plugin is widget based, so you only need to call a widget where you would like the plugin to be shown.

(In Green is what we have added, this is the code you will have to add to your views)

Feefo Product Template Review Overview - Example

ProductTemplate.Simple.cshtml

   @if (!String.IsNullOrEmpty(Model.ShortDescription))
    {
       <div class="short-description">
          @Html.Raw(Model.ShortDescription)
       </div>
    }
   @Html.Widget("productdetails_overview_top", Model.Id)
   <!--product reviews-->
   @Html.Partial("_ProductReviewOverview", Model.ProductReviewOverview)
   @Html.Widget("feefo_producttemplate_reviewoverview", Model.Id)
   <!--manufacturers-->
   @Html.Partial("_ProductManufacturers", Model.ProductManufacturers)
   <!--availability-->
   @Html.Partial("_Availability", Model)
   <!--SKU, MAN, GTIN, vendor-->
   @Html.Partial("_SKU_Man_GTIN_Ven", Model)
   <!--delivery-->
   @Html.Partial("_DeliveryInfo", Model)
   <!--sample download-->
   @Html.Partial("_DownloadSample", Model)

Feefo Product Template Review - Example

ProductTemplate.Simple.cshtml

   @Html.Widget("productdetails_before_collateral", Model.Id)
   <div class="product-collateral">
      @Html.Partial("_ProductSpecifications", Model.ProductSpecifications)
      @Html.Partial("_ProductTags", Model.ProductTags)

      @Html.Widget("feefo_producttemplate_reviews", Model.Id)
   </div>
   @Html.Action("ProductsAlsoPurchased", "Product", new { productId = Model.Id })
   @Html.Action("RelatedProducts", "Product", new { productId = Model.Id })

Feefo Product Grouped Template Review - Example

ProductTemplate.Grouped.cshtml

@foreach (var variant in Model.AssociatedProducts)
    {
       <div class="product-variant-line" data-productid="@variant.Id">
       @if (!String.IsNullOrWhiteSpace(variant.DefaultPictureModel.ImageUrl))
          {
            <div class="variant-picture">
               <img alt="@variant.DefaultPictureModel.AlternateText" src="@variant.DefaultPictureModel.ImageUrl"
                 title="@variant.DefaultPictureModel.Title" id="main-product-img-@variant.Id"/>
            </div>
           }
           <div class="variant-overview">
           @if (!String.IsNullOrWhiteSpace(variant.Name))
             {
              <div class="variant-name">
                @variant.Name
              </div>
             }

             @Html.Widget("feefo_producttemplate_reviewoverview", variant.Id)

             @if (!String.IsNullOrWhiteSpace(variant.ShortDescription))
             {
               <div class="variant-description">
                  @Html.Raw(variant.ShortDescription)
               </div>
             }

Feefo Service Reviews - Example

Home/Index.cshtml

   @Html.Action("HomePageNews", "News")
   @Html.Widget("home_page_before_poll")
   @Html.Action("HomePagePolls", "Poll")
   @Html.Widget("feefo_servicereviews")
   @Html.Widget("home_page_bottom")

Feefo Product Box Reviews - Example

_ProductBox.cshtml

   @if (Model.ReviewOverviewModel.AllowCustomerReviews)
     {
        int ratingPercent = 0;
        if (Model.ReviewOverviewModel.TotalReviews != 0)
         {
            ratingPercent = ((Model.ReviewOverviewModel.RatingSum * 100) / Model.ReviewOverviewModel.TotalReviews) / 5;
         }
         <div class="product-rating-box" title="@string.Format(T("Reviews.TotalReviews").Text, Model.ReviewOverviewModel.TotalReviews)">
             <div class="rating">
                 <div style="width: @(ratingPercent)%">
                 </div>
             </div>
         </div>
      }
      @{ 
          var url = Url.RouteUrl("Product", new { SeName = Model.SeName });
      }
      @Html.Widget("feefo_productbox_reviews", string.Format("{0}|{1}", Model.Id, url))
      <div class="description">
          @Html.Raw(Model.ShortDescription)
      </div>

• {0} = ID of the product
• {1} = URL of the Product Detail Page

Feefo Service Image - Example

Footer.cshtml

              @if (!string.IsNullOrEmpty(Model.GooglePlusLink))
                {
                   <li class="google-plus"><a href="@Model.GooglePlusLink" target="_blank">@T("Footer.FollowUs.GooglePlus")</a></li>
                }
         </ul>
      </div>
   @Html.Action("NewsletterBox", "Newsletter")
   @Html.Widget("feefo_serviceimage")