The testimonials modules provides a simple interface through which to manage site testimonials, it also allows customers to post testimonials for your review and inclusion within the site.

User submitted testimonials are added to the system unpublished and require a site administrator to check and publish them if appropriate.

Initial Setup


If you are allowing the public to submit testimonials to your site then once the testimonials module has been installed you need to configure the email address which will receive notifications on new submitted testimonials. From the dashboard select Settings then Testimonials and choose Notification Email on this page enter the email address that should get notification of testimonial submissions.

The testimonials module allows 1 image to be submitted with each testimonial, it can automatically resize this image to 4 different sizes, tiny, small, medium and large, the physical size of each of these can be set under Settings,Testimonials and then the image size e.g. Tiny Image. When setting the image size you can also choose if the image should be scaled to fit within the defined size or scaled and cropped to be the exact size.

Integrating with Search

The testimonials module adds three additional fields, testimonial.author, testimonial.body and testimonial.tags, before testimonials appear in search results you need to select which of these fields are indexed by the search module and which are used for tagging items.

Select Settings then Search then Search Settings and add the testimonial fields to the appropriate search fields. Next select the Tag Fields setting and add the testimonial.tags field.

For the changes to take effect the site content has to be reindexed, select the clearFusionCMS settings group, Rebuild Search and finally Reindex Content. It can take several minutes to rebuild the search index depending on the amount of data in the CMS.

Setting the Testimonials Page

For the testimonials system to work the testimonials module must be placed on a Document. To do this create a Document within the site where you’d like the testimonials located and from the Document Behavior dropdown select Container for Testimonials, this will cause the testimonials to be rendered within the Document.

Setting the container for the testimonials

Default CSS

The testimonials module includes a default style sheet to get you started, just add the following above </head> in your template to include it:

<link href="system/modules/testimonials/testimonials.css" rel="stylesheet" type="text/css">

While the default CSS provides a useful stating point in most cases you will want to refine the style for your site.