1FlashPlayer plugin for DokuWiki 2008-05-05 or later
2Version 2012-05-11
3
4Current version at http://arnowelzel.de/wiki/misc/flashplayer
5
6Uses the JW FLV Player 5.8.2011,
7see http://www.jeroenwijering.com/?item=JW_FLV_Player
8
9Based on the work of Sam Hall (http://www.dokuwiki.org/plugin:flashplayer),
10extended by Arno Welzel (http://arnowelzel.de).
11
12Licensed under the creative commons license BY-NC-SA
13http://creativecommons.org/licenses/by-nc-sa/3.0/deed
14
15
16Installation
17------------
18
19Copy all the files into a directory "flashplayer" within the plugin-directory
20if your DokuWiki installation
21
22IMPORTANT: When updating an older version, REMOVE the following line from
23the HEAD section of the template:
24
25<script type="text/javascript" src="<?php echo DOKU_BASE?>lib/plugins/flashplayer/player/swfobject.js"></script>
26
27This is NO LONGER neccessary since version 2008-10-12!
28
29
30Usage
31-----
32
33To embed a flash video inside a Wiki page, use the following code:
34
35<flashplayer width="width in pixels" height="height in pixels" position="0|1|2">flash vars</flashplayer>
36
37With "position" you can (optionally) define the alignment:
38
390 - left
401 - centered
412 - right
42
43It is not possible yet to let text flow around the video.
44
45Example - display a video "/demo.flv" with 480*380 pixels, use "/demo.jpg"
46for the preview image:
47
48<flashplayer width="480" height="380">file=/demo.flv&image=/demo.jpg</flashplayer>
49
50The flash vars tell the player, which file to play and which image to display
51for the static preview. You can also just provide a video without preview image:
52
53<flashplayer width="480" height="380">file=/demo.flv</flashplayer>
54
55A detailed description of all possible flash vars can be found at
56http://code.jeroenwijering.com/trac/wiki/FlashVars.
57
58
59Adding additional languages
60---------------------------
61
62Currently, the flashplayer plugin only supports English and German.
63
64If you want to add additional languages, just have a look in the "lang"
65directory. Just add the language you need by copying an existing language
66(according the conventions in "/inc/lang" of DokuWiki) and translate the
67appropriate file "lang.php" - be careful, as this is PHP code and has to
68be saved as UTF-8!
69
70
71Acknowledgments
72---------------
73
74Jeroen Wijering for his JW Player
75Sam Hall for the first version of this plugin
76
77
78History
79-------
80
812008-09-21  - Modified plugin by Sam Hall to generate valid XHTML and
82              using SWFObjects.
83
842008-10-12  - Moved SWFObjects to plugin script file, so it has not to
85              be included manually in the DokuWiki template.
86
872009-01-17  - Updated JW FLV Player to version 4.3.132.
88
892009-06-14  - Added "position" parameter.
90
912009-12-25  - Updated JW FLV to Version 5.0.753.
92
932010-02-26  - Removed SWFObjects and changed back to static output
94
952010-02-26a - Changed OBJECT element, so it works with WebKit too (Chrome, Safari)
96
972010-05-15  - Updated JW FLV to version 5.1.897.
98
992010-10-24  - Updated JW FLV to version 5.3.1397
100
1012011-04-20  - Versioninformation fixed and modified according the recommendations
102              for current DokuWiki versions.
103
1042011-08-14  - Updated JW FLV Player to version 5.7.1896.
105
1062011-12-23  - Updated JW FLV Player to version 5.8.2011.
107
1082012-05-11  - Bug fix for the handling of the "position" parameter.
109