kwmartin

Activating this plugin now means that you are able to award users for specific actions that they take.
NOTE: Currently this only works for actions that update or add to user meta values.
At a basic level, the following happens when you activate this plugin:
<ul>
<li>
Awards custom post type is added to the administration window. Regular post type window but with a few additional meta boxes that provide access to the core behavior of this plugin.
</li>
<li>
A new table is created under the name of <code>{wpdb_prefix}user_awards</code>. This contains all award assignment references to users. The User Awards sub-menu provides an interface to help perform administrative actions on the table.
</li>
</ul>
There is also a <code>User Awards</code> sub-menu which gives a tabular view of all the awards that are assigned to users. This is accessible from the <code>Awards</code> admin menu in your WordPress administration area.
<h3>Usage</h3>
Understanding the different actions you can take in each available window is key to having this plugin work for you.
<h3>Award List Window</h3>
This window displays all of the specific “Award” post types.
There are two different bulk actions available to you:
<ul>
<li>
Bulk Assign – Assign multiple awards to a user
</li>
<li>
Bulk Give – Give multiple awards to a user
</li>
</ul>
<h3>New Award / Edit Award Window</h3>
These administration windows have three meta boxes associated with them. Below are descriptions of each metabox and why it is included.
<h3>Awards Trigger</h3>
Text Input. Accepts an awards trigger string, which will describe the behavior of how an award will be assigned to users. Documentation for the awards trigger is shown below.
<h4>Example</h4>
You have a membership blog site, and because you’re a nice person, you want to award your members for being engaged with your site and liking at least ten blog posts!
A previous developer implemented a like button on each of your site’s blog posts that increments a <code>post_likes</code> user_meta value on the user that clicks it (e.g. If a member likes 3 blog posts, they will have a <code>post_likes</code> meta value of <code>3</code>).
We’ve decided to name our award the “User Engagement” award. In order to assign it to a member based on the prerequisites, you would put something like this in the “Awards Trigger” input.
<pre><code>CURRENT_USER_META ASSIGNED WHERE key=post_likes EQ 10
</code></pre>
This string tells the award to assign itself to the user if the <code>post_likes</code> value of the current user’s meta was updated or created to equal a value of <code>10</code>.
<h3>Auto-Give Award</h3>
Checkbox input. Check this box to automatically have the award be given to a user when it would originally be assigned.
<h3>Apply/Give Award To User</h3>
Select Input combined with a checkbox input. Select a user from your member list to either assign/give an award by clicking on the Assign submit button.
<h3>User Awards Window</h3>
This window allows administrators to physically see and update the status of all of the awards that are assigned to users.
This window will allow you to perform the following actions:
<ul>
<li>Singular/Bulk remove awards from members</li>
<li>Singular give awards to members</li>
<li>Edit Awards</li>
</ul>
<h3>Documentation</h3>
<h3>Awards Trigger Syntax</h3>
Explanation of each of the items that make up our trigger string, with accepted values of each listed under.
<ul>
<li>
[ entity ] — Used to scope your awards trigger to a specific action.
<ul>
<li>CURRENT_USER_META — Consider the meta value of the current user</li>
</ul>
</li>
<li>
[ trigger_type ] — Type of action that is performed to the current entity.
<ul>
<li>UPDATED — When entity value is updated (Listens to calls of the update_user_meta() function)</li>
<li>CREATED — When entity value is created (Listens to calls of the add_user_meta() function)</li>
<li>ASSIGNED — Listens to calls of both the update_user_meta() and add_user_meta() function.</li>
<li>~EXCLUDED~ — Not Implemented</li>
</ul>
</li>
<li>
[ trigger ] – Made up of three separate values itself, [ descriptor ] [ operator ] [ control ]
<ul>
<li>
[ descriptor ]
<ul>
<li>[ entity_type ] = [ value ] ex: key = hours</li>
</ul>
</li>
<li>
[ operator ]
<ul>
<li>GT – greater than</li>
<li>LT – less than</li>
<li>EQ – equal to</li>
<li>GTEQ – greater than equal to</li>
<li>LTEQ – less than equal to</li>
</ul>
</li>
<li>
[ control ]
<ul>
<li>Value used to compare against. e.g. 2</li>
<li>NOTE: The control can also be a string, but in order for this to work, you must use the EQ operator, as shown above.</li>
</ul>
</li>
</ul>
</li>
</ul>
EXAMPLE:
<pre><code>CURRENT_USER_META UPDATED WHERE key=total_hours GT 600
</code></pre>
This example creates a wp action handler that only applies when a user’s meta tags are updated. 
In the handler, we will compare the meta tag being updated to the given comparitors in the [ trigger ]. 
i.e. we will look for a meta tag of the current user that is labeled “total_hours” and check to see if the value is 
greater than 600. If that’s the case then the award will be assigned. If not then nothing happens.
<h3>$UserAward Global Object</h3>
The awards trigger syntax, while nice, is too limited in its current form. Our plugin provides a global $UserAward variable that allows developers to interact with the core API of the plugin in order to award items through methods that simply are not possible / too complex.
You will find documentation and usage for functions available to you below.
global $UserAward;
/** 
 * Check to see if a user already has a specific award 
 * @param int $user_id – WPUser_ID 
 * @param int $award_id – UserAward_ID (Post ID) 
 * @return bool Whether or not this user has an award with the current award id 
 */ 
