Recognition Center Plus: Leaderboard widget

The Recognition Center Plus Leaderboard widget is a part of the Recognition Center Plus module. It allows admins and page editors to display a leaderboard for:

  • Nominees: A list of users who have been recognized the most times.
  • Submitters: A list of users who have submitted the most recognition posts.

The Top Awards widget showing Walter, Stacy, Seth, and Antonia as the top 4 most awarded nominees.

Sections in this article:

Considerations

  • Recognition Center Plus set up: Before using this widget, ensure that you have set up the following components of a Recognition Center:
    •  Submissions Blog Channel

Set up

  1. Place an  Integrations widget on a page or space. For more information, see Placing and setting up a widget.
  2. Select the placed widget's Edit button.
  3. Under Integration Library, select Recognition Center Plus.
  4. Select the  Recognition Center Plus Leaderboard Widget from the library.
  5. Review and make changes to the settings on the Options and Appearance tabs. You can find details about the widget's settings in the Settings section below.
  6. In the widget editor, select Update to apply your changes or Cancel to discard them.
  7. At the bottom of your page, space, or dashboard, select Publish or Save as Draft to save your changes. 

Settings

Options tab

Setting Description
Title

Enter a title for the widget. The title appears as a heading above the widget's contents. You should use the title to provide context to the widget and better structure a page's content by clearly denoting different sections.

When entering a title, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select  Translation and enter a title for each supported language. 

This field can contain a maximum of 140 characters.
Title link

Enter the URL of a location in your digital workplace. If the widget has a title, users who select it will go to this location. Whether you enter the link as a relative URL or an absolute URL does not matter; it will convert to an absolute URL the next time you edit the widget.

This field can contain a maximum of 2,083 characters.
Description

Enter a description for the widget. The description appears between the title and the widget's contents. You can use this text to provide users with information about the widget.

When entering a description, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select  Translation and enter a description for each supported language.
General options
Setting Description
Recognition blog channel

Enter the URL of the blog channel where users create recognition posts. The widget will source post information from this channel.

This URL must be relative to the root URL of your digital workplace.

Example:

/recognition_center/kudos
Leaderboard type

Select the type of leaderboard to display. Options include:

  • Most recognitions received: Displays a list of users who have been recognized the most.
  • Most recognitions submitter: Displays a list of users who have submitted the most recognition posts.

Enter how many names are shown in the leaderboard list.

The maximum number of entries is 20.

The default value is 5.
Period starting date

Enter the start date of your reporting period. Posts before this date will not be reflected in the leaderboard standings. Use the format MM/DD/YYYY. 

If this field is left blank, no results will be shown.

Example:

07/21/2023
Content options
Setting Description
Leaderboard title

Enter the title text that will be displayed above the leaderboard.

This value is distinct from the value entered in Title. Use this instead of the Title setting if you want a title that better matches the widget's style. You do not need to use Title Link or any enhancements that interact with a widget's title. Entering values in both title fields will result in two titles on the widget. 
Title icon

Enter the name of a Font Awesome icon to display at the beginning of the Leaderboard Title. The name must be in Font Awesome format, preceded by fa-.

The default is fa-trophy.

If this field is left blank, no icon will appear.
Display options
Setting Description

Enter a hex color code, RGB or RGBa value, or color name. The widget uses this color for the top entry in the leaderboard, and the color fades with each subsequent position.

Example:

#EEECEA
Leaderboard icon color

Enter a hex color code, RBG or RGBA value, or color name. The widget uses this color for the icon's color in the leaderboard title.

Example:

#EEECEA
Font Awesome icon style

Enter the Font Awesome icon style for the icon in the leaderboard title.

The default is fa-solid. This value can not be blank.
Style options

Appearance tab

Setting Description
Class

 Enter CSS class selectors to provide additional styling to the widget. For more information, see Applying custom CSS to widgets.
Height

 Select the height of the widget. Options include:
  • Auto: The leftmost slider position. The widget's height will increase and decrease to contain what it displays.
  • Fixed: Select a fixed height between 50px and 600px in increments of 50px. A vertical scrollbar will appear on the widget if the content exceeds this fixed value.

Note

Your digital workplace's theme overwrites many of the settings on the Appearance tab. However, the settings listed above are usable.