tfrommen/that-was-helpful

Find out what posts logged-in users found helpful.

v1.1.0 2015-09-24 18:29 UTC

This package is auto-updated.

Last update: 2024-11-15 15:51:00 UTC


README

Latest Stable Version Project Status Build Status License

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.

Installation

  1. Download ZIP.
  2. Upload contents to the /wp-content/plugins directory on your web server.
  3. Activate the plugin through the Plugins menu in WordPress.
  4. 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.

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.

Settings

On the plugin's That Was Helpful settings page, you can have the form be automatically appended to the content and/or excerpt of your posts.

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.

/**
 * Filter 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

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.

Screenshots

Settings page
Settings page - Here you can manage your settings (i.e., automatically append to content and/or excerpt).

Frontend
Frontend - Frontend view for a logged-in user who marked the according post helpful.

Changelog

Changelog