Testimonials extension for refinerycms
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
app
bin
config
db
lib
rails
script
spec
tasks
.gitignore
.travis.yml
CONTRIBUTORS
Gemfile
Guardfile
MIT-LICENSE
Rakefile
readme.md
refinerycms-testimonials.gemspec

readme.md

Testimonials plugin for Refinery CMS

Version 2.0 is a rewrite of the original refinerycms-testimonials. It is compatible with Refinery CMS 2.0.

How to install

In your Gemfile, add the gem:

gem 'refinerycms-testimonials', '~> 2.0'

Now, run bundle install and the gem should install.

To install the migrations, run:

rails generate refinery:testimonials
rake db:migrate
rake db:seed

Add Testimonials to the database

You can now add testimonials to the database through the Refinery CMS. The testimonials fields are

  • quote (the actual testimonial)
  • name (of testimonial sender)
  • company ( ditto )
  • website ( ditto )
  • jobtitle ( ditto )
  • received_channel (letter, email, facebook, twitter)

##Control Testimonial display on a page

Each page now has a testimonials tab which can be used to decide how testimonials should be displayed on that page

  • Show Testimonials on this page (default: no)
  • How many testimonials to show (n, 0 means show all)
  • How to select and order which testimonials to show (Random, Most Recent First)

Changes to Views or Layout Templates

See Enabling Custome Layout Templates in this refinery guide

Views

Somewhere in a view or layout you will need to call the testimonials partial.

<section id='side'>
  <%= raw @page.content_for(:side) %>
  <%= render 'refinery/testimonials/testimonials' %>
</section>

will render the CMS content for a page part called 'side', followed by some testimonials.

For more control over what is displayed the @testimonials collection is available for you. You can call your own partial to render the collection.

<%= render 'myTestimonials', :testimonials => @testimonials.as_json %>