Print E-mail
Article Index
Introduction
Licence
Streaming local content
Streaming remote content
Plugin Parameters
Using playlists
Managing playlists
Using the AVR Media button
Popup window and lightbox
The system plugin
Managing Players, Rippers and Tags

Plugin Parameters

The plugin parameters can be set in two ways: First, in the administration backend of the plugin, you can preset global parameters which affect all videos. Second, you can override these global settings in each tag individually. When overriding parameters, you add them - separated by spaces - inside the first part of the tag like this: {flv width="180" height="150" autostart="true"}party{/flv}. Overriding always uses a lowercase attribute name, followed by an equal sign, followed by the attribute's value quoted in double quotation marks.

The following table shows the supported parameter names, their attribute counterparts (the name to use when overriding) and their possible values. As described in the Table of supported local formats, there are different players used for various media formats. The only player which supports all of the listed parameters is the JW Media Player. All other players usually support width, height and autoplay only. The YouTube player is an exception. It supports some special attributes which are described in the table at the end of this page. Please note: Some special attributes are not available in the backend parameter page but can be set in the tag only. Those attributes are explained in the remarks.

 
Global section Global parameter name Attribute name Values
Plugin Parameters Container class avcss any class name
Plugin Parameters Master video width width a pixel value
Plugin Parameters Master video height height a pixel value
Plugin Parameters iFilm video width iwidth a pixel value
Plugin Parameters iFilm video height iheight a pixel value
Plugin Parameters Metacafe video width mwidth a pixel value
Plugin Parameters Metacafe video height mheight a pixel value
Plugin Parameters Flash display mode wmode window, transparent or opaque
Plugin Parameters Flash background color bgcolor a color value 1)
Plugin Parameters Master audio width awidth a pixel value
Plugin Parameters Master audio height aheight a pixel value
Advanced Parameters Controls color pbgcolor a color value 1)
Advanced Parameters Controls text color pfgcolor a color value 1)
Advanced Parameters Controls highlight color phicolor a color value 1)
Advanced Parameters Video background psccolor a color value 1)
Advanced Parameters Autostart autostart true or false
Advanced Parameters Show control bar shownav true or false
Advanced Parameters Show digits showdigits true or false
Advanced Parameters Show icons showicons true or false
Advanced Parameters Show stop showstop true or false
Advanced Parameters Show download showdownload true or false 7)
Advanced Parameters Show fullscreen button usefullscreen true or false
Advanced Parameters Scriptable enablejs true or false 5)
Advanced Parameters Logo logo URL/relative path 2)
Advanced Parameters Video screen mode screenmode a mode identifier 3)
Advanced Parameters Playlist size plsize a pixel value 3)
Advanced Parameters Stretch content stretch 0, 1, 2 or 3 4)
Advanced Parameters Minimum Flash Version flashver Three numbers, separated by dots 10)
Advanced Parameters Show equalizer showeq true or false
Advanced Parameters Show search bar searchbar true or false
Advanced Parameters Search provider searchlink URL 12)
Advanced Parameters Alternate content alt any valid HTML 13)
- - cfg URL 6)
- - displaywidth a pixel value 3)
- - displayheight a pixel value 3)
- - divid any ID value 5)
- - link URL 7)
- - linkfromdisplay true or false 7)
- - linktarget a window name (e.g. _blank) 7)
- - plthumbs true or false 8)
- - type A file type 9)
- - repeat false, true or list 8)
- - shuffle true or false 8)
- - autoscroll true or false 8)
- - recurl URL 11)
- - img URL 14)
- - volume int 15)
- - menu true or false 16)
- - popup true or false 17)

Remarks:

