glFusion Wiki

Site Tools


Testimonials Plugin for glFusion

This is a plugin for glFusion that will allow you to showcase your testimonials. Site administrators can manually enter testimonials received via email or other methods. Users can also submit testimonials that optionally can be queued for review prior to publishing.

A Testimonial Block is included that will pull random testimonials to display on your site.


The Testimonials plugin offers several advanced features:

  • Allows users to submit their own testimonials
  • Option to allow any user (logged in or not) to submit testimonials or it can be limited to only logged in users or user submission can be completely disabled.
  • Testimonials can be queued for moderator approval
  • Email notification to moderators on new submissions
  • Email notification to user when testimonial is approved
  • Modern user interface for displaying testimonials - automatically trims long testimonials with More / Hide button to toggle viewing full testimonial
  • Random block to automatically display testimonials
  • Optional Random block that automatically rotates between 20 random testimonials

System Requirements

The Testimonials Plugin has the following system requirements:

  • PHP 5.3.3 and higher.
  • glFusion v1.7.0 or newer
  • Must be using a UIKIT based theme - will not work with Vintage or Nouveau themes


The Testimonials Plugin uses the glFusion automated plugin installer. Simply upload the distribution using the glFusion plugin installer located in the Plugin Administration page.


The upgrade process is identical to the installation process, simply upload the distribution from the Plugin Administration page.


Display Block
Which glFusion blocks to display when viewing Testimonials. For example, left, right, none, both…
Disable Testimonial Submissions
If this is set to TRUE, all user submissions will be disabled. Only the Testimonial Admin can enter testimonials through the admin interface.
Allow Anonymous Users to Submit Testimonials
If this is set to Yes, anonymous (non-logged-in users) will be able to submit testimonials. See Moderation Queue Below.
User Moderation Queue for User Submitted Testimonials
If set to TRUE (Recommended Settings), user submitted testimonials will be placed in a moderation queue for review and approval. Testimonials will not be available for public view until they have been approved by a Testimonials Administrator.
Time User must wait between testimonial submissions
The amount of time (in seconds) that a user must wait before submitting a new testimonial. Generally this value should be very high as most users do not submit more than one testimonial.
Number of Testimonials Per Page
The number of testimonials to display per page.
Enable Testimonials Centerblock
Set the location to display the Random Testimonial Centerblock - Set to No Centerblock to disable the centerblock.
Centerblock rotates through testimonials
If this is set to false, the center block (see above) will pull 1 random testimonial to display. If this is set to True - the center block will pull up to 20 random testimonials and rotate through them every few seconds.


Entering New Testimonial

Site Administrators can enter testimonials from the Command & Control → Testimonials administrative interface. Generally this is used to create a testimonial from an email or other method where a customer / user has provided feedback.

User Submitted Testimonials

If you allow users to submit testimonials, they can provide feedback using the Submit Testimonial button on the View Testimonials page. If the user has logged into your site, they only need to provide their name, website and their testimonial. If it is an anonymous user (not logged in), they must provide an email address as well.

For non-logged-in users, if you have the CAPTCHA plugin installed, the user will be required to enter the CAPTCHA string before submitting their testimonial. This requirement should cut down on SPAM and BOT submissions.

You can configure Testimonials to place new submissions in the Submission Queue where it must be approved by a Testimonials Admin or site admin. If the submission queue is enabled, glFusion will email the moderators that a new submission has been placed in the queue. Once approved, the user who submitted the testimonial will receive an email informing them their testimonial has been approved. If a testimonial is not approved, the user will not receive any notifications.

Setting Up Testimonial Admins

All members of the Root group are automatically Testimonial Admins. You may want to designate trusted non-admin users to review and moderate testimonials. To grant a user Testimonials Admin rights, simply add them to the Testimonials Admin Group.

Random Testimonials Block

When the Testimonials plugin was installed, a Random Testimonial Block is automatically created. This block will display a random testimonial.

If you wish to display several testimonials and have the block 'rotate' through them, please do the following:

  • Navigate to the Block Administration page from Command & Control
  • Edit the block named block_testimonials
  • Change the Block Function field to be phpblock_testimonials(1)
  • Save the block

By adding the (1) to the PHP block function, this will tell the Testimonials plugin to pull up to 20 random testimonials and cycle through them every few seconds.


This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This plugin was originally developed by Jodi Diehl - scripts AT sunfrogservices DOT com

glfusion/plugins/testimonials/start.txt · Last modified: 2017/10/20 10:28 (external edit)