Category_Plugin

Overview

The plug-in is the easiest way to embed Ensemble Video content into your site or LMS. Below is an example of the default IFrame plug-in. As you can see, part of the src url contains key/value pairs that control the look and feel of your content. A full list of parameters are listed below with examples of usage.

<iframe id="ensembleEmbeddedContent_klLSfd47G0akDUkOQaaipw"
        src="https://cloud.ensembleVideo.com/app/plugin/plugin.aspx?ID=klLSfd47G0akDUkOQaaipw&useIFrame=true&embed=true&displayTitle=false&autoPlay=false&hideControls=false&showCaptions=false&width=640&height=360"
        frameborder="0" style="width:640px;height:416px;" allowfullscreen>
</iframe>

General Plugin Parameters

Parameters are applied to the plugin by specifying them in the plugin URL as in "http://ensemble.myinstitution.edu/ensemble/plugin/plugin.aspx?displayCategoryList=true&displayContainerID=videoList" and can be chained together as the examples show.

• contentID/ID/videoID = string

When present, will display that content item directly.

Example:

You want to show one video specifically and bypass the listing.

/ensemble/plugin/plugin.aspx?DestinationID=QS7jbdTrMki7WNh35SODig&ContentID=bXSAhBEhAkqCM-WEWAut8Q

• displayCategoryList = true/false (defaults to "false")

Enables or disables the display of the category list in showcase mode or in the category list.

Examples:

Enable simple category list

/ensemble/plugin/plugin.aspx?displayCategoryList=true

Enable category list in showcase mode

/ensemble/plugin/plugin.aspx?displayCategoryList=true&displayShowcase=true

Enable category list with vertical orientation

/ensemble/plugin/plugin.aspx?displayCategoryList=true&categoryOrientation=vertical

• categoryOrientation = vertical/horizontal (defaults to "horizontal")

Specifies the orientation of the category list when displaying the category list by itself or when in showcase mode.

Example:

Enable category list with vertical orientation

/ensemble/plugin/plugin.aspx?displayCategoryList=true&categoryOrientation=vertical

• displayShowcase = true/false (defaults to "false")

Enables or disables the showcase mode which creates a simple video showcase page.

Examples:

Enable showcase mode with category list

/ensemble/plugin/plugin.js?displayCategoryList=true&displayShowcase=true

Enable showcase mode without category list

/ensemble/plugin/plugin.aspx?displayCategoryList=false&displayShowcase=true

• showcaseEmbeddedPlayer = true/false (Default to "true")

If false, only shows the preview image in the main page instead of interactive player.

Example:

Disable player on home page of showcase and show only the preview image

/ensemble/plugin/plugin.js?showcaseEmbeddedPlayer=false&displayShowcase=true

• newVideoOrientation = vertical/horizontal (defaults to "vertical")

Specifies the orientation of the new video list when displaying the new videos in showcase mode.

Example:

Enable a horizontal listing of new videos

/ensemble/plugin/plugin.aspx?displayShowcase=true&newVideoOrientation=horizontal

• enablePeriodicalUpdate = true/false (defaults to "false")

Enables the periodical update of the content. Once enabled the content will refresh every 20 seconds (by default). This parameter is used in conjunction with the periodicalUpdateInterval parameter.

Please Note: If the content is using the flash player and the user is playing the video, the page update is disabled until the video is either stopped or paused.

Example:

Enable the periodical update with the default 20 second interval

/ensemble/plugin/plugin.aspx?enablePeriodicalUpdate=true

• periodicalUpdateInterval = Any integer value in seconds >= 20 (defaults to "20")

Sets the interval at which the page content will be updated. This parameter is used in conjunction with the enablePeriodicalUpdate parameter.

Please Note: If this value is set to lower than the default 20 seconds, the periodical update will be disabled.

Example:

Enable the periodical update at 30 second intervals

/ensemble/plugin/plugin.aspx?enablePeriodicalUpdate=true&periodicalUpdateInterval=30

• displayContainerID = any existing HTML element ID (defaults to "videoList")

