Please note that the following scenarios rely almost entirely on 3rd party services, and ClearPeople are unable to support any such scenarios.
This functionality is not really related to Atlas code so it should work in any version of Atlas.
In this article:
- Allow a website URL to be embedded
- Option 1: Microsoft Embed web part
- Option 2: Atlas Secure Sript Editor web part
- Make embedded content taggable
-
Specific applications for embeds
Allow a website URL to be embedded
In order to do this first step you will need to be an Site Collection Administrator of the workspace where you want to embed the content. If you are a SharePoint Administrator you can add yourself as a Site Collection Administrator via the SharePoint Admin Centre.
Before you embed content from external websites you need to add that website URL as a "trusted" website for embedding. This ensures that users cannot embed potentially malicious content from the internet because an Owner has to enable that website first.
To learn how to do this, please read the following article: Enable external URLs for content embeds
Option 1: Microsoft Embed web part
The Embed web part is quite specific to be used for embed code or iframes. This is usually the type of code you will get when clicking "embed" or </> on websites such as Youtube, Vimeo etc.
We assume this restriction is for security reasons, but it does mean there are a lot of types of script that cannot be embedded using this web part. For any script that does not follow these rules, you'll need to try using the Atlas Secure Script Editor web part instead. From Microsoft's documentation:
- Embed code must be iframe-based (that is, start and end with <iframe> tags). Embed code that uses <script> tags is not supported.
- Only secure web sites can be embedded. Make sure the URL of the web site begins with HTTPS.
- Not all websites allow their pages to be embedded, so you may not be able to embed them, even when they are secure and use iframe-based embed code. If you have problems, check with the website to see if they allow embedding.
Option 2: Atlas Secure Sript Editor web part
If your script is not compatible with the Embed web part you can try using the Atlas Secure Script Editor web part as it is not so restrictive with the type of script that can be executed.
Some types of script that attempt to modify the page environment, such as JavaScript, may still not work depending what changes they are trying to make, or they may initially work but stop working when Microsoft make updates to the platform.
Make embedded content taggable
If you need to tag your embeds, you can create a page for that specific embed using the appropriate web part, add any required metadata to the page and give them a specific Information Type e.g. "Embedded Content". You can then create a Listing Page targetting the Information Type where users can filter by any other metadata.
Specific applications for embeds
- Juicer (social wall) - this is an unaffiliated 3rd party product that a few of our clients have used to aggregate their social media feeds into a single feed to show in Atlas: https://www.juicer.io/
- Embed podcast or other audio or video content from sources that do not offer embed code as they are not expectd to be embedded, for example content from your website
- Embed custom-developed scripts that could display any number of custom experiences on the page based on what you create
- Apply simple JavaScript to modify the page experience, bearing in mind such modifications are highly likely to break in future when Microsoft make changes.
Still need help?
Please get in touch with support or your CSM for further advice or assistance. Please note that we cannot support issues with your scripts, only issues with the web part itself.
Comments
0 comments
Please sign in to leave a comment.