Leitfaden-Plugin 4.0.0: Warnung im Formular-Designer

Mit Version 4.0.0 des Leitfaden-Plugins wurden einige Funktionen umstrukturiert. Bestehende Formulare funktionieren nach dem Update weiterhin wie gewohnt und es besteht kein sofortiger Handlungsbedarf. Einige Einstellungen gelten jedoch als veraltet und werden in einer zukünftigen Version des Plugins entfernt. Es wird empfohlen, die betroffenen Formulare nach und nach umzustellen.

Die in diesem Artikel beschriebenen Warnungen im Formular-Designer sind keine Fehler. Sie weisen lediglich darauf hin, dass veraltete Einstellungen verwendet werden, die zukünftig nicht mehr unterstützt werden.

Überblick: Was hat sich geändert?

Die folgende Tabelle zeigt auf einen Blick, welche Einstellungen veraltet sind und wie die empfohlene Alternative aussieht:

Schritt 1: Validatoren / Datentypen umstellen

Die Datentypen für Eingabefelder (z.B. IBAN, BIC, Steueridentifikationsnummer) wurden aus dem Leitfaden-Plugin entfernt und stehen nun über das separate Validationsregel-Plugin zur Verfügung.

Die Validatoren (Datentypen für Eingabefelder) wurden aus dem Leitfaden-Plugin entfernt. Um diese weiterzunutzen, muss das Validationsregel-Plugin in Version 4.1.0 installiert werden.

Warnung im Formular-Designer: Beim Speichern eines Formulars wird angezeigt, welche Eingabefelder noch veraltete Datentypen verwenden.

So stellen Sie um:

1. Installieren Sie das Validationsregel-Plugin in Version 4.1.0 oder höher.
2. Öffnen Sie das betroffene Formular im Formular-Designer.
3. Wählen Sie das betroffene Eingabefeld aus und wechseln Sie in die Eigenschaften des Feldes.
4. Ersetzen Sie den veralteten Datentyp durch den entsprechenden neuen Datentyp aus dem Validationsregel-Plugin:

       
    5. Speichern Sie das Formular. Die Warnung sollte nach der Umstellung nicht mehr erscheinen.

Schritt 2: Leitfaden-Theme manuell einbinden

Bisher wurde das Leitfaden-Theme automatisch in alle Formulare eingebunden. Ab Version 4.0.0 stellt das Plugin das Theme als auswählbares Formular-Theme im Formular-Designer bereit. Das automatische Einbinden ist aus Kompatibilitätsgründen zunächst noch aktiv, wird aber in einer zukünftigen Version abgeschaltet.

Warnung im Formular-Designer: Beim Speichern wird eine Warnung angezeigt, solange das Theme noch automatisch eingebunden wird.

So stellen Sie um:

1. Öffnen Sie das betroffene Formular im Formular-Designer.
2. Wechseln Sie in den Tab „Formular".
3. Wählen Sie unter „Theme" das Leitfaden-Theme aus der Liste aus.

4. Deaktivieren Sie anschließend im Tab „Formular" die Option „Leitfaden-Theme automatisch einbinden".
5. Speichern Sie das Formular. Die Warnung sollte nach der Umstellung nicht mehr erscheinen.

Wird ein eigenes Formular-Theme verwendet, das auf dem Leitfaden-Theme basiert, kann das Leitfaden-Theme unter Dateien & Templates → Formular-Theme im Feld „basierend auf" ausgewählt werden.

Schritt 3: Upload-Feld Dropzone umstellen

Bisher konnte die Darstellung eines Upload-Felds als Dropzone durch das Setzen der CSS-Klasse XUpload-Dropzone aktiviert werden. Diese Möglichkeit ist aus Kompatibilitätsgründen noch vorhanden, wird aber in einer zukünftigen Version entfernt. Stattdessen gibt es am Upload-Feld eine direkte Darstellungsoption.

Warnung im Formular-Designer: Beim Speichern wird eine Warnung angezeigt, wenn die CSS-Klasse XUpload-Dropzone noch verwendet wird.

So stellen Sie um:

1. Öffnen Sie das betroffene Formular im Formular-Designer.
2. Wählen Sie das betroffene Upload-Feld aus.
3. Wechseln Sie in den Bereich „Erweitert" und entfernen Sie die CSS-Klasse XUpload-Dropzone.
4. Wechseln Sie in den Bereich „Darstellung" und wählen Sie dort die gewünschte Darstellungsoption aus:

5. Speichern Sie das Formular. Die Warnung sollte nach der Umstellung nicht mehr erscheinen.
   
   

Die Darstellungsoption ist nur verfügbar, wenn die CSS-Klasse XUpload-Dropzone nicht mehr gesetzt ist.

Schritt 4: Hilfetexte-Einstellung pro Formular festlegen

Bisher wurde das Verhalten von Hilfetexten beim Fokussieren eines Eingabefelds global am Plugin konfiguriert. Ab Version 4.0.0 kann diese Einstellung direkt pro Formular im Formular-Designer vorgenommen werden. Die globale Plugin-Einstellung bleibt aus Kompatibilitätsgründen vorhanden, sollte aber nicht mehr verwendet werden.

So stellen Sie um:

1. Öffnen Sie das betroffene Formular im Formular-Designer.
2. Wechseln Sie in den Tab „Formular".
3. Wählen Sie unter „Darstellung Hilfetexte bei Fokus" die gewünschte Option aus:

• anzeigen – Der Hilfetext wird sofort beim Fokussieren des Feldes angezeigt.
• nicht anzeigen – Der Hilfetext wird erst beim Überfahren des Hilfe-Icons mit der Maus angezeigt.
• (globale Einstellung) – Es wird die am Plugin konfigurierte Einstellung verwendet. Diese Option sollte zukünftig nicht mehr verwendet werden.

4. Speichern Sie das Formular.

Hinweis zur CSS-Überarbeitung

In Version 4.0.0 wurde das CSS des Leitfaden-Themes technisch überarbeitet. Dadurch kann sich die Spezifität einzelner CSS-Selektoren geringfügig geändert haben. Bestehende eigene CSS-Anpassungen sollten grundsätzlich weiterhin funktionieren. Es kann jedoch in Einzelfällen nicht ausgeschlossen werden, dass es zu optischen Abweichungen kommt. Falls ein eigenes Theme oder eigene CSS-Anpassungen verwendet werden, die auf dem Leitfaden-Theme aufbauen, sollte das Erscheinungsbild der Formulare nach dem Update geprüft und bei Bedarf angepasst werden.