Copy of Wie definiere ich eine Datenstruktur im Medienverzeichnis (MediaDir)?

Die Datenstruktur eines neuen Objekts wird in einem Formular definiert. Zur Erfassung eines neuen Formulars gehen Sie wie folgt vor:

Öffnen Sie die Verwaltung der Formulare in der Adminkonsole unter Anwendungen > Medienverzeichnis > Einstellungen > Formular Vorlagen
Betätigen Sie die Schaltfläche Neue Formular Vorlageund füllen Sie die Eingabemaske wie folgt aus:
1. Name Der Name des Formulars, resp. des Objektes, welches repräsentiert werden soll.
2. Beschreibung (optional) Eine Kurze Beschreibung zum abzubildenden Objekt.
3. Bild (optional) Wählen Sie ein gewünschtes Bild aus, welches zur Visualisierung des Formulars eingesetzt werden soll.
4. Parameter (cmd) Ein Keyword welches zur Identifikation des Formulars eingesetzt werden soll. Z.b. employee, site, product, etc. Der Parameter darf nur aus alphanumerischen Zeichen bestehen (keine Leerzeichen und keine Sonderzeichen).
5. Kategorien verwenden Legen Sie fest, ob die Einträge (Datensätze), welche Sie über dieses Formular (Datenstruktur) erfassen und verwalten werden, in Kategorien organisiert werden sollen.
6. Ebenen verwenden Legen Sie fest, ob die Einträge (Datensätze), welche Sie über dieses Formular (Datenstruktur) erfassen und verwalten werden, in Ebenen organisiert werden sollen.
7. Anzahl Einträge pro Seite Bestimmen Sie das Limit für die Pagination dieses Formulars.
Speichern Sie Ihre erfassten Daten durch Betätigung der Schaltfläche Speichern
Wechseln Sie nun zurück zur Auflistung der Formulare unter Anwendungen > Medienverzeichnis > Einstellungen > Formular Vorlagen
Öffnen Sie nun Ihr neu erfasstes Formular in der Bearbeitungsmaske, um mit der Definition der Datenstruktur zu beginnen:

Die Datenstruktur wird über Eingabefelder definiert. Jede Eigenschaft des abzubildenden Objekts wird über ein Eingabefeld definiert.
Durch betätigen der Schaltfläche neues Feld hinzufügen, wird ein neues Eingabefeld (Eigenschaft) dem Formular (Objekt) hinzugefügt:

Hinweis: Es kann einen Moment dauern, bis das neue Eingabefeld nach Betätigung der Schaltfläche erscheint.
Ein Eingabefeld kann wie folgt konfiguriert werden:
1. Feldname Der Feldname wird in der Erfassungs- und Bearbeitungsmaske eines Eintrages als Name/Label zum Feld angezeigt
2. Feldtyp Siehe Tabelle Formular-Feld-Typ
3. Anzeigen in Bestimmt, ob das Eingabefeld in der Erfassungs- und Bearbeitungsmaske eines Eintrages generell (Back- und Frontend) verfügbar ist, oder ob dieses nur in der Adminkonsole (nur Backend) oder in der Frontend-Erfassung/Bearbeitung (nur Frontend) verfügbar ist.
4. Standardwerte Abhängig vom gewählten Feldtyp hat dieses Feld eine andere Funktion bei der Erfassungs- und Bearbeitungsmaske eines Eintrages. Die Typ-spezifische Funktion entnehmen Sie aus der Tabelle Formular-Feld-Typ.
5. Infotext Kurzbeschreibung des Feldes als Hilfe bei der Erfassungs- und Bearbeitungsmaske eines Eintrages (Anzeige erfolgt über title-HTML-Attribute des jeweiligen Formular-Feld-Types)
6. Kontext Mit Hilfe des Kontexts wird einem Feld eine systemweite Funktion zugeteilt. Siehe dazu Tabelle Kontext-Typen
7. Validierung Auswahl einer Eingabevalidierung für die Erfassungs- und Bearbeitungsmaske eines Eintrages
8. Pflichtfeld Definition ob das Feld bei der Erfassungs- und Bearbeitungsmaske eines Eintrages zwingend ausgefüllt werden muss
9. Erw. Suche Definition, ob das Feld bei der Erweiterten Suche eingebunden werden soll. Siehe Spalte "HTML-Element Erweiterte Suche" in der Tabelle Formular-Feld-Typ
Bestätigen Sie Ihre definierte Datenstruktur durch betätigung der Schaltfläche Speichern

