Bedienungsanleitung eXtroForms

Schritt 1.

Installation gehen Sie in ihr Joomla Backend zur Installation.
Laden Sie eXtroForms hoch und installieren Sie die Formkomponente.
Nach erfolgreicher Installation klicken Sie auf Komponenten -> eXtroforms

Schritt 2.

Erstellung einer Form. Klicken Sie auf den Button Neu, füllen Sie Schritt für Schritt die Felder aus.

• Geben Sie Ihrer Form einen internen Namen, Nutzen Sie nur Kleinbuchstaben und Zahlen. Machen Sie keine Leerstellen und Gedankenstriche, verwenden Sie keine Sonderzeichen.
  
  
• Wählen Sie einen Titel der Form, der als h1 Überschrift in der Seite zu sehen ist.
  
  
• Geben Sie zur Vervollständigung den Namen des Formularerstellers ein (SEO)
  
  
• Geben Sie ein Erstellungsdatum ein (SEO)
  
  
• Wählen Sie eine bestehende Seite aus, die nach erfolgreichem Ausfüllen der Form aufgerufen werden soll.
  
  
• Wählen Sie aus ob die Form zusätzlich zu dem eXtro-media.de Spamschutz über Google ReCaptcha vor maschinellem Spam geschützt werden soll.
  
  
• Tragen Sie den privaten Schlüssel für Ihren ReCaptcha Zugang ein (benötigt ein Google-Konto). Das Konto können Sie unter http://www.google.com/recaptcha anlegen.
  
  
• Tragen Sie den öffentlichen Schlüssel für Ihren ReCaptcha Zugang ein (benötigt ein Google-Konto). Das Konto können Sie unter http://www.google.com/recaptcha anlegen.
  
  
• Geben Sie als nächstes die Beschreibung der Form ein, dies kann der Einleitungstext sein.
  
  
• Tragen Sie die Metadescription und die Metakeys für die zu erstellende Form ein.
  
  
• Das Upload-Verzeichnis gibt an, wo die Dateien (falls Sie einen Datei-Upload zulassen möchten) gespeichert werden.
  
  
• Versand einer E-Mail, entweder zur Bestätigung oder als kleine Auto-Responder Funktion, sollten Sie einen Mailversand wünschen, so geben Sie die E-Mailadresse für den Versender ein.
  
  
• Sollen mehrere Personen über den Eintrag Informiert werden, so geben Sie diese in die Verteilerliste ein. Aus Gründen des Datenschutzes, findet nur ein Blind Carbon Copy (BCC) Versand der Mails statt. D.h. füllt jemand die Form aus so wird nur die Versand E-Mailadresse sichtbar sein, nicht der Verteiler. Sollte ein Passwortfeld in der Form enthalten sein, so erhält die ausfüllende Person das Passwort in Klartext, die Verteilerliste erhält das Passwort nur MD5 verschlüsselt (Datenschutz).
  
  
• Geben sie den Betreff der E-Mail ein.
  
  
• Tragen Sie die Nachricht der E-Mailadresse ein. Die Daten der ausgefüllten Felder werden automatisch an die E-Mail angehängt.
  
  
• Sollten Sie die Form zusätzlich noch mit einem Datei Versand versehen wollen, wählen Sie die anzuhängende Datei aus dem Dropdown-Verzeichnis auf dem Server aus. Sollte sich die Datei noch nicht auf dem Server oder Ihrer Joomla Installation befinden, so laden Sie die Datei mit dem Grünen Upload-Button hoch. Wählen Sie die Datei nach erfolgreichem Upload aus der Dropdownliste aus.
  
  
• Speichern Sie die soeben erstellte Form.

Sollten Sie eine Form formatieren wollen, so ist dies über den Button EditCSS möglich.
Markieren Sie hierzu die jeweilige Form mit der Vorangestellten Checkbox.

Schritt 3.

Erstellen der Felder.

• Klicken Sie auf den Button Neu.
  
  
• Wählen Sie aus der Drop down aus, was für einen Feld Typ angelegt werden soll.
  • Radio-Button
  • Checkbox
  • Button (Senden Reset)
  • Textbox einzeilig
  • Textbox mehrzeilig (Textarea)
  • Datei Upload
  • Hidden-Element
  • Auswahlliste(n) (Dropdown, Single-Select, Multi-Select)
  • HTML-Element
  • Datumsfeld
    
    
• Ordnen Sie das Feld einer zuvor angelegten Form zu.
  • Erklärung der Dateneingabe der Feld-Typen Radio-Button, Checkbox, Auswahllisten:
    Die Erläuterung findet am komplexeren Beispiel Auswahllisten statt:

• Geben Sie einen Internen Namen für das Feld ein. Verwenden Sie nur Kleinbuchstaben und Zahlen. Benutzen Sie keine Sonderzeichen und verwenden Sie nicht den Gedankenstrich.
  
  
• Anzeigetitel ist der Label des Feldes. Dieser Titel ist die Bezeichnung des Feldes in Frontend.

