Video Player widget

The KU Video Player widget displays a customizable video jukebox on your site using a few lines of code. It's possible to display different types and categories of videos – which are filmed, edited and categorized by University Relations – using a number of custom settings.

An example of the embedded widget looks like this:

Show students from studying
talking about or Search
or Browse


To include the widget on your site, you will need to use SSI, have KU's "contained" version of JQuery turned on (it's on by default), and be on a central KU webserver such as www2.ku.edu.

Using the settings below, it's possible to fine-tune what videos appear and how they're presented on your site, making every player unique. The example above shows student interviews from the Why KU? site, and was created using the following settings and include statement:

<!--#set var="otherheaderinfo" value="/~univrel/vidplayer_ohi.shtml" -->
<!--#set var="vidplayer_choice" value="whykustudents" -->
<!--#set var="vidplayer_defaultvideoid" value="6XENJNEb9S8" -->
<!--#set var="vidplayer_autoplay" value="false" -->
<!--#include virtual="/~http/ssi/2009/widgets/myvidplayer.shtml" -->

Like most KU widgets, almost every element of the Video Player widget has a CSS class or ID assigned to it, and can therefore be customized to fit the look and feel of your site. The default look of the player (shown above) is intentionally sparse and should be customized on a site-by-site basis. The Why KU? player, for example, has additional styles added to adjust margins, create a transparent background and reverse the font colors. When changing the player's size, you may also have to adjust the vidplayer_vidheight and vidplayer_vidwidth settings below.

Player Settings

These settings affect which player is loaded, which video category is displayed by default, and whether the top navigation is shown.

vidplayer_choice

Determines which video player is loaded. Each player contains a different set of videos and has different filter and search options at the top (if top nav is shown). There are currently three players available.

Values: whykustudents, whykufaculty, whykualumni, categories
Default Value: whykustudents
Example
<!--#set var="vidplayer_choice" value="whykustudents" -->

vidplayer_category

Displays a default category on page load. Note: this setting currently only works with a vidplayer_choice of "categories."

Values: faculty, features, research, service, studentlife, teaching, thisisku, traditions
Default Value: none
Example
<!--#set var="vidplayer_category" value="research" -->

vidplayer_showtopnav

Hides and shows the top navigation area. Useful if you've set a vidplayer_category and do not want visitors to be able to switch to other categories.

Values: true, false
Default Value: true
Example
<!--#set var="vidplayer_showtopnav" value="false" -->

Playlist/Play Order Settings

These settings change how videos are displayed and handled in the playlist.

vidplayer_playersize

By default, the video player displays the video player and caption on the left, and the playlist on the right. By changing this setting to "singlecolumn", the video playlist will appear over the video itself in a dropdown menu.
Default Value: none
Example
<!--#set var="vidplayer_playersize" value="singlecolumn" -->

vidplayer_defaultvideoid

The YouTube ID of the video you want to appear at the top of your playlist. This should be the ID only – not the full YouTube URL – and will only work if the video is already in the playlist.
Default Value: none
Example
<!--#set var="vidplayer_defaultvideoid" value="6XENJNEb9S8" -->

vidplayer_querystring

This parameter is unique in that if set, it enables you to pass parameters to the widget through the query string of the containing page. To use it, add this setting exactly as it's shown in the example below, and pass the YouTube ID as the first item in your query string as "?v=youtubeid".

Currently, the only option this parameter accepts is a YouTube ID, similar to vidplayer_defaultvideoid. If set, this parameter will override vidplayer_defaultvideoid as the first video in the playlist. This should be the ID only – not the full YouTube URL – and will only work if the video is already in the playlist.
Default Value: none
Example
<!--#set var="vidplayer_querystring" value="$QUERY_STRING" -->
http://webtools.ku.edu/widgets/videoplayer/index.shtml?v=zixrNQX75Tk

vidplayer_autoplay

Toggles whether the first video in the playlist begins playing automatically when the page loads. Clicking on another video in the playlist is unaffected by this setting and will always start automatically.

Values: true, false
Default Value: true
Example
<!--#set var="vidplayer_autoplay" value="false" -->

vidplayer_thumbs

Hides or shows all thumbnail images in the playlist.

Values: true, false
Default Value: true
Example
<!--#set var="vidplayer_thumbs" value="false" -->

Video Settings

These settings adjust display and playback options for the YouTube video itself.

vidplayer_controls

Toggles the display of the video's YouTube controls.
Default Value: true
Example
<!--#set var="vidplayer_controls" value="false" -->

vidplayer_fullscreen

Toggles the ability for users to play a video in fullscreen mode.

Values: true, false
Default Value: false
Example
<!--#set var="vidplayer_fullscreen" value="false" -->

vidplayer_vidheight

Sets the video's height, in pixels.
Default Value: 441
Example
<!--#set var="vidplayer_vidheight" value="480" -->

vidplayer_vidwidth

Sets the video's width, in pixels.
Default Value: 274
Example
<!--#set var="vidplayer_vidwidth" value="640" -->

If you have any questions about this process, please feel free to contact webcomms@ku.edu.


The University of Kansas prohibits discrimination on the basis of race, color, ethnicity, religion, sex, national origin, age, ancestry, disability, status as a veteran, sexual orientation, marital status, parental status, gender identity, gender expression and genetic information in the University’s programs and activities. The following person has been designated to handle inquiries regarding the non-discrimination policies: Director of the Office of Institutional Opportunity and Access, IOA@ku.edu, 1246 W. Campus Road, Room 153A, Lawrence, KS, 66045, (785)864-6414, 711 TTY.