Happiness Reports for Help Scout

Description

This plugin requires Help Scout API Access and therefore will only work with a paid Help Scout plan.

Do you use Help Scout?
Are you proud of your customer support? Showing highly positive ratings is a
great way to bring in more customers, be more transparent, and hold yourself
accountable.

Happiness Reports for Help Scout allows you to show your customer happiness reports
right on your website using WordPress shortcodes.

You can choose to show all ratings at once (Great, Okay, Not Good), or only one
specific rating, in text format, or as a graph.

Shortcode Usage

Show all ratings (great, okay, not good) as an unordered list

[happiness_report]

Show only the “great” rating

[happiness_report rating="great"]

Show only the “okay” rating

[happiness_report rating="okay"]

Show only the “not good” ratings

[happiness_report rating="not good"]

Show all ratings (great, okay, not good) as individual graphs

[happiness_report graph="yes"]

Show only the “great” rating as a graph

[happiness_report rating="great" graph="yes"]

Show only the “okay” rating as a graph

[happiness_report rating="okay" graph="yes"]

Show only the “not good” rating as a graph

[happiness_report rating="not good" graph="yes"]

Setup

  1. Activate the plugin.
  2. Go to Settings → Happiness reports.
  3. Enter your Help Scout API Key in the provided field and click “save changes”.
  4. Select the mailboxes you’d like to show happiness reports from, a date range, and click “save changes”.
  5. Use the provided shortcodes to show your happiness reports on your website!

PHP function usage

If you’re a developer, you can also use PHP functions for greater control.

Show all ratings (great, okay, not good) as an unordered list

<?php echo hrfhs_show_rating(); ?>

Show only the “great” rating

<?php echo hrfhs_show_rating( array( 'rating' => 'great' ) ); ?>

Show only the “okay” rating

<?php echo hrfhs_show_rating( array( 'rating' => 'okay' ) ); ?>

Show only the “not good” ratings

<?php echo hrfhs_show_rating( array( 'rating' => 'notGood' ) ); ?>

If you’d like to show happiness reports on a specific page, and want them to be graphs
you’ll first need to load the scripts like this:

/**
 * Force front-end scripts to load for graphs
 * Only required for showing the graphs
 */
function hrfhs_load_graph_scripts() {

    // only load the graph scripts on this page ID
    if ( ! is_page( '123' ) ) {
        return;
    }

    add_filter( 'hrfhs_force_frontend_scripts', '__return_true' );
}
add_action( 'template_redirect', 'hrfhs_load_graph_scripts' );

Then you can echo the PHP function as shown in the below examples:

Show all ratings (great, okay, not good) as individual graphs

<?php echo hrfhs_show_rating( array( 'rating' => 'all', 'graph' => 'yes' ) ); ?>

Show only the “great” rating as a graph

<?php echo hrfhs_show_rating( array( 'rating' => 'great', 'graph' => 'yes' ) ); ?>

Show only the “okay” rating as a graph

<?php echo hrfhs_show_rating( array( 'rating' => 'okay', 'graph' => 'yes' ) ); ?>

Show only the “not good” rating as a graph

<?php echo hrfhs_show_rating( array( 'rating' => 'notGood', 'graph' => 'yes' ) ); ?>

Screenshots

  • Show all ratings as a doughnut graph
  • Show only the "Great" rating as a doughnut graph
  • Show only the "Okay" rating as a doughnut graph
  • Show only the "Not Good" rating as a doughnut graph
  • Show all ratings as a simple unordered list
  • Show only the "Great" rating as text (add your own label)
  • Show only the "Okay" rating as text (add your own label)
  • Show only the "Not Good" rating as text (add your own label)

Reviews

Love it! Perfect way to share happiness ratings with customers!

worldtravlr

Thanks so much to Andrew for making this!

It works perfect, is lightweight, has really cool graph options which I love and makes it easy to share with customers contacting you how how happy the majority of your customers are with your companies support! Just what I had been looking for!

Highly recommended and with Andrew behind the code, you know it it top notch as he is also involved in making EDD and AffiliateWP 🙂 Why are you still reading this? If you have HelpScout and WordPress, download it and install it now 🙂

Read all 2 reviews

Changelog

1.0.0

  • Initial release

Contributors & Developers

Happiness Reports for Help Scout is open source software. The following people have contributed to this plugin.

Contributors

Translate Happiness Reports for Help Scout into your language.

Interested in development?

Browse the code or subscribe to the development log by RSS.