1. Vorwort
2. Wie funktioniert FLVideo?
3. Voraussetzungen
4. Download & Update
5. Installation
FLVideo ohne FFMPEG
FLVideo mit FFMPEG
Hinweise
6. Konfiguration
7. Support
8. Lizenz
9. Kontakt
10. Bekannte Probleme
11. FAQ
12. Danke für FLVideo Addon
1. Vorwort
Das 'FLVideo Addon' knüpft an die Idee von YouTube oder MyVideo, sprich das publik machen von Videos im Internet.
Jedermann kann sich einbeziehen und seine privaten Videos veröffentlichen.
Dieses Addon nutzt das gleiche Prinzip, aber nicht als eigenständige Plattform,
sondern als Zusatz (Addon) zum Woltlab Burning Board (WBB) der Woltlab GmbH.
2. Wie funktioniert FLVideo?
FLVideo baut in erster Linie auf eine Software namens FFMPEG auf. Diese
ermöglicht es Musik und Videos in andere Formate zu konvertieren und unterstützt
eine breite Palette an Video- und Audio-Codecs, die je nach Wunsch eingebunden
werden können. Programmiert ist FLVideo in der Programmiersprache PHP, die
komplexe Webapplikationen erlaubt. Durch einen System-Befehl werden alle zur
Konvertierung eines Videos erforderlichen Parameter an FFMPEG weitergegeben,
wodurch sich eine Konvertierung in Gang setzen lässt. Wird ein neues Video von einem
User per FLVideo Upload hochgeladen, entsteht ein neuer Datensatz in der
MySQL-Datenbank. Ein Mal pro Minute werden alle neuen Datensätze erfasst und
entsprechend ausgewertet. Solange ein Video noch nicht konvertiert wird,
befindet es sich in der 'Warteschlange'. Der entsprechende Status ist für den
jeweiligen User immer einsehbar. Das Herzstück auf dem Monitor, der Player, ist der Flash Video Player von Jeroen Wijering in einer leicht geänderten und für FLVideo Addon angepassten Variante.
3. Voraussetzungen
Dieses Addon hat durch seine Bestandteile weitaus größere Anforderungen als
"normale" Hacks oder Addons für das WBB. Wichtig ist in erster Linie ein
virtueller oder besser ein dedizierter Server, worauf dieses Addon installiert
werden soll. Ein normaler Webhosting-Account bei 1und1, GMX, Strato oder
woanders, wo man ein bisschen Speicherplatz für seine Homepage hat, ist nicht
geeignet und in diesem Fall nutzlos. Auf dem eigenen Server muss man in der Lage
sein Kommandobefehle per SSH (Secure Shell) ausführen und Software installieren
zu können. Sind diese Voraussetzungen nicht gegeben, kann die Installation an
dieser Stelle (jetzt) abgebrochen werden. Weitere Voraussetzungen sind eine
relativ schnelle Rechenleistung des Servers sowie ausreichend Arbeitsspeicher ab
512 MB. Als Betriebssystem wird Linux vorausgesetzt, wobei Windows mit ein wenig
Spielerei ebenso genutzt werden kann; Windows findet an dieser Stelle aber kein
Gehör. Ein normaler Systembenutzer mit SSH-Zugriff sollte vorhanden sein, womit
der Konverter "betrieben" wird; der Root-Account wird aus Sicherheitsgründen
hierfür nicht empfohlen. Das Addon lässt sich einsetzen auf WBBs der Version
2.3.x. Auf Boards der Version 2.2.x wurde das Addon nicht getestet;
Unterstützung aber theoretisch möglich, da kaum boardspezifische Funktionen
genutzt werden.
4. Download & Update
Version: 0.3.3
Datum: 02.08.2007
Screenshots:
Setup-Programm,
Alle Videos,
Meine Videos,
Video anschauen,
Tags,
Video Upload,
ACP - FLVideo Einstellungen
Live-Demo: 100 Tonnen Explosion
Tarball: FLVideo-Addon-0.3.3.tar.gz - (schon mehr als 1.000 Downloads! Stand: Dez 2009)
Einsatz: MietzMietz, NSW-Forum,
xHoch9, Nierott-Castle Forum,
Elbschrauber, Smiley Events, uvm.
Änderungen von 0.3.2 zu 0.3.3:
- Vollbild: das Abspielen von Videos ist nun auch im Vollbild-Modus möglich und über das ACP steuerbar
- Bewertung: ein 5-Sterne Bewertungssystem ist nun vorhanden
- Suche: ergänzend durch die Videosuche mit Tags ist nun auch eine Volltextsuche möglich
- RSS: Fehler im RSS-Feed wurden beseitigt, ebenso wurde dieser nun auch durch Vorschaubilder der Videos erweitert, wodurch
RSS-Reader (wie z. B. bei iGoogle) neben den Videoinformationen auch ein Vorschaubild darstellen können
- Updates: im ACP wird nun automatisch auf neue Updates des FLVideo Addon hingewiesen
- Debugging: 1. nachdem es vermehrt Probleme mit dem Logo im Flashplayer gab, wurde diese Funktion nun
etwas verändert und positiv auf mehreren Servern getestet, 2. weitere bekannte Fehler wurden beseitigt
Änderungen von 0.3.1 zu 0.3.2:
- Gruppenzugriffssteuerung: für bestimmte Zwecke lohnt es sich, wenn man regeln kann, welche Gruppen
was tun dürfen; welche Gruppen nun Videos anschauen und/oder hochladen dürfen, kann nun geregelt werden
- Logo im FlashPlayer: ein Logo inklusive Link kann nun dynamisch in den FlashPlayer eingebunden werden
- Debugging: bekannte Fehler beseitigt
Änderungen von 0.3.0 zu 0.3.1:
- Setup-Programm optimiert (siehe Screenshot); Systemkonfiguration wird ausgelesen und für das Setup verwendet; gibt nun
Hinweise auf Korrekturmöglichkeiten und bietet die Möglichkeit zum direkten Eingriff; ebenso nun kompatibel mit MySQL 4
- stripos() fest integriert; wichtig für PHP Versionen unter 5.0.0, da dort nicht existent
- Videos lassen sich in frei wählbare und durch den Administrator vordefinierte Kategorien einteilen
- anstössige Inhalte von Videos können durch Benutzer per Mausklick gemeldet werden (Video melden)
Änderungen von 0.2.0 BETA zu 0.3.0:
- Benutzerfreundlichkeit gesteigert (Grafiken, Menü)
- Administratoren und SuperModeratoren sind in der Lage Videos zu löschen
- Kommentare sind nun auch direkt löschbar
- RSS-Feed für 'Alle Videos' sowie ein RSS-Feed für jeden einzelnen User
- kleiner Ladebalken beim Upload macht das Warten einfacher
Änderungen von 0.1 BETA zu 0.2.0 BETA:
- klarere Strukturen (Dateien, Templates)
- FFMPEG kann systemweit installiert werden, Beschränkung entfernt; Installation dadurch einfacher
- Setup-Skript prüft nun ob FFMPEG bereits unter einem der Standardverzeichnisse installiert ist und richtet sich entsprechend darauf ein
- Standard-FLVs erstellt, die bei Fehlern im Player angezeigt werden, wie "Video nicht gefunden", "Keine Berechtigung"
- Alternative Cronjob verbessert
- Flash Player neuen Sturkturen angepasst
- Skript zum Deinstallieren von FLVideo erstellt, welches die Datenbank bei Bedarf aufräumt
Update zu 0.3.3 : Wer FLVideo schon in der Version 0.1 BETA, 0.2.x BETA oder 0.3.x zu laufen hat, kann ein Update wie folgt vornehmen:
|
 |
