Paramètres du Plugin

Les paramètres du plugin peuvent être réglés de deux façons : D'abord, dans l'interface d'administration du plugin, vous pouvez définir de façon globale les paramètres ce qui affecte toutes les vidéos. Deuxièmement, vous pouvez ajouter ces paramètres globaux dans chaque tag de façon individuel. Quand vous ajoutez des paramètres, les ajouter - separés par des espaces - dans la première partie du tag, comme ceci : {flv width="180" height="150" autostart="true"}soiree{/flv}. En ajoutant, utilisez toujours le nom de l'attribut en minuscule, suivit d'un signe egal, suivit d'une valeur pour l'attribut entouré de guillement de type double quote.

Le tableau suivant montre les noms des paramètres supportés, leurs attributs (le nom à utiliser quand on l'ajoute au tag) et leur valeurs possible. Comme il est décrit dans le tableau des formats locaux supportés, il y a différents lecteurs utilisés pour les différents formats de fichiers. Le seul lecteur qui supporte tous les paramètres listés est le JW Media Player. Tous les autres lecteurs supportent normalement width, height et autoplay seulement. Le lecteur YouTube est une exception. Il supporte certains attributs spéciaux qui sont décrit dans le tableau à la fin de la page. Note : Certains attributs spéciaux ne sont pas disponibles dans l'interface d'administration et peuvent être réglés dans le tag seulement. Ces attributs sont expliqués dans les remarques.

Remarques :

1. Les valeurs de couleur peuvent être specifiées dans n'importe quel format suivant et sont convertis dans le format correct automatiquement :

• 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:

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):

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

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

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):

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