Plugin Examples

Category List

• Horizontal Orientation
• Vertical Orientation

Showcase Mode

• With Horizontal Category List
• With Vertical Category List
• Without Category List

Video List

• Browsable Video List

General Plugin Parameters

Parameters are applied to the plugin by specifying them in the plugin URL as in "../plugin/v3/plugin.js?displayCategoryList=true&displayContainerID=videoList" and can be chained together as the examples show.

• 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
  ../plugin/v3/plugin.js? displayCategoryList=true
  
  Enable category list in showcase mode
  ../plugin/v3/plugin.js? displayCategoryList=true&displayShowcase=true
  
  Enable category list with vertical orientation
  ../plugin/v3/plugin.js? 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
  ../plugin/v3/plugin.js?displayCategoryList=true& categoryOrientation=vertical
  
  
• 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
  ../plugin/v3/plugin.js?displayCategoryList=true& categoryOrientation= horizontal
  
  
• 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
  ../plugin/v3/plugin.js? displayCategoryList=true&displayShowcase=true
  
  Enable showcase mode without category list
  ../plugin/v3/plugin.js? displayCategoryList=false&displayShowcase=true
  
  
• 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.
  
  Examples:
  Enable the periodical update with the default 20 second interval
  ../plugin/v3/plugin.js?enablePeriodicalUpdate=true
  
  Enable the periodical update at 30 second intervals
  ../plugin/v3/plugin.js?enablePeriodicalUpdate=true&periodicalUpdateInterval=30
  
  
• 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.
  
  Examples:
  Enable the periodical update at 30 second intervals
  ../plugin/v3/plugin.js?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"
  ../plugin/v3/plugin.js?displayCategoryList=true& displayContainerID=videoList

Browse Mode Video Parameters

• displayFullDescription = true/false (defaults to "false")
  Enables or disables the display of the full video description.
  
  Examples:
  Enable the display of the full video description
  ../plugin/v3/plugin.js?displayFullDescription=true
  
  
• displayVideoDuration = true/false (defaults to "false")
  Enables or disables the display of the video duration under the description.
  
  Examples:
  Enable the display of the full video duration
  ../plugin/v3/plugin.js?displayVideoDuration=true
  
  

Individual Video Parameters

• displayCredits = true/false (defaults to "true")
  Enables or disables the display of the video credits in the individual video page.
  
  Examples:
  Disable the display of the video credits
  ../plugin/v3/plugin.js?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
  ../plugin/v3/plugin.js?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
  ../plugin/v3/plugin.js?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
  ../plugin/v3/plugin.js?displayStatistics=false
  
  
• displayEmbedCode = true/false (defaults to "true")
  Enables or disables the display of the embedding code in the individual video page.
  
  Example:
  Disable the display of the video link and embedding code
  ../plugin/v3/plugin.js?displayInformation=false

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"
  ../plugin/v3/plugin.js?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"
  ../plugin/v3/plugin.js?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"
  ../plugin/v3/plugin.js?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, videoDescription, videoTitle, videoDuration, videoKeywords
  
  Example:
  Order the video list in ascending order by the videoTitle
  ../plugin/v3/plugin.js?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
  ../plugin/v3/plugin.js?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 2 videos per page
  ../plugin/v3/plugin.js? pageIndex=1&pageSize=2
  
  
• 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 1 video per page
  ../plugin/v3/plugin.js? pageIndex=2&pageSize=1
  
  
• 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
  ../plugin/v3/plugin.js?resultsCount=2&orderBy=videoDate&orderByDirection=desc