Page 5 of 6
Plugin ParametersThe 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: 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. 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.
Remarks: 1. Color values can be specified in any of the following formats and are converted to the correct format automatically:
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:
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. true will stretch them proportionally to fill the display, false will stretch them to fit. fit will stretch them disproportionally to fit both height and width. none 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. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Last Updated ( Wednesday, 16 January 2008 20:02 ) |