• Geben Sie mit dem Hilfetext dem User eine Hilfestellung zum ausfüllen der Form. Erklären Sie Ihm zB, in welcher Form er die jeweiligen Daten eingeben soll.

• Wählen Sie aus, ob das Feld ein Pflichtfeld sein soll oder nicht.
  Ein Pflichtfeld setzt zwingend eine Eingabe voraus.

• Mehrfachauswahl: diese Option gibt es nur bei der Auswahlliste. Die Option NEIN ist Grundlage für eine Dropdown Liste.

• Die Option Anzahl der Zeilen gibt an wie viele Optionen sichtbar sind. Für eine Dropdown-Liste wählen Sie „1“

• Mit der Position können Sie die Feldposition auf der Frontend-Seite bestimmen. Eine Standardeinstellung der eXtroForms sind die Positionen Links oben, Rechts oben, Mittig, Links unten oder Rechts unten. Je nach Wahl positionieren Sie die Felder im Contentbereich der Seite.

• Der Wert bezeichnet den Feldwert/-inhalt einer Option, der in die Datenbank geschrieben wird.

• Die Beschriftung ist lediglich der angezeigte Label für die Option. Eine Option besteht aus Wert und Beschriftung. Die Beschriftung in ser sichtbare Teil der Option, der Wert wird beim absenden übergeben. Klicken Sie auf hinzufügen um eine Option zu erstellen

• Im Feld Inhalt sehen Sie die eingegebenen Werte und Feldbeschriftungen. Sie können einen Standard setzen, in dem Sie einen Wert auswählen und auf Standardauswahl festlegen klicken.

• Am Beispiel Textbox wird kurz erklärt wie Sie die Felder anlegen und die Inhalte verwalten.
  • Nach der Feldtypauswahl und der zugehörigen Form vergeben Sie den Internen Namen und den Label + den Hilfetext. Wählen Sie ob die Auswahl eine Pflichtfeld sein soll.
  • Das Feld maximale Zeichen bestimmt die Anzahl der Zeichen, die in das jeweilige Feld eingegeben werden darf.
  • Das Feld minimale Zeichen bestimmt, wie viele Zeichen mindestens im Frontend in das Feld eingegeben werden müssen.
  • Breite des Feldes definiert, wie breit ein Feld im Frontend angezeigt wird.
  • Die Position bestimmt, an welcher Stelle die Felder ausgegeben werden sollen.
  • Untertyp wählen: Dies ist ein Spezialfeld für den Feldtyp Textbox einzeilig. Wählen Sie einen Unterfeldtyp aus. Standardmäßig steht dieser Feldinhalt auf Text. Weitere Optionen dieses Feldes sind:
    • Password: Blendet zur Passworteingabe die normalen Schriftzeichen und Zahlen aus und blendet anstelle der Zeichen Punkte ein.
    • Die Option E-Mail überprüft die eingegebene E-Mailadresse auf Konformität, bzw. übernimmt im eingeloggtem Zustand die E-Mailadresse die im Account angegeben ist.
    • Die Option Nummer lässt nur eine Eingabe von Zahlen in das Feld zu.
    • Die Option URL überprüft ob die eingegebene Webadresse standardkonform ist.
    • Automatisches einfügen fügt automatisch vorhandene Inhalte aus dem Account in die Felder ein, zum Beispiel den internen Namen der in der Accountregistration angegeben wurde. Ebenso ist das Autoeinfügen für Benutzernamen oder E-Mailadressen möglich.
    • Wenn Sie das Feld Datei-Upload nutzen, lesen Sie die Hinweise und die Warnung durch, es können potentielle Gefahren für Ihr System bei Datei-Uploads entstehen.
    • Das Hidden Element kann mit vordefinierten Inhalten versehen werden, oder die IP des Users speichern, der die Form abgesendet hat.
    • Das HTML Element kann mit beliebigem Inhalt gefüllt werden.
    • Das Datumsfeld ist eine Joomla Standard Anwendung die die Eingabe eines Datums zulässt.

• Die Kopierfunktion: Wählen Sie die Felder aus, die Sie kopieren möchten. Kopierte Felder erkennen Sie an einem vorangestellten 'Kopie-' im Titel des Feldes.
  
  
• Vorschau: je nach Feld und zugeordneter Form wird nach Auswahl der Checkbox und klicken auf den Button Vorschau, die entsprechende Form angezeigt.

Schritt 4.

Der Results Manager zeigt die gespeicherten Daten nach Form und Datum an.

Sie können durch anklicken der Checkboxen bestimmen, welche der Ergebnisse in CSV oder XML-Dateien auf Ihren lokalen Rechner gespeichert werden sollen.

Upload-Dateien können verursachungsgerecht auf den lokalen Rechner gespeichert werden.
Klicken Sie auf das gewünschte Ergebnis, um die Datei herunterzuladen.

Schritt 5

Der Spam Manager filtriert nach den definierten Spam Regeln nicht konforme Einträge heraus, Sie können falsch deklarierte Einträge in den regulären Ergebnis Manager verschieben, indem sie das Ergebnis via Checkbox markieren und auf den Button Nospam klicken.