1. downloaden Sie die aktuelle Version
2. entpacken Sie das Archiv
3. laden Sie die Ordner acp, flvideo, images und templates auf
den Server; vorhandenes kann überschrieben werden (es sei denn, Sie haben eine spezielle Datei verändert)
4. gehen Sie ins ACP, importieren Sie die Templates beginnend mit 'flvideo_', cachen Sie die neuen Templates
5. führen Sie die acp_tpl.php im Ordner acp aus, um die ACP-Templates zu cachen
6. wechseln Sie in den Ordner extras und lesen Sie die readme.txt, laden Sie anschließend
die entsprechende Update-Datei auf den Server und führen Sie diese aus
7. laden Sie die flvideo.swf, flvideo.php und flvideo_functions.php auf den Server (alte Dateien überschreiben)
8. bei Versionen unter 0.3.1: öffnen Sie die global.php und entfernen Sie folgenden Code: require_once("./flvideo_functions.php"); |
FLVideo sollte nun wie vorgesehen arbeiten.
5. Installation
Vor der Installation ist sicherzustellen, ob vom ganzen Forum (Dateien sowie Datenbank) eine Sicherungskopie existiert und ob das
nötige Wissen, um diese Installation durchzuführen, vorhanden ist.
5.1 FLVideo ohne FFMPEG (wenn schon installiert, sonst siehe 5.2)
1. entpacken Sie das Archiv mit WinRAR, WinACE oder ähnlichem
2. wechseln Sie in den Ordner wbb und laden Sie die darin enthaltenen Ordner und Dateien in das
Forum-Verzeichnis auf dem Server
3. wechseln Sie auf dem Server in den Ordner flvideo/bin und geben Sie der Datei output.txt volle
Rechte (chmod 777)
4. führen Sie die Datei flvideo_setup.php im Ordner acp aus
5. gehen Sie ins ACP, 'Templates importieren/exportieren', und importieren Sie die Templates ins
gewünschte Templatepack
6. Cachen Sie die neuen Templates, vorallem aber auch das ACP-Template (rufen Sie die acp_tpl.php im
Ordner acp auf; wenn Datei nicht vorhanden, im Zip-Archiv des WBB ist sie enthalten)
7. Verlinkungen: Um zu FLVideo innerhalb des Forum zu gelangen, genügt der Einbau eines Links zur flvideo.php.
8. Cronjob: richten Sie einen Cronjob für den jeweiligen Systembenutzer ein, der den Konverter in Gang setzen soll.
In diesem Beispiel wird ein Systembenutzer namens flvideo verwendet. Führen Sie folgendes aus, wenn kein grafisches
Frontend wie Webmin, Plesk etc. verfügbar: crontab -e -u flvideo
Daraufhin öffnet sich ein Editor, für gewöhnlich der vi, worin die Cronjobs bearbeitet werden können. Dort muss nun folgendes rein
(der Pfad ist natürlich entsprechend anzupassen):
* * * * * /usr/bin/php /dein_pfad_zum_forum/flvideo/bin/flvideo_converter.php
auch möglich ist folgende Variante:
* * * * * /usr/bin/wget -q -O /dev/null http://www.deineseite.de/flvideo/bin/flvideo_converter.php
Bei der letzten Variante muss die IP des Servers in die .htaccess im Ordner flvideo/bin/ eingetragen werden
(z. B. allow from 83.32.42.90).
Den vi nun beenden (ESC drücken, :wq! eingeben und Enter drücken). Der Cronjob ist nun eingerichtet und die Warteschlange wird
minütlich auf neue Videos geprüft.
|
 |
