Adiform Formulareditor (vormals Redform)

Adiform ist ein sehr einfach zu bedienender Formulareditor für das CMS Redaxo. Er unterstützt verschiedene Eingabeformate für alle möglichen Arten von Kontaktformularen. Adiform unterstützt mehrere Sprachen, zusätzliche Sprachfiles können angelegt werden. Als Zieladresse können eine To- und eine CC-Emailadresse angegeben werden. Ein Eingabefeld jedes Formulars kann als "Reply-To" gekennzeichnet werden.

Adrian Schärli, Azular GmbH 

Neu ab Adiform 2.5.2

• Multicheckbox-Feldtyp
• HTML-"Formularfeld": HTML-Ausgabe mitten im Formular
• Date-Formularfeld: Kalender von DHTML-Goodies integriert
• Mehrfaches Senden des Formulars verhindert
• Bitte Upgrade-Hinweise (weiter unten) beachten

Unterstützte Eingabefelder von Adiform

• Eingabefelder (Text, Textarea)
• Auswahlfelder (Checkbox, Radiobutton, Select, Multiselect)
• Dateiupload
• Hidden-Felder (z.B. für die Übertragung von Session- oder Get-Variablen)
• Kalender (ab Adiform 2.3)
• HMTL-Code, Texte zwischen Eingabefeldern (ab Adiform 2.3)

Voraussetzungen

• Redaxo 4.3.1 oder höher (Redaxo 4.2.1 möglich, jedoch Introtext ohne Tinymce-Editor)
• PHP 5.2 oder höher
• Redaxo System-Addon PHP-Mailer (Adiform bezieht Maileinstellungen und Absender daraus)
• Redaxo-Addon Tinymce (zum Editieren des Introtextes)
• Nicht getestet: Adiform auf Webseiten, die NICHT mit UTF8-Codierung laufen

Download

Adiform herunterladen

Installation

Zur Installation muss die ZIP-Datei entpackt und ins Verzeichnis ./redaxo/includes/addons kopiert werden. Anschliessend muss das Addon installiert und aktiviert werden (Backend: Hauptmenü->AddOn).

Bei der Installation werden erstellt:

• Datenbank-Tabellen: rex_adiform_forms, rex_adiform_fields
• Modul "Formular anzeigen"
• Verzeichnis: ./files/addons/adiform

Deinstallation

Bei der Deinstallation von Adiform werden die Tabellen und das Verzeichnis gelöscht, das Modul muss aber von Hand entfernt werden.

Upgrade

Adiform 1.x -> 2.x

Die Datenbank-Struktur, das Ausgabemodul und die Konfiguration haben sich verändert. Trotzdem können bestehende Formulare weiter verwendet werden, wenn wie folgt vorgegangen wird:

1. Adiform-Modul löschen (vorher natürlich aus den Artkeln entfernen)
2. Ordner löschen: ./files/addons/adiform 
3. Addon-Inhalt komplett ersetzen mit dem Code der neuen Version: ./redaxo/include/addons/adiform
4. Redaxo-Backend->AddOns->Adiform->Re-Installieren klicken

Ein neues Modul (Formular Anzeigen Adiform 2) wird automatisch erstellt.

Konfiguration (Addons->Formulare->Konfiguration)

Die Konfiguration wird ab Adiform 2 im INI-Format eingegeben.

Ein/Ausschalten Herstellerlink

Der Link zum Hersteller kann ein- und ausgeschaltet werden (ab Adiform 2.3).

Ausgabe des Formulartitels steuern (ab Version 2.5.2)

Die Ausgabe des Formulartitels kann unterbunden werden (formtitle = 0), oder als h1...h6-Tag ausgegeben werden (formtitle = 1 ... 6).

Eigenes CSS-Stylesheet verwenden (ab Version 2.5.2)

Der Parameter useadiformcss steuert die Verwendung von adiform.css.
useadiformcss = 1 : wird verwendet
useadiformcss = 0 : adiform.css wird nicht geladen, eigenes CSS-Stylesheet wird verwendet

Frontend-Sprachen

Redaxo verwendet unterschiedliche Sprachcodierungen im Front- und Backend. Im Frontend wird die Sprache durch die Variable REX['CUR_CLANG'] definiert, was leider keinen direkten Zusammenhang mit der tatsächlich gewählten Sprache liefert. Deshalb muss in der Konfiguration definiert werden, welcher Wert von CLANG welchem Sprachcode entspricht.

Backend-Sprachen (muss nicht konfiguriert werden)

