Difference between revisions of "FlvHandler"

From Wiki4Intranet
Jump to: navigation, search
 
(14 intermediate revisions by the same user not shown)
Line 1: Line 1:
Местный FlvHandler — доработка расширения [[mediawikiwiki:Extension:FlvHandler|Extension:FlvHandler]], размещённого на данный момент в [[mediawikiwiki:Main page|Mediawiki Wiki]].
+
{{Extension4info
 +
|name=FlvHandler
 +
|mediawiki=1.16+
 +
|description ru=Поддержка вставки Flash-видеоплееров на страницы аналогично изображениям. Поддерживаются кодеки FLV+MP3 или H.264+AAC в контейнерах FLV или MP4.
 +
|description en=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.
 +
|created=2009-02-01
 +
|included=2009-09-09
 +
|status=fork
 +
|useful=definitely
 +
}}
 +
{{ExtensionFromInfo|lang=en|name=FlvHandler}}
  
== На русском ==
+
== Usage ==
  
Доработки:
+
After installation you can insert videoplayers on wiki pages using normal wiki-syntax: <tt><nowiki>[[File:Video.mp4]]</nowiki></tt>.
  
* В отличие от обычного FlvHandler, местный вставляет код видеоплеера везде, где только можно, кроме галерей изображений и очень маленьких расположений (<code>$wgMinFLVSize[]</code>). Оригинальный вставлял код плеера только при явном написании <nowiki>[[Image:File.flv]]</nowiki>, а при вставке в виде <nowiki>[[Image:File.flv|thumb]]</nowiki> вы получали уменьшенный первый кадр со ссылкой, ведущей на «страницу изображения», на которой также не было кода видеоплеера.
+
== Improvements ==
* Несколько улучшенный формат сообщений об ошибках.
+
* Наличие русской локализации.
+
* Ликвидирован 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».
+
 
+
Пример: [[:Категория:Видео]].
+
 
+
== 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 38: Line 28:
 
* 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 ==
 +
 
 +
Return these changes back to trunk.
 +
 
 +
== Example ==
  
Hope these will be accepted into «trunk».
+
[http://yourcmc.ru/wiki/Category:Видео Example]
  
Example: [[:Категория:Видео]].
+
== Installation ==
  
[[Категория:MediaWiki]]
+
# 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>

Latest revision as of 15:31, 15 February 2013

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 improvements

Usage

After installation you can insert videoplayers on wiki pages using normal wiki-syntax: [[File:Video.mp4]].

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. 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