kitForm - Änderungen am form.htt Template durchführen

[Ralf Hertsch]

Die grundsätzliche Vorgehensweise beim Bearbeiten und Verändern von Templates ist in dem Artikel kitForm - Formulare individuell anpassen und mit Presets arbeiten beschrieben.

Das Template /modules/kit_form/htt/1/DE/form.htt erschließt sich nicht auf den ersten Blick. Dieses Template kann alle Formulare, die mit kitForm erstellt werden anzeigen, es gibt also keine speziellen Templates für einzelne Formulare. form.htt ist deshalb etwas komplexer, dieses Template deckt auch spezielle Anforderungen ab, z.B. bei der Übermittlung von Dateien in Kombination mit kitUploader.

Damit dies möglich ist, verwendet das Template eine foreach() Schleife in der alle Felder abgefragt und bearbeitet werden:

{foreach $fields as field}
...
{/foreach}

Die Schleife beginnt etwa in Zeile 31 und endet etwa in Zeile 239.

Damit nicht genug, differenziert das Template zusätzlich zwischen Datenfeldern, die einem KeepInTouch (KIT) Datensatz zugeordnet werden (z.B. Vorname, Nachname, E-Mail Adresse, Telefon, Straße usw.) und sogenannten freien Datenfeldern, die keinen direkten Bezug zur KIT Kontaktverwaltung haben, z.B. Mitteilungen oder Datenübertragungen.

KIT Datenfelder verfügen über eine Kennung (ID) die kleiner als 100 ist, freie Datenfelder erhalten eine Kennung (ID) größer als 100. Das Template fragt diese Werte entsprechend ab:

{foreach $fields as field}

  {if $field.id < 100}
    ...
  {else}
    ...
  {/if}
{/foreach}

Entsprechend werden KIT Datenfeldern zwischen Zeile 32 sowie Zeile 122 verarbeitet und allgemeine Datenfelder zwischen Zeile 124 sowie Zeile 238.

Die Dokumentation der Dwoo Template Engine hilft dabei die Funktionsweise der Schleifen und der Zugriffe auf die einzelnen Felder zu verstehen.

Sehr hilfreich ist es, in dem Droplet mit dem das jeweilige Formular aufgerufen wird, den Parameter debug=true zu verwenden:

[[kit_form?form=test&debug=true]]

Wird das Formular jetzt ausgegeben, werden ergänzende Informationen ausgegeben:

• der vollständige Pfad auf das Template
• alle Datenfelder mit Bezeichnern und Werten

Die DEBUG Ausgabe zeigt alle Datenfelder mit den Bezeichnern und alle Daten die tatsächlich an das Formular übermittelt werden. 

Suchen Sie mit Hilfe dieser Informationen in der foreach() Schleife das gewünschte Feld um die Ausgabe zu verändern bzw. anzupassen.

Für bestimmte Formulare kann es sinnvoll sein ein eigenes Preset anzulegen und für diese Formulare die Schleife aus form.htt aufzulösen und stattdessen die einzelnen Felder dieses Formular direkt anzusprechen. Die vollständige Beschreibung der Vorgehensweise hierbei sprengt leider die Möglichkeiten dieses Forums. Falls Sie hierzu konkrete Fragen haben kann Ihnen das Forum ganz sicher helfen, den vollständigen Vorgang können wir hier leider nicht vermitteln. Die phpManufaktur bietet regelmäßig Schulungen zur Dwoo Template Engine an, sprechen Sie uns bitte an, falls Sie hier Bedarf haben.