$UserAwards->UserHasAward( $user_id, $award_id );
/** 
 * Assigns multiple awards to users using AssignAward 
 * @param int $user_id – WPUser_ID 
 * @param array $award_ids – Array of UserAward_IDs (Post ID) 
 * @return bool – True if awards were assigned, false if there was an error with assigning awards 
 */ 
$UserAwards->AssignAwards( $user_id, $award_ids );
/** 
 * Function that marks an award as assigned to a user. 
 * We insert a new record into our awards table that relates the award to the user. 
 * 
 * We do check to see if there is an auto-assignment of the award before we finish up our function though. 
 * 
 * @param int $user_id – ID of the user that we are “awarding” the award to 
 * @param int $award_id – ID of the award that we are “awarding” 
 * @return bool – True if award was assigned, 
 * False if: 
 * – User already has that award 
 * – Error with assigning our award 
 */ 
$UserAwards->AssignAward( $user_id, $award_id );
/** 
 * Give multiple awards to users using GiveAward(). 
 * @param int $user_id – WPUser_ID 
 * @param array $award_ids – Array of UserAward_IDs (Post ID) 
 * @return bool – True if awards were given, false if there was an error with giving awards 
 */ 
$UserAwards->GiveAwards( $user_id, $award_ids );
/** 
 * Function that will mark an award as given to a user, 
 * which essentially means that we mark the “date_given” time with 
 * an actual date. 
 * 
 * Returns the return value of a <code>db->update</code> call 
 * 
 * @param int $user_id – ID of the user that we are “awarding” the award to 
 * @param int $award_id – ID of the award that we are “awarding” 
 * @return mixed – Return value of a $wpdb->update() call 
 */ 
$UserAwards->GiveAward( $user_id, $award_id );
/** 
 * Removes awards from our database. 
 * If “$award_id” is null, then we are going to delete everything in the database with the specific “$user_id” 
 * 
 * @param int $user_id – ID of the user that we are “awarding” the award to 
 * @param int $award_id – ID of the award that we are “awarding” 
 * @return mixed – Return the value of a $wpdb->delete() call 
 */ 
$UserAwards->RemoveUserAward( $user_id, $award_id = NULL );
/** 
 * Function that grabs as many awards assigned to the user as we can based on the parameters given. 
 * For example, if just a user_id is supplied, then we will return all of the awards with that user_id. 
 * If an award_id is supplied along with our user_id then we will probably get only one award. Hopefully 
 * 
 * @param int $user_id – ID of the user that we are “awarding” the award to 
 * @param int $award_id – ID of the award that we are “awarding” 
 * @return mixed – Returnes the value of a $wpdb->get_results() call 
 */ 
$UserAwards->GetUserAward( $user_id, $award_id = NULL);
<h3>Attribution</h3>
This plugin’s icon is not an original piece of work. It was made by <a href="www.flaticon.com" rel="nofollow ugc">Freepik from Flaticon.com</a>

