Survey & Testimonial Addon for WHMCS

Overview

Collect useful customer feedback with a WHMCS survey, then turn approved comments into testimonials for your website. Build surveys across separate pages, send invitations when clients register, use a service or close a support ticket, and review the results in clear charts. Survey + Testimonial keeps survey answers and testimonial moderation together in WHMCS.

Survey + Testimonial 2.0 interface
Survey + Testimonial 2.0 interface

Features

  • Build surveys with separate pages and seven answer types
  • Add multiple language translations with the globe control
  • Use custom star ratings and numeric scales
  • Send invitations manually or through WHMCS enrollment rules
  • Use WHMCS email templates for invitation messages
  • Review charts, individual responses and CSV exports
  • Keep the original questions with existing responses after editing
  • Publish approved testimonials with customer websites, categories and product details
  • Display testimonials with PHP, Smarty, XML or JSON integrations
  • Send optional SMS invitations and administrator notifications through The SMS Addon

Screenshots

Reviews, Changelog & Documentation

Jay Vasallo

www.clanwarz.com

The survey addon created by WHMCSnow is a must have. It bridges the communication gap between the client who never complains and you! Clients can complete the survey when they have time and thoughtfully suggest improvements along with any grips they may have. As you know, we are driven by the needs of our clients so this addon compliments WHMCS very well. Lastly, the devs behind this addon are top notch and do support any question you may have. Clanwarz rates this addon ... 4 thumbs up!


Fredrik Hallgren

www.ballou.se

We need to collect information from our customers to be able to improve ourselves. To find out what they think of our service, products, GUI and the processes to become a client. With this add on from WHMCSnow we get all of this in an easy tool to achieve all of this. Excellent support from WHMCSnow as well.


v2.0.0

Latest

Released on 3rd November 2026

  • Redesigned the survey builder, results and testimonial management.
  • Improved page editing and star-rating controls; added multiple survey translations.
  • Added more chart options and CSV export.
  • Added testimonial website, category and product details with PHP, Smarty, XML and JSON integration.
  • Added optional SMS invitations and notifications through The SMS Addon.
  • Fixed invitation expiry, email notifications and editing existing surveys and testimonials.
  • Improved automatic updates with compatibility checks and recovery.

v1.3.1

Released on 3rd November 2025

  • Email Templates now use WHMCS' inbuilt system

v1.2.12

Released on 25th August 2025

  • Added option for surveys to be sent on cancellation requests being received
  • Bug fixes

v1.2.11

Released on 22nd May 2024

  • Added support for ionCube Loader v13 and PHP 8.2
  • Update notifications now shown in admin area

v1.2.10

Released on 22nd November 2022

  • Added support for ionCube Loader v12 and PHP 8.1

v1.2.9

Released on 14th April 2021

  • Issue with manual client enrol fixed
  • Issue with graphs autoload in admin area fixed

v1.2.8

Released on 17th May 2019

  • Fixed issue with Grace Period in the licensing system

v1.2.7

Released on 17th April 2018

  • PHP 7.1 & 7.2 Support

v1.2.6

Released on 25th June 2017

  • Bug Fixes

v1.2.5

Released on 2nd January 2017

  • Support for PHP 7

v1.2.4

Released on 16th February 2016

  • Fix a javascript error in survey settings
  • Hook added for external development (SurveyCompleted)
  • Renamed anonymous surveys to "login required"

v1.2.2

Released on 29th September 2015

  • Support for WHMCS v6.x

v1.1.3

Released on 8th March 2014

  • Compatibility with WHMCS v5.3.x added

v1.1.2

Released on 19th August 2013

  • Firefox compatibility issue resolved

v1.1.0

Released on 21st April 2013

  • Improved client searching + More client info displayed
  • Email notification when survey completed or testimonial received
  • New Ticket Criteria - Send survey after x days of support ticket closing
  • Make survey token tokens expire after x days
  • Progress bar hidden when only 1 page in client area
  • Issue with character encoding resolved in emails

v1.0.0

Released on 10th March 2013

  • Initial Release
  • Create custom surveys
  • Fully customisable template
  • Generate reports with clear graphs
  • Multiple surveys and email templates
  • Email sent automatically with link when criteria is met
  • Searches for common keywords in custom entries
  • Use textarea within survey to gather testimonials with the built in testimonial system
  • Custom client area page for Testimonials or advance XML / JSON API for custom intergration

Getting Started


Installation / Upgrading

Back up your WHMCS files and database before updating.
  • Upload the package into your WHMCS root, retaining its includes/ and modules/ directories and the root survey.php and testimonials.php files.
  • For a new installation, activate Survey + Testimonial in System Settings > Addon Modules and grant access to the administrator roles that need it.
  • Open the addon and activate your licence or available trial.
  • When upgrading, replace the files and open the addon to apply the database upgrade. Do not deactivate it or remove its tables.
Existing surveys, answers and settings are retained. Existing response formats are read by the addon; you do not need to export and re-enter them. Back up any changes to client.tpl or testimonials.tpl before replacing those files.

