Joomla 5 Mitteilung

Wir freuen uns mitteilen zu können, dass seit dem 29. Januar 2024 alle unsere Joomla Erweiterungen mit Joomla 5 kompatible sind.

Für alle die gerade noch von Joomla 3 auf 4 aktualisieren: Anleitungen für die Joomla 4 Migration gibt es hier:

Es gibt nun auch eine eigenständige Dokumentation für Visforms für Joomla 4 und für Visforms auf Joomla 5

Achtung: Dies ist die Dokumentation für Joomla 3

Wir empfehlen die Nutzung der Dokumenation für Joomla 5

Sie ist aktueller und umfangreicher. Das meiste darin gilt rückwirkend auch für Joomla 3.

Bedingte Anzeige von Feldern im Formulare

Bedingte Anzeige von Feldern heißt, dass z.B. Feld "A" im Formular nur angezeigt, wenn der Benutzer für Feld "B" einen bestimmten Wert gewählt hat. D.h. es sind mindestens immer 2 Felder an der "Bedingten Anzeige" beteiligt. Das regelnde Feld (in unserem Beispiel B) und das geregelte Feld (in unserem Beispiel A).

Welche Feldtypen können als regelnde Felder verwendet werden?

Listboxen, Radiobutton, Checkbox Gruppen und Checkboxen, können als regelnde Felder verwendet werden.

Welche Feldtypen können als geregelte Felder verwendet werden?

Alle Feldtypen außer den Formular-Buttons können als geregelte Felder verwendet werden.

Die Konfiguration

  • Legen Sie mindestens ein Feld vom Typ Listbox, Radiobutton, Checkbox Gruppe oder Checkbox an, das Sie als regelndes Feld verwenden wollen.
  • Legen Sie ein weiteres Feld an, das Sie als geregeltes Feld mit bedingter Anzeige verwenden wollen.
  • Speichern Sie dieses zweite Feld.
  • Klicken Sie in das Eingabefeld der Option "Bedingte Anzeige". Sie sehen nun alle Optionen, die Sie im regelnden Feld angelegt haben in dieser Auswahlliste.
  • Wählen die Sie die Option, die auslösen soll, dass das geregelte Feld angezeigt wird, durch Klick mit der Maus aus.
  • Halten Sie die Strg-Taste gedrückt, wenn sie mehr als einen Option auswählen wollen.
  • Speichern Sie das geregelte Feld.

Die folgenden Abbildungen verdeutlichen, wie sie ein Feld mit bedingter Anzeige anlegen können und wie die Darstellung im Formular aussieht.

Zum Vergrößern auf das Vorschaubild klicken.

  • Feldliste in der Administration

    Übersicht

    Liste der Felder, die für das Formular angelegt wurden.

  • Option für bedingte Anzeige wählen

    Option für bedingte Anzeige wählen

    In der Auswahlliste werden alle Optionen aller Felder vom Type Listbox, Radiobutton, Checkbox Gruppe oder Checkbox angezeigt, die verwendet werden können, um die Anzeige dieses Feldes im Formular zu regeln.

  • Option für bedingte Anzeige gewählt

    Option für bedingte Anzeige gewählt

    Durch drücken der Strg-Taste ist es möglich mehrere Optionen für die bedingte Anzeige auszuwählen.

  • Bedingtes Feld wird nicht angezeigt

    Bedingtes Feld wird nicht angezeigt

    Option, die zur Anzeige des bedingten Feldes führt ist nicht ausgewählt.

  • Bedingtes Feld wird angezeigt

    Bedingtes Feld wird angezeigt

    Option die zur Anzeige des bedingten Feldes führt ist ausgewählt.

Sie können in der Listbox "Bedingte Anzeige" beliebige viele Bedingungen festlegen, die zu seiner Anzeige führen. Dies sind immer oder Bedingungen. Wenn Sie für ein Feld mehrere Bedingungen festelgen wollen, die alle erfüllt sein müssen, bevor dieses Feld angezeigt wird, wenn Sie also eine und Bedingung erstellen wollen müssen Sie hierzu geschachtelte bedingte Felder, wie im folgenden beschreiben, verwenden.

Beliebig tiefe Schachtelung ist möglich

Visforms ermöglicht Ihnen die beliebig tiefe Schachtelung von bedingten Feldern. D.h. ein Feld, das selbst nur unter bestimmten Bedingungen angezeigt wird, kann selbst die Anzeige eines weiteren Feldes regeln. Feld A steuert die Anzeige von Feld B welches die Anzeige von Feld C reguliert.

Endlosschleifen werden vermieden

In der Auswahlliste, in der Sie festlegen können, welche Felder und welche Werte regeln, ob ein geregeltes Feld angezeigt wird oder nicht, finden Sie nicht alle Optionen aller Felder vom Type Listbox, Radiobutton, Checkbox Gruppe oder Checkbox, die Sie für das Formular angelegt haben, sondern nur solche, die auch zur Regelung des Feldes verwendet werden können. Alle Optionen, die zu einer "Endlosschleife" führen würde, fehlen in der Auswahlliste. So wird verhindert, dass Sie eine Konfiguration treffen können in der Feld A die Anzeige von Feld B unterbindet und gleichzeitig Feld B die Anzeige von Feld A. Hierbei werden auch tiefere Ebenen der Abhängigkeit berücksichtigt.

Besonderheiten von bedingten Feldern

Durch bedingten Feldern in Visforms wurden direkte Wechselwirkungen zwischen Formularfeldern erzeugt. Deshalb gibt es Aktionen bei der Konfiguration von Feldern, die unter Umständen zu Konflikten bei diesen Wechselwirkungen führen könnten. Dies hat zur Folge, dass einige Aktionen für regelnde und/oder geregelte Felder nicht erlaubt sind. Sie werden hierüber durch eine aussagekräftige Fehlermeldung informiert. Insbesondere sind dies folgende Aktionen.

  • Der Feldtype eines regelnden Feldes kann nicht geändert werden
  • Regelnde Felder können nicht gelöscht werden
  • Regelnde Felder können nicht versteckt werden
  • Beim Kopieren von regelnden und geregelten Feldern werden Regeln, die im neuen Kontext nicht mehr gültig sind, gelöscht (dies gilt sowohl für das Kopieren von Feldern und/oder Formularen mit Feldern mittels Stapelverarbeitung, als auch bei der Verwendung des "Als Kopie Speichern Buttons")
  • Da die Zusammensetzung der Optionenliste zur Auswahl "bedingte Anzeige" auch von Zustand des geregelten Feldes abhängig ist, ist diese Liste so lange leer, bis ein neu angelegtes Feld, oder ein Feld dessen Feldtyp Sie geändert haben, das erste Mal gespeichert wurde.
  • Sie dürfen den "Name" eines regelnden Feldes nicht ändern. Dies führt zu Fehlern im Programm
  • Optionen, die ein bedingte Anzeige steuern, dürfen im Optionswert kein Komma enthalten!

Wollen Sie ein regelndes Feld löschen oder verstecken, so müssen Sie zuerst in allen durch dieses Feld gesteuerten geregelten Feldern alle Optionen des regelnden Feldes aus der "bedingten Anzeige" entfernen.

Zur Beitragsliste