Backend-Sprachcodes werden automatisch übersetzt. Aus de_de_utf8 wird de-DE, aus en_gb wird en-GB.

Absenderadresse und Maileinstellungen

Adiform arbeitet mit dem System-Addon PHPMailer zusammen. Das Addon "phpmailer" muss installiert und aktiviert sein, damit Adiform arbeiten kann. In den Addon-Einstellungen (AddOns->PHPMailer) werden die Absender-Emailadresse und die Maileinstellungen konfiguriert.

Formulareinstellungen

Für jedes Formular können die folgenden Parameter frei gewählt werden (Introtext ab Adiform 2.3, Redaxo 4.2.1 ohne Tinymce):

Formularfeld-Einstellungen

Abhängig vom Feldtyp sind die Einstellungen für das Formularfeld verschieden. Im Beispiel: Datumseingabe (ab Adiform 2.3):

Erklärungen

Label	Wird im Formular in der linken Spalte ausgegeben
Erforderlich	Ja = Dieses Feld muss ausgefüllt werden. Bei Select-Eingabefeldern bedeutet dies, dass ein Wert ausser dem ersten gewählt werden muss.
Als Reply-To verwenden	Sollte nur bei Text-Feldern mit Email-Validierung verwendet werden. Wird dem Email mit den Formulardaten automatisch als "Reply-To"-Adresse hinzugefügt
Vorgabewert	Default-Wert des Formularfeldes. Bei Multiselect- oder Multicheckbox-Feldern können hier mehrere Werte mit Doppelkomma getrennt eingegeben werden (,,). Der Vorgabewert kann auch automatisch mit SESSION- oder GET-Variablen belegt werden.
Auswahlwerte	Optionen für Select-Felder, Radiobuttons oder Multicheckbox-Felder. Einzelne Werte müssen mit Doppelkomma getrennt werden (,,).
Validierung	Werte-Validierung bei Text- oder Textarea-Feldern. Wahlmöglichkeiten: none, text, textarea, email, integer, regex. regex: In diesem Fall prüft Adiform die Eingabe nach einem Regulären Ausdruck (Regular Expression), der im Feld "Regex" eingegeben werden kann. Feldtypen wie Select, Radio etc. benötigen keine Validierung ('none'), weil Adiform-intern alle Werte in reine Integer-Values umgesetzt werden. Diese werden automatisch validiert, sodass kein Fremdcode eingeschmuggelt werden kann.
Regex	Regulärer Ausdruck für die Validierung, wenn "Validierung: regex" gewählt.
Klasse	Adiform vergibt automatisch Klassen an die Felder (z.B. "notvalid" oder "required"). Wenn mittels CSS ein Feld speziell ausgezeichnet werden soll, kann hier der Name der Klasse angegeben werden.
Style	Eingabe von Attributen wie style, cols, rows, id etc.
Beschreibung	Der hier eingetragene Wert wird neben dem Label mit einem Infobutton ausgegeben. Beim Feldtyp HTML wird dieser Code auf der ganzen Breite des Formulars ausgegeben.
Zusatzcode	Dieser Code wird direkt hinter dem Eingabefeld ausgegeben. Damit lassen sich zum Beispiel Auswahl-Buttons realisieren (siehe Beispiel Date-Feld) oder Bilder einfügen etc. HTML-Tags werden erhalten.

FAQ

Ich habe zwei Datumsfelder im gleichen Formular. Es funktioniert aber nur eines.

Erklärung: Wenn ein Datums-Feld kopiert wird, bleiben die zugewiesenen ID-Nummern erhalten. Der Kalender weiss dann nicht wohin mit dem Datum.
Abhilfe: Bei einem der zwei Datumsfelder die ID bei "Style" und bei "Zusatzcode" ändern.

Ich möchte bei einem Kalenderfeld den Button von "Cal" in "Kalender" umbenenen.

Den Button-Namen kann man beim entsprechenden Feld unter "Zusatzcode" anpassen (value=cal -> value=Kalender)

Anregungen, Fehler, Probleme?

Bitte hier melden

Unterstützung

Sie können Adiform zu privaten Zwecken kostenlos auf Ihrer Webseite einsetzen. Wir bitten Sie nur darum, den Hersteller-Link unterhalb des Formulars zu belassen. Falls Sie den Link entfernen wollen oder Adiform nicht nur auf Ihrer privaten Webseite einsetzen, bitten wir Sie um eine finanziellen Beitrag zur Entwicklung. Sie bestimmen selbst, was Ihnen Adiform wert ist. Vielen Dank!