Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- player [14.09.2016 13:49] – lsotrug
+++ player [05.07.2017 18:50] – [Eigene Wordpress-Blogs] lsotrug
@@ Zeile 1: / Zeile 1: @@
-====== Madek-Player für Typo3 ======
+====== Madek-Player ======
-Der Madek-Typo3-Player ermöglicht die Einbindung von Bildern aus dem Medienarchiv der Künste in ZHdK-Typo3-Websites. Dieses Feature ist für alle Nutzerinnen und Nutzer mit einem gültigen ZHdK-Typo3-Account nutzbar.
+Die URL eines öffentlichen Medieneintrages ermöglicht neu die Einbettung von Bildern, Videos und Audios in Websites, Blogs und Messaging Apps. Zusätzlich werden die Metadaten Titel, Autorschaft und Rechteinhaber mitgeliefert.
-===== Der Player =====
+ZHdK Website Beispiele:
+https://preview-prod.zhdk.ch/3321 (benötigt Login)\\
+Messaging Apps Beispiele:
+https://blog.zhdk.ch/madektest/link-preview-collection/\\
+ZHdK Blog Beispiele: https://blog.zhdk.ch/madektest/
-Der Madek-Player ermöglicht die Einbettung und Darstellung von Bildern aus dem Medienarchiv in ZHdK-Websites. Es werden dabei Bilder eines spezifischen Sets aus dem Medienarchiv dargestellt.
+===== URL teilen =====
+Die URL zum Einbetten finden Sie unter dem "Teilen"-Button im kontextbezogenen Menü eines Medieneintrags. Wählen Sie aus zwischen der eindeutigen URL, wenn Sie explizit diesen Medieneintrag teilen wollen, und der sprechenden URL, wenn Sie wechselnde Inhalte anzeigen wollen.
-{{:madek-player.png|}}
+{{:madek_me_teilen.png?600|}}\\
+\\
+{{:madek_link_teilen.png?600|}}
-Das abgebildete Beispiel zeigt die Verwendung des Madek-Typo3-Players in der offiziellen ZHdK-Medienarchiv-Informationswebsite. [[http://www.zhdk.ch/index.php?id=12991]] Der Player verfügt über folgende Features:
+===== ZHdK Website auf Typo3 =====
-  * Vor- und Zurücklinks
+Für die richtige Implementierung und Darstellung des Players in Typo3 empfehlen wir folgendes Vorgehen:
-  * Slideshow-Modus (“Präsentation starten”)
-  * Anzeige von Metadaten (optional)
-  * Leiste mit Kleinbilder aller enthaltenen Medien
-Für die richtige Implementierung und Darstellung des Players bitte unbedingt nachfolgende Hinweise beachten.
+  - Erstellen Sie auf dem Overlay ein neues Inhaltselement an der gewünschten Stelle, indem Sie auf das "Content" Icon klicken {{:1_typo3.jpeg?600|}}
-===== Voraussetzungen und Darstellungsoptionen =====
+  - Wählen Sie im Tab „Content“ das Element „Video“ aus {{:2_typo3.png?300|}}
+  - Im Tab „General“ sollte das Feld „Header“ leer bleiben {{:3_typo3.png?300|}}
+  - Im Tab „Assets“ klicken Sie auf die Schaltfläche „Add file“ {{:4_typo3.jpeg?300|}}
+Nun öffnet sich die Ordnerstruktur Filelist. Wählen Sie dann den entsprechenden Ordner aus. Im Bereich „Add new media asset“ tragen Sie die gewünschte URL aus dem Medienarchiv (oder Vimeo/ Youtube) ein. Bestätigen Sie die Selektion mit einem Klick auf die Schaltfläche „Add media“.
-Der Madek-Typo3-Player referenziert auf ein von Ihnen ausgewähltes Set im Medienarchiv der Künste. Er zeigt die darin enthaltenen Bilder an – gegenwärtig keine Videos oder Dokumente. Die Zugriffsberechtigungen dieses Sets sowie die darin enthaltenen Bilder müssen zwingend auf “öffentlich” eingestellt ein. Es gilt zu beachten, dass lediglich die Bilder und keine Untersets des ausgewählten Sets im Player dargestellt werden. Der Madek-Player erlaubt zusätzlich ausgewählte Metadaten anzuzeigen und aus verschiedenen Darstellungoptionen zu wählen.
+{{:5_typo3.png|}}
-===== Erst ausprobieren, dann integrieren =====
+URL-Beispiel (Bitte beachten Sie dass sprechende Adressen nicht unterstützt werden):
-Testen Sie aus, wie Ihre eigenen Bilder im einem Player aussehen würden!
+{{:6_typo3.jpeg|}}
-Legen Sie öffentliche Bilder von sich selbst in dieses Set: http://medienarchiv.zhdk.ch/media_sets/67772 (nur für ZHdK-Mitglieder freigeschaltet)
+Der Link zum Video erscheint nun in der Liste:
-Sehen Sie das Ergebnis aus dieser Seite: www.zhdk.ch/madek-player-typo3
+ {{:7_typo3_hinweis.jpeg?600|}}
-Beachten Sie die Ladezeiten aufgrund des Cachings (siehe unten Punkt 4). Diese können Sie auf dem Test-Set leider nicht selbst beeinflussen.
+Setzen Sie nun das Häkchen und klicken Sie auf die Schaltfläche „import selection“, danach wird das Video hinzugefügt: {{:8_typo3.jpeg|}}
-===== Integration des Players im Typo3-Backend =====
-Diese Kurzanleitung ist für Nutzer mit einem gültigen ZHdK-Typo3-Account und einer Berechtigung zur Bearbeitung einer oder mehrerer ZHdK-Websites.
-==== 1. Madek-Player Plugin hinzufügen ====
-Der Madek-Player kann in allen Typo3-Inhaltsbereichen hinzugefügt werden. Hierfür muss beim Hinzufügen eines neuen Inhaltselements unter Plugins der “Madek Player” angewählt werden.
+Eine vollständige Anleitung zu Typo 3 finden Sie unter:
+https://intern.zhdk.ch/fileadmin/data_subsites/data_weboffice/ZHdK_Website_CMS-Dokumentation_22.06.2017_.pdf
-{{:madek_player_auswahl.png|}}
-==== 2. Gewünschtes Set auswählen ====
+===== ZHdK Blog auf Wordpress =====
-Der Player referenziert auf ein ausgewähltes Set, von welchem man die Set-ID angibt. Diese Set-ID kann man aus der URL des gewünschten Sets im Medienarchiv der Künste rauskopieren oder aber den praktischen “Madek Set Picker” benutzen. Dieser öffnet sich in einem Popup und erlaub die Stichwort-Suche nach dem gewünschten Set. Durch Anklicken des spezifischen Sets wird die Set-ID automatisch ergänzt.
+Unsere ZHdK Blogs (blog.zhdk.ch) erkennen automatisch die URLs des Medienarchivs.
-{{:madek-typo3-player-02.png|}}
+===== Eigene Wordpress-Blogs =====
+** Madek-Plugin "madek-oembed" **
-==== 3. Darstellungsoptionen wählen ====
+Bei selbst gehosteten Wordpress-Seiten ist es erforderlich das Madek-Plugin zu installieren. Das Plugin stuft dann die Webseite medienarchiv.zhdk.ch als vertrauenswürdigen Provider (Anbieter) ein.
-Unter dem Reiter “General” und “Formats” lassen sich anschliessend die weiteren Darstellungsoptionen des Players aktivieren/deaktivieren. Es kann gewählt werden, ob die Copyright-Informationen, Titel und Datum, Untertitel, Bildlegende und Autor angezeigt werden sollen. Unter “Formats” kann die Dimension des Players und die Anzahl der Thumbnails angegeben werden.
+** Vorgehen zur Installation **
-==== 4. Achtung: Ladezeiten ====
+Das Plugin „madek-oembed“ kann im Register "Plugins > hinzufügen" (im Wordpress Dashboard) ausgewählt, installiert und aktiviert werden.
-Da die Elemente des Madek-Players in einen Zwischenspeicher (Cache) geladen werden, kann es in folgender Situation zu Verzögerungen kommen: Wenn Sie die Inhalte des Sets, auf das der Madek-Player zugreift, verändern (Bilder hinzufügen oder entfernen), gibt es aufgrund des Cachings keine sofortige Abgleichung mit dem Player. Sollten Sie eine solche benötigen, dann löschen Sie im Typo3-Interface den Cache der Seite, die den Player enthält.
+Das Plugin kann auch direkt über die Entwickler-Plattform Github heruntergeladen werden:
+https://github.com/Madek/madek-wordpress-oembed-plugin
-{{:cache_leeren.png|}}
-==== Weitere Informationen ====
+Das nachfolgende Beispiel verwendet statt der automatischen oEmbed Variante (nur URL) die
+Wordpress-Syntax. Damit können Breite und Höhe konfiguriert werden.
+https://blog.zhdk.ch/madektest/2017/01/30/mini-video-beispiel/
+===== Technische Dokumentation =====
+Weitere Informationen finden Sie in der technischen Dokumentation:
+https://github.com/Madek/madek-documentation/blob/master/source/development/embeds.md
-Bei weiterführenden Fragen zum Madek-Typo3-Plugin wenden Sie sich bitte an den Support oder kontaktieren Sie direkt den technischen Verwantwortlichen.
-**Medienarchiv-Support**\\
-[[support.medienarchiv@zhdk.ch]]\\
-Telefon 043 43 446 21 60
-**ITZ-Typo3-Entwicklung**\\
-[[service.itz@zhdk.ch]]\\
-Telefon 043 446 21 21