1. Color values can be specified in any of the following formats and are converted to the correct format automatically:

  • A 6-digit hexadecimal value, preceeded by a hash sign (e.g.: #223344 like ordinary HTML syntax)
  • A 3-digit hexadecimal value, preceeded by a hash sign (e.g.: #234 like CSS short syntax)
  • 3 decimal values following the word rgb in parenthesis (e.g.: rgb(99,140,235) - like CSS rgb syntax)
  • A 1-6-digit hexadecimal value, preceeded by 0x (e.g.: 0x2345 like in JavaScript)
  • One of the 16 standardized color names as specified in HTML 4.0.1 (e.g.: red)

2. Logo images can be specified either by their absolute URL (e.g.: http://host/logo.png) or - if locally stored on the same server - by their local path (e.g.: /images/stories/logo2.png). The logo should be png (preferred) or gif in order to support transparency. The logo is always positioned in the upper right corner of the video screen. If you like a different position you can work around this limitation by creating a larger image where most of the image is transparent.

3. The parameter screenmode is kind of special. It is not an actual parameter for JW mediaplayer but a shortcut which affects how the player's parameters displaywidth and displayheight (those specify the size of the player's video screen) are calculated by the plugin. The following modes are available:

  Mode Description
  default This mode results in the standard display where the player's control bar is located below the screen. Since the control bar has a height of 20 pixels, the available screen size is width × height - 20.
  coverlay In this mode, displaywidth and displayheight are set equally to width and height. This results in the control bar being shown transparently inside the screen area. Furthermore, the control bar fades out, if the mouse leaves the screen area and reappears if the mouse enters the screen area. The available screen size in this mode is width × height.
  plbottom This mode is intended to display a playlist at the bottom below the control bar. The height of this scrollable window is taken from the parameter plsize. The available screen size in this mode is width × height - 20 - plsize.
  plright Like plbottom, except the playlist is to be displayed to the right of the screen. The width of the scrollable window is taken from the parameter plsize. The available screen size in this mode is width - plsize × height - 20.
  floatcplright A combination of coverlay and plright. In this mode, the available screen size is width - plsize × height.

Please note: When overriding displaywidth or displayheight within the tag, then the whole automatic calculation described above is disabled.

4. The stretch mode defines how to stretch movies to make them fit the display size. 1 will stretch them proportionally to fill the display, 0 will stretch them to fit. 2 will stretch them disproportionally to fit both height and width. 3 will show all items in their original dimensions.

5. If enabling scripting, the player can be controlled with JavaScript. To do this (and to distinguish multiple players in a page) it has to be addressed by it's ID. For easy scripting, this ID (which otherwise would be assigned automatically by the plugin) can be set manually by using the attribute divid. The resulting ID of the flash object to be used from within JavaScript is the specified value, prefixed by p_.

6. If many parameters have to be specified, you end up with quite lenghly tags. Alternatively, you can put all those parameters in a config file and then simply reference that. The URL, specified in the cfg attribute should point to a configuration XML file. The variable names in that file might differ from the attributes listed above. See the JW Media Player documentation for a reference. An example file can be found here.

7. The URL, specified in the link attribute is normally used for providing a download of the media or related information. This URL is invoked, when the player's download button is activated. Additionally, if the attribute linkfromdisplay is set to true, a click in the players display invokes that URL instead of toggling play/pause. The attribute linktarget (default: _blank) specifies the window in which this URL will be shown.

8. If plthumbs is set to true and a playlist is provided which provides image tags in its entries, those images are displayed as thumbnails in the playlist. If autoscroll is set to true, the playlist is scrolling automatically via mouse movement instead of using a scrollbar. The attribute repeat specifies how to proceed when a media stream is finished: false means stop the player, true means repeat the stream from beginning and list means start playing the next item in the playlist. In this context, the next item to be played is selected depending on the parameter shuffle (default: true). If this is set to false, the playlist is iterated sequentially. Using playlists is explained further down.

9. If using the remote variant of a media tag, you can reference any media file, even with a different extension or non extension at all. If this is the case, JW Media Player might not recognize the file type correctly. With this attribute you can forcibly set the media type to one of the supported types.

10. This attribute allows you to set the minimum Flash version, required to use the builtin JW Media Player. The player requires at least Flash version 7, however when running under that version, the features "display of GIF/PNG images", "smoothing of scaled images/video", VP6 and H264 encoded video, javascripting and the digits in the controlbar are not functional. Furthermore, for full screen display, at least Flash version 9.0.28 is required and for playing H264 encoded videos, at least Flash version 9.0.98. For full functionality, it is therefore strongly recommended, to specify at least version 9.0.28 (if using the fullscreen feature) or version 8 (without using fullscreen).

11. This attribute provides an URL for a recommendations XML file. A recommendations XML file contains titles, thumbnails and URLs for recommended Items, related to the currently playing video. It's content is shown after the video has finished playing (Similar like on YouTube). A sample recommendations XML file can be found here.

12. The URL provided here defines an alternate search provider which is used, when a user uses the search function of the search bar. The text typed by the user is appended to this URL. Example: If the URL is http://youtube.com/results?search_query= and the user searches for computer, then the resulting query is http://youtube.com/results?search_query=computer.

13. By default, the plugin provides two different warnings if the content can not be displayed: The first warning is displayed, if JavaScript is not available. Another warning is displayed, when JavaScript is working, but the flash plugin is either not available or it's version is below the value of the parameter flashver. With this parameter, the second warning can be replaced by custom content. If custom content is provided, the first warning will be disabled completely. The custom content must not contain any single quote or closing curly brace. To display those characters, they have to be encoded using html entities. The default warnings look like this:

Typical appearance of the default JavaScript warning (uses localized text):

JavaScript is disabled!
To display this content, you need a JavaScript capable browser.

Typical appearance of the default Flash warning (uses localized text):

Adobe Flash Player not installed or older than x.x.x!
Get Adobe Flash Player here

14. This attribute allows to specify a preview (thumbnail) image which is shown whenever the player is stopped. If a relative path is specified (i.e. the value does not start with a slash or http:// or https://), then it is automatically prefixed by the default image directory (usually images/stories).

15. The initial volume. Unit is percent, which implies a valid range of 0 .. 100.

16. This attribute can be used to manipulate the context menu of the player. For flash based players, setting this to false restricts the menu to the basic entries. For the DivX player, this disables the menu completely.

17. When this attribute is set to true, then the resulting player will be invisible and prepared to be displayed in a popup window or lightbox by using the avrpopup special tag.

Special parameters of the YouTube player

When using the tag {youtube}, the YouTube player supports the following additional attributes (All boolean attributes have a default value of false):

 
Global section Global parameter name Attribute name YouTube API Name Values
Advanced Parameters Autostart autostart autoplay true or false
Advanced Parameters Controls color pbgcolor color1 a color value
Advanced Parameters Controls highlight color phicolor color2 a color value
- - ytborder border true or false
- - ytegm egm true or false
- - ytloop loop true or false
- - ytrel rel true or false

More information about the meaning of those attributes can be found in the YouTube API specification here.



Last Updated ( Monday, 11 January 2010 23:43 )
 
Banner