The Recognition Center Plus Viewer widget is a part of the Recognition Center Plus module. It displays all recognition posts in the specified blog channel in reverse chronological order, with user profile photos and badge images associated with each value.
From this widget, users can read the beginning of each recognition post, with a link to the post itself in the blog channel to read the full post.
Sections in this article:
Considerations and caveats
-
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
-
Value Badges Folder (containing badge images)
-
Default Profile Image
-
-
- Formatting requirements: The Viewer widget has specific formatting requirements, and will only display blog posts created by a Recognition Center Plus Submission Widget. Any posts created in the blog channel directly will not appear in the Viewer widget.
Set up
- Place an
Integrations widget on a page or space. For more information, see Placing and setting up a widget.
- Select the placed widget's Edit button.
- Under Integration Library, select Recognition Center Plus.
- Select the
Recognition Center Plus Viewer Widget from the library.
- 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.
- In the widget editor, select Update to apply your changes or Cancel to discard them.
- 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 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 information to users 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 |
| Setting | Description |
|---|---|
| Path to the 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:
|
| Default profile image |
Enter the URL of the default profile image. The widget displays this image for users who do not have a profile photo. The URL must be relative to the root URL of your digital workplace and be prepended with If this field is blank, the widget will show a broken image for any user without a profile photo. Example:
|
| Default badge image |
Enter the URL of the default badge image. The widget displays this image if there is no badge image found for a given value label. The URL must be relative to the root URL of your digital workplace and be prepended with If this field is blank, the will show a broken image when no badge image is found for a label. Example:
|
| Path to folder channel containing badges |
Enter the URL of the folder channel that contains the badge images. The URL must be relative to the root URL of your digital workplace and be prepended with Example:
|
| Setting | Description |
|---|---|
| More Button Text |
Enter the label text of the read more link that appears below recognition posts. The default is |
| Pagination Page Size |
Enter the number of posts to display per page of results. The default is The maximum number of posts that can be displayed is |
| Use the site's theme |
Select to load color and style elements from your digital workplace's theme. This is selected by default. |
| Content Background Color |
Enter a hex color code or color name. The widget uses this color for the background of each recognition post. This color overrides any color set by your digital workplace's theme. Example:
|
| Content Radius |
Enter a number. This value corresponds to the corner radius (in pixels) for the container of each recognition post. The larger the radius, the more rounded the container corners will be. Set to The default is |
| Badge Image Size |
Enter the width (in pixels) of the badge icons to display in each recognition post. The default is |
| Profile Picture Size |
Enter the width (in pixels) of the user profile photo to display in each recognition post. The default is |
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. The default value is Auto (leftmost slider position) scales the widget's height to fit its contents. You can use the slider to set a fixed height between 50px to 600px in increments of 50px. Selecting a height less than what is needed to display its contents results in the widget having a vertical scrollbar. |
Note
Your digital workplace's theme overwrites many of the settings on the Appearance tab. However, the settings listed above are usable.