Note:
Your organization must be subscribed to Igloo's Gadget Depot to use gadgets in your digital workplace. Contact your Customer Success Manager or email the Customer Success Team to subscribe to the Gadget Depot and get access to all available gadgets.
Use the trending content gadget to display content from connected channels ordered by views, likes, or comments. Users can interact with the displayed content by viewing, liking, sharing, or bookmarking it.
The trending content gadget can only display content from the following channel types:
Sections in this article:
Considerations
-
Keyboard Navigation: The following functionality of the gadget does not support keyboard navigation:
- Share button
- Bookmark button
- Add a Personal Bookmark popup
- Firefox web browser: When using Firefox, selecting the Share or Bookmark buttons will cause the browser window to jump to the top of the current page. If your organization uses Firefox, we recommend hiding the Share and Bookmark buttons from the gadget.
- Images: If no feature image or image in the content is found, the gadget can be configured to display the workplace logo, a custom fallback image, or nothing.
Who can do this?
- Enterprise administrators
- Workplace administrators
- Space administrators
- Members of the digital workplace with Edit or Full access
Language support
- Files: The platform does not support file languages, so file names and descriptions will appear as they are uploaded to the digital workplace.
- Error messages: Error messages are displayed in English.
- Personal bookmarks: If adding an object as a personal bookmark from the gadget, the title will autofill to the same title as the object. As a result, if the object has a title for the currently selected language, that will be the title the bookmark uses. The title can be changed before saving the personal bookmark.
- Gadget text: All gadget interface text and tooltips have translations for all platform languages.
Set up
Follow these steps to set up this gadget:
- Place an
Integrations widget on a page, space, or dashboard. For more information, see Placing and setting up a widget. The gadget can be placed in any size column. However, it does look best in a small or medium-sized column rather than spanning the whole page.
- Select the placed widget's Edit button.
- Under Integration Library, select Igloo Gadget Depot.
- Select the
Trending Content Gadget 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 to provide context to the widget. The title appears as a heading above the widget's contents. When entering a title, enter it in your currently selected language. If your digital workplace supports multiple languages, you select This field can contain a maximum of 140 characters. |
Title link | Enter the URL of a location in your digital workplace. Users who select the widget's title, if it has one, will go to this location. The URL may be a relative URL or an absolute URL. This field can contain a maximum of 2,083 characters. |
Description |
Enter a description of the widget to provide information to users about it. The description appears between the title and the widget's contents. When entering a title, enter it in your currently selected language. If your digital workplace supports multiple languages, you select |
Setting | Description |
---|---|
Channel paths to search for trending items |
Enter a comma-separated list of URLs to identify which channels the gadget will display trending items from. This should be the whole path after the site's domain. For example, for a channel located at To display objects from multiple channels, list the paths separated by commas. For example: It is recommended that 1-4 channels be connected to the gadget to optimize the performance and predictability of the displayed content. |
Number of items to display |
Select the maximum number of objects to display. Options include:
This limit is applied after items are sorted. As a result, the sort order can result in different objects being displayed. |
Date range for trending items |
Select the date range that will be applied to the items found in the channels listed in the gadget configuration. If items are published within the selected time range, they will be displayed in the gadget. Options include:
|
Include archived items |
Select to display archived objects. This setting is not selected by default. |
Sort order |
Select the order in which objects are displayed. Options include:
|
Setting | Description |
---|---|
Number of Top Trending Items to Highlight |
Select the number of items in the gadget that will appear with a highlighted styling. For example, if 3 is entered, but there are 10 objects in the gadget, there will be a carousel for items 3-10 to cycle through, and objects 1 and 2 will always be displayed. If this value is not 0, a negative number, or a number higher than the number entered in the configuration option Number of items to display, the gadget will use the value 3. The default value is |
Choose whether links open in the same or a new tab |
Select how users experience links that redirect to another location. Options include:
|
Use article feature images for blog articles |
Select to have the gadget to check if a blog article has a featured image and use that object's image in the gadget instead of an image in the blog's content. To use this feature, the configuration options Do not display images in the gadget and Use custom fallback image instead of using images from content must be unselected. For more information on how blog article feature images are displayed in the gadget, see Feature image. This setting is unselected by default. |
Image to display if no image available |
Select what to display if the content has no image to display. Options include:
If the configuration option Do not display images in the gadget is selected, this configuration option will not affect the gadget. If the configuration option Use custom fallback image instead of using images from content is selected, this configuration option will not affect the gadget. |
Custom fallback image |
Enter the absolute link of an image to display if an image is not found in the content. To use this configuration option, the previous configuration option Image to display if no image available must be set to Custom fallback image. If the configuration option Use custom fallback image instead of using images from content is selected, this image will be used for every object in the gadget. If the configuration option Do not display images in the gadget is selected, this configuration option will not affect the gadget. Keep in mind the following:
|
Use custom fallback image instead of using images from content |
Select to use the custom fallback image for every object in the gadget instead of using images from the content. If the configuration option Do not display images in the gadget is selected, this configuration option will not affect the gadget. This setting is unselected by default. |
Select an image position |
Select how the content's image is displayed in the gadget. Display options include:
If the configuration option Do not display images in the gadget is selected, this configuration option will not affect the gadget. For smaller viewports and column sizes (440 pixels width or smaller), the image will default to Above the content. |
Which author to credit |
Choose whether the author credited in the gadget will be the author who created the object or the author who last modified the object. Options include:
If the configuration option Hide content author is selected, this configuration option will not affect the gadget. |
Do not display images in the gadget |
Select to not display images found in the gadget's content. If turned on, the configuration options Image to display if no image is available and Select an image position will not affect the gadget. This setting is unselected by default. |
Do not use icons to show rank changes for trending items |
Select to not use icons to track the ranking changes for the items displayed in the gadget. If turned on, the order of trending items will not be stored in the user's local storage, and the content in the gadget will still display their numerical ranking, but all items will use the This setting is unselected by default. |
Hide the trending number and icon |
Select to not display the chip with the trending ranking and icon. If turned on, the order of trending items will not be stored in the user's local storage, and the numerical ranking for each item will be hidden. This setting is unselected by default. |
Hide the published date |
Select to not display the published date on items. This setting is unselected by default. |
Hide content author |
Select to not display the chip with the author's name and profile picture in the gadget. This setting is unselected by default. |
Hide content author's profile image |
Select to not display the content author's profile picture beside their name in the gadget. If this setting is selected, all author's profile images will be icons with the first letter of their first name. If Hide content author is selected, this configuration option will not affect the gadget. This setting is unselected by default. |
Hide content channel |
Select to hide the name and icon of the channel from which the content originated. This setting is not selected by default. |
Hide the object summary from the toolbar |
Select to hide the object descriptions in the gadget. This setting is not selected by default. |
Hide views |
Select to not display the number of views on items. This setting is unselected by default. |
Hide likes |
Select to not display the number of likes on items. This setting is unselected by default. |
Hide comments |
Select to not display the comment button on items. The comment button displays the current number of comments on an item, and users can select it to go to the comment section of that item. This setting is unselected by default. |
Hide the like button |
Select to hide the This setting is unselected by default. |
Hide the share button |
Select to hide the When clicked, options include:
This setting is not selected by default. |
Hide the bookmark button |
Select to hide the When clicked, a form will pop up with text fields auto-filled with the item's title and URL. The field for the title can be edited, but the field for the URL can't. Users can click Save to save the personal bookmark or Cancel to close the form. This setting is not selected by default. |
Setting | Description |
---|---|
Check to load styles from the main Igloo stylesheet |
Select to style the gadget according to the theme of your digital workplace. This setting is selected by default. |
Choose the color scheme |
Select a color scheme. Options include:
If Check to load styles from the main Igloo style sheet is selected, this setting will use the color theme of your digital workplace when determining the colors of the gadget. If it is not selected, the color scheme will use black ( |
Custom CSS file |
If you are using a custom CSS file to style this gadget, enter the absolute URL of where the style sheet is located. Keep in mind the following:
|
Text color |
Enter the color used for the text in the gadget. Use any of the following formats:
The default value is:
|
Background color |
Enter the color used for the background of the gadget. Use any of the following formats:
The default value is:
|
Clickable Button and Links color |
Enter the color used for the gadget's links (the content title and comments) and buttons (which appear in the bookmark form). Use any of the following formats:
The default value is:
|
Like Button color - clicked |
Enter the color used for the like icon in the gadget if an item is liked. Use any of the following formats:
The default value is |
Trending Chip color |
Enter the color used for the chip displaying the object's current trending position in the gadget. Use any of the following formats:
The default value 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), 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 other than Auto will add a vertical scrollbar to the gadget. |
Note
Your digital workplace's theme overwrites many of the settings on the Appearance tab. However, the settings listed above are usable.
Using it
On page load, the gadget displays trending content from configured channels.
The gadget provides the following options:
- Article title: Select to navigate to view the content in the original location in the digital workplace.
- Author chip: Select to navigate to view the author's profile page.
- Channel chip: Select to navigate to view the content's channel in the original location in the digital workplace.
- Comments: Select the comments link to navigate to view the content in the original location in the digital workplace. Comments can be added to this location.
-
Like button: Select to like the display content item. Selecting a second time will remove your Like from the content.
-
Share button: Select to copy the original location URL of the displayed content item.
-
Bookmark button: Select to add a personal bookmark for the displayed content item.
Troubleshooting
The gadget will be unable to display any information if any of the following conditions are met:
- No valid blog, calendar, folder, forum, and wiki channel paths are provided in the gadget configuration.
- The blog, calendar, folder, forum, and wiki channel paths are valid, but they do not contain any content for the gadget to display.
- The blog, calendar, folder, forum, and wiki channel paths are valid, but the user viewing the gadget does not have Read access or higher to the connected channels. The user needs to have Read access to at least one channel in the gadget configuration to see content in the gadget.
- If they have Read access to a specific content object (blog, event, etc.) but not the parent channel, they cannot see that object.
- If a user has Read access to a channel but not the channel's content, they will likewise not see content in the gadget.