Das Hinzufügen und Entfernen von Eingabefeldern geschieht in Echtzeit. Wird ein Eingabefeld gelöscht, so wird dies unwiderruflich entfernt (ohne dass zudem noch die Schaltfläche Speichern betätigt werden muss) und kann nicht rückgängig gemacht werden. Im Gegensatz dazu muss die getätigte Konfiguration der Eingabefelder dann über die Schaltfläche Speichern gesichert werden.

Formular-Feld-Typen ¶

Feldtyp Beschreibung HTML-Element Bearbeitungsmaske HTML-Element Erweiterte Suche Funktion Standardwert Mehrspachigkeit

Textfeld Ein normales Eingabefeld input[type=text] input[type=text]

Vorgabewert bei Neuerfassung Ja

Textfeld mehrzeilig

Mehrzeiliges Eingabefeld

textarea input[type=text]

Vorgabewert bei Neuerfassung Ja

Auswahlmenu Dropdown-Menu select select Liste der Optionen separiert durch Komma Nein

Auswahlfelder Auswahl zwischen mehreren Optionen input[type=radio] (mehrere) select Liste der Optionen separiert durch Komma Nein

Kontrollkästchen

Auswahl einer oder mehreren Möglichkeiten input[type=checkbox] (mehrere) input[type=checkbox] (mehrere) Bezeichnung (Label) des Kontrollkästchen. Für eine Auswahl mehrerer Kontrollkästchen können mehrere Bezeichnungen komma-separiert hinterlegt werden. Nein

Dateiupload

Datei-Upload Funktion MediaBrowser-Upload-Feld - - Ja

Bilddatei

Bildauswahl MediaBrowser-Upload-Feld - - Ja

Klassifizierung

Bewertung/Ranking.

Siehe Konfiguration unter Anwendungen > Medienverzeichnis > Einstellungen > Klassifizierung HTML-Code HTML-Code Standard Bewertung/Ranking Nein

Link

Interne oder externe Verlinkung input[type=text]

Vorgabewert bei Neuerfassung Ja

Link Gruppe

Sammlung von internen und externen Verlinkungen input[type=text] (mehrere) - Vorgabewert bei Neuerfassung Ja

Google Map

Auswahl eines Standortes (Koordinaten)

Für die Benützung dieser Funktion wird eine entsprechende Lizenz von Google benötigt

Google Maps Karte - - Nein

Wysiwyg Editor

HTML-Editor WYSIWYG-Editor input[type=text] Vorgabewert bei Neuerfassung Ja

E-Mail

E-Mail Adresse input[type=text]

Vorgabewert bei Neuerfassung Ja

Google Wetter

Wetteranzeige zu einem Standort

Für die Benützung dieser Funktion wird eine entsprechende Lizenz von Google benötigt

HTML-Code - Vorgabewert (Standort) bei Neuerfassung Nein

Land

Länderauswahl (nur ein Land) select select Vorausgewähltes Land. Dazu muss die ID des gewünschten Landes hinterlegt werden. Nein

Wertebereich

Bereichsauswahl input[type=text] jQuery Range Slider Definition des Wertebereichs nach folgendem Schema:

min,max,step

Text

min: ontere Grenze

max: obere Grenze

step: Interwal/Schritte

Beispiel: 0,10,2

Erzeugt einen Wertebereich wie folgt: 0,2,4,6,8,10 Nein

Kontext-Typen ¶

Kontext Beschreibung

Titel Das ausgewählte Feld wird als Titel eines Eintrages genutzt. Zudem wird der Wert des ausgewählten Feldes für [[METATITLE]] genutzt (siehe Suchmaschinenoptimierung).

Inhalt Das ausgewählte Feld wird als Beschreibung eines Eintrages genutzt (z.B. bei Resultaten der globalen Volltextsuche). Zudem wird der Wert des ausgewählten Feldes für [[METADESC]] genutzt (siehe Suchmaschinenoptimierung).

