feefo 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 5fcf57ef48dcefe4a7558831e36dbfdf1bd06a79
+  data.tar.gz: 9b51ea6281c9d558f3a360e344936d58b29408e2
+SHA512:
+  metadata.gz: 07d98ef5fd9cd2101a343fa9688cddfd58e3fcf3562b6be8bffd56f63d7f68b871986580d777105c0a599dab3076b1cae330a58775fab3e251189ac7f2937891
+  data.tar.gz: d766c7f8f587b75543c25c86242940d83cf4fe5e2679738c4b8b8252b8daeab19debebc5bcf8147740ccb7a1a421b5d7bfdde3a7683f582fd3a586a20a6dcf38

data/.gitignore

@@ -0,0 +1,5 @@
+coverage
+Gemfile.lock
+
+vendor/ruby
+.bundle

data/.travis.yml

@@ -0,0 +1,9 @@
+language: ruby
+rvm:
+  - 2.3.0
+script: "bundle exec rake"
+notifications:
+  email:
+    - support@travellink.com.au
+sudo: false
+cache: bundler

data/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Unreleased #
+
+# 0.1.0 #
+
+* Use coverage kit to enforce maximum coverage
+* Updated params for feed to allow code and category
+* Added a method to build a review image
+* Fix issue with caching forever
+* Fix issue when feedback result blank

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/README.md