Specifies the ID of the HTML container where the plugin will insert the data. Can be used in every plugin instance to override the default plugin results container.

Example:

Enable simple category list and show the results inside the HTML element with ID "videoList"

/ensemble/plugin/plugin.aspx?displayCategoryList=true&displayContainerID=videoList

Browse Mode Parameters

These parameters apply to the display of multiple videos in "browse" mode.

• displayFullDescription = true/false (defaults to "false")

Enables or disables the display of the full video description.

Example:

Enable the display of the full video description

/ensemble/plugin/plugin.aspx?displayFullDescription=true

• displayVideoDuration = true/false (defaults to "false")

Enables or disables the display of the video duration under the description.

Example:

Enable the display of the full video duration

/ensemble/plugin/plugin.aspx?displayVideoDuration=true

Individual Video Parameters

These parameters apply to the detailed content page.

• displayCredits = true/false (defaults to "true")

Enables or disables the display of the video credits in the individual video page.

Example:

Disable the display of the video credits

/ensemble/plugin/plugin.aspx?displayCredits=false

• displayLinks = true/false (defaults to "true")

Enables or disables the display of the links in the individual video page.

Example:

Disable the display of the links

/ensemble/plugin/plugin.aspx?displayLinks=false

• displayAttachments = true/false (defaults to "true")

Enables or disables the display of the video attachments in the individual video page.

Example:

Disable the display of the video attachments

/ensemble/plugin/plugin.aspx?displayAttachments=false

• displayStatistics = true/false (defaults to "true")

Enables or disables the display of the video statistics in the individual video page.

Example:

Disable the display of the video statistics

/ensemble/plugin/plugin.aspx?displayStatistics=false

• displayEmbedCode = true/false (defaults to "true")

Enables or disables the display of the embed code in the individual video page.

Example:

Disable the display of the video link and embedding code

/ensemble/plugin/plugin.aspx?displayEmbedCode=false

• displaySharing = true/false (defaults to "false")

Enables or disables the display of social networking icons/links in the individual video page.

Example:

Enable the display of social networking icons/links

/ensemble/plugin/plugin.aspx?displaySharing=true

• displayVideoDuration = true/false (defaults to "true")

Enables or disables the display of video duration in the individual video page.

Example:

Enable the display of video duration

/ensemble/plugin/plugin.aspx?displayVideoDuration=true

• autoplay = true/false (defaults to "false")

Enables or disables the auto-play of video in the individual video page.

Example:

Enable the auto-play of video

/ensemble/plugin/plugin.aspx?autoplay=true

• showCaptions = true/false (defaults to "false")

Enables or disables the display of captions for video in the individual video page.

Example:

Enable the display of captions for video

/ensemble/plugin/plugin.aspx?showCaptions=true

• maxContentWidth = Any whole integer (defaults to 640)

Set the size of the embedded player.

Example:

Set the maximum embedded player width to 300 pixels

/ensemble/plugin/plugin.aspx?maxContentWidth=300

• hideControls = true/false (Default to "false")

Will hide the controls on the FlowPlayer. You can pause and play by clicking on the video itself or you can hover over the player and the controls will appear.

Example:

You want to hide scrubbing and hide the duration/fullscreen options by default.

/ensemble/plugin/plugin.aspx?hideConrols=true

• audioPreviewImage = true/false (Default to "false")

Allows you to set a enable preview images for audio content, embedded in the FlowPlayer.

Example:

You have an audio file, and want to display the album artwork you setup as a custom image in ensemble for that item.

/ensemble/plugin/plugin.aspx?audioPreviewImage=true

Filtering and Sorting Parameters

• categoryID

Specifies the category ID by which to filter the video list.

You can obtain the category ID by clicking on the "i" icon in the "Categories" screen of the Ensemble Video administrative panel.

Example:

Show only videos for the category with ID "bXSAhBEhAkqCM-WEWAut8Q"

/ensemble/plugin/plugin.aspx?categoryID=bXSAhBEhAkqCM-WEWAut8Q

