How to embed content in Jostle

Links view, which can be custom-named by System Admins, is your platform's links repository. It consists of two sections:

Shared Link Categories: are where you can find the Links used by your organization. System Admins can organize these into Categories, each of which can be visible to everyone or targeted at a specific team, location, or other group. Each person will only see the Categories that are permitted to see.

My Link Categories: Is where anyone can add and store their own Personal Links. They can also create your own Categories to organize things. These links are only viewable and accessible to the person that created them.

When the destination permits it (see Restrictions), Links can be embedded so that they can be viewed without leaving the Jostle application.

Embedding a link

To embed a Link follow these steps:

1. Click Links in the Main Nav Panel
2. On the slide-out panel, open a Category and find a Link that you want to embed.
3. Click on the Action Menu (three dots) next to the Link and select Edit
4. On the Edit screen, if the destination is embeddable, you will be able to check the Embed box
5. Click Save at the top

Note: if a Link cannot be embedded, the Embed option will be greyed-out with a message stating why.

Tip: Electronic forms from various applications can be embedded in Links view, either via a URL link or via embed code on an HTML page. For an example, go here. 

Technical restrictions

Content and websites can only be embedded when:

• the URL starts with "https"
• the site permits iframing

When a URL is inspected on our end, it will be not be embeddable if it specifies an X-FRAME-OPTIONS header with value "DENY" or "SAMEORIGIN"

If a URL is embeddable, but the content doesn't appear the way it should, it may be because of the these restrictions:

if (WebUtils.RUNNING_ON_CHROME)

embeddedFrame.getElement().setPropertyString("sandbox", "allow-forms allow-popups allow-pointer-lock allow-scripts allow-popups-to-escape-sandbox");

else

embeddedFrame.getElement().setPropertyString("sandbox", "allow-forms allow-popups allow-pointer-lock allow-scripts");

As embedded content is sandboxed, this may cause some content to not work, especially if it requires the use of cookies.

Embedding an HTML page

Links view also supports the embedding of HTML code for orgs that wish to add a custom page to their platform that can then be accessed from their Main Nav Panel.

Notes:

• This feature can only be accessed by System Admins
• This feature is only for already-created HTML pages, not for creating new HTML pages (however you can use most embedded HTML editors in situ)

To embed HTML on a new Link, a System Admin should:

1. Click Links on the Main Nav Panel
2. Click on the + at the top
3. Select HTML Page
4. Read the guidelines provided
5. Enter or paste your HTML into the Code area
6. Give the page a Name and select a Category (you can change this later)
7. Click the Save at the top

Tip: You can make an HTML page a Custom View.