Share via


Yammer Embed and SharePoint 2013

By Chris Hopkins

Original Post
https://blogs.msdn.com/b/chhopkin/archive/2013/11/20/yammer-embed-and-sharepoint-2013.aspx

Well mostly just about Yammer Embed to help clear up some questions I get about its capabilities.

Yammer Embed

The Embed documentation on https://developer.yammer.com/connect/ specifically calls out 5 feed types that can be embedded using Yammer Embed today: My Feed (Home Feed), a Group Feed, a Topic Feed, a User Feed or an Object Graph Feed.

FYI – I have included a download which has a single HTML page configured for each of the scenarios discussed below.

Group Feed

When targeting a group using the feed id for that group, this embedded feed displays all the posts that were made to this specific group.

Note: Posts made from this feed are targeted at the group specified by the Embed parameters and cannot be redirected to any other group.

Topic Feed

When targeting a topic using the feed id for that topic, this embedded feed displays all the posts that reference the specified topic.

Note: You cannot create a new post from a Topic Feed, you can only reply to existing posts.

FYI - Topics can be found using search or the topic glyphs attached to specific posts. To learn about creating Topics see this video https://success.yammer.com/yaminars/topics/

User Feed

When targeting a user by specifying the user id (alias), this embedded feed displays all the posts that the user directly participated in (mentioned, posted, replied to).

Note: You cannot create a new post from a User Feed, you can only reply to existing posts.

Object Graph Feed

When targeting a specific object (based on URL), this embedded feed displays all the posts that are related to the specified object.

Note: Colleagues is the default option for any posts made from this embedded feed. Colleagues actually means All Company. You will need to change this to target a specific group if that is the intention. You cannot default this option to a specific group.

My Feed – aka Home Feed

FYI - The details of the ‘My Feed’ are explained here - https://support.microsoft.com/kb/2842157

When the feedtype and the feedid are not specified as part of the Embed, the ‘My Feed’ or ‘Home’ feed is displayed. This is the only feed that is confusing to developers that are implementing Embed because what you see from the home page on Yammer.com might not be the same as what you see from the embedded feed. The feed on the home page is your ‘My Feed’ and gives you the option to see posts based on Top – All – Following filters from the current network. The My Feed Embed is restricted to the Following option and only displays posts from the people, groups, topics, etc that you are following.

Note: Colleagues is the default option for any posts made from this embedded feed. Colleagues actually means All Company. You will need to change this to target a specific group if that is the intention. You cannot default this option to a specific group.

Additional Notes about Yammer Embed

  • The Top, All, and Following filters are not available and cannot be specified using Yammer Embed. By default the My Feed displays posts using the Following option and this cannot be changed via the Embed API.
  • Posts from External Networks are not included in this feed – You must specify a specific network as part of the Embed parameters.
  • Posts to Private groups that are part of the specified network are included.
  • You cannot limit the number of posts that are displayed.
  • There is no search mechanism provided by Embed.

Yammer App for SharePoint

This app is built using the Embed feature and specifically targets three use cases

  • Group Feed
  • Home Feed
  • Comment Feed

All but Comment Feed is self-explanatory. The Comment Feed option is actually the Open Graph feed in disguise. By supplying a URL this will either create a new object or connect to an existing object if one does not already exist. All posts for this object will be displayed in this feed.

Note: Colleagues is the default option for any posts made from this embedded feed. Colleagues actually means All Company. You will need to change this to target a specific group if that is the intention. You cannot default this option to post to a specific group.

Adding your own Yammer Embed to SharePoint using Content Editor or Script Editor

I use the Content Editor web part to display a Yammer feed which references a standard html page that contains all the JS references and the JS functions needed for the embed that I store in a document library or Site Assets library.

IE Settings

To ensure that Yammer Embed functions properly I suggest that you make sure the following settings are configured in IE:

Security > Trusted Sites

[Enable] Protected Mode

*.sharepoint.com

login.microsoftonline.com

Security > Local intranet

[Disabled] Protected Mode

*.assets-yammer.com

*.yammer.com

Note: Make sure your pages are checked in and published if you are doing this as part of a publishing site.

feed_sample_pages.zip

Comments

  • Anonymous
    November 25, 2013
    Thanks Chris, great stuff.
  • Anonymous
    March 11, 2014
    I am not able to vies the zipped HTML files. Are these set to private? How can I gain access? Thank you! :)
  • Anonymous
    April 02, 2014
    Great roundup, thanks.
  • Anonymous
    June 24, 2014
    Thanks. Have you used the embed with the Minimal Download Strategy feature enabled in SP2013? When we do it in our network, the Yammer feed only shows in "Edit" mode, and not in published mode. Have you written and code to help with the scenario of using the MDS?
  • Anonymous
    September 02, 2015
    I added yammer using script editor and I'm running into a redirect issue. If I am logged in with yammer the sharepoint site redirects me to the yammer feed and there is no way to open the sharepoint page without getting redirected. I have to log out of yammer and open the sharepoint page; at which point the yammer embed requires a login. Logging in circles back to the issue above. Any ideas?