Points, Badges and Ranks

Award points, badges, and ranks to your users for various activities. Bimber includes a set of readymade hooks, badges, and ranks that you can easily import.

Requirements

Points, badges, and ranks require the myCRED plugin to work.
The plugin is available for free in wordpress.org repository.
You can download it or install directly
from the WP Dashboard › Plugins › Add new panel.

After installing the plugin you will see the following notice:

myCRED needs your attention. Run Setup

at the top of the admin panel. Please perform the setup, it is necessary for the plugin to work.

Activation Problem

If you can’t activate the plugin because of the error:

The plugin could not be activated because it triggered a fatal error.

Sorry but your WordPress installation does not reach the minimum requirements for running myCRED. The following errors were given: The mcrypt PHP library must be enabled in order to use this plugin! Please check your PHP configuration or contact your host and ask them to enable it for you!

You have to install on your server the PHP mcrypt library (myCRED uses it to encrypt data transmitted on the “front end” of your website to prevent tempering or abuse) or
you can, for a development phase, disable the protection by adding the line below to your wp-config.php file:

define( 'MYCRED_DISABLE_PROTECTION', true );

After adding this line, you will be able to activate the plugin.

Updates

As any other plugin from wordpress.org site, when a new version of the plugin is available, you will be notified about it directly in your Dashboard.

Official Documentation

Please refer to the official documentation for extensive information on the plugin’s functionalities.

Basic Concepts

Hooks. The most important part. They are preset events that you can assign points for. Without defined hooks, you won’t gain any points, badges and finally ranks.

Example
If you enable the Publishing Content hook and set it to assign 10 points for a published post, 10 points will be given to each user every time they publish a post.

Points are awarded to a user for chosen actions, like adding content, leaving comments, posting on the forum, etc. Every time points are added, an entry to points log is made, which contains the number of points and the reference (action which was awarded points)

Ranks are titles awarded to the user for getting a set number of points in total. They are displayed next to the avatar.

Badges are ‘achievement’ that is awarded for getting a set number of points for a chosen action. For example, you can get ‘Forum Submissions’ badge for getting 10 points for posting on the forum. Badges might have multiple levels.

How To Import Bimber Content For MyCred?

1. Please go to WP Dashboard › Appearance › Theme Options panel and choose the Tasks tab
2. In the Import MyCred section, you can choose content you wish to import. The content is sorted by the associated plugins and also by the type of content (hooks, badges, ranks). Please notice, that some checkboxes might be disabled if the plugin is not active or if not all of the MyCred add-ons are turned on (in case of badges and ranks). Check the section below to enable them.
3. Press Run Now to start the import. This might take up to a minute
4. You can clean all the MyCred content using the Reset MyCred task

Icons Not Imported

Depends on your site’s setup, WordPress might not allow you to import SVG icons.
The reason SVG images are not allowed is that there are security concerns to be addressed. SVG is an XML file, which by itself opens it up to different
vulnerabilities of which normal image formats are not affected.
Best and, what’s more important, a safe way to allow SVG uploads is to use the Safe SVG plugin.
The theme is fully compatible with it, so when you enable the Safe SVG plugin it will take full control over uploaded SVGs, the same protect your site against SVG/XML vulnerabilities.

More detailed info about SVG security concerns you will find in the How to Safely Enable WordPress SVG Support article.

How To Enable Badges/Ranks/Notifications

1. Please go to WP Dashboard › Points › Add-ons panel
2. Find the functionality you’re interested in and click Activate

How To Get Your First Points And a Badge?

After importing the content you can take a few quick steps to test the plugin with What’s your reaction

1. Please go to WP Dashboard › Points › Add-ons panel
2. Please enable the Notifications addon to see the notifications
3. Please go to a post and vote for a reaction. For each reaction, you will receive 1 point.
4. You will receive a notification for getting points in your next page view.
5. After getting 10 points for reactions you will receive a level 1 Reactions badge.
6. You will receive a notification for getting the badge in your next page view.

How To Create a Leaderboard, Badges or Ranks page (like on the demo)

1. Please go to WP Dashboard › Pages panel and create a new page
2. Inside the page content please paste the following code: [mycred_leaderboard template="page"] to get the Leaderboard page
3. Inside the page content please paste the following code: [mycred_badges] to get the Badges page
4. Inside the page content please paste the following code: [mycred_list_ranks] to get the Ranks page

How To Display MyCred Information In the BuddyPress Profile Header?

1. Please go to WP Dashboard › Points › Settings panel
2. Inside the Ranks section set BuddyPress to include in the profile header
3. Inside the Badges section set BuddyPress to include in the profile header
4. Inside the BuddyPress section set Point Balance to include in the profile header

How To Customize the Notifications?

1. Please go to WP Dashboard › Points › Add-ons panel
2. Inside the Notifications section set Template to modify the format of the points notifications
3. Inside the Notifications section set Duration to modify the displaying time of the points notifications

How To Add My Own Ranks?

1. Please make sure that the ranks addon is enabled (see above)
2. Please go to WP Dashboard › Points › Ranks panel and press the ‘add new’ button
3. Set the title of the rank and add the rank image on the right
4. Set the point requirements (minimum and maximum), between which the rank will be awarded
5. Press publish
6. You can learn more here

How To Add My Own Badges?

1. Please make sure that the badges addon is enabled (see above)
2. Please go to WP Dashboard › Points › Badges panel and press the ‘add new’ button
3. Set the title of the badge and add the default image on the right (displayed for users without the badge, the ‘locked’ version)
4. You can create levels for the badge, each with its own image, requirements, and rewards
5. You can set the description to be used on the ranks page by setting the excerpt (you might have to enable it in the Screen Options at the top of the page)
6. You can change the order of rank display using the Order input on the right
7. Press publish
8. You can learn more here

How To Add My Own Hooks?

1. Please go to WP admin panel › Points › Hooks panel and press the ‘add new’ button
2. You can choose and drag hooks like widgets to activate and deactivate them
3. For each hook, you can manipulate their individual options. Please remember to press save.
4. You can learn more here

How To Manually Assign Badges And Points?

1. Please go to WP Dashboard › Users panel and choose a user
2. You can give/reduce points in the Balances section
3. You can give/reduce badges in the Badges section
4. Please remember to save the changes

How To Recalculate Badges Ranks For Users?

When you create or edit Badges or Ranks you might want to apply them to the users who already have fulfilled their requirements. To do this, please follow those steps:

1. Please go to WP Dashboard › Points › Settings panel
2. In the Management section please press Assing Ranks to Users
3. Please go to WP admin panel › Points › Badges panel and go into the edition of the badge you wish to apply
4. Press Assing Badge. You have to do it for every badge individually