DEPRECATION WARNING
This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.
EXT: FLV Player & Video Gallery¶
Author: | Kasper Skårhøj |
---|---|
Created: | 2002-11-01T00:32:00 |
Changed by: | Sebastian Fahrenkrog |
Changed: | 2009-02-16T09:46:17.570000000 |
Author: | Sebastian Fahrenkrog, David Bender |
Email: | videogallery@thoughtdivision.de |
Info 3: | |
Info 4: |
EXT: FLV Player & Video Gallery¶
Extension Key: bddb_flvvideogallery
Copyright 2007, Sebastian Fahrenkrog, David Bender, <videogallery@thoughtdivision.de>
This document is published under the Open Content License
available from http://www.opencontent.org/opl.shtml
The content of this document is related to TYPO3
- a GNU/GPL CMS/Framework available from www.typo3.com
Table of Contents¶
EXT: FLV Player & Video Gallery 1
Introduction 1
What does it do? 1
About the player/Licensing 1
Screenshots 2
Users manual 3
Configuration 3
Using FLV Player & Videogallery with Ajax 6
RealURL 6
Reference 7
Known problems 7
To-Do list 7
Changelog 8
Sponsoring 8
Introduction¶
What does it do?¶
This Advanced Flash Video (FLV) Player + Videogallery allows you to show your videos more controlled and to a broader audience as with Quicktime, Windows Media or Real Media. It is based on the extension sk_simpleflvplayer , but throughout the development, the code was nearly completely rewritten. It supports the possibility to add as many videos as needed to a playlist from which the user can choose. If only one Video should be presented, the playlist can be disabled. The videos from the playlist can be loaded via ajax (Extension xajax needed) into the player. Full implementation of swfobject.
About the player/Licensing¶
This extension is an integration of an existing standalone FLV player, developed by Jeroen Wijering – www.jeroenwijering.com . Thanks a lot to him for his great work.
The original files (including the Flash source file) can be downloaded on the following URL:
http://www.jeroenwijering.com/?item=Flash+Video+Player
Note that a creative commons license (exact terms: `http://creativecommons.org/licenses/by-nc-sa/2.5/ <http://creativecommons.org/licenses/by-nc-sa/2.5/>`_ ) is applied to this software. Please contact his author before using it for commercial purposes. It allows you to use and modify the script for noncommercial purposes. For commercial use, Jeroen Wijering distributes licenses of the script for 15 euros. For more info and instant ordering, please go to www.jeroenwijering.com .
Users manual¶
- Import the Extension from the online repository and install it.
- If you want to make use of the ajax functionality, the Extension xajax (xajax) is needed. Download it from the online repository and install it as well.
- Use Flexform or TypoScript for configuration (see below)
- Example Template on: ext/bddb_flvvideogallery/tmpl/template.tmpl
Configuration¶
Nothing special, the player has predifined TypoScript. You can change the template file, the CSS and the TS-Setup to your needs. In the Flexform you will have to add the path to the folder, where the videos are stored. After saving, these videos will be displayed in the flexform. The Thumbnails are not generated automatically for now, you will have to make them on your own. If no thumbnail is selected, there is a fallback to a default Thumbnail to make sure the video is selectable for the user in the frontend.
Note: If there are configurations in Flexform and in TypoScript, Flexform configuration has a higher priority.
That's all information on Configuration for now: if we see interests in this extension, we will keep on development and the documentation will get more precise. Feedback is welcome!
plugin.tx_bddbflvvideogallery_pi1 {
#path to the template file
templateFile = EXT:bddb_flvvideogallery/tmpl/template.tmpl
#Wraps the whole player and playlist
plugin.wrap = |
#Wraps the flv Description
caption.wrap=<div id="flvcaption">|</div>
noAjax= 0
AjaxLoadingMsg (
<img src="typo3conf/ext/bddb_flvvideogallery/res/ajax-loader.gif" /> Loading...
)
defaultVideoThumb= typo3conf/ext/bddb_flvvideogallery/res/defaultThumb.png
width=360
height=308
FlashVersion = 8
#Alternative content for people that got no flash
altFlashContent (
<a href="http://www.macromedia.com/go/getflashplayer">Get the Flash Player</a> to see this video.
)
#add extra Flash Parameter:
#for the swfobject: http://www.powerflasher.de/sites/blog/swfobject/
#for the flvplayer: http://www.jeroenwijering.com/extras/readme.html#flashvars
SwfObjectJS (
s1.addParam("allowfullscreen","true");
s1.addVariable('linkfromdisplay','true');
)
_LOCAL_LANG.default {
pi_list_browseresults_prev = <previous
pi_list_browseresults_page = page
pi_list_browseresults_next = next >
pi_list_browseresults_first = << first
pi_list_browseresults_last = last >>
}
_LOCAL_LANG.de {
pi_list_browseresults_prev = <Zurück
pi_list_browseresults_page = Seite
pi_list_browseresults_next = Nächste >
pi_list_browseresults_first = << Erste
pi_list_browseresults_last = Letzte >>
}
_CSS_DEFAULT_STYLE (
.tx-bddbflvvideogallery-pi1 p {
padding:0px;
text-align:center;
border:1px solid #ddd;
background-color:#eee;
}
.flvplayer_listpic_pic {
border: 0px solid #990000;
}
.flvplayer_listpic {
height: 70px;
width: 70px;
border: 0px solid #888888;
padding: 0px 4px 4px 0px;
margin: 0px 6px 6px 0px;
background-repeat: no-repeat;
background-position: 0px 0px;
}
.flvplayer_listpic_firstofrow {
height: 70px;
width: 70px;
border: 0px solid #888888;
padding: 0px 4px 4px 0px;
margin: 0px 6px 6px 0px;
background-repeat: no-repeat;
background-position: 0px 0px;
}
.flvplayer_listpic_lastofrow {
height: 70px;
width: 70px;
border: 0px solid #888888;
padding: 0px 4px 4px 0px;
margin: 0px 0px 6px 0px;
background-repeat: no-repeat;
background-position: 0px 0px;
}
.flvplayer_pagebrowser {
}
.browseLinksWrap {
text-align: center;
}
#flvplayercaption {
float:left;
}
#flvcaption {
clear: both;
margin-top: 0px;
width: 360px;
}
.flvplayer_pagebrowser_fwd {
float:right;
margin-right: 4px;
}
.flvplayer_pagebrowser_back {
float:left;
}
#player {
float: left;
margin-right: 16px;
margin-bottom: 10px;
}
* html #player {
margin-right: 8px;
}
#playlist {
}
#loadingMessage {
padding: 7px 0px 7px 0px;
width: 320px;
background-color: #ffffff;
text-align: center;
position: absolute;
margin: 130px 0px 0px 19px;
}
)
}
Using FLV Player & Videogallery with Ajax¶
If you want to use the Player with Ajax to prevent from loading the whole page when switching to another video, you have to install the Extension xajax . Because Ajax has problems with cached Data set the Page Properties to no cache .
If you have installed xajax and you don't want to use ajax with the player, you can disable this by setting up in TS plugin.tx_bddbflvvideogallery_pi1.noAjax = 1
RealURL¶
To use FLV Player & Videogallery with realURL add the following code to your RealURL configuration in localconf.php:
'postVarSets' => array (
'_DEFAULT' => array (
// bddb flv gallery
'video' => array(
array(
'GETvar' =>
'tx_bddbflvvideogallery_pi1[video]' ,
),
),
// bddb flv gallery pagebrowser
'videopage' => array(
array(
'GETvar' =>
'tx_bddbflvvideogallery_pi1[pointer]' ,
),
), // bddb flv gallery END
), // _DEFAULT END
), // postVarSets END
Reference¶
plugin.tx_bddbflvvideogallery_pi1.
templateFile¶
Property
templateFile
Data type
string
Description
Path to the template file.
Default
EXT:bddb_flvvideogallery/tmpl/flvplayer.tmpl
plugin.wrap¶
Property
plugin.wrap
Data type
string
Description
Wraps the whole player and playlist
Default
noAjax¶
Property
noAjax
Data type
boolean
Description
Choose if ajax should be used or not (Extension xajax needed!).
Default
0
AjaxLoadingMsg¶
Property
AjaxLoadingMsg
Data type
string
Description
Message that is displayed while a new video is loaded into the player or the pagebrowser loads a new part of the playlist, when using ajax. Only displayed if ajax is used.
Default
<img src="typo3conf/ext/bddb_flvvideogallery/res/ajax-loader.gif" /> Loading...
defaultVideoThumb¶
Property
defaultVideoThumb
Data type
string
Description
Default Thumbnail to be displayed, if no thumbnail is selected in the Flexform
Default
typo3conf/ext/bddb_flvvideogallery/res/defaultThumb.gif
width¶
Property
width
Data type
Int
Description
Width for the flvplayer
Default
360
height¶
Property
height
Data type
Int
Description
Height for the flvplayer (add 20px for the Player Navigation, if this should be displayed under the player).
Default
308
FlashVersion¶
Property
FlashVersion
Data type
Int
Description
Choose which Flash Version is needed. If no Flash is detected, or the Version is lower than needed, the content from altFlashContent will be displayed instead of the player.
Default
8
altFlashContent¶
Property
altFlashContent
Data type
string
Description
Alternative Content to be displayed, if no Flash or a too low version of Flash is installed.
Default
<a href="http://www.macromedia.com/go/getflashplayer">Get the Flash Player</a> to see this video.
SwfObjectJS¶
Property
SwfObjectJS
Data type
string
Description
Add extra Flash Parameters. For a full overview use the following links:
For the swfobject:
http://www.powerflasher.de/sites/blog/swfobject/
For the flvplayer: http://www.jeroenwijering.com/extras/readme.html#flashvars
Example:
plugin.tx_bddbflvvideogallery_pi1.SwfObjectJS (
s1.addParam("allowfullscreen","true");
s1.addParam("wmode","transparent");
s1.addVariable('usefullscreen','false');
s1.addVariable('linkfromdisplay','true');
s1.addVariable("overstretch","fit");
)
Default
s1.addParam("allowfullscreen","true"); s1.addParam("wmode","transparent"); s1.addVariable('usefullscreen','false'); s1.addVariable('linkfromdisplay','true');
s1.addVariable("overstretch","fit");
_LOCAL_LANG.default¶
Property
_LOCAL_LANG.default
Data type
Description
Default
_CSS_DEFAULT_STYLE¶
Property
_CSS_DEFAULT_STYLE
Data type
Description
Example given in file ext_typoscript_setup.txt
Default
Known problems¶
None at the time. Just contact us if you find some.
Note: Javascript must be enabled for this extension to work properly.
To-Do list¶
We made this extension for a special project. Throughout Development, we made a list with possible new functions (Sponsoring welcome!) to make the player more comfortable for different projects:
- Clean Up the code and templates a little bit more
- Separate Flexform for different options in groups
- Seperate player and playlist to use both parts on different sites
- integration of all text parts into locallang.xml
- Make Videos downloadable in Zip-Format (Video + Player as EXE?)
- Categories (Subfolders as Categories?)
- RSS Playlist Support
- Skinning of the Player
- Integration of the Flash Express Install Script
- Java Upload for large Films
- Automatic generation of thumbnails from Videofiles (ffmpeg Support)
- http://www.jeroenwijering.com/extras/statistics.html
- Replay and download link: http://home5.inet.tele.dk/nyboe/flash/replay/replay.htm
- http://home5.inet.tele.dk/nyboe/flash/
- Email to a friend
- Comments
- .htaccess -Instructions for controlling of external linking to the videos (traffic!)
- Automatic encoding of the videos directly on the server
Changelog¶
- 0.3.1 - Fixed some minor bugs- updated Manual (realURL configuration)- changed status to Stable
- 0.0.3 - Fixed a small Bug concerning the Pagebrowser: URLs have been decoded wrong on some systems.- integration of the new Version (3.99) of the FLV Player from Jeroen Wijering.- Set status of the Extension to BETA.
- 0.0.2 - First Release
- 0.0.1 - sk_simpleflvplayer
Sponsoring¶
Ghost-o-one (Main Extension Sponsor)
EOL - ensemble on_line ( www.eolv.at ) (New feature)
Andreas Gruber ( www.der-scout.com )
EXT: FLV Player & Video Gallery - 8