Automedia 3 Plugin für MyBB 1.8

Dokumentation

Autor: doylecc ( http://community.mybb.com/user-14694.html)

Version: 3.0.3 (04.02.2015)

Homepage: http://mybbplugins.de.vu

Kontaktmöglichkeiten: siehe http://mybbplugins.de.vu

Inhaltsverzeichnis

• Pluginbeschreibung
• Screenshots
• Installation
• Update
• Globale Einstellungen
• Modulverwaltung
• Benutzer-CP
• MyCode-Buttons
• Modul-Erstellung
• Lizenz

Pluginbeschreibung

Das AutoMedia-Plugin erkennt bestimmte URLs in Beiträgen, die zu Video-, Audio o.a. Medien führen und bettet unter Verwendung der Embera oEmbed Library und optional der embed.ly API diese Dateien automatisch in den Beitrag ein. Dafür ist keinerlei MyCode notwendig.

AutoMedia 3 ist modular aufgebaut - die Module für zusätzliche Dateitypen/Webseiten können einzeln aktiviert/deaktiviert, hinzugefügt/gelöscht oder aktualisiert werden, ohne dass dabei das Plugin selbst aktualisiert oder zwischenzeitlich deaktiviert werden muss.

Einzelne Features:

->Kann im ACP aktiviert/deaktiviert werden

->Template-Änderungen werden automatisch ausgeführt, wenn später ein neues Theme importiert oder hinzugefügt wird.
Zusätzlich können Template-Änderungen von der Pluginübersicht aus angewendet werden (z.B. nach dem Zurücksetzen von Templates), ohne das Plugin zu deaktivieren.

->Kann nur für Gäste deaktiviert werden

->Kann für bestimmte Benutzergruppen deaktiviert werden

->Kann nur für bestimmte Foren aktiviert werden

->Das automatische Einbetten einzelner Links kann durch die Verwendung des MyCode Tags [amoff]URL[/amoff] deaktiviert werden.

->Mit Hilfe des [ampl]URL1.mp3|URL2.mp3|URL3.mp3[/ampl] MyCode Tags können MP3 Playlists erstellt werden.

->Das automatische Einbetten kann für Signaturen deaktiviert werden (Standard.)

->Einbetten kann in Zitaten deaktiviert werden.

->Codebuttons für die MyCodes des Plugins können im Editor unter der Textbox angezeigt werden.

->Jeder Benutzer kann das automatische Einbetten für sich im Benutzer CP aktivieren/deaktivieren.

->Bettet Videos und Musik von Dutzenden Webseiten ein.

->Ein embed.ly API Key kann verwendet werden.

->Dokumentation direkt über die Pluginübersicht im ACP erreichbar.

->Das automatische Einbetten von Videos von Erwachsenenseiten kann aktiviert/deaktiviert werden.

->Das automatische Einbetten von Videos von Erwachsenenseiten kann nur für Gäste deaktiviert werden.

->Berechtigungen für Videos von Erwachsenenseiten können auf Benutzergruppen- und Forenbasis erteilt werden.

->Nutzung des MyBB Cachesystems, um zusätzliche Datenbankabfragen zu vermeiden.

Liste der unterstützen Medien:

Durch die oEmbed API werden viele Webseiten (Embera ca. 65 und embed.ly ca. 250) unterstützt. Siehe Embera Provider Liste und embed.ly Provider Liste

U.a. durch die im Plugin enthaltenen Mediaelement HTML5 Player, Flowplayer und MP3-Player werden verschiedene Dateitypen unterstützt. Z.B.:

# MP3/M4A/WAV/OGG Audio und MP3 Playlist

# MP4/M4V/MP4V/OGV/WEBM Video

# FLV Flashvideo

# SWF Flash

# DivX Video

# AVI Video

# MKV Video

# MOV Quicktime Videos

# RM/RAM/SMIL/RV/RPM Real Media

# WMV/WMA Windows Media

# MPG/MPEG Video

Bitte beachten, dass für die korrekte Anzeige alle Medientypen die entsprechenden Plugins im Browser installiert sein müssen!

Ebenfalls werden verschiedene Erwachsenen Video Seiten unterstützt (standardmäßig deaktiviert)

cURL und fsockopen Support:

Falls cURL oder fsockopen nicht vom Server untersützt werden (oder deaktiviert sind), können die Medien sehr vieler Seiten nicht angezeigt werden.

Zurück zum Seitenanfang

Screenshots

Screenshots sowie News, Updates und die aktuellen Module befinden sich auf der Seite:

http://doylecc.altervista.org/de/automedia.html

Zurück zum Seitenanfang

Installation

1. Den kompletten Inhalt des Ordners "Upload" in das Forenverzeichnis hochladen.
   (Für weitere Sprachen sind die entsprechenden Sprachdateien ebenfalls hochzuladen.)
2. In "Admin CP - Konfiguration - Plugins" auf "Installieren & Aktivieren" hinter AutoMedia klicken
3. Nach der Aktivierung befindet sich eine neue Einstellungsgruppe "AutoMedia Global" unter "ACP - Konfiguration - Einstellungen".
   Hier kann das Plugin aktiviert/deaktiviert werden, ohne die vorhandenen Einstellungen zu verlieren.
   Einbetten kann nur für Gäste deaktiviert werden
   Einbetten kann für bestimmte Benutzergruppen deaktiviert werden
   Einbetten kann nur für bestimmte Foren aktiviert werden
   Einbetten von Videos von Erwachsenenseiten kann aktiviert/deaktiviert werden. (Standard: deaktiviert)
   Einbetten von Videos von Erwachsenenseiten kann nur für Gäste deaktiviert werden.
   Berechtigungen für Videos von Erwachsenenseiten können auf Benutzergruppen- und Forenbasis erteilt werden.
   Einbetten kann deaktiviert werden für Signaturen (Standard)
   Berechtigungen für das Einbetten von Flash Dateien: (nur Admins)(Admins, Supermods, Mods)(alle Benutzer)
   Max. Breite und Höhe der angezeigten Dateien kann eingestellt werden.
   Embera kann (de)aktiviert werden
   Embed.ly kann mit vorhandenem API Key aktiviert werden.
   Codebuttons für die MyCodes des Plugins können aktiviert/deaktiviert werden.
   Einbetten kann in Zitaten deaktiviert werden.
4. Fügt eigene Administrator-Berechtigung hinzu.
5. In "ACP - Tools & Verwaltung" wird der Menüpunkt "AutoMedia" hinzugefügt. Dort können alle Module für die Dateitypen und Webseiten angesehen und verwaltet werden.
   Einbetten kann für jede zusätzliche Webseite bzw. jeden zusätzlichen Dateityp aktiviert/deaktiviert werden. (Standard: alle aktiviert)
6. Das Plugin fügt im "Benutzer CP" einen neuen Menüpunkt "AutoMedia" hinzu. In "AutoMedia" befindet sich eine Auswahlbox, über die jeder Benutzer das automatische Einbetten für sich aktivieren (Yes (Standard)) oder deaktivieren (No) kann. Wenn er "No" wählt, werden für ihn nur die Links in den Beiträgen aller Benutzer angezeigt. Gleichzeitig werden dann für alle Benutzer in den Beiträgen des entsprechenden Benutzers nur die Links angezeigt.
7. Fertig.

Zurück zum Seitenanfang

Update

Update von Version 3.0:

1. Den kompletten Inhalt des Ordners "Upload" in das Forenverzeichnis hochladen, alle älteren Plugindateien überschreiben.
2. Im ACP unter Konfiguration -> Plugins das AutoMedia deaktivieren und anschließend wieder aktivieren.
3. Im ACP unter Templates & Style -> Templates -> Finde aktualisierte Templates ausführen. Falls automedia-Templates aufgeführt werden, diese zurücksetzen (und ggf. die eigenen Änderungen wieder einfügen.)
4. Fertig

Update von allen älteren Versionen:

1. Das alte AutoMedia Plugin muss komplett deinstalliert werden.
2. Den kompletten Inhalt des Ordners "Upload" in das Forenverzeichnis hochladen, alle älteren Plugindateien überschreiben.
   (Der alte Ordner "sites" im Verzeichnis inc/plugins/automedia kann gelöscht werden.)
   Für weitere Sprachen sind die entsprechenden neuen Sprachdateien ebenfalls hochzuladen.
3. siehe Installation ab Punkt 2

Zurück zum Seitenanfang

Globale Einstellungen

Im ACP unter Konfiguration - AutoMedia Global befinden sich 20 folgende Einstellungsmöglichkeiten:

1. AutoMedia Sites aktivieren? - Hier kann das automatische Einbetten komplett deaktiviert/aktiviert werden, ohne dass vorhandene Einstellungen verloren gehen.
2. AutoMedia fuer Gaeste erlauben? - Hier kann das automatische Einbetten nur für Gäste deaktiviert werden.
3. AutoMedia fuer bestimmte Gruppen verbieten?
4. AutoMedia nur fuer bestimmte Foren aktivieren?
5. Einbinden von Erwachsenen Videos aktivieren? - Hier kann das automatische Einbetten der Videos von Erwachsenen-Webseiten (auch Special Module genannt) deaktiviert/aktiviert werden. (Standardmäßig ist es bei der Installation deaktiviert) - Hinweis: Die Erwachsenen-Module in der Modulverwaltung werden nur angezeigt, wenn diese Einstellung aktiviert ist.
6. Einbinden von Erwachsenen Videos fuer Gaeste erlauben? - Hier kann das automatische Einbetten der Videos von Erwachsenen-Webseiten für Gäste deaktiviert werden.
7. AutoMedia von Erwachsenenseiten fuer bestimmte Gruppen erlauben? - Hier können Benutzergruppen gewählt werden, für die das automatische Einbetten der Videos von Erwachsenen-Webseiten aktiviert werden soll.
8. AutoMedia von Erwachsenenseiten fuer bestimmte Foren aktivieren?
9. AutoMedia in Signaturen erlauben? - Hier kann das automatische Einbetten in Signaturen der Benutzer dektiviert/aktiviert werden. (Standardmäßig ist es bei der Installation deaktiviert.)
10. Berechtigung fuer das Einbinden von Flashdateien - Hier wird festgelegt, wer Flash-Dateien (FLV und SWF) in Beiträge einbetten darf. Es gibt 3 Optionen: a: nur Admins, b: Admins, Supermoderatoren und Moderatoren und c: alle Benutzer (Standard).
11. Max. Breite der eingebetteten Dateien. - Hier wird die Breite (in Pixeln) für die eingebetteten Medien festgelegt.
12. Max. Hoehe der eingebetteten Dateien. - Hier wird die Höhe (in Pixeln) für die eingebetteten Medien festgelegt.
13. Embera oEmbed verwenden (Standard.)
14. Embed.ly Service verwenden. (Embed.ly und Embera können gemeinsam verwendet werden.)
15. Embed.ly API Key eintragen.
16. Embed.ly Medien direkt einbinden, über einen Button oder als Modal-Poup anzeigen lassen.
17. Embed.ly Webseiten-Vorschau von Links in Beiträgen aktivieren.
18. Embed.ly Medien als Embedly-Cards anzeigen.
19. Codebuttons fuer MP3 Playlist und Deaktivierung MyCodes anzeigen - Wenn diese Einstellung auf "JA" gesetzt ist, werden den Benutzern im Editor unter der Texteingabebox zwei Buttons zum Einfügen des [amoff]-MyCodes (dieser deaktiviert das automatische Einbetten des entsprechenden Links) sowie des [ampl]-MyCodes (zur Erstellung einer MP3 Playlist) angezeigt.
20. AutoMedia in Zitaten? - Hier kann das automatische Einbetten beim Zitieren von Beiträgen dektiviert/aktiviert werden.

Zurück zum Seitenanfang

Modulverwaltung

• Im ACP unter Tools & Verwaltung befindet sich der Menüpunkt "AutoMedia."
• Dahinter verbirgt sich die Modulverwaltung von AutoMedia.
• Nach einen Klick darauf zeigt sich eine Tabelle mit den vorhandenen Modulen (Installierte AutoMedia Module verwalten.)
• Falls in den globalen Einstellungen das automatische Einbetten der Videos von Erwachsenen-Webseiten aktiviert ist, wird ein zweiter Tab angezeigt. (Installierte Erwachsenen-Seiten Module)
• In der Tabelle werden alle Module angezeigt, die sich als PHP-Dateien im Modul-Ordner "inc/plugins/automedia/mediasites/" befinden. (Der Modul-Ordner für Videos von Erwachsenen-Webseiten (Special Module) ist "inc/plugins/automedia/special/".)
• In der 1. Spalte der Tabelle wird die laufende Nummer angezeigt.
  Die 2. Spalte zeigt den Namen des Moduls. Durch einen Klick auf den Namen kann man sich den Code des entsprechenden Moduls anzeigen lassen.
  Die 3. Spalte zeigt den Status des Moduls. Ein grün umrandeter, fröhlicher Smiley signalisiert, dass das Modul aktiviert ist, während ein rot umrandeter, trauriger Smiley darauf hinweist, dass das Modul deaktiviert ist.
  In der 4. Spalte kann jedes Modul aktiviert werden (wenn es gerade nicht aktiv ist) oder deaktiviert werden (wenn es gerade aktiv ist) Die Optionen werden zusätzlich durch verschiedene Farben verdeutlicht.
  Unter der Tabelle befindet sich zusätzlich ein Button (Alle aktivieren), mit dem man alle inaktiven Module mit einem Klick aktivieren kann.
• Die Modulverwaltung funktioniert im Tab für die Erwachsenen-Seiten Module nach dem gleichen Muster.

• Neue Module können hinzugefügt werden, in dem sie in den entsprechenden Ordner (Site Module in "inc/plugins/automedia/mediasites/" und Special Module nach "inc/plugins/automedia/special/") per FTP, Dateimanager, SSH o.a. hochgeladen werden.
  Danach die Modulverwaltung aufrufen - die neuen Module wurden nun als inaktiv zur Tabelle hinzugefügt und können dort aktiviert werden.

• Module können vollständig entfernt werden, in dem sie in der Modulverwaltung deaktiviert werden und anschließend per FTP, Dateimanager, SSH o.a. aus dem entsprechenden Ordner (Site Module in "inc/plugins/automedia/mediasites/" und Special Module nach "inc/plugins/automedia/special/") gelöscht werden.

• Für das Hinzufügen, Entfernen oder Aktualisieren vom Modulen muss das AutoMedia Plugin weder deaktiviert werden, noch ist in den meisten Fällen ein Update des gesamten Plugins erforderlich.

Zurück zum Seitenanfang

Benutzer-CP

Im Benutzer-CP befindet sich links unten der Menüpunkt "AutoMedia." Wenn der Benutzer darauf klickt, erscheint rechts eine Tabelle. Diese Tabelle zeigt auf der rechten Seite ein Status-Icon.

Daumen hoch bedeutet: Das automatische Einbetten ist in den persönlichen Einstellungen aktiviert.
Daumen nach unten bedeutet: : Das automatische Einbetten ist in den persönlichen Einstellungen deaktiviert.

In der Mitte der Tabelle befindet sich eine Auswahlbox mit den Optionen "YES" (Einbetten aktivieren) und "NO" (Einbetten deaktivieren).

Durch einen Klick auf den "Ok" Button wird die gewählte Einstellung gespeichert.

Zurück zum Seitenanfang

MyCode-Buttons

Wenn die Codebuttons zum Einfügen der MyCodes in den globalen Einstellungen aktiviert sind, werden diese unterhalb der Texteingabebox im Editor angezeigt.

Durch einen Klick auf den entsprechenden Button werden die MyCode Tags eingefügt (öffnender und schließender Tag gleichzeitig.)

Die Tags werden an der Stelle eingefügt, an der sich die Eingabemarke befindet oder aber, wenn Text ausgewählt ist, vor bzw. hinter dem markierten Bereich.

Zurück zum Seitenanfang

Modul-Erstellung

Hier ein paar Tipps für die Erstellung von eigenen Modulen:

• Ein Modul besteht aus eine PHP Datei, die sich im entsprechenden Ordner befinden muss. ("inc/plugins/automedia/mediasites/" oder "inc/plugins/automedia/special/")
• Das Modul kann nur aktiviert werden, wenn der Funktionsname den Namen des Moduls enthält.
• Beispiel für den Aufbau eines Moduls:
  
  Das Modul hat den Dateinamen: mein_modul.php
  Der Modulname ist hier: mein_modul
  Die Funktion des Moduls muss entsprechend benannt werden: automedia_mein_modul($message)
  
  Code:
  
  <?php
  //Datei darf nicht direkt aufgerufen werden
  if(!defined("IN_MYBB"))
  {
   die("Direct initialization of this file is not allowed.
   Please make sure IN_MYBB is defined.");
  }
  
  
  //Jetzt die Funktion:
  function automedia_mein_modul($message)
  {
   // Folgende Variablen werden für die Anzeigegröße der Videos benötigt:
   global $mybb, $width, $height;
  
   // Breite und Höhe festlegen, dabei aber die globalen Einstellungen beachten:
   $w = $width;
   $h = $height;
  
   // Die gewünschte URL erkennen
   if (preg_match('SUCHMUSTERisU',$message))
   {
   // Link durch den Embed-Code ersetzen. Nicht vergessen, den <div="am_embed"> Tag und die Variablen für Breite und Höhe zu benutzen!
   $message = preg_replace("#SUCHMUSTER#i", "<div class=\"am_embed\">EMBED-CODE width=$w heigth=$h</div>", $message);
   }
   return $message;
  }
  

Zurück zum Seitenanfang

Lizenz

Dieses Programm ist freie Software.

Sie können es unter den Bedingungen der GNU General Public License, wie von der Free Software Foundation veröffentlicht,

weitergeben und/oder modifizieren, entweder gemäß Version 3 der Lizenz oder (nach Ihrer Option) jeder späteren Version.

Die Veröffentlichung dieses Programms erfolgt in der Hoffnung, daß es Ihnen von Nutzen sein wird,

aber OHNE IRGENDEINE GARANTIE, sogar ohne die implizite Garantie der MARKTREIFE oder der VERWENDBARKEIT FÜR EINEN BESTIMMTEN ZWECK.

Details finden Sie in der GNU General Public License.

Sie sollten ein Exemplar der GNU General Public License zusammen mit diesem Programm erhalten haben.

Falls nicht, siehe <http://www.gnu.org/licenses/>.

Deutsche Übersetzung: http://www.gnu.de/documents/gpl.de.html

Zurück zum Seitenanfang

Zuletzt bearbeitet: 04.02.2015