@@ -0,0 +1,6 @@
+Feefo
+=====
+
+[![Build Status](https://travis-ci.org/sealink/feefo.png?branch=master)](https://travis-ci.org/sealink/feefo)
+[![Coverage Status](https://coveralls.io/repos/sealink/feefo/badge.png)](https://coveralls.io/r/sealink/feefo)
+[![Code Climate](https://codeclimate.com/github/sealink/feefo.png)](https://codeclimate.com/github/sealink/feefo)

data/Rakefile

@@ -0,0 +1,18 @@
+require "bundler/gem_tasks"
+
+desc 'Default: run specs.'
+task :default => :spec
+
+require 'rspec/core/rake_task'
+
+desc "Run specs"
+RSpec::Core::RakeTask.new do |t|
+  t.pattern = "./spec/**/*_spec.rb" # don't need this, it's default.
+  # Put spec opts in a file named .rspec in root
+end
+
+desc "Generate SimpleCov test coverage and open in your browser"
+task :coverage do
+  ENV['COVERAGE'] = 'true'
+  Rake::Task['spec'].invoke
+end

data/feefo.gemspec

@@ -0,0 +1,32 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'feefo/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "feefo"
+  spec.version       = Feefo::VERSION
+  spec.authors       = ["Michael Noack"]
+  spec.email         = ["support@travellink.com.au"]
+  spec.description   = %q{Methods to fetch and show feefo reviews}
+  spec.summary       = %q{Methods to fetch and shwo feefo reviews}
+  spec.homepage      = 'https://github.com/sealink/feefo'
+
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'coverage-kit'
+  spec.add_development_dependency 'simplecov-rcov'
+  spec.add_development_dependency 'coveralls'
+  spec.add_development_dependency 'vcr'
+  spec.add_development_dependency 'webmock'
+  spec.add_development_dependency 'pry'
+  spec.add_development_dependency 'travis'
+end

data/feefo.yml.example

@@ -0,0 +1,4 @@
+logon: 'www.sealinktravelgroup.com.au'
+division: 'SeaLink KI'
+time_to_cache_reviews: 86400 # 1 day
+review_limit: 1000000

data/lib/feefo.rb

@@ -0,0 +1,56 @@
+require 'feefo/remote_review_fetcher'
+require 'feefo/review_fetcher'
+require 'feefo/review'
+require 'feefo/reviews'
+require 'feefo/version'
+
+module Feefo
+  def self.config
+    @config
+  end
+
+  def self.config=(config)
+    @config = {
+      name: config['name'],
+      logon: config['logon'],
+      division: config['division'],
+      time_to_cache_reviews: config['time_to_cache_reviews'],
+      review_limit: config['review_limit']
+    }
+  end
+
+  def self.review_base_url
+    name     = configEncode(:name)
+    logon    = configEncode(:logon)
+    division = configEncode(:division)
+    "https://www.feefo.com/reviews/#{name}/?logon=#{logon}/#{division}"
+  end
+
+  def self.review_badge_image(filters)
+    logon          = configEncode(:logon)
+    division       = configEncode(:division)
+    code           = filters[:code]
+    category       = filters[:category]
+    base_image_url = "https://www.feefo.com/feefo/feefologo.jsp?logon=#{logon}/#{division}"
+    category_part  = category ? "/#{category}"       : ''
+    code_part      = code     ? "&vendorref=#{code}" : ''
+    image_template = "&template=product-stars-grey-150x38_en.png"
+    return '' unless category || code
+    base_image_url + category_part + code_part + image_template
+  end
+
+  def self.review_for_code(filters)
+    fetcher = ReviewFetcher.new(filters)
+    data = JSON.parse(fetcher.fetch_reviews_json)
+    Feefo::Reviews.new(data)
+  rescue JSON::ParserError => e
+    nil
+  end
+
+  private
+
+  def self.configEncode(key)
+    URI.encode(config.fetch(key))
+  end
+
+end

data/lib/feefo/remote_review_fetcher.rb

@@ -0,0 +1,42 @@
+module Feefo
+  class RemoteReviewFetcher
+    attr_reader :code
+
+    def initialize(filters, config)
+      @code     = filters[:code]
+      @category = filters[:category]
+      @config   = config
+    end
+
+    def fetch_reviews
+      params = {
+        logon:     logon,
+        vendorref: @code,
+        limit:     @config[:review_limit],
+        json:      true,
+        mode:      'both'   # Needed to get both product and service rating
+      }.reject { |k, v| v.nil? }
+
+      uri          = URI(url)
+      uri.query    = URI.encode_www_form(params)
+      http         = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.port == 443
+      response     = http.get(uri.request_uri)
+      response.body
+    end
+
+
+    private
+
+    def logon
+      logon = @config[:logon]
+      logon += '/' + @config[:division] if @config.key? :division
+      logon += '/' + @category if @category
+      logon
+    end
+
+    def url
+      'https://www.feefo.com/feefo/xmlfeed.jsp'
+    end
+  end
+end

data/lib/feefo/review.rb

@@ -0,0 +1,41 @@
+module Feefo
+  class Review
+    attr_reader :data
+
+    def initialize(data)
+      @data = data
+    end
+
+    def customer_comment
+      data['CUSTOMERCOMMENT']
+    end
+
+    def review_date
+      data['HREVIEWDATE']
+    end
+
+    def service_rating
+      data['SERVICERATING']
+    end
+
+    def vendor_comment
+      data['VENDORCOMMENT']
+    end
+
+    def review_rating
+      data['HREVIEWRATING']
+    end
+
+    def description
+      data['DESCRIPTION']
+    end
+
+    def link
+      data['LINK']
+    end
+
+    def date
+      data['DATE']
+    end
+  end
+end

data/lib/feefo/review_fetcher.rb

@@ -0,0 +1,39 @@
+module Feefo
+  class ReviewFetcher
+    attr_reader :filters, :feefo_config
+
+    def initialize(filters, feefo_config = Feefo.config, cache = Rails.cache)
+      @filters      = filters
+      @feefo_config = feefo_config
+      @cache        = cache
+    end
+
+    def fetch_reviews_json
+      with_caching do
+        RemoteReviewFetcher.new(filters, feefo_config).fetch_reviews
+      end
+    end
+
+    private
+
+    def with_caching
+      fetch_from_cache || yield.tap { |reviews| store_in_cache(reviews) }
+    end
+
+    def fetch_from_cache
+      cache.read feefo_key(filters)
+    end
+
+    def store_in_cache(reviews)
+      cache.write feefo_key(filters), reviews, expires_in: feefo_config[:time_to_cache_reviews]
+    end
+
+    def feefo_key(filters)
+      "feefo_reviews_for_#{filters[:code]}_#{filters[:category]}"
+    end
+
+    def cache
+      @cache
+    end
+  end
+end

data/lib/feefo/reviews.rb

@@ -0,0 +1,19 @@
+module Feefo
+  class Reviews
+    attr_reader :reviews, :summary
+
+    def initialize(data)
+      list = data.fetch('FEEDBACKLIST')
+      @reviews = list.fetch('FEEDBACK', []).map { |review| Feefo::Review.new(review) }
+      @summary = list.fetch('SUMMARY')
+    end
+
+    def average
+      @summary['AVERAGE']
+    end
+
+    def count
+      @summary['COUNT']
+    end
+  end
+end

data/lib/feefo/version.rb

@@ -0,0 +1,3 @@
+module Feefo
+  VERSION = '0.1.0'
+end

data/spec/badge_spec.rb

@@ -0,0 +1,18 @@
+require 'spec_helper'
+require 'feefo'
+
+describe 'Feefo' do
+  before do
+    Feefo.config = {
+      'logon'    => 'www.link.com',
+      'division' => 'My Brand'
+    }
+    @code = 'abc'
+    @category = 'cat'
+  end
+
+  it 'should determine url' do
+    expected_url = 'https://www.feefo.com/feefo/feefologo.jsp?logon=www.link.com/My%20Brand/cat&vendorref=abc&template=product-stars-grey-150x38_en.png'
+    expect(Feefo.review_badge_image(code: @code, category: @category)).to eq expected_url
+  end
+end

data/spec/cassettes/feefo_reviews_with_feedback.yml

@@ -0,0 +1,207 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://www.feefo.com/feefo/xmlfeed.jsp?json=true&limit=9&logon=www.sealinktravelgroup.com.au/SeaLink%20KI&mode=both&vendorref=HTCC
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      Accept-Encoding:
+      - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+      Accept:
+      - "*/*"
+      User-Agent:
+      - Ruby
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Server:
+      - Apache-Coyote/1.1
+      Set-Cookie:
+      - JSESSIONID=EEDD7B14F96E1E4B524214ADDDA53A46; Path=/; Secure
+      Cache-Control:
+      - max-age=3600
+      Content-Type:
+      - application/json;charset=UTF-8
+      Transfer-Encoding:
+      - chunked
+      Vary:
+      - Accept-Encoding
+      Date:
+      - Wed, 04 May 2016 04:53:09 GMT
+    body:
+      encoding: ASCII-8BIT
+      string: |-
+        {"FEEDBACKLIST": {
+            "FEEDBACK": [
+                {
+                    "COUNT": 1,
+                    "CUSTOMERCOMMENT": "Great trip over and back and very enjoyable day tour",
+                    "DATE": "40 Hour(s) ago",
+                    "DESCRIPTION": "KI Experience",
+                    "FACEBOOKSHARELINK": "http://www.facebook.com/sharer.php?u=http%3A%2F%2Fwww.feefo.com%2FAU%2Fen%2Freviews%2FSeaLink-Kangaroo-Island_Tours%2F%3Fid%3D987195%26servicefeedbackid%3D101092",
+                    "FEEDBACKID": 101092,
+                    "HREVIEWDATE": "2016-05-02T12:43:36",
+                    "HREVIEWRATING": 5,
+                    "LINK": "http://www.sealink.com.au/kangaroo-island-tours/1-day-tours/kangaroo-island-highlights-day-tour/",
+                    "PRODUCTCODE": "HTCC",
+                    "READMOREURL": "http://www.feefo.com/AU/en/reviews/SeaLink-Kangaroo-Island_Tours/?id=987195&servicefeedbackid=101092",
+                    "SERVICERATING": "++",
+                    "SHORTCUSTOMERCOMMENT": "Great trip over and back and very enjoyable day tour"
+                },
+                {
+                    "COUNT": 2,
+                    "CUSTOMERCOMMENT": "Ferry was on time, staff were most certainly friendly and helpful.....clean and tidy ferry inside.",
+                    "DATE": "01-May-2016",
+                    "DESCRIPTION": "KI Experience",
+                    "FACEBOOKSHARELINK": "http://www.facebook.com/sharer.php?u=http%3A%2F%2Fwww.feefo.com%2FAU%2Fen%2Freviews%2FSeaLink-Kangaroo-Island_Tours%2F%3Fid%3D987195%26servicefeedbackid%3D101230",
+                    "FEEDBACKID": 101230,
+                    "HREVIEWDATE": "2016-05-01T05:28:36",
+                    "HREVIEWRATING": 5,
+                    "LINK": "http://www.sealink.com.au/kangaroo-island-tours/1-day-tours/kangaroo-island-highlights-day-tour/",
+                    "PRODUCTCODE": "HTCC",
+                    "READMOREURL": "http://www.feefo.com/AU/en/reviews/SeaLink-Kangaroo-Island_Tours/?id=987195&servicefeedbackid=101230",
+                    "SERVICERATING": "++",
+                    "SHORTCUSTOMERCOMMENT": "Ferry was on time, staff were most certainly friendly and helpful.....clean and tidy ferry inside."
+                },
+                {
+                    "COUNT": 3,
+                    "CUSTOMERCOMMENT": "It was the highlight of our trip to Adelaide. Amazing wildlife and a fantastic guide. It would have been nice to know that there is very limited dinner meal options available (especially for vegetarians).",
+                    "DATE": "01-May-2016",
+                    "DESCRIPTION": "KI Experience",
+                    "FACEBOOKSHARELINK": "http://www.facebook.com/sharer.php?u=http%3A%2F%2Fwww.feefo.com%2FAU%2Fen%2Freviews%2FSeaLink-Kangaroo-Island_Tours%2F%3Fid%3D987195%26servicefeedbackid%3D101209",
+                    "FEEDBACKID": 101209,
+                    "HREVIEWDATE": "2016-05-01T05:06:22",
+                    "HREVIEWRATING": 5,
+                    "LINK": "http://www.sealink.com.au/kangaroo-island-tours/1-day-tours/kangaroo-island-highlights-day-tour/",
+                    "PRODUCTCODE": "HTCC",
+                    "READMOREURL": "http://www.feefo.com/AU/en/reviews/SeaLink-Kangaroo-Island_Tours/?id=987195&servicefeedbackid=101209",
+                    "SERVICERATING": "++",
+                    "SHORTCUSTOMERCOMMENT": "It was the highlight of our trip to Adelaide. Amazing wildlife and a fantastic guide. It would have been nice to know that there is very limited dinner meal options available (especially for vegetarians)."
+                },
+                {
+                    "COUNT": 4,
+                    "CUSTOMERCOMMENT": "A wonderful experience",
+                    "DATE": "01-May-2016",
+                    "DESCRIPTION": "KI Experience",
+                    "FACEBOOKSHARELINK": "http://www.facebook.com/sharer.php?u=http%3A%2F%2Fwww.feefo.com%2FAU%2Fen%2Freviews%2FSeaLink-Kangaroo-Island_Tours%2F%3Fid%3D987195%26servicefeedbackid%3D101107",
+                    "FEEDBACKID": 101107,
+                    "HREVIEWDATE": "2016-04-30T21:35:56",
+                    "HREVIEWRATING": 4,
+                    "LINK": "http://www.sealink.com.au/kangaroo-island-tours/1-day-tours/kangaroo-island-highlights-day-tour/",
+                    "PRODUCTCODE": "HTCC",
+                    "READMOREURL": "http://www.feefo.com/AU/en/reviews/SeaLink-Kangaroo-Island_Tours/?id=987195&servicefeedbackid=101107",
+                    "SERVICERATING": "+",
+                    "SHORTCUSTOMERCOMMENT": "A wonderful experience"
+                },
+                {
+                    "COUNT": 5,
+                    "CUSTOMERCOMMENT": "Impressed customer service experience thoughout the Kangaroo Island tour including the ferry ride.",
+                    "DATE": "30-Apr-2016",
+                    "DESCRIPTION": "KI Experience",
+                    "FACEBOOKSHARELINK": "http://www.facebook.com/sharer.php?u=http%3A%2F%2Fwww.feefo.com%2FAU%2Fen%2Freviews%2FSeaLink-Kangaroo-Island_Tours%2F%3Fid%3D987195%26servicefeedbackid%3D101143",
+                    "FEEDBACKID": 101143,
+                    "HREVIEWDATE": "2016-04-30T13:36:26",
+                    "HREVIEWRATING": 4,
+                    "LINK": "http://www.sealink.com.au/kangaroo-island-tours/1-day-tours/kangaroo-island-highlights-day-tour/",
+                    "PRODUCTCODE": "HTCC",
+                    "READMOREURL": "http://www.feefo.com/AU/en/reviews/SeaLink-Kangaroo-Island_Tours/?id=987195&servicefeedbackid=101143",
+                    "SERVICERATING": "+",
+                    "SHORTCUSTOMERCOMMENT": "Impressed customer service experience thoughout the Kangaroo Island tour including the ferry ride."
+                },
+                {
+                    "COUNT": 6,
+                    "CUSTOMERCOMMENT": "A long day but good tour guides and so much information.The coach was comfortable and lunch at Vivonne  bay  yummy.  There was little time for a pie at 4pm and a snack just before the 7:30pm ferry so no dinner break but a few people were seasick on the trip back so maybe that is the reason. Thankyou for the highlights of Kangaroo Island.",
+                    "DATE": "30-Apr-2016",
+                    "DESCRIPTION": "KI Experience",
+                    "FACEBOOKSHARELINK": "http://www.facebook.com/sharer.php?u=http%3A%2F%2Fwww.feefo.com%2FAU%2Fen%2Freviews%2FSeaLink-Kangaroo-Island_Tours%2F%3Fid%3D987195%26servicefeedbackid%3D101077",
+                    "FEEDBACKID": 101077,
+                    "HREVIEWDATE": "2016-04-30T09:30:32",
+                    "HREVIEWRATING": 4,
+                    "LINK": "http://www.sealink.com.au/kangaroo-island-tours/1-day-tours/kangaroo-island-highlights-day-tour/",
+                    "PRODUCTCODE": "HTCC",
+                    "READMOREURL": "http://www.feefo.com/AU/en/reviews/SeaLink-Kangaroo-Island_Tours/?id=987195&servicefeedbackid=101077",
+                    "SERVICERATING": "+",
+                    "SHORTCUSTOMERCOMMENT": "A long day but good tour guides and so much information.The coach was comfortable and lunch at Vivonne  bay  yummy.  There was little time for a pie at 4pm and a snack just before the 7:30pm ferry so no dinner break but a few people were seasick on the trip back so maybe that is the reason. Thankyou..."
+                },
+                {
+                    "COUNT": 7,
+                    "CUSTOMERCOMMENT": "One Day Tour was a wonderful experience, for what it was: a ONE DAY tour. It is definitely an overview of a vast island that has so much to offer. Our driver, guide was extremely knowledgeable and personable, showing us the island through history, culture and personal stories. Lunch buffet was VERY good. Several choices to accommodate varied tastes, as well as options for my guest with food allergies.&#13;<br/>&#13;<br/>You must understand that it is a very large island and requires ALOT of driving time. During our 16hour day, over 10 hours is spent on some form of transportation.&#13;<br/>&#13;<br/>My one suggestion would be to have guides or &quot;spotters&quot; for the brief time at Hansen's Reserve. We were allowed only 30 minutes off the bus to explore and FIND koalas. Of the 4 found, they were VERY high in the trees. Time consuming and didn't allow time for really exploring this reserve and what it truly offers.&#13;<br/>&#13;<br/>All in all, I do recommend this tour, especially for this with minimal time or first time visitors to Australia.",
+                    "DATE": "30-Apr-2016",
+                    "DESCRIPTION": "KI Experience",
+                    "FACEBOOKSHARELINK": "http://www.facebook.com/sharer.php?u=http%3A%2F%2Fwww.feefo.com%2FAU%2Fen%2Freviews%2FSeaLink-Kangaroo-Island_Tours%2F%3Fid%3D987195%26servicefeedbackid%3D99976",
+                    "FEEDBACKID": 99976,
+                    "FURTHERCOMMENTSTHREAD": {"POST": {
+                        "CUSTOMERCOMMENT": "Thank you",
+                        "DATE": "30-Apr-2016",
+                        "SERVICERATING": "++"
+                    }},
+                    "HREVIEWDATE": "2016-04-29T14:08:50",
+                    "HREVIEWRATING": 5,
+                    "LINK": "http://www.sealink.com.au/kangaroo-island-tours/1-day-tours/kangaroo-island-highlights-day-tour/",
+                    "PRODUCTCODE": "HTCC",
+                    "READMOREURL": "http://www.feefo.com/AU/en/reviews/SeaLink-Kangaroo-Island_Tours/?id=987195&servicefeedbackid=99976",
+                    "SERVICELATEST": "++",
+                    "SERVICERATING": "++",
+                    "SHORTCUSTOMERCOMMENT": "One Day Tour was a wonderful experience, for what it was: a ONE DAY tour. It is definitely an overview of a vast island that has so much to offer. Our driver, guide was extremely knowledgeable and personable, showing us the island through history, culture and personal stories. Lunch buffet was VERY ..."
+                },
+                {
+                    "COUNT": 8,
+                    "CUSTOMERCOMMENT": "The bus was filled with some smelly perfume, which makes passenge feel very sick all the way. Not a pleasant experience on this day trip. Dad will never go by tour again.",
+                    "DATE": "28-Apr-2016",
+                    "DESCRIPTION": "KI Experience",
+                    "FACEBOOKSHARELINK": "http://www.facebook.com/sharer.php?u=http%3A%2F%2Fwww.feefo.com%2FAU%2Fen%2Freviews%2FSeaLink-Kangaroo-Island_Tours%2F%3Fid%3D987195%26servicefeedbackid%3D101194",
+                    "FEEDBACKID": 101194,
+                    "FURTHERCOMMENTSTHREAD": {"POST": {
+                        "DATE": "29-Apr-2016",
+                        "VENDORCOMMENT": "&#13;<br>&#13;<br>Thank you for your feedback and we are very sorry the perfume smell affected your enjoyment of the tour.&#13;<br>&#13;<br>We can only assume it was a fellow passenger&rsquo;s perfume which caused the issue and as I&rsquo;m sure you can appreciate, we can&rsquo;t control this. Our coaches are cleaned with a Eucalyptus-based floor wash and we do not have any automated air-fresheners on board.&#13;<br>&#13;<br>We hope you enjoyed the itinerary and the destinations visited.&#13;<br>&#13;<br>Kind regards,&#13;<br>&#13;<br>Ian Everitt&#13;<br>Sales Centre Manager<br><br>"
+                    }},
+                    "HREVIEWDATE": "2016-04-28T09:53:09",
+                    "HREVIEWRATING": 2,
+                    "LINK": "http://www.sealink.com.au/kangaroo-island-tours/1-day-tours/kangaroo-island-highlights-day-tour/",
+                    "PRODUCTCODE": "HTCC",
+                    "READMOREURL": "http://www.feefo.com/AU/en/reviews/SeaLink-Kangaroo-Island_Tours/?id=987195&servicefeedbackid=101194",
+                    "SERVICERATING": "-",
+                    "SHORTCUSTOMERCOMMENT": "The bus was filled with some smelly perfume, which makes passenge feel very sick all the way. Not a pleasant experience on this day trip. Dad will never go by tour again.",
+                    "SHORTVENDORCOMMENT": "Thank you for your feedback and we are very sorry the perfume smell affected your enjoyment of the tour.&#13;<br/>&#13;<br/>We can only assume it was a fellow passenger&rsquo;s perfume which caused the issue and as I&rsquo;m sure you can appreciate, we can&rsquo;t control this. Our coaches are cleaned with ...",
+                    "VENDORCOMMENT": "Thank you for your feedback and we are very sorry the perfume smell affected your enjoyment of the tour.&#13;<br/>&#13;<br/>We can only assume it was a fellow passenger&rsquo;s perfume which caused the issue and as I&rsquo;m sure you can appreciate, we can&rsquo;t control this. Our coaches are cleaned with a Eucalyptus-based floor wash and we do not have any automated air-fresheners on board.&#13;<br/>&#13;<br/>We hope you enjoyed the itinerary and the destinations visited.&#13;<br/>&#13;<br/>Kind regards,&#13;<br/>&#13;<br/>Ian Everitt&#13;<br/>Sales Centre Manager"
+                },
+                {
+                    "COUNT": 9,
+                    "CUSTOMERCOMMENT": "An excellent day and well organised. The only problem which was not as well set up was the dinner before boarding the ferry on the way back. Choices were limited for a busload of people arriving at places all at once. It was not helped that there was only one person on duty at the cafe at the ferry terminal serving customers and making hot drinks.",
+                    "DATE": "28-Apr-2016",
+                    "DESCRIPTION": "KI Experience",
+                    "FACEBOOKSHARELINK": "http://www.facebook.com/sharer.php?u=http%3A%2F%2Fwww.feefo.com%2FAU%2Fen%2Freviews%2FSeaLink-Kangaroo-Island_Tours%2F%3Fid%3D987195%26servicefeedbackid%3D101011",
+                    "FEEDBACKID": 101011,
+                    "HREVIEWDATE": "2016-04-28T04:51:26",
+                    "HREVIEWRATING": 5,
+                    "LINK": "http://www.sealink.com.au/kangaroo-island-tours/1-day-tours/kangaroo-island-highlights-day-tour/",
+                    "PRODUCTCODE": "HTCC",
+                    "READMOREURL": "http://www.feefo.com/AU/en/reviews/SeaLink-Kangaroo-Island_Tours/?id=987195&servicefeedbackid=101011",
+                    "SERVICERATING": "++",
+                    "SHORTCUSTOMERCOMMENT": "An excellent day and well organised. The only problem which was not as well set up was the dinner before boarding the ferry on the way back. Choices were limited for a busload of people arriving at places all at once. It was not helped that there was only one person on duty at the cafe at the ferry ..."
+                }
+            ],
+            "SUMMARY": {
+                "AVERAGE": 97,
+                "BEST": 100,
+                "COUNT": 352,
+                "LIMIT": 9,
+                "MODE": "service",
+                "PRODUCTLINK": "http://www.sealink.com.au/kangaroo-island-tours/1-day-tours/kangaroo-island-highlights-day-tour/",
+                "START": 1,
+                "SUPPLIERLOGO": "http://www.feefo.com/feefo/getnonpublicfile.jsp?vendorimage=987195&vendorimageext=file.png",
+                "TITLE": "KI Experience",
+                "TOTALPRODUCTCOUNT": 0,
+                "TOTALSERVICECOUNT": 352,
+                "VENDORLOGON": "www.sealinktravelgroup.com.au/SeaLink KI",
+                "VENDORREF": "HTCC",
+                "WORST": 0
+            }
+        }}
+    http_version: 
+  recorded_at: Wed, 04 May 2016 04:53:09 GMT
+recorded_with: VCR 3.0.1

data/spec/feefo_review_fetcher_spec.rb

@@ -0,0 +1,54 @@
+require 'spec_helper'
+require 'feefo/review_fetcher'
+require 'feefo/remote_review_fetcher'
+
+describe "Fetching a set of reviews" do
+  let(:cache) { double(read: nil, write: nil) }
+
+  let(:feefo_review_fetcher) do
+    config = {
+      logon:                 'www.sealinktravelgroup.com.au',
+      division:              'SeaLink KI',
+      time_to_cache_reviews: 25,
+      review_limit:          9
+    }
+    Feefo::ReviewFetcher.new({code: 'HTCC'}, config, cache)
+  end
+
+  subject(:reviews) do
+    VCR.use_cassette('feefo_reviews_with_feedback') do
+      feefo_review_fetcher.fetch_reviews_json
+    end
+  end
+
+  it 'should return a String' do
+    expect(reviews).to be_an_instance_of(String)
+  end
+
+  context 'when converted to json' do
+    subject(:json) { JSON.load(reviews) }
+
+    it { should be_a(Hash) }
+    it { should include 'FEEDBACKLIST' }
+
+    context 'its FEEDBACK list' do
+      let(:feedback) { json['FEEDBACKLIST']['FEEDBACK'] }
+      subject(:feedback_length) { feedback.length }
+
+      it { should eq 9 }
+
+      context 'its first FEEDBACK element' do
+        subject { feedback.first }
+        it { should be_a(Hash) }
+        it { should include 'SERVICERATING' }
+        # These guys are optional keys:
+        # it { should include *%w(SERVICERATING CUSTOMERCOMMENT VENDORCOMMENT) }
+      end
+    end
+
+    context 'its SUMMARY' do
+      subject { json['FEEDBACKLIST']['SUMMARY'] }
+      it { should include *%w(COUNT AVERAGE) }
+    end
+  end
+end

data/spec/feefo_spec.rb

@@ -0,0 +1,17 @@
+require 'spec_helper'
+require 'feefo'
+
+describe 'Feefo' do
+  before do
+    Feefo.config = {
+      'logon'    => 'www.link.com',
+      'division' => 'My Brand',
+      'name'     => 'My Company'
+    }
+  end
+
+  it 'should determine url' do
+    expected_url = 'https://www.feefo.com/reviews/My%20Company/?logon=www.link.com/My%20Brand'
+    expect(Feefo.review_base_url).to eq expected_url
+  end
+end

data/spec/reviews_spec.rb

@@ -0,0 +1,58 @@
+require 'spec_helper'
+
+describe Feefo::Reviews do
+  let(:cache) { double(read: nil, write: nil) }
+  let(:feefo_review_fetcher) do
+    config = {
+      logon:                 'www.sealinktravelgroup.com.au',
+      division:              'SeaLink KI',
+      time_to_cache_reviews: 25,
+      review_limit:          9
+    }
+    Feefo::ReviewFetcher.new({code: 'HTCC'}, config, cache)
+  end
+  let(:data) do
+    VCR.use_cassette('feefo_reviews_with_feedback') do
+      JSON.parse(feefo_review_fetcher.fetch_reviews_json)
+    end
+  end
+  subject(:reviews) { Feefo::Reviews.new(data) }
+
+  it 'should parse reviews' do
+    expect(reviews.average).to eq 97
+    expect(reviews.count).to eq 352
+  end
+  let(:hours_ago_regex) { /[0-9]{1,2} Hour\(s\) ago/ }
+  let(:time_regex) { /[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}/ }
+  let(:date_regex) { /[0-9]{1,2}-[A-Z][a-z][a-z]-[0-9]{4}/ }
+
+  context 'latest reviews' do
+    subject(:review) { reviews.reviews.first }
+    it 'should have the various aspects' do
+      expect(review.customer_comment).to be_a(String)
+      expect(review.vendor_comment).to be nil
+      expect(review.description).to eq 'KI Experience'
+      expect(review.service_rating).to eq '++'
+      expect(review.review_date).to match time_regex
+      expect(review.review_rating).to eq 5
+      expect(review.link).to eq 'http://www.sealink.com.au/kangaroo-island-tours/1-day-tours/kangaroo-island-highlights-day-tour/'
+      expect(review.date).to match hours_ago_regex
+      expect(review.data).to be_a(Hash)
+    end
+  end
+
+  context 'oldest reviews' do
+    subject(:review) { reviews.reviews.last }
+    it 'should have the various aspects' do
+      expect(review.customer_comment).to be_a(String)
+      expect(review.vendor_comment).to be nil
+      expect(review.description).to eq 'KI Experience'
+      expect(review.service_rating).to eq '++'
+      expect(review.review_date).to match time_regex
+      expect(review.review_rating).to eq 5
+      expect(review.link).to eq 'http://www.sealink.com.au/kangaroo-island-tours/1-day-tours/kangaroo-island-highlights-day-tour/'
+      expect(review.date).to match date_regex
+      expect(review.data).to be_a(Hash)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+$LOAD_PATH.unshift File.expand_path('../../app/models', __FILE__)
+
+require 'support/vcr_loader'
+require 'support/coverage_loader'
+require 'feefo'

data/spec/support/coverage_loader.rb

@@ -0,0 +1,4 @@
+require 'simplecov-rcov'
+require 'coveralls'
+require 'coverage/kit'
+Coverage::Kit.setup(minimum_coverage: 96.3)

data/spec/support/vcr_loader.rb

@@ -0,0 +1,7 @@
+require 'vcr'
+require 'webmock/rspec'
+
+VCR.configure do |c|
+  c.cassette_library_dir = 'spec/cassettes'
+  c.hook_into :webmock
+end

metadata

@@ -0,0 +1,214 @@
+--- !ruby/object:Gem::Specification
+name: feefo
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Michael Noack
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-11-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: coverage-kit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simplecov-rcov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: travis
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Methods to fetch and show feefo reviews
+email:
+- support@travellink.com.au
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- CHANGELOG.md
+- Gemfile
+- README.md
+- Rakefile
+- feefo.gemspec
+- feefo.yml.example
+- lib/feefo.rb
+- lib/feefo/remote_review_fetcher.rb
+- lib/feefo/review.rb
+- lib/feefo/review_fetcher.rb
+- lib/feefo/reviews.rb
+- lib/feefo/version.rb
+- spec/badge_spec.rb
+- spec/cassettes/feefo_reviews_with_feedback.yml
+- spec/feefo_review_fetcher_spec.rb
+- spec/feefo_spec.rb
+- spec/reviews_spec.rb
+- spec/spec_helper.rb
+- spec/support/coverage_loader.rb
+- spec/support/vcr_loader.rb
+homepage: https://github.com/sealink/feefo
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.8
+signing_key: 
+specification_version: 4
+summary: Methods to fetch and shwo feefo reviews
+test_files:
+- spec/badge_spec.rb
+- spec/cassettes/feefo_reviews_with_feedback.yml
+- spec/feefo_review_fetcher_spec.rb
+- spec/feefo_spec.rb
+- spec/reviews_spec.rb
+- spec/spec_helper.rb
+- spec/support/coverage_loader.rb
+- spec/support/vcr_loader.rb