Es ist oft eine Erleichterung für Webseitenbesucher, wenn Formulare bereits mit situationsabhängigen Werten vorbelegt sind. Beispielsweise wenn bereits das gewünschte Thema oder der richtige Ansprechpartner vorbelegt sind - jeweils abhängig von der Seite, von der aus man das Formular aufgerufen hat. Diese Anleitung beschreibt, wie dies auf einfachem Weg mittels GET-Parameter realisiert werden kann.

Benötigt:

• Erweiterung inputvar

Anleitung:

WICHTIG: Bitte bei den Insert-Tags die Leerzeichen zwischen den beiden geschweiften Klammern entfernen.

1. Installieren Sie die Erweiterung inputvar.
2. Öffnen Sie in dem zuvor angelegten Kontaktformular die Felder die vorbelegt werden können sollen. Tragen Sie dort unter Experten-Einstellungen/Standard-Wert ein: { {get::feldname} } (Wenn dieses Feld nicht vorhanden ist, siehe Beschreibung des Sonderfalls unten.) Dabei ist "feldname" eine eindeutige Bezeichnung des Feldes, die keine Sonderzeichen enthalten darf.
   In dem folgenden Beispiel gehen wir davon aus, dass es zwei solche Felder gibt: "ansprechpartner" und "thema".
3. Öffnen Sie nun in dem Artikel, aus dem Sie auf ein vorbelegtes Kontaktformular verlinken möchten, das entsprechende Content-Element. Erstellen Sie im Text-Editor einen ganz normalen Link auf die Kontaktformular-Seite.
4. Wechseln Sie in die HTML-Ansicht des Editors und suchen Sie dort den Link. Er sieht etwa so aus: <a href="{ {link_url::XXX} }"> (Dabei ist XXX die Contao-Id der Seite.)
5. Diesen Link können Sie nun um soegenannte GET-Parameter ergänzen. Diese werden jeweils als "feldname=wert" angefügt. Der Wert darf dabei keine Sonderzeichen enthalten, auch keine Leerzeichen.
   Sollten Sie Sonderzeichen benötigen, muss der Text beispielsweise hier mittels urlencode "kodiert" werden. Aus "Manfred Müller" wird dabei beispielsweise "Manfred+M%FCller".
   Die erste Angabe wird am Ende der URL angehängt und durch ein ? angetrennt, die weiteren Angaben durch ein &.
   Beispiel mit einem Parameter:
   <a href="{ {link_url::XXX} }?ansprechpartner=Manfred+M%FCller">
   Beispiel mit zwei Parametern:
   <a href="{ {link_url::XXX} }?ansprechpartner=Zentrale&thema=Test">
6. Wechseln Sie zurück in die normale Ansicht und speichern Sie ihre Anpassungen.

Externe Aufrufe

Auch bei externen Aufrufen kann das Formular über GET-Parameter vorbelegt werden. Diese müssen wie oben beschrieben an die ganz normale URL angehängt werden. Beispiel:
http://www.firmenbezeichnung.de/kontakt.html?ansprechpartner=Zentrale&thema=Test

Sonderfall: Felder ohne Default-Wert

Einige Feldtypen haben in Contao keine Einstellung für den Default-Wert. In diesem Fall die Anleitung von oben bis auf Schritt 2 durchführen und statt dessen:

1. Ein neues Modul vom Typ "Eigener HTML-Code" anlegen.
2. Dort folgen JavaScript-Code eintragen:
   <script type="text/javascript"><!--
   document.getElementById("ctrl_XX").value = { {get::feldname} };
   --></script>
   Dabei muss "ctrl_XX" durch die HTML-Id des Feldes und "feldname" durch den Feldname für den Get-Parameter (wie oben beschreiben) ersetzt werden.
   Sollen mehrere derartige Felder vorbelegt werden, die mittlere Zeile für jedes Feld eintragen.
3. Dieses neue Modul nach dem Formular einfügen.