Adresse Bei der Verknüpfung mit dem Veranstaltungskalender wird das Feld als Adresse genutzt.

PLZ Bei der Verknüpfung mit dem Veranstaltungskalender wird das Feld als PLZ genutzt.

Ort Bei der Verknüpfung mit dem Veranstaltungskalender wird das Feld als Ort genutzt.

Land Bei der Verknüpfung mit dem Veranstaltungskalender wird das Feld als Land genutzt.

Bild Der Wert des ausgewählten Feldes wird für [[METAIMAGE]] genutzt (siehe Suchmaschinenoptimierung).

Stichworte Der Wert des ausgewählten Feldes wird für [[METAKEYS]] genutzt (siehe Suchmaschinenoptimierung).

Slug Das ausgewählte Feld wird als URL-Slug (bei Verwendung von sprechenden URLs) verwendet.

Website Integration ¶

Die Daten der Medienverzeichnis Anwendung können einerseits über deren Anwendungsseiten auf der Website eingebunden werden. Andererseits können die Daten an beliebiger Stelle über Widgets eingebunden werden.

Zudem können die Daten in die globale Volltextsuche integriert werden.

Anwendungsseiten ¶

Die Integration der Medienverzeichnis Anwendung über deren Anwendungsseiten wird in zwei Arten unterteilt. Einerseits der Anzeige der Daten und andererseits deren Verwaltung.

Anzeige der Daten ¶

Die Anwendung stellt die folgenden Anwendungsseiten bereit, um die Daten auf der Website anzuzeigen:

Bereich Beschreibung Anwendungsvorlage

Ohne spezifikation eines Bereichs (leerer Wert) wird die Übersichtsseite der Anwendung angezeigt. Je nach Konfiguration erfolgt hier die Auflistung der neusten Einträge oder der erfassten Ebenen und Kategorien. Default.html

oder:

<ID1>

oder:

-<ID2> Für jede Kategorie und Ebene kann eine separate, spezifische Anwendungsseite angelegt werden. Ist die Verwendung von Ebenen aktiv, so wird über das Fragment <ID1> die ID einer Ebene spezifiziert und über <ID2> die ID einer Kategorie. Damit kann direkt die Auflistung von Einträgen gefiltert nach einer ausgewählten Ebene und Kategorie erzeugt werden. Um alle Einträge einer ausgewählten Ebene aufzulisten (also ohne zusätzliche Filterung einer spezifischen Kategorie), kann der Teil -<ID2> (inkl. Minuszeichen) einfach weg gelassen werden. Um andererseits alle Einträge einer ausgewählten Kategorie aufzulisten (ohne zusätzliche Filter einer Ebene), kann der Teil <ID1> weggelassen werden.

Ist die Verwendung von Ebenen deaktiviert, so wird lediglich das Fragment <ID1> genutzt, welches in diesem Fall für die Auswahl einer Kategorie genutzt werden kann.

Hinweis: Jede Auflistung von Einträgen kann zudem über funktionale Platzhalter weiters gefiltert oder in der Sortierreihenfolge geändert werden. Detailliertere Informationen sind direkt aus dem Platzhalterverzeichnis zu entnehmen.

<ID1>-<ID2>.html

<ID1>.html

-<ID2>.html

<FORM-CMD> Für jedes Formular kann eine separate, spezifische Anwendungsseite angelegt werden. <FORM-CMD> ist dabei durch den Wert Parameter (cmd) des gewünschten Formulars zu ersetzen.

Hinweis: Jede Auflistung von Einträgen kann zudem über funktionale Platzhalter weiters gefiltert oder in der Sortierreihenfolge geändert werden. Detailliertere Informationen sind direkt aus dem Platzhalterverzeichnis zu entnehmen.

<FORM-CMD>.html

Wichtig: Das erste Zeichen von Parameter (cmd) wird groß geschrieben. Beispiel bei Parameter (cmd) "team": Team.html

alphabetical Alphanumerisch sortierte Auflistung der Einträge, groupiert nach deren Anfangsbuchstabe. Dieser Bereich kann zur Erzeugung eines Index-Verzeichnisses genutzt werden. Alphabetical.html