Supported PHP versions are 7.3, 7.4 and 8.1–8.4. PHP 7.3/7.4 require ionCube Loader 10.4 or newer; PHP 8.1–8.4 require Loader 15 or newer. Use a PHP version supported by your WHMCS installation. Required extensions are cURL, Zip, JSON, mbstring, ctype and DOM.

The package includes the updated automatic updater. Administrators need addon access and the WHMCS Update WHMCS role permission to run it. Compatibility checks use the requirements for that exact product release. Older installed updater files may not perform these checks for the first update to this version; check the requirements before updating.

Initial Setup

Open Overview and select Create survey. Add the survey title, introduction and completion message, then add your questions and pages.

Choose a WHMCS general email template for invitations. Set Enrollment to Manual invitations only while preparing and testing the survey. Keep Public survey link off if only invited clients should respond. Preview lets an authorised administrator try the form without saving responses or sending notifications.

Set the survey to Published when ready. Draft surveys do not enrol clients. Pausing stops access and new enrolment; resume it from Overview when ready. Archive removes it from the current list without deleting its responses. Use the status filter to view archived surveys.

Automatic enrolment uses WHMCS hooks and the normal daily cron. No additional Survey + Testimonial cron command is required.

Email Templates

Invitation templates use WHMCS's built-in general email templates. Select the template by name in the survey builder; edit its subject, message and translations in WHMCS Email Templates.

The addon provides these custom merge fields:
  • {$survey_link} — the personal survey link.
  • {$survey_title} — the survey title.
  • {$ticket_id} — the ticket ID for a ticket-based invitation, otherwise 0.
  • {$service_id} — the service ID for service or cancellation invitations, otherwise 0.
Include {$survey_link} in the invitation. WHMCS handles email transport and the global header, footer and signature. If an invitation fails, check the selected template, WHMCS email log and mail-provider configuration.

Settings has separate notification recipients for survey completion and testimonial submissions. Enter email addresses separated by commas, or leave a field blank to disable that notification.

Client Area Templates

Survey layout is in modules/addons/survey/client.tpl, with styling in assets/client.css. The public testimonial layout is in testimonials.tpl, with assets/testimonials.css. Both use normal WHMCS addon template loading; no theme-specific bridge file is required.

Keep theme-specific CSS overrides in your theme's custom stylesheet where possible. Save a copy of modified addon templates before an update, then reapply your changes to the updated templates. Keep the form action, field names, hidden tokens and page controls intact when changing survey layout. All customer-supplied text should remain escaped.

Survey content translations are added with the globe control in the builder. This translates the survey text and questions; it is separate from translating every administrator-interface label.

SMS Notifications

SMS integration is optional. Install and activate a current licensed copy of The SMS Addon to use it. If it is missing or unavailable, the Survey + Testimonial settings show a product link and the reason SMS options are unavailable. Email continues independently.

Enable Also send the invitation by SMS on an individual survey to send the client a link. The client's saved mobile number and SMS notification preference are checked. Set the invitation message in Settings; it must include {survey_link} and can also include {survey_title}.

In Settings > SMS Notifications, enable survey-completed or testimonial-received alerts and select administrators with mobile numbers configured in The SMS Addon. Messages use its queue and configured signature. Do not put the signature in the survey message itself.

Use The SMS Addon's queue, message log and Debugger gateway to check delivery without sending paid SMS. A queued message is waiting for the SMS worker; provider acceptance does not by itself confirm delivery to a handset.

Settings

Survey access controls whether clients must sign in to use a personal invitation. Public survey links remain available without signing in. Invitation validity is entered in days; use 0 for no expiry.

Under Email notifications, enter comma-separated recipient addresses for completed surveys and new testimonials. Leave a field blank to disable that notification.

SMS Notifications is optional and requires The SMS Addon with an active licence. Select the administrators who should receive SMS notifications and save the settings. Survey invitation SMS is enabled separately for each survey.

Features


Creating a Survey

Questions are grouped by page. Use Add Page to create another page, then Add question within that page. Page and question arrows change their order. An empty page can be removed.

Choose single choice, multiple choice, short answer, long answer, star rating, numeric scale or testimonial. Enter one choice per line. Mark questions Required where an answer is needed. Star ratings allow a custom maximum; numeric scales also support a minimum and labels at each end.

Use the globe icon to add translations for any installed WHMCS language. You can add more than one language. The default text is used when a translation is blank. Clients can choose from the languages added to the survey.

Changes to a survey with invitations or responses create a new revision for future invitations. Existing invitations and responses retain the questions they were issued with, so old answers keep their meaning. Duplicate makes a separate survey when you want to reuse a design.

Invitations and enrollment

From the survey, open Invitations to find a client by name or email and send a personal invitation. Failed invitations can be reviewed and resent. Completed responses are not sent another invitation through the resend control.

Enrollment options include manual invitations, client registration, service registration, ticket closure and cancellation requests. Choose the relevant products or ticket departments and a delay where available. Client registration rules can also limit the number of active services. Allow repeat invitations only when you want a client to receive the survey again.