• categoryName

Specifies the category name by which to filter the video list.

Example:

Show only videos for the category with name "Default Category"

/ensemble/plugin/plugin.aspx?categoryName=Default%20Category

• searchByString = Any search keyword

Filters the list of videos to only show vidoes that have a matching string the title, abstract or keywords.

Example:

Show only videos for which the title, abstract or keyword contain the word "test"

/ensemble/plugin/plugin.aspx?searchString=test

• orderBy = defaults to "videoDate"

Specifies the column by which the video list will be sorted. This parameter works in conjunction with the orderByDirection parameter.

Possible values: videoID, videoDate, videoDateProduced, videoDescription, videoTitle, videoDuration, videoKeywords, viewCount

Example:

Order the video list in ascending order by the videoTitle

/ensemble/plugin/plugin.aspx?orderBy=videoTitle&orderByDirection=asc

• orderByDirection = asc/desc (defaults to "desc")

Specifies the sort order of the video list. This parameter works in conjunction with the orderBy parameter.

Possible values: asc (ascending), desc (descending)

Example:

Order the video list in ascending order by the videoDuration

/ensemble/plugin/plugin.aspx?orderBy=videoDuration&orderByDirection=asc

• pageIndex = Any whole integer (defaults to 1)

Specifies the index number of the current page when paging is used. Used in conjunction with the pageSize parameter.

Example:

Show the first page of videos with 20 videos per page

/ensemble/plugin/plugin.aspx?pageIndex=1&pageSize=20

• pageSize = Any whole integer (defaults to 10)

Specifies the number of videos to list per page when paging is used. Used in conjunction with the pageIndex parameter.

Example:

Show the second page of videos with 15 video per page

/ensemble/plugin/plugin.aspx?pageIndex=2&pageSize=15

• resultsCount

Specifies the the number of videos to show in the video list. Similar to pageSize but limits the number of videos returned by the server.

Example:

Show only the top 2 videos sorted by ascending date

/ensemble/plugin/plugin.aspx?resultsCount=2&orderBy=videoDate&orderByDirection=desc

 

Featured Video Parameters

These parameters apply to the Featured Videos.

• featuredContentID

Specifies the featured category ID by which to filter the video list.

Example:

Show only videos for the category with ID "bXSAhBEhAkqCM-WEWAut8Q"

/ensemble/plugin/plugin.aspx?featuredContentID=bXSAhBEhAkqCM-WEWAut8Q

• featuredContentCategoryID

Specifies the featured category name by which to filter the video list.

Example:

Show only videos for the category with name "Default Category"

/ensemble/plugin/plugin.aspx?featuredContentCategoryID=Default%20Category

• featuredContentCategoryName

Specifies the featured content category name by which to filter the video list.

Example:

Show only videos for the content category with name "Default Category"

/ensemble/plugin/plugin.aspx?featuredContentCategoryName=Default%20Category

• featuredContentOrderBy = defaults to "videoDate"

Specifies the column by which the video list will be sorted. This parameter works in conjunction with the featuredContentOrderByDirection parameter.

Possible values: videoID, videoDate, videoDateProduced, videoDescription, videoTitle, videoDuration, videoKeywords, viewCount

Example:

Order the featured video list in ascending order by the videoTitle

/ensemble/plugin/plugin.aspx?featuredContentOrderBy=videoTitle&featuredContentOrderByDirection=asc

• featuredContentOrderByDirection = asc/desc (defaults to "desc")

Specifies the sort order of the video list. This parameter works in conjunction with the featuredContentOrderBy parameter.

Possible values: asc (ascending), desc (descending)

Example:

Order the featured video list in ascending order by the videoDuration

/ensemble/plugin/plugin.aspx?featuredContentOrderBy=videoDuration&featuredContentOrderByDirection=asc

• featuredRandom = true/false (Default is "true")

Randomizes the featured content in showcase mode

Example:

You want to completely randomize content on the showcase page, including feature video and listings.

/ensemble/plugin/plugin.aspx?featuredRandom=true