====== htvid Plugin ======

---- plugin ----
description: HTML5 video with flash fallback
author     : jjoelc 
email      : jjoelc@gmail.com
type       : syntax
lastupdate : 2013-04-05
compatible : 2012-10-13, !Hogfather
depends    : 
conflicts  : 
similar    : HTML5Video, FlashPlayer
tags       : video html5 flash mp4 ogv

downloadurl: https://github.com/jjoelc/htvid/archive/master.zip
bugtracker : https://github.com/jjoelc/htvid/issues
sourcerepo : https://github.com/jjoelc/htvid/
donationurl: 

screenshot_img : 
----

Flash is not available anymore in browsers.


===== Installation =====
Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

===== Adopt Me! =====
This plugin will accept two video urls (one mp4 and one ogv) and writes html video tags, with a flash fallback into your Dokuwiki page. The JWPlayer Flash player uses the mp4 file to play out, so you do not have to encode to flv. Has been tested with: IE v8,9,10 - Firefox latest, Chrome Latest, Safari latest, iPad and various Android devices without issue.

This plugin was a "one-off" solution used in our company in-house dokuwiki. It is based off of the [[plugin:html5video|HTML5 Video Plugin]] by Jason van Gumster, and uses JWPlayer 5.8 from the [[plugin:flashplayer|FlashPlayer]] plugin by Arno Welzel. **At least** 95% of the credit goes to them.

===== Examples/Usage =====
<code>
{{htvid>http://path.to/video.mp4|http://path.to/video.ogv|WidthxHeight|loop?autoplay}}
</code>

===== Syntax =====

Syntax is simple enough. 
<code>
{{htvid>http://path.to/video.mp4|http://path.to/video.ogv|WidthxHeight|loop,autoplay}}
</code>
  * %%{{htvid>%%
    * IDs this as htvid plugin
  * %%http://path.to/video.mp4%%
  * %%http://path.to/video.ogv%%
    * **Must** list 2 urls, plugin will fail if only one listed
    * **Must** be full urls (dokuwiki style paths don't work right now)
    * **Must** list mp4 file first, then ogv (Flash player uses the mp4 file)
  * %%WidthxHeight%%
    * Size of the player window. Will default to 640x360 if left blank, can be changed in video.php line 107, 108 if you wish
  * %%loop,autoplay%%
    * Optional, sets video to either loop, or start playing as soon as page opened. comma seperated if using both attributes.

You can set alignment by using spaces, just like other Dokuwiki media links. However, the first space should be between the greater than sign (">") and the first url.

Inline:
  {{htvid>http:/path.to/video.mp4|http://path.to/video.ogv}}
  
Left Aligned:
  {{htvid>http:/path.to/video.mp4|http://path.to/video.ogv }}
  
Center Aligned:
  {{htvid> http:/path.to/video.mp4|http://path.to/video.ogv }}
  
Right Aligned:
  {{htvid> http:/path.to/video.mp4|http://path.to/video.ogv}}

=== Change Log ===

  * **2013-04-05**
    * Initial release

=== Known Bugs and Issues ===

As stated above, you must list full urls to video files, as JWPlayer does not seem to like the "..fetch.php?media=" links that the "ml()" function returns. Not a big deal in my use case, so I didn't worry about it too much.

Also, since JWPlayer uses the mp4 file to play, you **must** list the mp4 url first, then the ogv video as the second parameter

=== ToDo/Wish List ===

  * Someone feel free to adopt this plugin!
  * Make dokuwiki style media paths work (e.g. :media:videos:video.mp4)
  * More graceful handling of more video filetypes (e.g. add support for any combination of mp4, ogv, webm, flv)
  * Not require specific order of mp4 and ogv file listings