Cube Testimonials

Documentation

Installation

Installation can be performed by using the Extend Concrete5 section of the Dashboard if you have connected to the community, or by following these instructions if you prefer a manual installation:

  1. Copy the cube_testimonials directory into the packages folder in the root of your site
  2. Login to your Dashboard
  3. Go to: Extend Concrete5 > Install
  4. You should see Cube Testimonials in the Awaiting Installation section
  5. Click the install button and wait for it to complete

Usage

Creating A Testimonial

To get started you'll first need to create a testimonial.  To do this:

  1. Go to: Dashboard > Cube Testimonials > Add Testimonial
  2. A title and testimonial are required fields, the others are optional
  3. Fill in the fields you require
  4. Click Save Testimonial

Managing Testimonials

  1. Go to: Dashboard > Cube Testimonials > Manage Testimonials
  2. Here you'll see a list of all the testimonials that you've created

You now have the following options:

  • click a title to edit the testimonial
  • click any of the table headings to sort the table
  • set the display order to specify which order testimonials are displayed on the frontend (applies when you choose to display more than one)
  • use the checkbox to select one or more testimonial, and then use the With Selected dropdown at the to delete them

Displaying Testimonials

To display testimonials do the following:

  1. Go to a page on your site where you want to add the testimonial(s)
  2. Go into Edit mode
  3. Click an Area where you want to add the block, and select Add Block
  4. Choose Testimonials from the list
  5. You can now use the form to create your block:
    1. Title: this optional field will display a title at the top of your block if you enter one
    2. Select all testimonials?: Yes if you want to show ALL the testimonials, and No if you want to select which testimonials to show
    3. Number of testimonials to display: This is the number of testimonials to show.  For example, you can select all, randomise, and set the number of testimonials to display to 1, to show one random testimonial.
    4. Randomise: Yes to show testimonials in a random order, No to use the  display order specified in the management interface
    5. Select Testimonials: this appears if Show All is set to No.  You can choose which one(s) you'd like to show
  6. Once you've configured your block, click the Add button
  7. When you're happy Exit Edit Mode and Publish your changes

Customisation

The block can be customised and styled in any way that you like using the Concrete5 Custom Template feature.

More information about customisation and using the date field can be found on the Github page: https://github.com/cubewebsites/c5-testimonials