Diese Anleitung ist in Arbeit und ist deshalb noch nicht vollständig.
Inhaltsverzeichnis
- Einleitung
- Medienverzeichnis Anwendung installieren
- Datenstruktur definieren
- Website Integration
- Glossar
Einleitung ¶
Das Medienverzeichnis stellt ein universeller Objektcontainer dar, mit welchem strukturierte Daten abgelegt und verwaltet werden können. Anders formuliert, ist das Medienverzeichnis ein einfaches Datenbanksystem, welches über eine grafische Oberfläche (GUI) konfiguriert und verwaltet werden kann.
Offene Datenstruktur ¶
Die Struktur der Daten kann frei definiert werden. So ist es möglich fast jegliche Art von Daten im Medienverzeichnis abzulegen. Mögliche Beispiele sind Mitarbeiter, Immobilien, Standorte, Produkte, Berichte, Inserate u.v.m.
Die Definition der Datenstruktur wird in einem sogenannten Formular abgelegt und kann über eine Eingabemaske in der Adminkonsole einfach konfiguriert werden. Die Erfassung und Verwaltung von Datensätzen (sogenannte Einträge), in der definierten Datenstruktur, erfolgt auch über eine Eingabemaske in der Adminkonsole. Letzteres kann zudem in der Website-Ansicht (Frontend) auch für Besucher (anonym oder autorisiert) bereit gestellt werden.
Universell Einsetzbar ¶
Das Medienverzeichnis erlaubt nicht nur die Definition einer einzigen Datenstruktur (z.B. Mitarbeitern oder Standorte), sondern mehreren parallel. So kann die Anwendung Medienverzeichnis mehrfach auf einer Website eingesetzt werden, um unterschiedliche Daten zu präsentieren, wie z.B. mit einem Mitarbeiterverzeichnis, einer Google Maps-Karte mit den Firmenstandorten und einem kategorisierten Produktkatalog, welcher nach ausgewählten Kriterien gefiltert werden kann.
Datenorganisation ¶
Die Organisation (Ablage) der erfassten Datensätze (Einträge genannt) erfolgt in zwei Dimensionen. Einerseits in Kategorien und andererseits in Ebenen.
Die primäre Organisation der Einträge erfolgt über die Kategorien. Jeder Eintrag kann keiner, einer oder mehreren Kategorien zugewiesen werden.
Sekundär können die Einträge in Ebenen eingeteilt werden. Auch hier kann jeder Eintrag keiner, einer oder mehreren Ebenen zugeteilt werden.
Die Struktur der Kategorien und Ebenen kann auf mehrere Hierarchiestufen festgelegt werden.
Der Unterschied zwischen Kategorien und Ebenen besteht daran, dass bei der Auflistung auf der Website (Frontend) jede Ebene jeweils alle Kategorien enthält. Im Gegensatz dazu, enthält eine Kategorie keine Ebenen. Sobald der Besucher also in einem eingerichteten Verzeichnis in eine Kategorie navigiert, so werden von diesem Schritt an keine Ebenen im Verzeichnis mehr aufgeführt.
Strukturell kann dies wie folgt visualisiert werden. Angenommen in der Medienverzeichnis Anwendung sind die folgenden Ebenen und Kategorien definiert:
Ebenen
- Ebene A
- Ebene B
- Ebene C
Kategorien
- Kategorie 1
- Kategorie 2
- Kategorie 3
- Kategorie 4
Die darausfolgende Verzeichnisstruktur sieht wie folg aus:
- Ebene A
- Kategorie 1
- Kategorie 2
- Kategorie 3
- Kategorie 4
- Ebene B
- Kategorie 1
- Kategorie 2
- Kategorie 3
- Kategorie 4
- Ebene C
- Kategorie 1
- Kategorie 2
- Kategorie 3
- Kategorie 4
Auf der Website (Frontend) kann zudem nur ein ausgewählter Ausschnitt der Verzeichnisstruktur angezeigt werden. So kann z.B. die Ebene A zur Organisation von Mitarbeiter und Standorte eingesetzt werden und die Ebene B zur Organisation der Produkte.
Medienverzeichnis Anwendung installieren ¶
Bevor die Medienverzeichnis Anwendung eingesetzt werden kann, muss diese installiert werden.
Installieren Sie die Medienverzeichnis Anwendung gemäß Artikel Wie aktiviere/installiere ich eine Anwendung?.
Datenstruktur definieren ¶
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:
Option Beschreibung Name Der Name des Formulars, resp. des Objektes, welches repräsentiert werden soll. Beschreibung (optional) Eine Kurze Beschreibung zum abzubildenden Objekt. Bild (optional) Wählen Sie ein gewünschtes Bild aus, welches zur Visualisierung des Formulars eingesetzt werden soll. 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).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. 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. 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.
Wichtig: 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.
- Ein Eingabefeld kann wie folgt konfiguriert werden:
Option Beschreibung Feldname Der Feldname wird in der Erfassungs- und Bearbeitungsmaske eines Eintrages als Name/Label zum Feld angezeigt Feldtyp Siehe Tabelle Formular-Feld-Typ 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. 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. Infotext Kurzbeschreibung des Feldes als Hilfe bei der Erfassungs- und Bearbeitungsmaske eines Eintrages (Anzeige erfolgt über title-HTML-Attribute des jeweiligen Formular-Feld-Types) Kontext Mit Hilfe des Kontexts wird einem Feld eine systemweite Funktion zugeteilt. Siehe dazu Tabelle Kontext-Typen Validierung Auswahl einer Eingabevalidierung für die Erfassungs- und Bearbeitungsmaske eines Eintrages Pflichtfeld Definition ob das Feld bei der Erfassungs- und Bearbeitungsmaske eines Eintrages zwingend ausgefüllt werden muss 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
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 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 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ählt Feld wird als Titel eines Eintrages genutzt. Zudem wird der Wert Der Wert des ausgewählten Feldes wird für [[METATITLE]] genutzt |
| Inhalt | Das ausgewählt Feld wird als Beschreibung eines Eintrages genutzt (z.B. bei Resultaten der globalen Volltextsuche). Zudem wird der Wert Der Wert des ausgewählten Feldes wird für [[METADESC]] genutzt |
| 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 |
| Stichworte | Der Wert des ausgewählten Feldes wird für [[METAKEYS]] genutzt |
| 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 |
|---|---|
| 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. | |
| <ID1>-<ID2> <ID1> -<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. |
| <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. |
| alphabetical | Alphanumerisch sortierte Auflistung der Einträge, groupiert nach deren Anfangsbuchstabe. Dieser Bereich kann zur Erzeugung eines Index-Verzeichnisses genutzt werden. |
| latest | Auflistung der neusten Einträge |
| popular | Auflistung der Einträge nach deren Beliebtheit |
| map | Anzeige der Einträge auf einer GoogleMaps-Karte |
| 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. |
Verwaltung der Daten ¶
Die folgenden Bereiche stehen zur Verwaltung der Medienverzeichnis Daten direkt auf der Website zur Verfügung:
| Bereich | Beschreibung |
|---|---|
| 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. |
| 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. |
| edit[<FORM-ID>] | Bearbeitungsmaske eines ausgewählten Eintrages. Optional kann für jedes Formular eine separate, spezifische Anwendungsseite definiert werden |
| delete | Anzeige des Formulars zum Löschen von Einträgen |
Widgets ¶
Die Medienverzeichnis Anwendung stellt diverse Widgets bereit, um die Daten der Anwendung natlos 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) gesetz ist
Glossar ¶
| Begriff | Erläuterung |
|---|---|
| Eintrag | Ein erfasster Datensatz/Objekt im Medienverzeichnis. |
| Formular | Definiert die Datenstruktur eines Eintrages |
| Kategorie | Hierarchisches Element zur Organisation der Einträge |
| Ebene | Hierarchisches Element zur Organisation der Einträge und Kategorien |