Leaderboard Feature

Introduction

The Leaderboard component provides the ability to obtain a sense of how members are interacting within the community by ranking members according to points earned (basic scoring) or their expertise (advanced scoring).

Prior to including the leaderboard component on a page, it is necessary to configure Communities Scoring and Badges.

This section of the documentation describes

• Adding the Leaderboard component to a community site

• Configuration settings for the Leaderboard component

Adding a Leaderboard to a Page

To add a Leaderboard component to a page in author mode, locate the component

• Communities / Leaderboard

and drag it into place on a page.

For necessary information, visit Communities Components Basics.

When first placed on a page of a community site, this is how the component appears:

Configuring Leaderboard

Select the placed Leaderboard component to access and select the Configure icon which opens the edit dialog.

Settings tab

Under the Settings tab, specify what information related to the member is displayed:

• Display Name
  A descriptive name to display for the board, reflecting the rules selected for displaying badges and scores.

  Default is Leaderboard, if nothing entered.

• Badge
  If checked, a column for badge icons is included in the leaderboard.

  Default is unchecked.

• Badge Name
  If checked, a column for the badge name is included in the leaderboard.

  Default is unchecked.

• Use Avatar
  If checked, the member’s avatar image is included in the leaderboard, next to their name link to their member profile.

  Default is unchecked.

Rules tab

Under the Rules tab, the community site, and its scoring and badging rules

• Rule Location
  (required) Location where the Scoring/Badging rule is configured.

• Scoring Rule
  (required) Specific rule generating the scores to display.

• Badging Rule
  (required) Specific rule generating the badge to display.

• Display Limit
  Number of members to display per page.

  Default is 10.

Example: Participants Leaderboard

This leaderboard reports results from applying basic scoring rules.

Leaderboard component configuration:

• Settings tab:

  • Display Name = Participation Board

  • checked:

    • Badge
    • Badge Name
    • Use Avatar

• Rules tab:

  • Rule Location = /content/sites/communities/jcr:content
  • Scoring Rule = /etc/community/scoring/rules/forums-scoring
  • Badging Rule = /etc/community/badging/rules/reference-badging
  • Display Limit = 10

Example: Experts Leaderboard

This leaderboard reports results from applying advanced scoring rules.

Leaderboard component configuration:

• Settings tab:

  • Display Name = Expertise Board

  • checked:

    • Badge
    • Use Avatar

• Rules tab:

  • Rule Location = /content/sites/communities/jcr:content
  • Scoring Rule = /etc/community/scoring/rules/adv-forums-scoring
  • Badging Rule = /etc/community/badging/rules/adv-forums-badging
  • Display Limit = 10

Additional Information

More information may be found on the Leaderboard Essentials page for developers.

Instructions for creating rules are provided on the Communities Scoring and Badges page for administrators.