Alternative: Scheint die Sache mit dem Cronjob zu kompliziert, so kann alternativ ein Cronjob über den kostenlosen Service
von cronjob.de eingerichtet werden. Die einzutragende URL muss dann lauten,
wie z. B.:
http://www.deine-domain.de/wbb2/flvideo/bin/flvideo_converter.php. Die normale Registrierung und Verwendung dieses
Service ist kostenlos. |
9. Schreibrechte: folgende Ordner benötigen volle Rechte (777): flv, jpg und ori im Ordner flvideo; wenn NICHT die Alternative verwendet wird, reichen normale Rechte (755)
5.2 FLVideo mit FFMPEG
Sollte FFMPEG auf Ihrem System noch nicht installiert sein, so führen Sie vor dem Punkt 5.1 die Anweisungen in der install_ffmpeg.txt durch.
5.3 Hinweise
Ist das Forum für die Gruppe 'Gäste' nicht sichtbar, arbeitet auch
der Konverter nicht, da er als Gast auf die Daten zugreift. Um den
Konverter trotzdem laufen zu lassen, öffnen Sie die global.php und
suchen Sie nach einer Zeile (ungefähr 267), die wie folgt beginnt:
if ($wbbuserdata['can_view_board'] == 0 && $filename != "login.php" && $filename
!= "logout.php" && $filename != "register.php" ...
In diese Kontrolle muss ein weiterer Check, nämlich: $filename !=
"flvideo_converter.php"
Beispiel: if ($filename != "flvideo_converter.php"
&& $wbbuserdata['can_view_board'] == 0 && $filename != "login.php"
&& $filename != "logout.php" ...
|
 |
6. Konfiguration
Alle Einstellungen können wie gewohnt über das ACP vorgenommen werden. Über den Menüpunkt 'FLVideo Einstellungen',
zu sehen im erweiterten ACP-Modus, gelangt man zu den verfügbaren Optionen. Die voreingestellten Werte sind
empfohlene oder durch das Setup vorgegebene Werte. Bis auf die Pfade, die nur geändert werden sollten, insofern
man weiss was man tut. Entsprechende Hinweise sind auch dort nochmal zu finden.
7. Support
Das offizielle Supportforum finden Sie hier. Ebenso wurden
und werden viele Fragen unter
rootserverprojekt.de geklärt.
|
Tipp: Wenn Sie im Supportforum registriert sind, bekommen Sie - falls gewünscht - aktuelle Neuigkeiten zwecks
der Entwicklung des Addons per E-Mail zugesandt und sind so stets auf dem aktuellen Stand.
|
8. Lizenz
Diese Software steht unter der Creative
Commons License. Das Copyright in sämtlichen Dateien darf nicht verändert oder entfernt werden.
Der kommerzielle Einsatz von FLVideo Addon ist nur mit schriftlicher
Genehmigung (kommerzielle Lizenz durch Autor) gestattet.
9. Kontakt
Bei allgemeinen Fragen oder Problemen rund um FLVideo Addon schreiben Sie an: support[at]flvideo[dot]de
10. Bekannte Probleme
bis 0.3.0:
- Call to undefined function: stripos() ... Diese Funktion gibt es erst seit PHP 5, daher fügen Sie bitte die stripos-Funktion manuell an den Anfang der global.php.
bis 0.1 BETA RC3:
- Warning: chdir() [function.chdir]: Not a directory (errno 20) ... Ein von einem Experiment zurückgebliebener und vergessener
Fehler. Ersetzen Sie die flvideo_converter.php der RC2 und RC3 durch die der RC4.
- Alternative funktioniert nicht auf anhieb. Um es nicht noch komplizierter zu machen, bitte die neue Alternative verwenden.
0.1 BETA RC2:
- Fehler 202 (dieser Datentyp ist nicht erlaubt) tritt auf. Hierbei ist die Trennung bei der Angabe der erlaubten Datentypen
fehlerhaft. Statt einem Komma nach jedem Datentyp muss jedes Komma durch einen senkrechten Strich ersetzt werden, bspw:
3gp|wmv|avi|divx|mpg. Bitte entsprechend im ACP abändern.
11. FAQ
1. Wenn ich den Konverter in Gang setze, steht beim Status 'FEHLER BEI DER KONVERTIERUNG; nicht unterstütztes Format?'. Was ist falsch?
Diese Meldung kann viele Ursachen haben. Die häufigste ist, dass FFMPEG nicht korrekt installiert oder der Pfad zu FFMPEG nicht richtig ist. Eine andere wäre, dass die Datei 'output.txt' im Ordner 'flvideo/bin' keine vollen Rechte hat (777). Oder aber die Meldung hinterfragt was es auch sein könnte, nämlich dass das Video-Format nicht unterstützt wird. Diese Fehlerquellen gilt es zu untersuchen.
2. Beim Aufruf der flvideo.php kommt eine weisse Seite.
Das kann bis zu der Version 0.3.2 passieren, wenn beim Update zu dieser Version die entsprechende Code-Zeile (require_once("./flvideo_functions.php")) nicht aus der global.php entfernt wurde.
3. Beim Setup der Versionen unter 0.3.1 erhalte ich einen Database-Error. Was ist hierfür die Ursache?
Die MySQL-Befehle im Skript sind nicht mit MySQL-Versionen unter 5.0 kompatibel. Bitte verwenden Sie die aktuelle Version.
4. Im FlashPlayer wird kein Logo dargestellt. Woran liegt das?
Ihr Webserver verarbeitet den Player, die flvideo.swf, nicht direkt als Flash-Datei, sondern als eine, die ihm nicht bekannt ist, da der Mime-Type
"application/x-shockwave-flash" fehlt oder von einem anderen Mime-Type überschrieben wird. Suchen Sie in Ihrer Webserver-/Apache-Konfiguration nach
der Auflistung der Mime-Types und suchen Sie nach "swf". Der eben genannte Mime-Type sollte allein in der Konfiguration für "swf" vorgesehen sein. Beispiel:
application/x-shockwave-flash swf
Sollten Sie auf "application/x-shockwave-flash2-preview swf" stossen, so entfernen Sie diesen Mime-Type.
5. Gäste können auf die Videos nicht zugreifen, auch wenn ich die FLVideo-Einstellungen im ACP richtig gesetzt habe.
Laden Sie die aktuelle Version herunter und updaten Sie FLVideo Addon.
6. Wenn ich ein Video via BBCode in einen Beitrag einbinde, ist dort nur
ein weißes Feld zu sehen. Woran liegt das?
Um diesen Fehler zu korrigieren, laden Sie den Bugfix #0001 herunter und laden Sie diesen direkt in das Board-Verzeichnis Ihres WBB. Führen Sie die Datei aus
und löschen Sie diese anschliessend. Das Problem sollte nun behoben sein.
12. Danke für FLVideo Addon
Wenn Ihnen das FLVideo Addon gefällt und Sie mich bei meiner Arbeit unterstützen möchten, bin ich jederzeit für einen kleinen Beitrag dankbar.
|