User Awards

Let your users know how much you appreciate them! Enhances your site with the ability to assign and give awards to users based on the actions that the …

J.D. Grimes

<h4>Features</h4>
This plugin lets you create one or multiple types of points which you can use to reward your users when certain events occur on your site. It also includes a Ranks component, which lets you create ranks for your users based on how many points they have.
You can currently award points to users for:
<ul>
<li>Registration</li>
<li>Posts – You can be selective in which post types get awarded points, and award different amounts for different types. Points will automatically be removed when a post is removed.</li>
<li>Comments – You can award points to a user when they leave a comment, and also to post authors when they receive a comment. As with posts, you can award different amounts for comments on different post types, and points will automatically be removed if you delete a user’s comment or mark it as spam.</li>
<li>Visiting your site – You can award points to a user when they visit your site at least once in a time period; once per day, for example.</li>
</ul>
You can also conditionally award points based on a post’s tags, a comment’s text, a user’s role, and more!
All points transactions are logged and can be reviewed by administrators from the WordPoints » Points Logs admin screen. The logs can be displayed on the front end of your site using the <a href="https://wordpoints.org/user-guide/shortcodes/wordpoints_points_logs/" rel="nofollow ugc"><code>[wordpoints_points_logs]</code></a> shortcode.
You can show how many points a user has using the <a href="https://wordpoints.org/user-guide/shortcodes/wordpoints_points/" rel="nofollow ugc"><code>[wordpoints_points]</code></a> shortcode. You can also display a list of the top users with the most points using the <a href="https://wordpoints.org/user-guide/shortcodes/wordpoints_points_top/" rel="nofollow ugc"><code>[wordpoints_points_top]</code></a> shortcode.
You can display a list of ways that your users can earn points using the <a href="https://wordpoints.org/user-guide/shortcodes/wordpoints_how_to_get_points/" rel="nofollow ugc"><code>[wordpoints_how_to_get_points]</code></a> shortcode.
The plugin also provides <a href="https://wordpoints.org/user-guide/widgets/" rel="nofollow ugc">several widgets</a> you can use for the same things as the shortcodes.
More features are always being planned, and you can check out the roadmap on the plugin website, <a href="https://wordpoints.org/roadmap/" rel="nofollow ugc">WordPoints.org</a>.
Also on the plugin’s website, you can <a href="https://wordpoints.org/extensions/" rel="nofollow ugc">browse the available extensions</a>. There’s <a href="https://wordpoints.org/extensions/importer/" rel="nofollow ugc">an extension that imports from CubePoints to WordPoints</a>, one that <a href="https://wordpoints.org/extensions/woocommerce/" rel="nofollow ugc">integrates with WooCommerce</a>, one that <a href="https://wordpoints.org/extensions/buddypress/" rel="nofollow ugc">integrates with BuddyPress</a>, and another that let’s you <a href="https://wordpoints.org/extensions/reset-points/" rel="nofollow ugc">reset your users’ points</a>. More are being added regularly, so take a look to see what is new.
<h4>Developers</h4>
If you are a developer, designer, or accessibility expert, and you’d like to give back to this plugin, you should visit the <a href="https://github.com/WordPoints/wordpoints/" rel="nofollow ugc">plugin’s repo on GitHub</a>, where active development takes place.
If you are interested in integrating or extending the plugin, you’ll want to read the <a href="https://wordpoints.org/developer-guide/" rel="nofollow ugc">developer docs</a>.
If you are a security researcher you can report vulnerabilities through our <a href="https://hackerone.com/wordpoints" rel="nofollow ugc">bug bounty program on HackerOne</a>.
<h4>Privacy Policy</h4>
WordPoints does not communicate with any remote services by default. However, when you install extensions from WordPoints.org or other servers, WordPoints may communicate with those services in order to provide you updates for the extensions. Check the privacy policy of the extension server in question to learn more about what information is shared with it, though generally only the ID and version of the extension will be sent to the update service.

WordPoints

Gamify your site, track user rep, or run a rewards program. WordPoints has a powerful core, infinitely extendable via add-ons.

User Awards vs WordPoints