Microblog Posts widget

The Microblog Posts widget is used to display a feed of posts made on the connected microblog channels. Users can then view and interact with these posts from a central location, rather than each channel separately.

Sections in this article:

Considerations and caveats

I can't find the widget: The Microblog Posts widget only appears in the Widget Carousel if your digital workplace has Microblogs enabled. You can find this option on the Global Settings page of the Control Panel.

Widget layout

The microblog post widget on a page. The labeled components are described below.

Point of interest Description
1. Title The title provides context to the purpose of the widget.
2. Description The description provides additional information about the widget
3. Follow button

Select to follow all microblog channels connected to the widget. For more information, see Following channels from widgets.

The presence of this element is configurable in the widget's settings.

4. Share a thought...

Select to begin creating a new post on the connected microblog channels. For more information, see Writing microblog posts.

Users can only post to microblog channels that they have at least Write access to.

The presence of this element is configurable in the widget's settings.

5. Connected channels

Shows which microblog channels the widget is connected to. Select a channel's hash name to go to it.

Users can only see microblog channels that they have at least Read access to.

The presence of this element is configurable in the widget's settings.

6. Microblog post

Microblog posts from the connected channels are shown in chronological order and will display the following information:

  • Author's profile photo (configurable in the widget's settings)
  • Author's name (configurable in the widget's settings) 
  • Date and time of the post (configurable in the widget's settings) 
  • Body of the post
  • Attachments on the post

Other users can interact with a post by:

  • Selecting Like
  • Selecting Reply to add a comment to the post

Users can only see posts that they have at least Read access to.

The number of posts initially shown is configurable in the widget's settings.

7. Shared in Select to view which microblog channels a post is shared to.
8. Actions button

Select to display additional ways of interacting with a post. Options include:

  • View Post: Select to go directly to the post
  • Edit: Select to make changes to the post
    • Requires Edit access or higher on the connected microblog channels or post. Since posts can be shared to multiple microblog channels, a user only needs at least Edit access on one of those channels to edit the post. The edit will change the post across all of the channels that it is shared to.
  • Translate: Select to translate the post to your preferred language
  • Archive: Select to archive the post
    • Workplace and Enterprise Administrators only
9. Comments

The three most recent comments made on a post are always shown. Select Show more comments to view ten more comments.

Other users can interact with a comment by:

  • Selecting Like
  • Selecting Reply to comment directly on the comment
10. Load More

Select to load additional posts.

This option is not available if the widget's layout is configured to be Compact.

Legend

Set up

Follow these steps to set up this widget:

  1. Place a  Microblog Posts widget on a page, space, or dashboard. For more information, see Placing and setting up a widget
  2. Select the placed widget's Edit button.
  3. Review and make changes to the settings on the Options, Layout, and Appearance tabs. You can find details about the widget's settings in the Settings section below.
  4. In the widget editor, select Update to apply your changes or Cancel to discard them.  
  5. At the bottom of your page, space, or dashboard, select Publish or Save as Draft to save your changes.

Settings

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.

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  Translation and enter a description for each supported language.

Community Channels / Space Channels

Select which microblog channels to use as sources for the widget. Only microblog channels that are in a space are listed in the space channels section. All other microblog channels in your digital workplace are listed in the Community Channels section.

When configuring the widget, users can only select microblog channels that they have at least Write access to. Other microblog channels won't appear in the channels list.

Enabling sharing thoughts

Select whether users can make new posts to the connected microblog channels.

If enabled, users can select Share a thought... to begin writing a microblog post using the compact WYSIWYG editor

  • By default, users can unselect which of the connected microblog channels to post to. Otherwise, the post is shared with all connected microblog channels. To remove the ability to unselect connected microblog channels (to force publishing to all connected channels), enable the setting Always Share to all selected channels.
  • Regardless of this setting, users can only post to microblog channels that they have at least Write access to.
  • Users can toggle whether commenters can share this post with other channels or not by toggling the Open for sharing option. By default, sharing is always enabled. To disable sharing, hover over Open for sharing and select Close. Select Enable to turn this behavior back on.

If disabled, users cannot make new posts from the widget. However, they can still reply to existing posts.

Regardless of whether this setting is enabled, users cannot Share a thought... if the widget is configured to use the Compact layout.

Always share to all selected channels

This setting is only available when Enable sharing thoughts is enabled.

Select to make user's new posts automatically be shared with each of the connected Microblog Channels.

If enabled, users can't deselect which of the connected microblog channels to post to. If disabled, users can click Share with... when creating a new post to deselect the connected channels they don't want to post to.

Display feed

Select to show a feed of microblog posts made on the connected microblog channels.

If enabled, users can view and comment on posts made on the connected microblog channels that appear in the widget. However, users can only see posts that they have at least Read access to. If disabled, no feed will appear in the widget.

Show available channels in header

This setting is only available when the Display feed is enabled.

Select to show a list of the connected microblog channels in the widget.

If enabled, the connected microblog channels are shown using their microblog hash name and can be selected to go to the channel itself. Users who do not have at least Read access to a channel won't see the channel in this list. If disabled, no list of connected microblog channels is shown.

Number of results

This setting is only available when the Display feed is enabled.

Enter the maximum number of results to increment by and to display initially. You must enter a value between 1 and 99. If there are additional items to display, users can select the Load More link, found at the bottom of the feed, to load additional results.

Users are unable to load more posts when the widget is configured to use the Compact layout.

Show follow icon Select to add a Follow button to the widget. Users can select this button to subscribe to all channels displayed in the widget to which they have at least Read access.
Options tab
Setting Description
Choose A Layout

Select how the widget displays posts. Options include:

  • Standard: Best used when the widget occupies the center column of a page or moreA microblog widget using the standard layout.


  • Compact: Best used when the widget occupies a narrow side column of a page or space.
    • Does not allow users to Share a thought...
    • Does not show comments or allow users to post comments.
    • Can't load more posts

      A microblog widget using the compact layout.

User Photo Select whether an author's profile photo is shown on their post or comment.
Date Select whether the date and time of a post are shown. Comments still display when they occur, regardless of this setting.
Author Select whether an author's name is shown on their post or comment.
Layout option
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 height of the widget will increase and decrease to contain what it is displaying.
  • Fixed: Select a fixed height between 50px to 600px in increments of 50px. A vertical scrollbar will appear on the widget if the content exceeds this fixed value.
Appearance tab

Note

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