Find out what posts logged-in users found helpful.
Have you ever wanted to know about the quality of your posts? At least a little bit?
This is exactly when
That Was Helpful kicks in.
This simple plugin lets you track how many logged-in users found individual posts helpful.
Usage
What this plugin is all about is providing a means to mark individual posts helpful. Each unique user can vote only once for each post. Of course, cast votes can be retracted.
Actions
In case you want to show the form depending on some (complicated) condition (and not always), simply wrap
do_action( 'that_was_helpful', $optional_post_id )
in the condition, and put it in your desired template file(s). If you provide an existing post ID as parameter, the according post's votes are displayed. Otherwise the current post is used.
Filters
In order to customize certain aspects of the plugin, it provides you with several filters. For each of these, a short description as well as a code example on how to alter the default behavior is given below. Just put the according code snippet in your theme's
functions.php
file or your
customization plugin, or to some other appropriate place.
that_was_helpful_capability
Managing the plugin's settings is restricted to a certain capability, which is by default
manage_options
.
`
/**
- Filters the capability required to manage the settings.
- @param string $capability Capability required to manage the settings.
*/
add_filter( 'that_was_helpful_capability', function() {
return 'edit_users';
} );
`
Contribution
To
contribute to this plugin, please see its
GitHub repository.
If you have a feature request, or if you have developed the feature already, please feel free to use the Issues and/or Pull Requests section.
Of course, you can also provide me with translations if you would like to use the plugin in another not yet included language.
This plugin requires PHP 5.3.
- Upload the
that-was-helpful
folder to the /wp-content/plugins/
directory on your web server.
- Activate the plugin through the Plugins menu in WordPress.
- Use the That Was Helpful form either by defining Automatic Appending to content/excerpt on the according That Was Helpful settings page, or by using
do_action( 'that_was_helpful', $optional_post_id )
somewhere in your template files.