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.