Content Plugin - Visforms Daten
Hinweis: Diese Feature sind Teil der Visforms Subscription und in der freien Visforms Version nicht enthalten.
Neue Anwendungsbereiche für Formulare erfordern mehr Flexibilität bei der Darstellung von Daten
Visforms bietet Ihnen die Möglichkeit die Eingaben, die die Benutzer Ihrer Webseite mit dem Formular übermitteln, zu speichern. Diese gespeicherten Daten können mit Hilfe eines Menüs in Ihrer Webseite angezeigt werden.
Visforms hat sich im Laufe der Zeit hinsichtlich seines Funktionsumfangs und hinsichtlich seiner Flexibilität kontinuierlich weiterentwickelt. Mittlerweile gibt es sehr viele unterschiedliche Anwendungsbereiche in denen Visforms Formulare verwendet werden können. Je nach Anwendungsbereich des Formulars werden nun auch andere Möglichkeiten benötigt, Formulardaten anzuzeigen.
Besonders interessant ist es:
- Übermittelte Daten in Beiträgen oder Modulen anzeigen.
- Nur Datensätze anzeigen, bei denen eine oder mehrere Benutzereingaben einen bestimmten Wert haben.
- Die Anzahl der angezeigten Datensätze begrenzen, etwa nur die 5 neuesten Datensätze anzeigen.
- Nur eigene Datensätze des aktuell angemeldeten Benutzers anzeigen.
Was sind Plugins und wie funktionieren sie?
Joomla unterstützt die Verwendung von sogenannten Plugins. Das sind kleinere Programme, die an unterschiedlichsten Stellen in den Code eingreifen und dort irgendwelche speziellen Aufgaben ausführen können. Die “Verschleierung” einer E-Mail-Adresse in einem Text, sodass sie von Spambots nicht mehr gefunden werden kann, ist etwa eine typische Aufgabe, die von einem Plugin erledigt wird. Eine andere Plugin-Aufgabe ist es, bei mehrsprachigen Webseiten das Wechseln zwischen den Sprachen zu regeln.
Content Plugins können den Inhalt von Beiträgen und von Modulen des “Eigenes HTML”-Typs nachträglich verändern
Module des “Eigenes HTML”-Typs sind für die Darstellung von Inhalten in einer Modulposition dasselbe, was Beiträge für die Darstellung von Inhalt im Contentbereich der Webseite sind. Man kann beliebigen eigenen HTML Inhalt als freien Text in das Modul eingeben und in einer Modulposition anzeigen. Es wäre wirklich zu langatmig, in dieser Dokumentation immer explizit von Beiträgen und Modulen vom Typ “Eigenes HTML” zu sprechen.
Hinweis:
Daher werden Beiträge und Module des "Eigenes HTML"-Typs im Weiteren unter dem handlichen Sammel-Begriff "Beiträge" zusammengefasst.
Das hier Gesagte gilt also immer auch für das Modul.
Es gibt unterschiedliche Plugin-Typen und ein Typ davon sind sogenannte “Content Plugins”. “Content Plugins” können den Inhalt von Beiträgen nachträglich verändern.
Dies kann man verwenden, um in einem Beitrag das Folgende auszuführen:
- Nach einer definierten Zeichenkette suchen, der sogenannten Plugin-Zeichenkette.
- Die gefundene Plugin-Zeichenkette aus dem Beitrag herausschneiden.
- An der Fund-Stelle etwas ganz anderes einzufügen.
Ein Beispiel dazu ist die Plugin-Zeichenkette {loadposition bottom}. Alle aktiven Module mit der Modulposition “bottom” werden dadurch an genau der Stelle angezeigt, an der diese Plugin-Zeichenkette steht.
Hierbei kann man als Entwickler selbst definieren, wie die Plugin-Zeichenkette im Beitrag aussehen soll. Deshalb kann man sehr einfach zusätzliche Informationen in die Plugin-Zeichenkette hineinpacken. Über die Plugin-Zeichenkette können so dem Plugin beliebige Parameter übergeben werden. Der Plugin-Code wertet die Parameter aus und wird auf diese Weise gesteuert.
Unsere Visforms Plugins vom Typ “Content Plugins” verwenden diese Plugin-Zeichenkette Ersetzungs-Technik. Damit wird es etwa möglich, ein Formular oder die Formular-Daten in einem Beitrag anzuzeigen und gleichzeitig das Aussehen des Formulars oder der Daten zu steuern.
Ein Vorteil bei der Verwendung von Plugins in Verbindung mit einer Plugin-Zeichenkette ist, dass man alle notwendigen Informationen sehr einfach und handlich übergeben kann. Die konkrete Ausgestaltung der Plugin-Zeichenkette bedeutet also die direkte Übergabe von Steuerparametern an das Plugin. Es wird flexibel gesteuert, wie das Eingefügte für exakt diese Stelle aussehen soll. Das Einfügen einer kurzen Plugin-Zeichenkette in einen Beitrag ist zudem wirklich einfach und macht wenig Arbeit.
Ein kleiner Nachteil ist, dass der Anwender genau wissen muss, wie die Plugin-Zeichenkette auszusehen hat. Denn wenn die Plugin-Zeichenkette, die Sie einfügen, nicht genau so aufgebaut ist, wie es der Plugin-Code erwartet, dann funktioniert das Plugin an dieser Stelle nicht. Sie müssen das Konzept verstanden haben und die Dokumentation aufmerksam lesen. Nur so können Sie herausfinden, wie die Plugin-Zeichenkette genau auszusehen hat, damit das Plugin auch das tut, was Sie wollen.
Was bedeutet das konkret?
Um Ihnen dieses Konzept etwas anschaulicher zu machen, hier ein paar Beispiele, wie eine Plugin-Zeichenkette aussehen kann und was sie bewirkt. Die Beispiele verwenden die Daten aus unserem Demo-Meldeformular für eine Sportveranstaltung, das die Formular-ID 7 hat.
Beispiel 1: Vollständige Meldeliste
Die folgende Plugin-Zeichenkette wird ersetzt mit den Daten in Tabellenform aus den Feldern mit der ID 89, 90, 91, 92 und 93 aus dem Formular mit der ID 7. Für die Datensätze wird eine eigene Pagination angezeigt, die 5 Datensätze pro Seite zeigt.
{vfdataview}{"formid":"7","fieldlist":"89,90,91,92,93","display_num":"5"}{/vfdataview}
Beispiel 2: Neueste Meldung
Mit der folgenden Plugin-Zeichenkette werden nur die Daten des jüngsten Datensatzes aus dem Formular mit der ID 7 angezeigt. Die Darstellung erfolgt als Detailliste mit nur den relevanten Daten, die in den Feldern mit der ID 89, 90, 91, 92 und 93 stehen.
{vfdataview}{"formid":"7","count":"1","sortorder":"created","sortdirection":"desc","layout":"list","fieldlist":"89,90,91,92,93"}{/vfdataview}
- Vorname
- Karl
- Nachname
- Clausen
- Jahrgang
- 2000
- Geschlecht
- Männlich
- Laufstrecke
- 10 Kilometer
Beispiel 3: Teilnehmerinnen des 10 Kilometerlaufs
Mit der folgenden Plugin-Zeichenkette werden nur Datensätze der weiblichen Teilnehmer angezeigt, die eine Laufstrecke von 10 Kilometern gewählt haben. Das sind Datensätze, die im Feld mit ID 92 den Wert “w” stehen haben und im Feld mit der ID 93 den Wert “10 Kilometer”. Angezeigt werden Vorname und Nachname, welche in den beiden Feldern mit der ID 89 und der ID 90 stehen.
{vfdataview}{"formid":"7","fieldselect":{"92":"w","93":"10 Kilometer"},"fieldlist":"89,90"}{/vfdataview}
Große Anzahl unterschiedlicher Parameter
Das Content Plugin - Visforms Daten wertet eine große Anzahl unterschiedlicher Parameter aus, mit der sich fast jede Darstellung von Formulardaten realisieren lässt. Eine vollständige Liste der Parameter findet sich hier: Liste der Plugin-Parameter.