If you’d like to make the information in Beekeeper available in your SharePoint or another website without duplicating efforts, you have the option of embedding a Beekeeper stream within that website.
- iFrame embedding needs to be activated for your Beekeeper tenant before you can use this feature.
- When setting this up in SharePoint, the user must have admin privileges.
Activating iFrame embedding
For security reasons, iFrame embedding is disabled by default in Beekeeper. In order to enable it, in the Beekeeper Admin Dashboard, head to Settings > General > Security, where you can select one of the following options:
- iFrame Embedding is disallowed (default)
- iFrame Embedding is allowed for any domain (insecure)
- iFrame Embedding is allowed for specified domain only
Allowing iFrame embedding for any domain is not recommended. Instead, we suggest whitelisting a single domain.
Embedding Beekeeper into SharePoint
- Login to Beekeeper on the web app
- Click on your profile image in the top right corner and select “Dashboard”
- To the left, select the “Extensions” tab and then select the “Website Embed” subtab
- From the dropdown menu, select the stream you wish to embed
- If relevant, edit the configuration parameters in the code, as explained in the box below
- Copy the code
- Open a SharePoint article
- Create a new web part
- Paste the code that you copied from Beekeeper
- Save the page
Embedding Beekeeper into SharePoint Online
SharePoint Online does not allow the embedding of scripts into modern site pages, in order to protect your content (a malicious script could take over the page, resize its own window over your content, or change the content on the page without your consent).
Should you try to use the Beekeeper embedding code from the admin dashboard, you will receive the error: "This embed code doesn't seem to work. We only support iframe based embeds."
The embedded Beekeeper app resizes itself depending on how much content the user is viewing, to make for a smoother user experience. This is achieved through script injection, which SharePoint Online does not allow.
Embedding Beekeeper as an iframe:
You can add the Beekeeper web app to your SharePoint Online page as a fixed-size iframe, e.g.
<iframe src="https://your-company.us.beekeeper.io" width="800" height="600"></iframe>
You can change the width and height parameters to suit the layout of your content.
Should you encounter any difficulty, please contact our support team at email@example.com