Difference between revisions of "FlvHandler"

From Wiki4Intranet
Jump to: navigation, search
Line 1: Line 1:
 
{{Extension4info
 
{{Extension4info
 
|name=FlvHandler
 
|name=FlvHandler
|mediawiki=
+
|mediawiki=1.16+
 
|description ru=Поддержка вставки Flash-видеоплееров на страницы с использованием обычного синтаксиса <tt><nowiki>[[File:Видео.mp4]]</nowiki></tt>. Поддерживаются видеокодеки FLV+MP3 или H.264+AAC в контейнерах FLV или MP4.
 
|description ru=Поддержка вставки Flash-видеоплееров на страницы с использованием обычного синтаксиса <tt><nowiki>[[File:Видео.mp4]]</nowiki></tt>. Поддерживаются видеокодеки FLV+MP3 или H.264+AAC в контейнерах FLV или MP4.
 
|description en=Support inserting Flash video players onto wiki pages using normal <tt><nowiki>[[File:Video.mp4]]</nowiki></tt> syntax. Supports FLV+MP3 or H.264+AAC codecs inside FLV or MP4 containers.
 
|description en=Support inserting Flash video players onto wiki pages using normal <tt><nowiki>[[File:Video.mp4]]</nowiki></tt> syntax. Supports FLV+MP3 or H.264+AAC codecs inside FLV or MP4 containers.
Line 8: Line 8:
 
|included=2009-09-09
 
|included=2009-09-09
 
|status=fork
 
|status=fork
|authors=Vitaliy Filippov & Stas Fomin. Based on HaloACL by ontoprise GmbH, 2009.
 
 
}}
 
}}
 
{{ExtensionFromInfo|lang=en|name=FlvHandler}}
 
{{ExtensionFromInfo|lang=en|name=FlvHandler}}
  
== На русском ==
+
[[Mediawiki4Intranet]] has its own modified FlvHandler extension version. It is an improved version of original [[mediawikiwiki:Extension:FlvHandler|Extension:FlvHandler]].
  
Местный FlvHandler — доработка расширения [[mediawikiwiki:Extension:FlvHandler|Extension:FlvHandler]], размещённого на данный момент в [[mediawikiwiki:Main page|Mediawiki Wiki]].
+
== Improvements ==
 
+
Доработки:
+
 