Public survey link creates a link that anyone can use without an invitation. Keep this off for a private survey. Personal invitation access can require the client to sign in, configured in Settings. Invitation validity is set in days; 0 means no expiry. Expired links cannot be used to submit a response.

The daily cron evaluates date-based rules. Ticket closure and cancellation rules also use the corresponding WHMCS hooks. Paused, draft and archived surveys do not automatically enrol clients.

Reports

Open Results from a survey's chart icon, or click its response count to jump to individual responses. Charts and the response list are on the same page.

Choose Bar, Column, Pie or Donut for choice questions. Star and numeric questions also offer Line and Area charts, plus a percentage breakdown. Line and Area show the distribution of ratings, not changes over time. A selected chart is remembered for that administrator and question in the same browser.

View opens an individual response. Results retain the original question revision. Search the responses and use CSV export when you need the data outside WHMCS. Written answers and testimonials appear with their question text.

Testimonials

New testimonial answers appear under Pending review. The Testimonials tab badge shows how many are waiting. Review the wording before choosing Publish testimonial or Ignore. Publishing is always a separate administrator action.

You can set the display name, customer website, category, product type and optional WHMCS product during review, or when editing a published testimonial. Use Shared Hosting and Reseller Hosting as labels; existing shared/reseller values remain compatible with integrations. Published testimonials can be archived and restored.

The root testimonials.php page displays published testimonials with pagination. Pending, ignored and archived items are excluded. Customer website links are limited to HTTP and HTTPS. The addon does not automatically migrate unrelated third-party testimonial tables; contact support before moving data from another system.

Website integration

Website integration

The public testimonials.php page shows published testimonials from the addon database. Archived, pending and ignored testimonials are never returned. The page is paginated, so every published testimonial can be viewed.

PHP on a website using the same WHMCS installation:

require_once '/absolute/path/to/whmcs/init.php';
require_once ROOTDIR . '/modules/addons/survey/core.php';
require_once ROOTDIR . '/modules/addons/survey/lib/public-testimonials.php';
$testimonials = WHMCSnowSurveyTestimonials(['product_type' => 'reseller'], 6);
foreach ($testimonials as $testimonial) {
echo '<blockquote>' . nl2br(htmlspecialchars($testimonial['body'], ENT_QUOTES, 'UTF-8')) . '</blockquote>';
echo '<p>' . htmlspecialchars($testimonial['clientname'], ENT_QUOTES, 'UTF-8') . '</p>';
}

Filters: ['product_type' => 'reseller'], ['category' => 'Managed hosting'], or ['product_id' => 12]. Filters match saved values exactly and can be combined (all must match). Omit filters with [] to show all. The second argument is a limit (1–100); the third is an offset for pagination. The helper returns plain text, not trusted HTML. Escape all text when rendering. website_url is restricted to HTTP/HTTPS; still escape it as an HTML attribute. Do not create a publicly accessible database endpoint or embed database credentials in templates.

Smarty integration

Create includes/hooks/survey-testimonials.php with:

<?php
add_hook('ClientAreaPage', 1, function ($vars) {
require_once ROOTDIR . '/modules/addons/survey/core.php';
require_once ROOTDIR . '/modules/addons/survey/lib/public-testimonials.php';
return ['websiteTestimonials' => WHMCSnowSurveyTestimonials(['category' => 'Managed hosting'], 3)];
});

Then place this in the desired client-area .tpl:

{foreach $websiteTestimonials as $testimonial}
<blockquote>{$testimonial.body|escape:'html'|nl2br}</blockquote>
<strong>{$testimonial.clientname|escape:'html'}</strong>
{if $testimonial.website_url}<a href="{$testimonial.website_url|escape:'html'}" rel="nofollow noopener" target="_blank">{$testimonial.website|escape:'html'}</a>{/if}
{/foreach}

For performance, scope the hook to the required page using $vars['filename'] before calling the helper. A .tpl alone cannot query the database; the hook supplies the data. On a separate site, this PHP example requires a local/shared WHMCS installation; it is not a remote API.

Layout and styling

modules/addons/survey/testimonials.tpl controls the public layout; assets/testimonials.css controls its styling. Keep theme-specific CSS in your theme custom.css and back up edited addon templates before updates. Customer names, websites, category, product type and product association are set during review or when editing a published testimonial.


JSON and XML feeds

Use your WHMCS base URL followed by:
modules/addons/survey/core.php?testimonials=1&type=json

Change type=json to type=xml for XML. Add product_type=shared, product_type=reseller, category=Business or product_id=12 to filter published testimonials. Filters can be combined and must all match. Use the stored raw product-type value in an integration, not its display label.

Add limit=6&page=1 for pagination. The limit is capped at 100. The response retains the testimonials root and includes numtestimonials; paginated requests also include numpages and currentpages. Text must be escaped when adding it to HTML. The feed is for published testimonial data, not private survey answers or client-account information.

Pricing Options

Free Trial

15 Days

Semi-Annually

£19.99

Annually

£34.99

Owned*

£79.99

* Owned Licenses include 1 Year Support & Updates access with the initial purchase.

After the first year, support & updates access can be optionally renewed to maintain access at a cost of just £12.99 per year.