latest

Auflistung der neusten Einträge

Latest.html

popular Auflistung der Einträge nach deren Beliebtheit Popular.html

map Anzeige der Einträge auf einer GoogleMaps-Karte Map.html

detail[<FORM-ID>] Detailansicht eines Eintrages. Mit der optionalen Ergänzung <FORM-ID> kann für jedes Formular eine separate, spezifische Detailansicht zur Anzeige dessen Einträgen definiert werden. <FORM-ID> ist dabei durch die ID des gewünschten Formulars zu ersetzen. Der Platzhalter zur Verlinkung eins Eintrages auf dessen Detailansicht ([[MEDIADIR_ENTRY_DETAIL_URL]]) verlinkt automatisch auf die Formular-spezifische-Detailansicht (sofern vorhanden) oder auf die allgemeine Detailansicht (ohne <FORM-ID>). Falls die allgemeine Detailansicht nicht existiert, so erfolgt die Verlinkung auf die Übersichtsseite der Anwendung oder auf eine spezifische Anwendungsseite einer zugewiesenen Kategorie/Ebene. Letzteres ist abhängig von jeweiligen Kontakt, in welchem ein Eintrag angezeigt wird. Detail[<FORM-ID>].html

Verwaltung der Daten ¶

Die folgenden Bereiche stehen zur Verwaltung der Medienverzeichnis Daten direkt auf der Website zur Verfügung:

Bereich Beschreibung Anwendungsvorlage

myentries Auflistung der eigenen Einträgen. Also Einträge, welche dem aktuell angemeldeten Benutzer gehören. Von dieser Seite kann z.B. auf die Bearbeitungsmaske eines Eintrages verlinkt werden oder auf dessen Löschformular. Myentries.html

add[<FORM-ID>] Maske zur Erfassung eines neuen Eintrages. Mit dem Fragment <FORM-ID> kann direkt die Erfassungsmaske eines ausgewählten Formulars angesprochen werden (<FORM-ID> ist dabei durch die ID des gewünschten Formulars zu ersetzen). Bei Verwendung der allgemeinen Erfassungsmaske (Anwendungsseite ohne <FORM-ID>) wird dem Benutzer zuerst eine Auswahl von möglichen Formularen (abhängig von den definierten Berechtigungen) aufgeführt. Add[<FORM-ID>].html

edit[<FORM-ID>] Bearbeitungsmaske eines ausgewählten Eintrages. Optional kann für jedes Formular eine separate, spezifische Anwendungsseite definiert werden Edit[<FORM-ID>].html

delete Anzeige des Formulars zum Löschen von Einträgen Eelete.html

Widgets ¶

Die Medienverzeichnis Anwendung stellt diverse Widgets bereit, um die Daten der Anwendung nahtlos in die Website integrieren zu können.

So kann z.B. die Breadcrumb-Navigation (bezogen auf die Anzeige der Daten) getrennt von den Anwendungsseiten an beliebiger Stelle im Webdesign Template platziert werden. Weiters kann ein gewählter Auszug der Daten (z.B. einer ausgewählten Kategorien) auf einer normalen Inhaltsseite oder im Webdesign Template integriert werden. Weitere Informationen zu den Möglichkeiten sind im Platzhaterverzeichnis zu finden.

Globale Volltextsuche ¶

Damit Einträge aus der Anwendung Medienverzeichnis bei den Suchresultaten der globalen Volltextsuche aufgeführt werden, muss eine Anwendungsseite im Content Manager folgende Bedingungen erfüllen:

Die Anwendungsseite muss der Anwendung MediaDir zugewiesen sein

Die Anwendungsseite muss als Bereicheiner der folgenden Werte gesetzt haben:

detail (→ allgemeine Detailansicht für Einträge)

detail<form-id> (→ Formular-spezifische Detailansicht für Einträge / <form-id> ist dabei durch die ID des jeweiligen Formulars zu ersetzten)

<form> (→ Formular-spezifische Übersichtsseite / <form> ist dabei durch den Parameter (cmd) des jeweiligen Formulars zu ersetzen)