+
* В отличие от обычного FlvHandler, местный вставляет код видеоплеера везде, где только можно, кроме галерей изображений и очень маленьких расположений (<code>$wgMinFLVSize[]</code>). Оригинальный вставлял код плеера только при явном написании <nowiki>[[Image:File.flv]]</nowiki>, а при вставке в виде <nowiki>[[Image:File.flv|thumb]]</nowiki> вы получали уменьшенный первый кадр со ссылкой, ведущей на «страницу изображения», на которой также не было кода видеоплеера.
+
* Несколько улучшенный формат сообщений об ошибках.
+
* Наличие русской локализации.
+
* Ликвидирован legacy-код — то есть старый, закомментированный код, присутствовавший в [http://www.shikadi.net/mediawiki/FlvHandler/FlvHandler-r3.zip FlvHandler-r3]. Хуки теперь не используются вообще!
+
* Возможность переопределения <code>$wgFLVConverters</code> и <code>$wgFLVProbes</code> в настройках '''до включения''' <code>FlvHandler.php</code>.
+
* Автоматическое добавление в начало строки <code>$wgFlashPlayer</code> пути к файлам MediaWiki (<code>$wgScriptPath</code>).
+
* Поддержка любых Unicode-имён видеофайлов.
+
* Генерация коллажей в качестве предпросмотра и свобода от ошибок, связанных с требованием ffmpeg чтобы ширина и высота изображения были кратны 2 — кадр сначала извлекается, а потом масштабируется.
+
* [http://www.flowplayer.org/ Flow player] 3.1.3 в комплекте.
+
 
+
<div style="color: red">Примечание: для работы пункта 1), то есть для отключения вставки кода плеера в галереи изображений, необходимо применить простой однострочный патч к ImageGallery.php.</div>
+
 
+
Надеюсь, что данные доработки будут приняты в «trunk».
+
 
+
[http://yourcmc.ru/wiki/Category:Видео Пример]
+
 
+
== In english ==
+
 
+
This Wiki has a modified FlvHandler extension installed. It is an improved version of [[mediawikiwiki:Extension:FlvHandler|Extension:FlvHandler]] from Mediawiki Wiki.
+
 
+
Improvements:
+
  
 
* Video player code is embedded anywhere (including Image Page) except Image Galleries and when size is set less than $wgMinFLVSize[] = array(180,180) by default. In Image Galleries, a «filmstrip» icon is also shown below each video to distinguish between videos and images.
 
* Video player code is embedded anywhere (including Image Page) except Image Galleries and when size is set less than $wgMinFLVSize[] = array(180,180) by default. In Image Galleries, a «filmstrip» icon is also shown below each video to distinguish between videos and images.
Line 51: Line 26:
 
* Flow player 3.1.3 bundled.
 
* Flow player 3.1.3 bundled.
  
<div style="color: red">Important note: to disable embedding of video player code on image galleries, you need to apply 1-line patch to ImageGallery.php.</div>
+
== TODO ==
  
Hope these will be accepted into «trunk».
+
Return these changes back to trunk.
 +
 
 +
== Example ==
  
 
[http://yourcmc.ru/wiki/Category:Видео Example]
 
[http://yourcmc.ru/wiki/Category:Видео Example]
 +
 +
== Installation ==
 +
 +
# Install [http://www.ffmpeg.org/ ffmpeg] on your server (see also [http://ffmpeg.arrozcru.org/wiki/index.php?title=Main_Page window$ version]) and make sure it’s in PATH environment variable.
 +
# Then as usual put {{cmd|require_once "$IP/extensions/FlvHandler/FlvHandler.php";}} to your <tt>LocalSettings.php</tt>.
 +
# {{warning}} To disable embedding of video player code on image galleries and image pages, you need to apply 1-line patches to <tt>ImageGallery.php</tt> and <tt>ImagePage.php</tt>:
 +
<pre>
 +
patch includes/ImagePage.php < extensions/FlvHandler/ImagePage.php.diff
 +
patch includes/ImageGallery.php < extensions/FlvHandler/ImageGallery.php.diff
 +
</pre>

Revision as of 15:58, 13 February 2013

The given value was not understood.

FlvHandler is a MediaWiki extension.

  • Main purpose: Support inserting Flash video players onto wiki pages using normal image syntax. Supports FLV+MP3 or H.264+AAC codecs inside FLV or MP4 containers.
  • Repository: https://github.com/mediawiki4intranet/FlvHandler
  • Homepage: FlvHandler on mediawiki.org 
  • Compatible MediaWiki versions: guaranteed 1.16+, maybe others
  • License: GPLv2.0+ 
  • Created: 2009-02-01 
  • Our rating: Definitely useful (5)

Status for Mediawiki4Intranet distribution:

  • Inclusion date: 2009-09-09
  • Included version: newest available
  • Improvement status: Forked in MediaWiki4Intranet with major improvementsMediawiki4Intranet has its own modified FlvHandler extension version. It is an improved version of original Extension:FlvHandler.

Improvements

  • Video player code is embedded anywhere (including Image Page) except Image Galleries and when size is set less than $wgMinFLVSize[] = array(180,180) by default. In Image Galleries, a «filmstrip» icon is also shown below each video to distinguish between videos and images.
  • Some error message formatting.
  • English+Russian i18n.
  • Removed commented out legacy-code (no hooks at all!).
  • Ability to set $wgFLVConverters and $wgFLVProbes before the inclusion of FlvHandler.php.
  • Automatic prepending of $wgFlashPlayer with MediaWiki script path ($wgScriptPath).
  • Support for any Unicode video file names (r3 can not download files with non-latin1 filenames).
  • Collages of 4 frames as previews when size is more than $wgMinFLVSize.
  • Modified FlvHandler is free of errors «frame size must be a multiple of 2» generated by ffmpeg, because the frame is extracted, and THEN resized using ImageMagick.
  • Flow player 3.1.3 bundled.

TODO

Return these changes back to trunk.

Example

Example

Installation

  1. Install ffmpeg on your server (see also window$ version) and make sure it’s in PATH environment variable.
  2. Then as usual put require_once "$IP/extensions/FlvHandler/FlvHandler.php"; to your LocalSettings.php.
  3. Attention niels epting.svg To disable embedding of video player code on image galleries and image pages, you need to apply 1-line patches to ImageGallery.php and ImagePage.php:
patch includes/ImagePage.php < extensions/FlvHandler/ImagePage.php.diff
patch includes/ImageGallery.php < extensions/FlvHandler/ImageGallery.php.diff