Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

--- cms:manual:modul:rss [2016/03/23 11:10] – sr
+++ cms:manual:modul:rss [2016/05/27 11:43] (aktuell) – [Abbrechen (10)] sr
@@ Zeile 1: / Zeile 1: @@
-====== Autoplay Modul ======
+======RSS Modul======
-Das Autoplaymodul ermöglicht es Ihnen, hochgeladenen Dateien automatisch nach bestimmten Kriterien zu Playlisten zuzuordnen. Das Autoplaymodul stellt hierbei ein Playlistenelement dar, das wie eine hochgeladene Datei in eine Playliste eingefügt werden kann und als Platzhalter für andere Inhalte steht. Diese Inhalte werden mithilfe von sog. Autoplay-Konfigurationen ausgewählt und zu festgelegten Zeitpunkten wird geprüft, ob eine andere Datei für den Platzhalter eingefügt werden muss.
+Mithilfe des RSS-Moduls können Sie RSS-Feeds in ihren Playlisten verwenden und auf dem CMAIR-Playern wiedergeben. RSS Feeds werden stets als Lauftext mit Laufrichtung von rechts nach links dargestellt.
-\\
+=====Modul konfigurieren=====
+Der folgende Screenshot zeigt eine Übersicht des Konfigurationsbildschirms für das RSS-Modul.
-===== Übersicht =====
+<WRAP center round box 60%>
-{{ :cms:manual:modul:autoplay-overview.png |}}
+{{ :cms:manual:modul:module-rss-overview.png |}}
+</WRAP>
-Die Bildschirmmaske zum Verwalten eines Autoplaymoduls teilt sich in zwei Bereiche auf:
+====Name (1)====
-  * **(I)** - Liste aller Konfigurationen des Autoplaymoduls
+Das Eingabefeld ermöglicht ihnen, den RSS-Modul einen Namen zuzuweisen. Dieser Name wird verwendet, um das gerade konfigurierte RSS-Modul in der [[cms:manual:modul#moduluebersicht|Modulübersicht]] und dem [[cms:manual:playlist#playlisten-editor|Playlisteneditor]] zu identifizieren.
-  * **(II)** - Darstellung der Details derjenigen Konfiguration, die in Anzeigebereich **(I)** ausgewählt ist.
+====URL (2)====
+Hier können Sie die Datenquelle für ihren Feed bestimmen. Hier geben Sie die (Web-)Adresse des Feeds an, den Sie in ihren Playlisten wiedergeben wollen.
-===== Konfigurationen =====
+====Anzeigestil (3)====
-Ein Autoplaymodul besteht aus einer oder mehreren Konfigurationen. Diese bestimmen, **wann** das Modul für **welche** Dateien prüft, ob sie eingefügt werden sollen. Außerdem wird festgelegt, welche Datei gewählt wird, falls keine passende Datei gefunden werden kann. Die Konfigurationen werden in zwei Kategorien eingeordnet: grundlegend oder playerspezifisch. Bei der Erstellung eines Autoplaymoduls muss immer zuerst eine grundlegende Konfiguration erstellt werden, welche untrennbar mit dem Modul verbunden ist. Zusätzlich haben Sie die Möglichkeit, für jeweils einen Player genau __eine__ spezifische Konfiguration anzulegen.
+Momentan stehen Zwei Anzeigemodi zur Verfügung:
-\\
+  * einzeln
-==== Aufbau ====
+  * fortlaufend
-Alle Konfigurationen setzen sich aus den folgenden Informationen zusammen
-=== Ausdruck (4) ===
+===Einzeln===
-Dies ist ein [[https://de.wikipedia.org/wiki/Regul%C3%A4rer_Ausdruck|regulärer Ausdruck]] **(4)**, der bestimmt, welche Dateien für eine Zuordnung in frage kommen. Dies ist eine Art Schablone, die entweder auf den Namen einer Datei passt, oder nicht. Falls der reguläre Ausdruck auf einen Dateinamen passt, so wird diese Datei in die engere Auswahl aufgenommen. Kommen mehrere Dateien in frage, so wird immer die Datei mit dem jüngsten Upload-Datum gewählt. \\ \\
+Der Anzeigestil "einzeln" stellt einen Spezialfall des Anzeigestils "fortlaufend" dar. Hier wird ein einzelner Eintrag des Feeds in langsamer Geschwidigkeit dargestellt. Bei Auswahl dieser Option werden die Eingabeelemente (4) - (6) deaktiviert.
-**__Beispiel:__** Das im Screenshot dargestellte Beispiel **(4)** zeigt einen regulären Ausdrucks, der auf alle Dateien, die den Namen "dateiname.jpg" tragen, zutrifft. In diesem Fall würden alle Dateien, die den Namen "dateiname.jpg" tragen in der Auswahl landen, die in Betracht kommen um für das Autoplaymodul in einer Playliste eingesetzt zu werden. Da letztendlich aber __genau **eine**__ Datei gewählt werden muss, wird von allen in Betracht kommenden Dateien genau diese gewählt, die als letztes hochgeladen wurde.
-=== Ordner (5) / (6) ===
+===Fortlaufend===
-Wählen Sie hier einen ihrer Ordner **(5)**, um die Auswahl an Dateien einzuschränken, die mithilfe des regulären Ausdrucks **(4)** auf Eignung geprüft werden. Aktivieren Sie die Checkbox **(6)**, um zu bestimmen, dass Unterordner ihres gewählten Ordners ebenfalls durchsucht werden sollen. Andernfalls wird nur der von ihnen gewählte Ordner durchsucht.
+Im Anzeigestil "fortlaufend" wird eine von Ihnen wählbare Anzahl an Einträgen (4) des Feeds, jeweils getrennt durch ein Trennzeichen (5) mit einer bestimmten Geschwindigkeit (6) dargestellt.
-=== Anzeigedauer (7) ===
+====Maximale Nachrichten (4)====
-Diese Angabe ist analog zum Punkt [[cms:manual:playlist#playlisten-details|Anzeigedauer (4)]] des Editors für Playlisten Details aufzufassen. Sie findet Anwendung, falls das einzufügende Element keine eigene Abspieldauer besitzt (wie etwa Bilder, PDFs, ..)
+Hiermit können Sie die Anzahl der Einträge des Feeds bestimmen, die nacheinander wiedergegeben werden sollen.
+====Geschwindigkeit (5)====
+Dies bestimmt die Geschwidigkeit, mit der der Lauftext von rechts nach links über den Bildschirm wandert.
-=== Standarddatei (8) ===
+====Trennzeichen (6)====
-Diese Datei wird vom System in eine Playliste eingefügt, falls der regulären Ausdrucks **(4)** auf keine Datei aus dem Ordner **(5)** passt oder aus sonstigen Gründen keine Auswahl getroffen werden kann.
+Bestimmt die Zeichenkette, die zur Trennung der einzelnen Feed-Einträge voneinander verwendet werden soll.
-=== Aktualisierungszeitpunkt (9) - (13) ===
+====Hintergrundbild (7)====
-Der Aktualisierungszeitpunkt bestimmt, wann / wie oft das System prüft, ob neue Inhalte in die Playlisten eingefügt werden müssen. Falls Sie hier keine Auswahl treffen, so wird eine Aktualisierung automatisch vorgenommen, sobald Sie eine am gesamten Prozess beteiligte Komponente ändern. Dies kann bspw. eine neu hochgeladene Datei sein, eine Änderung an einer Autoplaykonfiguration oder auch die Umbenennung einer Datei.
+Hiermit können Sie bestimmen, was im Hintergrund des Feeds dargestellt werden soll. Sie können Bilder sowohl als auch Videos verwenden.
-  * Aktivieren Sie die Checkbox **"Aktualisierungzeitpunkt festlegen"(9)**, so werden die Bedienelemente **(10)** - **(13)** sichtbar.
-  * Bei der Wiederholungsfrequenz **(10)** haben Sie die Möglichkeit zwischen "stündlich", "täglich" & "wöchentlich" zu wählen.
-  * Die Bedienelemente **(11)** & **(12)** werden aktiviert, sobald sie "täglich" (Uhrzeit) bzw. "wöchentlich" (Tag der Woche) in der Wiederholungsfrequenz gewählt haben.
-  * Falls der Aktualisierungszeitpunkt in Bezug auf eine anderen Zeitzone als CET (GMT+1) interpretiert werden soll, können Sie hier die Zeitzone wählen.
-==== Grundlegende Konfiguration ====
-Eine grundlegende Konfiguration legt das Basisverhalten des Autoplaymoduls fest. Im Gegensatz zu den playerspezifischen Konfigurationen ist beim Erstellen derselbigen keine Angabe eines Players erforderlich. Die grundlegende Konfiguration findet bei allen Playern Verwendung, für die keine spezielle Konfiguration angelegt wurde (die aber trotzdem eine mit dem vorliegenden Autoplaymodul bestückte Playliste wiedergeben).
-==== Spezifische Konfiguration ====
-Eine spezifische Konfiguration wird immer für einen einzelnen Player angelegt. Gibt ein Player eine Playliste wieder, die mit dem vorliegenden Autoplaymodul bestückt ist, und existiert für diesen Player eine spezifische Konfiguration, so wir diese spezielle Konfiguration genutzt um die Inhalte für diesen Player auszuwählen. Das Konzept der playerspezifischen Konfigurationen ermöglicht es, eine Playliste auf verschiedenen Playern wiederzugeben und in Abhängigkeit des Players bestimmte Inhalte zu platzieren.
-===== Verwaltung =====
+====Schriftfarbe (8)====
+Dies bestimmt die Farbe, in der der Lauftext dargestellt werden soll. Klicken Sie auf den weißen Bereich, woraufhin sich ein Dialogfenster öffnet, in dem Sie die Farbe mithilfe eines Colorpickers auswählen können.
-==== Konfiguration erstellen ====
+====Höhenfaktor (9)====
-Wenn Sie eine neue (spezielle) Konfiguration erstellen möchten, können Sie diesen Vorgang über einen Klick auf die Schaltfläche **"Neu" (1)** in Anzeigebereich **(I)** starten. Ein Dialog erscheint, in dem Sie den Player wählen können, für den die spezielle Konfiguration bestimmt ist. Bestätigen Sie ihre Auswahl über einen Klick auf **"Auswählen"** oder brechen Sie den Vorgang über **"Abbrechen"** ab. Nun wird die Eingabemaske des Anzeigebereichs **(II)** angezeigt. Nehmen Sie die Einstellungen vor und speichern Sie diese mittels eines Klicks auf **"Speichern" (15)**. Falls Sie die Konfiguration verwerfen wollen, so können Sie dies über einen Klick auf den Button **"Verwerfen" (14)** erreichen.
+Der Höhenfaktor wird zum Berechnen der Schrifthöhe herangezogen. Er bezieht sich auf die vefügbare Höhe des Viewports, der den Feed wiedergibt. D.h. wenn Sie einen Viewport der Höhe 100px benutzen, um ihren Feed anzuzeigen und beim Höhenfaktor 0.75 (Standardwert) ausgewählt haben, werden die Buchstaben des Feeds mit maximal 75px dargestellt.
-==== Konfiguration bearbeiten ====
+====Abbrechen (10)====
-Um eine Konfiguration des Moduls zu bearbeiten, wählen Sie in Anzeigebereich **(I)** den entsprechenden Eintrag aus. Für die grundlegende Konfiguration wäre das **"Grundlage" a)**, für die spezifische Konfiguration eines Players der Eintrag mit dessen Seriennummer (hier 0803-000).  In Anzeigebereich **(II)** werden nun die gespeicherten Einstellungen der gewählten Konfiguration angezeigt. Bearbeiten Sie die Einstellungen nach ihren Vorstellungen und speichern Sie die vorgenommenen Änderungen mit einem Klick auf den Button **"Speichern" (15)**. Falls Sie die Änderungen verwerfen wollen, so klicken Sie auf **"Verwerfen" (14)**.
+Um etwaige Änderungen zu verwerfen und zur [[cms:manual:modul#moduluebersicht|Modulübersicht]] zurückzukehren, klicken Sie auf die Schaltfläche "**Abbrechen**" (10).
-==== Konfiguration löschen ====
+====Speichern (11)====
-Um eine Konfiguration des Moduls zu löschen, wählen Sie zunächst in Anzeigebereich **(I)** den entsprechenden Eintrag aus. Klicken Sie nun auf die Schaltfläche **"Löschen" (2)**. Ein Dialog erscheint, in dem Sie die Löschung mittels eines Klicks auf **Ja** bestätigen oder über einen Klick auf **Nein** abbrechen können.
+Um vorgenommene Änderungen zu speichern klicken Sie auf die Schaltfläche "**Speichern**" (11).
-===== Beispiel-Workflow =====
+=====Modul verwenden=====
-Um ihnen den Einstieg in die Verwendung des Autoplaymoduls zu erleichtern, haben wir in den [[cms:manual:workflows|Beispiel-Workflows]] das [[|typische Vorgehen]] bei der Einrichtung dokumentiert.
+Die Verwendung des RSS-Moduls läuft exakt wie die [[cms:manual:workflows:setup_autoplay#schritt_3autoplaymodul_verwenden|Verwendung des Autoplay-Moduls]] ab:
+  * Voraussetzung ist ein konfiguriertes RSS-Modul
+  * Gehen Sie nun im Playlisteneditor auf die Seite zur Bestimmung der Elementreihenfolge
+  * Klappen Sie im Bereich über der Dateiauswahl den Menüpunkt "**Module**" aus
+  * Nun sehen Sie das von ihnen konfigurierte RSS-Modul mit dem Namen, den Sie vergeben haben
+  * Ziehen Sie das RSS-Modul nun wie eine reguläre Datei in die Playliste
+  * Abschließend müssen Sie die Playliste noch dem Viewport zuweisen, auf dem der Feed wiedergegeben werden soll
+  * **Fertig**