<leer> (→ Übersichts- / Einstiegsseite der Anwendung / als Bereich wird nichts gesetzt)

Die Anwendungsseite muss publiziert (aktiv) sein

Die Anwendungssseite muss sichtbar sein, falls die Option Nur in sichtbaren Inhaltsseiten suchen (unter Administration > Grundeinstellungen > System > Website) gesetzt ist

Integration im Veranstaltungskalender ¶

Die in der Anwendung Medienverzeichnis erfassten Einträge können in der Anwendung Veranstaltungskalender als Veranstaltungsorte und/oder Veranstalter verwendet werden.

Sortierung ¶

Die erfassten Daten (Einträge, Kategorien und Ebenen) können an den jeweiligen Anwendungsfall entsprechend sortiert angezeigt werden.

Kategorien / Ebenen ¶

Die Auflistung der Kategorien und Ebenen kann entweder in alphanumerischer Reihenfolge oder nach individuell definierter Reihenfolge erfolgen. Die alphanumerische Reihenfolge kann zudem gruppiert (nach dem jeweiligen Anfangszeichen) angezeigt werden.

Dazu steht in der Adminkonsole unter Anwendungen > Medienverzeichnis > Einstellungen > Ebenen & Kategorien die Option Auflistungsansicht der Kategorien, resp. Auflistungsansicht der Ebenen zur Verfügung. Die Auswahlmöglichkeiten haben folgende Funktion

Option Beschreibung

Alphabetisch aufgelistet Die Kategorien, resp. Ebenen werden in alphanumerischer Reihenfolge aufgelistet.

