My Feed gadget

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 My Feed gadget to provide your digital workplace users with a personalized feed of content based on their channel subscriptions. By default, the gadget displays content from blogs, calendars, forums, microblogs, and wikis that users are subscribed to as items in a feed. However, settings exist to modify the items displayed in the feed and their sort order.

An example feed showing 3 items with one expanded.

Sections in this article:

Considerations and caveats

  • Subscriptions: Only content items associated with channel subscriptions are displayed in the gadget. Content subscriptions are not displayed.
  • Channel support: The gadget supports only blogs, calendars, forums, microblogs, and wikis. It does not support folders or tasks.
  • Language support: Feed items are shown in a user's preferred language as long as the content creator has provided a translation.
  • Performance: If you are finding that the feed is loading slowly, you can improve performance by hiding the like button.

Set up

Follow these steps to set up this gadget:

  1. Place an  Integrations widget on a page, space, or dashboard. For more information, see Placing and setting up a widget. While the widget can be placed anywhere on a page, for the best experience, place it in a side column.
  2. Select the placed widget's Edit button.
  3. Under Integration Library, select Igloo Gadget Depot.
  4. Select the My Feeds gadget 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

General Options
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. Users who select the widget's title, if it has one, 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.

Content Options
Setting Description
Include archived items Select to include archived content in the feed.

This setting is unselected by default.
Include these channel types Found by expanding Advanced Options.

Enter a comma-separated list of channel types. Content from the selected channel types will be displayed as items in the feed. Supported channel types are:
  • blog
  • calendar
  • forum
  • microblog
  • wiki

Example:

blog,forum, microblog

The default value of this option is:

blog,calendar,forum,microblog,wiki
The default value will be applied if this option is left blank or incorrect.
Display Options
Setting Description
Number of items to display Select the maximum number of items to display in the feed. Options include:
  • 5
  • 10
  • 15
  • 20
This limit is applied after items are sorted. As a result, the Sort order can cause the feed to show different items.

The default value is 10.
Sort order Select the order in which feed items are displayed. Options include:
  • Created: The date the item was created.
  • Published: The date the item was published.
  • Modified: The date the item was last modified.
The most recent items are always displayed at the top of the feed.

The default value is Created.
Limit results to same location as the gadget Select to only display content from channels nested below this gadget's location.

For example, if the gadget were placed on the Company News page of the digital workplace shown below, the channels displayed in the feed would change as follows based on the value of this option:
  • Selected: Only items from CEO Updates, Corporate News, and Town Halls would be included in the feed. 
  • Unselected: Items from CEO Updates, Corporate News, Town Halls, Upcoming Events, Classifieds, and Chatter would be displayed in the feed.
This setting is unselected by default.
Hide likes Select to not display the like button on feed items. The like button displays an item's current number of likes, and users can select it to add a like.

This setting is unselected by default.
Hide comments Select to not display the comment button on feed 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 views Select to not display the number of views on feed items.

This setting is unselected by default.
Disable the like button Select to turn off the like button's functionality. The number of likes will still be displayed, but users cannot select the button to add a like.

This setting is unselected by default.
Disable the add a comment button Select to turn off the comment button's functionality. The number of comments will still be displayed, but users cannot select the button to go to the comment section of that item.

This setting is unselected by default.

Style Options
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.

Custom CSS File If you are using a custom CSS file to style this widget, enter the absolute URL of where the style sheet is located. Keep in mind the following:
  • The style sheet will take precedence over styles in your digital workplace's theme.
  • The style sheet must reside in the same digital workplace using the gadget or be hosted in a service such as Azure.
  • If you are hosting the style sheet in your digital workplace, it must be located in a folder channel named filesthat is located at the root of your digital workplace. The style sheet can be located anywhere within this folder channel. For example: 
    https://customercare.igloosoftware.com/files/css/stylesheetcss
  • Valid files must end with css.

Appearance tab

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

Appearance options
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.

Using it

On page load, the feed shows a list of content-related titles from configured channels you are subscribed to. You can select a title to expand it, revealing the following information:

  • Summary
  • Read more link
  • Number of likes (if enabled)
  • Number of comments (if enabled)
  • Number of views (if enabled)

While viewing an expanded feed item, you can:

  • Select Read more to go to the content.
  • Select the likes button to add a like (if enabled).
  • Select the comments button to go to the comment section of the content (if enabled).

Empty feed

The gadget displays no content warning when no feeds are being followed.

A feed may be empty for the following reasons:

  • You are not subscribed to any supported channels (blogs, calendars, forums, microblogs, and wikis).
  • You are not subscribed to any supported channels that the gadget is configured to display.
  • The supported channels that you are subscribed to don't have any content.