Inlines

The standard selection of inline types include links to other articles within iCM, links to documents and other items in the iCM Media Library, external links, images, and a script inline which can be used to embed JavaScript, HTML fragments and other third party embedding code such as YouTube videos. Your site and theme may have other inline types, which will be described in documentation specific to your site.

Inlines have two parts. The inline definition in iCM, which sets up the various elements in the inline and provides the interface for the user, and the inline handler in the site code that interprets what a user enters in the article editor and turns it into HTML on the page.

The examples below show the five standard inlines provided by the core framework.

Article Link

The Article Link inline provides a link to another article held in the same subsite. The link appears as as a standard link defined by the site's design and opens in the same browser window. The link title is the target article's heading, which can be overridden by the article's alternative link text. The inline definition also lets you enter your own title for the link.

If the target article is secured then the link still appears in the body text as described. However, if a user who is not logged in clicks the link, they will be redirected to the login page. Upon successful authentication the user will be redirected to the secured page.

 

Here's an article link to the iCM 10.0.7.0 new features documentation: Here are the new features!

Document Link

The Document Link inline provides a link to a downloadable media item from the media library. The link appears as as a standard link defined by the site's design.

Typically an icon is displayed to the left of the link text which represents the media type. The link text is either the title of the media item, or the title provided in the inline dialogue. To the right of the link text the download size is shown in square brackets. The link text and download size act as a link to the document.

You can choose the target for the link, either "_self" (the current browsing context) or "_blank" (usually a new tab, but users can configure browsers to open a new window instead).

 

Here's a document link to the iCM 10.0.5.0 new features: A PDF of the 10.0.5.0 Release Notes (PDF) [1MB]

External Link

The External Link inline provides a link to an external URL from the external link library. The link appears as as a standard link defined by the site's design. The link title can be overridden in the inline dialogue.

You can choose the target for the link, either "_self" (the current browsing context) or "_blank" (usually a new tab, but users can configure browsers to open a new window instead).

 

Here's a link to the main GOSS site, with a custom title: The GOSS Site (opens new window)

Image

 The image inline adds an image from the media library to the body text of the article. This inline above all others probably has the most unsupported elements across the various themes (because it's used differently in each theme and has existed for such a long time). In general only the image position is supported.

This is an image of the image inline dialogue used to create the image of the image inline dialogue(!). It's floated to the right.

Script

The Script Inline lets you insert JavaScript, HTML and other third party embedding code, such as YouTube videos, into the body text of the article. Content embedded in this way will bypass the article editor's script tidying and protection functionality.

 

Videos

This inline can be used to embed video media items uploaded to the iCM media library into your article. Videos are output using the HTML5 video tag.

 

You can set the size of the player and its position, and the playback options. For accessibility reasons autoplay should be set to "No".

Many of the video features, like the transcript, captions, description and "poster" (an image displayed before the video plays) are set in the video media item itself - only the link to the transcript can be toggled on and off via the inline.