The Recognition Center Plus Submission widget is part of the Recognition Center Plus module. It allows users to submit a post to the recognition channel used by the rest of the module's widgets.
The fields that appear in the Submission widget are:
- Search for employees to recognize: A user search to select the user(s) to call out for recognition
- What values are you recognizing in this employee?: A dropdown list of the values set in the configuration. This is populated based on the labels in the label group chosen in the config.
- Why are you recognizing this employee?: A large text field where a submitter can write details about why they want to recognize the employee(s) they selected. This editor allows for rich text and images.
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)
-
Values Label Group (containing value labels)
-
- Static form: The fields in the submission form can change their labels but do not support additional customization.
- Editing posts: Once a recognition post is made, its content can not be edited. If moderation is turned on for the recognition channel and the content is not approved, the submitter must delete the draft and create a new one.
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 Submission 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 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 |
| Setting | Description |
|---|---|
| Blog Channel Path |
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:
|
| Label Group Name |
Enter the name of the label group containing the labels you use for badges. The widget displays some metrics broken down by the labels in this group. This value is case-sensitive. Example:
|
| Badge Folder Channel Path |
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 |
|---|---|
| Awardee Search Help Label |
Enter the label text that displays above the user search field. The default value is We recommend keeping this text below 255 characters. |
| Awardee Search Help Text |
Enter the tooltip text that displays when a user hovers over the user search field. The default value is We recommend keeping this text below 255 characters. |
| Value Search Help Label |
Enter the label text that displays above the values dropdown. The default value is We recommend keeping this text below 255 characters. |
| Value Search Help Text |
Enter the tooltip text displayed when a user hovers over the values field. The default value is We recommend keeping this text below 255 characters. |
| Textbox Help Label |
Enter the label text that displays above the details field. The default value is We recommend keeping this text below 255 characters. |
| Textbox Help Text |
Enter the tooltip text displayed when a user hovers over the details field. The default value is We recommend keeping this text below 255 characters. |
| Submit Button Text |
Enter the label text of the submit button. The default value is We recommend keeping this text below 255 characters. |
| Setting | Description |
|---|---|
| Mention the awardee's manager in the post? |
Select to @mention the user's manager in the body of the post so that they receive a notification. If selected:
This option is selected by default. |
| Manager's email profile field |
Enter the profile field name that contains the manager's email address. This default value is |
| Mention this user in every post (checkbox) |
Select to @mention the user specified by the Mention this user in every post text field so that they receive a notification. If selected, you must enter a value for the Mention this user in every post text field setting. This option is unselected by default. |
| Mention this user in every post (text field) |
Enter the user's email address that you want to @mention on each post. This user must be a member of your digital workplace. Example:
|
| Notify users with an Igloo Message |
Select this option to also send a message in your digital workplace to any users who are @mentioned in the body of the post. This sends a message to all of the following if they are configured to get @mentioned:
The format of this message is as follows:
This option is selected by default. |
| Link to Recognition Viewer in Igloo Messages |
If Notify users with an Igloo Message is selected, select this option to replace the messages link to the blog post with a link to a page with the Recognition Viewer widget on it. If selected, you must specify the link's URL in the Path to Recognition Viewer setting. This option is selected by default. |
| Path to Recognition Viewer |
If Link to Recognition Viewer in Igloo Messages is selected, enter the URL of the page you want to link to. The URL must be relative to the root URL of your digital workplace. Example:
|
| Setting | Description |
|---|---|
| Minimum Post Size |
Enter the minimum number of characters required by the details field (this value does not count HTML elements). Users can only submit posts that contain at least this many characters. The default value is |
| Humblebrag Mode |
Select to allow users to pick themselves as someone to recognize. This is unselected by default. |
| Load Site Theme |
Select to load color and style elements from your digital workplace's theme. This is selected by default. |
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), which scales the widget's height to fit its contents. You can use the slider to set a fixed height between 50px and 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.
Using it
To submit a recognition post:
- Search for and select the user they want to recognize in the Search for employees to recognize field.
- Select the values they would like to recognize from the values field.
- Write a description of why they are recognizing the user in the Why are you recognizing this employee? field.
- Select Submit. A popup will appear, asking the user to confirm their submission.
- Select Post. A loading bar will appear, and when complete, the submission page will be refreshed.
Once the submission process is complete, a new blog post will be created in the blog channel defined in the Blog Channel Path setting. The recognized user will be notified, and any Recognition Center Plus Viewer widget or Metrics widget configured to use that blog channel as a source will display the details of the newly created post.