1. Documentation
  2. Leaderboards
  3. Configuring a leaderboard

Configuring a leaderboard

Leaderboards add-on will add the “Leaderboards” submenu under the GamiPress menu.

Accessing to this menu you will be able to start configuring leaderboards similar to WordPress post/pages views.

1 – Configuring the metrics

First you will need to configure how internally the leaderboard should track to rank the users.

You will find this settings on the Leaderboard Data box:

Number of Users
Maximum number of users to rank.

Metrics to track
The metrics with which users will be ranked. Automatically they will be ranked by the most high value of each metric selected.

2 – Display options

From the Leaderboards Display Options box you will be able to set which columns will be showed to the visitors and enable/disable the frontend live functionalities.

Columns
From this option you can choose the columns to show regardless of the metrics selected. This means you are able to choose more metrics to track than the columns to be shown to visitors.
Also you have the ability to drag and drop any option to reorder them.

Show Search
Check this option to display the live search input (you can override this option in [gamipress_leaderboard] shortcode and in GamiPress: Leaderboard widget).

Enable Sort
Check this option to enable live column sorting (you can override this option in [gamipress_leaderboard] shortcode and in GamiPress: Leaderboard widget).

Hide Administrators
Check this option to hide website administrators (you can override this option in [gamipress_leaderboard] shortcode and in GamiPress: Leaderboard widget).

3 – Cache options

From the Leaderboards Cache Options box you will be able to configure the leaderboard caching results functionality, something really important if you want to show a large leaderboard (more than 100 users).

Enable Cache
Check this option to enable the caching results functionality.

Cache Duration
How much time should cache be stored (in hours).

Cache Information
From this area you will be able to see where the cache has been created as well as the number of users stored.
Also you will be able to manually refresh the cache if you are testing it, if not, then it will be refreshed automatically based on the Cache Duration option.

4 – Announcing a leaderboard

From the Leaderboards settings page you can enable/disable the ability to access to a leaderboard as a page.

If you disable it, Leaderboards has the [gamipress_leaderboard] shortcode that allows you to place a leaderboard anywhere, including in-line on any page or post.

Also you can place any leaderboard on any sidebar through the GamiPress: Leaderboard widget.

Both methods will show something like this:

Was this article helpful to you? Yes No

How can we help?