Alphabetisch gruppiert Die Kategorien, resp. Ebenen werden gruppiert (Kategorien und Ebenen von einander aber getrennt) in alphanumerischer Reihenfolge aufgelistet. Alle Kategorien, resp. Ebenen welche den gleichen Anfangsbuchstaben teilen, werden als Gruppe aufgelistet. Alle Kategorien, resp. Ebene mit einen Anfangszeichen, dass nicht dem Alphabet entstammt (z.B. Sonderzeichen oder Nummern), werden am Anfang der Liste unter einem Hashtag (#) gruppiert angezeigt.

Hinweis: In der Adminkonsole erfolgt die Auflistung nicht gruppiert.

nach angegebener Reihenfolge Die Auflistung der Kategorien, resp. Ebenen erfolgt nach der individuell definierter Reihenfolge. Die Reihenfolge wird in der Adminkonsole im Bereich Anwendungen > Medienverzeichnis > Übersicht über die numerischen Eingabefelder bei der Auflistung der Kategorien, resp. Ebenen definiert. Die Auflistung erfolgt dabei in aufsteigender Reihenfolge.

Hinweis: Die Konfiguration gilt sowohl für die Website-Integration (Frontend), sowie für die Adminkonsole (Backend).

Einträge ¶

Die Auflistung der Einträge erfolgt abhängig vom jeweiligen Bereich in unterschiedlicher Reihenfolge.

Website-Integration (Frontend) ¶

Bereich Beschreibung

alphabetical Alphanumerische Reihenfolge.

latest Sortierung nach Zeitpunkt der Erfassung (aus Backend), resp. Bestätigung (aus Frontend). Neuster Eintrag zuerst.

popular Sortierung nach Beliebtheit (Anzahl Anzeigen auf der Website). Beliebtester Eintrag zuerst.

Bei allen anderen Bereichen erfolgt die Auflistung gemäß Option Einträge individuell sortieren. Ausnahmen sind Übersichtsbereiche, falls die Option Neuste Einträge bei der Übersicht auflisten (unter Administration > Medienverzeichnis > Einträge) aktiv ist - dann erfolgt die Auflistung nach dem Zeitpunkt der Erfassung (aus Backend), resp. deren Bestätigung (bei Frontend-Einsendungen).

Übersteuerung ¶

Die standardmäßige Sortierreihenfolge (gemäss Konfiguration) kann durch Platzierung einer der folgenden funktionalen Platzhalter in den jeweiligen Anwendungsvorlagen übersteuert werden:

Option Beschreibung

[[MEDIADIR_CONFIG_SORT_POPULAR]] Auflistung der Einträge sortiert nach Beliebtheit

[[MEDIADIR_CONFIG_SORT_ALPHABETICAL]] Alphabetische Auflistung der Einträge

[[MEDIADIR_CONFIG_LIST_LATEST]]

Auflistung der Einträge sortiert nach Neuigkeit

Adminkonsole (Backend) ¶

Bereich Beschreibung

Bestätigungsliste Sortiert nach Zeitpunkt der Einsendung/Erfassung. Ältester Eintrag zuerst.

Neuste Einträge Sortierung nach Zeitpunkt der Erfassung (aus Backend), resp. deren Bestätigung (bei Frontend-Einsendungen). Neuster Eintrag zuerst.

Einträge verwalten Auflistung gemäß Option Einträge individuell sortieren.

Konfiguration ¶

Für die standardmäßig zu verwendende Sortierreihenfolge bei der Auflistung der Einträge kann in der Adminkonsole unter Anwendungen > Medienverzeichnis > Einstellungen > Einträge über die Option Einträge individuell sortieren zwischen folgenden zwei Varianten ausgewählt werden:

Option Beschreibung

aktivieren Die Auflistung der Einträge erfolgt nach einer individuell definierten Reihenfolge. Die Reihenfolge wird in der Adminkonsole im Bereich Anwendungen > Medienverzeichnis > Einträge verwalten über die numerischen Eingabefelder bei der Auflistung der Einträge definiert. Die Auflistung erfolgt dabei in aufsteigender Reihenfolge.

deaktivieren Die Auflistung der Einträge erfolgt in alphanumerischer Reihenfolge.

Filterung ¶

Die Anzeige der Einträge kann dem jeweiligen Anwendungsfall entsprechend gefiltert werden.

Dazu kann mittels Platzierung von funktionalen Platzhaltern in den Anwendungsvorlagen die Anzeige nach Formular-Typ, Kategorie und Ebene gefiltert werden. Siehe Platzhalter-Dokumentation.

Suche ¶

Die Anwendung Medienverzeichnis bittet drei Arten von Suchmöglichkeiten an:

Normale Suche

Erweiterte Suche

Integration in Globale Volltextsuche

Normal ¶

Die normale Suchfunktion stellt eine einfache Keyword-basierte Suche dar. D.h. es werden Einträge gefunden, welche das eingegebene Keyword enthalten.

Die Integration des normalen Suchformulars ist in der Platzhalter-Dokumentation erläutert.

Erweitert ¶

Die erweiterte Suchfunktion erlaubt die Suche von Einträgen nach konkreten Kriterien (Filterung angewendet auf ausgewählte Formularfelder - siehe Dazu Option Erw. Suche bei der Formularfeld-Konfiguration).

Die Integration des erweiterten Suchformulars ist in der Platzhalter-Dokumentation erläutert.

E-Mail-Benachrichtigungen ¶

Die Anwendung Medienverzeichnis löst bei bestimmten Ereignissen (z.B. Erfassung eines Eintrages auf der Website) den Versand von E-Mail-Benachrichtigungen aus.

Die nachfolgende Tabelle zeigt die verschiedenen Ereignisse auf, bei welchen eine E-Mail-Benachrichtigungen ausgelöst wird. Zudem beschreibt die Auflistung, welcher E-Mail-Vorlage-Typ dazu verwendet wird und an welche Empfänger die E-Mail-Benachrichtigungen gesendet werden, nebst den bei jeder E-Mail-Vorlage bereits hinterlegten E-Mail-Adressen (gemäß Option zusätzliche Empfänger).

Ereignis E-Mail Vorlage Typ Empfänger

Bei Einreichung eines neuen Eintrages über die Website (Frontend), sofern die Option Neu eingetragene Einträge müssen bestätigt werden (unter Anwendungen > Medienverzeichnis > Einstellungen > Einträge) aktiviert ist. Neuer Eintrag hinzugefügt

Administrator der Website (gemäß Option E-Mail Adresse des Administrators von Administration > Grundeinstellungen > System > Kontaktinformationen)

Bei Einreichung eines neuen Eintrages über die Website (Frontend). Eintrag erfolgreich hinzugefügt