update forms

src/kicktemp-addons-for-yootheme-pro/module/form/advanced.md

@@ -0,0 +1,101 @@
+### `settings.md` – Erweiterte Formular-Konfiguration
+
+In dieser Sektion findest du die erweiterten Einstellungen für dein Formular, einschließlich Layout, Validierung und Modal-Optionen. Diese Felder bieten dir die Möglichkeit, das Erscheinungsbild und Verhalten des Formulars weiter anzupassen.
+
+---
+
+| **Feld**                      | **Beschreibung**                                                                                                                   | **Bedingung (wenn gesetzt)** | **Source** |
+|-------------------------------|------------------------------------------------------------------------------------------------------------------------------------|------------------------------|-----------|
+| **ccs**                        | Eine durch Kommas getrennte Liste von Empfängern im CC-Feld (Carbon Copy).                                                                                          | -                            | Ja        |
+| **bccs**                       | Eine durch Kommas getrennte Liste von Empfängern im BCC-Feld (Blind Carbon Copy).                                                                                          | -                            | Ja        |
+| **horizontal**                 | Bestimmt, ob das Formular im horizontalen Layout angezeigt wird.                                                                                                  | -                            | Nein      |
+| **novalidate**                 | Wenn aktiviert, wird die HTML5-Validierung für das Formular deaktiviert.                                                                                                   | -                            | Nein      |
+| **show_label**                 | Wenn aktiviert, werden die Labels für jedes Formularfeld angezeigt.                                                                                                        | -                            | Nein      |
+| **gap**                        | Setzt den Abstand (Gap) zwischen den Spalten im Grid-Layout des Formulars.                                                                                                  | -                            | Ja        |
+| **form_size**                  | Bestimmt die Größe des Formulars.                                                                                                                                            | -                            | Ja        |
+| **form_style**                 | Bestimmt den Stil des Formulars.                                                                                                                                        | -                            | Ja        |
+| **label_button**               | Bestimmt den Text des Formular-Submit-Buttons.                                                                                                                             | -                            | Ja        |
+| **button_style**               | Bestimmt den Stil des Submit-Buttons.                                                                                                                                         | -                            | Ja        |
+| **button_fullwidth**           | Wenn aktiviert, wird der Submit-Button über die gesamte Breite des Formulars angezeigt.                                                                                      | -                            | Nein      |
+| **show_inmodal**               | Wenn aktiviert, wird das Formular in einem Modal-Fenster angezeigt.                                                                                                       | -                            | Ja        |
+| **modal_id**                   | Die ID des Modal-Fensters. Wird verwendet, wenn das Formular im Modal angezeigt werden soll.                                                                                  | Wenn **show_inmodal** aktiviert ist    | Ja        |
+| **modal_center**               | Wenn aktiviert, wird das Modal-Fenster zentriert auf der Seite angezeigt.                                                                                                    | Wenn **show_inmodal** aktiviert ist    | Ja        |
+| **modal_container**            | Wenn aktiviert, wird ein Container-Modifikator für das Modal angewendet.                                                                                                    | Wenn **show_inmodal** aktiviert ist    | Ja        |
+| **modal_header**               | Der Header des Modals, der in der oberen Ecke des Modals angezeigt wird.                                                                                                     | Wenn **show_inmodal** aktiviert ist    | Ja        |
+| **close_style**                | Bestimmt den Stil des Schließen-Buttons im Modal.                                                                                                                              | Wenn **show_inmodal** aktiviert ist    | Ja        |
+
+---
+
+### Beschreibung der Felder
+
+#### **ccs (CCs)**
+Gib eine durch Kommas getrennte Liste von E-Mail-Adressen an, an die eine Kopie des Formulars gesendet wird. Dies ist nützlich, wenn mehrere Personen eine Kopie der gesendeten E-Mail erhalten sollen.
+
+**Beispiel:**
+- `[email protected], [email protected]`
+
+#### **bccs (BCCs)**
+Dies ist eine durch Kommas getrennte Liste von E-Mail-Adressen, an die das Formular im Blind Carbon Copy (BCC)-Feld gesendet wird. Empfänger im BCC sehen nicht, an wen die E-Mail noch gesendet wurde.
+
+**Beispiel:**
+- `[email protected], [email protected]`
+
+#### **horizontal**
+Mit dieser Einstellung kannst du dein Formular in einem horizontalen Layout darstellen. Standardmäßig ist das Formular vertikal ausgerichtet, aber wenn du das Kästchen aktivierst, werden die Formularfelder nebeneinander statt untereinander angezeigt.
+
+#### **novalidate**
+Aktiviert oder deaktiviert die HTML5-Formularvalidierung. Wenn aktiviert, werden keine eingebauten HTML5-Validierungen angewendet, und du kannst eigene Validierungsregeln oder ein benutzerdefiniertes Verhalten verwenden.
+
+#### **show_label**
+Bestimmt, ob die Formularfelder Labels anzeigen sollen. Wenn aktiviert, wird der Name des Feldes über dem Eingabefeld angezeigt. Wenn deaktiviert, kannst du Platzhalter verwenden, die in den Eingabefeldern angezeigt werden.
+
+#### **gap**
+Setzt den Abstand (Gap) zwischen den Spalten in einem Formularlayout. Dies hilft, das Layout des Formulars visuell anzupassen und eine benutzerdefinierte Benutzeroberfläche zu gestalten.
+
+#### **form_size**
+Definiert die Größe des Formulars. Du kannst "Small", "Default" oder "Large" auswählen, um die Größe des gesamten Formulars auf der Seite anzupassen.
+
+#### **form_style**
+Wählt das Stil-Design des Formulars. Du kannst zwischen dem Standardstil und dem leeren Stil ("Blank") wählen, um das Aussehen des Formulars zu steuern.
+
+#### **label_button**
+Definiert den Text des Buttons, der das Formular abschickt. Der Standardtext ist "Send", aber du kannst ihn nach Bedarf ändern.
+
+**Beispiel:**
+- `Submit`
+
+#### **button_style**
+Wählt den Stil des Submit-Buttons aus. Du kannst zwischen verschiedenen Stilen wie "Primary", "Secondary" und "Danger" wählen, um den Button visuell hervorzuheben.
+
+**Beispiel:**
+- `Primary`
+
+#### **button_fullwidth**
+Wenn aktiviert, wird der Submit-Button die gesamte Breite des Formulars ausfüllen. Dies ist besonders nützlich für größere Formulare oder wenn du ein sehr minimalistisches Design bevorzugst.
+
+#### **show_inmodal**
+Wenn aktiviert, wird das Formular in einem Modal-Fenster angezeigt. Dies bedeutet, dass das Formular in einem Popup erscheint, wenn der Benutzer auf einen Button oder ein anderes Element klickt.
+
+#### **modal_id**
+Dies ist die ID des Modal-Fensters, das das Formular enthält. Du musst diese ID angeben, damit der Button oder andere Auslöser das Modal-Fenster korrekt ansprechen können.
+
+#### **modal_center**
+Wenn aktiviert, wird das Modal-Fenster auf der Seite zentriert. Ohne diese Option kann das Modal-Fenster an der oberen linken Ecke erscheinen, abhängig von den CSS-Einstellungen.
+
+#### **modal_container**
+Ein Container-Modifikator, der es ermöglicht, das Modal-Fenster zusätzlich anzupassen. Dies ist hilfreich, wenn du das Modal-Fenster in einen bestimmten Container einfügen möchtest, um es visuell besser in deine Seite zu integrieren.
+
+#### **modal_header**
+Der Titel des Modal-Fensters. Du kannst hier einen Text wie "Formular zur Anfrage" eingeben oder ihn leer lassen, wenn du kein Header-Element benötigst.
+
+#### **close_style**
+Bestimmt, wie der Schließen-Button im Modal-Fenster aussieht. Du kannst zwischen "Close Default" (Standard-Stil) und "Close Outside" (Schließen des Modals durch Klicken außerhalb) wählen.
+
+---
+
+**Fazit**
+Diese erweiterten Einstellungen für dein Formular ermöglichen es dir, das Verhalten und das Layout des Formulars genau nach deinen Wünschen anzupassen. Du kannst sowohl das Design als auch das Verhalten der Formulareingabe und der Formularübermittlung steuern, um die Benutzererfahrung zu verbessern.
+
+---
+
+**Bist du bereit für die nächste Sektion oder möchtest du noch etwas hinzufügen?**

src/kicktemp-addons-for-yootheme-pro/module/form/captcha.md

@@ -0,0 +1,51 @@
+# Spam-Schutz im Kickform Modul
+
+Das **Kickform Modul** bietet mehrere Methoden zum Schutz vor Spam und Missbrauch von Formularen. Diese Schutzmechanismen stellen sicher, dass nur legitime Benutzer das Formular absenden können und verhindern, dass Bots Formulare automatisch ausfüllen. Im Kickform Modul können drei Hauptmethoden aktiviert werden:
+
+- **Joomla Session Token**
+- **Honeypot-Feld**
+- **Captcha** (Google reCaptcha oder EasyCalcCheck)
+
+## 1. **Joomla Session Token**
+
+Das **Session Token** von Joomla stellt sicher, dass das Formular nur von einem gültigen Benutzer abgesendet wird. Ein **Session Token** wird automatisch generiert, wenn ein Benutzer sich bei der Website anmeldet, und es hilft zu verhindern, dass ein Bot das Formular absendet.
+
+### **Funktionsweise:**
+- Wenn das Formular abgeschickt wird, wird das **Session Token** überprüft, um sicherzustellen, dass der Benutzer berechtigt ist, das Formular abzusenden.
+- Wenn das Token ungültig oder abgelaufen ist, wird die Anfrage abgelehnt, und der Benutzer erhält eine Fehlermeldung.
+
+### **Verwendung:**
+Aktiviere die Option **Joomla Session** im Formular, um diesen Schutz zu aktivieren. Wenn diese Option aktiviert ist, überprüft das Formular, ob das Token gültig ist, bevor es die Daten absendet.
+
+## 2. **Honeypot-Feld**
+
+Das **Honeypot-Verfahren** ist ein unsichtbares Feld, das speziell für Bots entwickelt wurde. Menschliche Benutzer sehen dieses Feld nicht, während Bots automatisch alle Formularfelder ausfüllen. Wenn das unsichtbare Honeypot-Feld ausgefüllt wird, weiß das System, dass es sich um einen Bot handelt.
+
+### **Funktionsweise:**
+- Ein unsichtbares Feld wird zum Formular hinzugefügt, das von echten Benutzern nicht gesehen werden kann.
+- Wenn das Feld dennoch ausgefüllt wird (was nur ein Bot tun würde), wird die Anfrage abgelehnt.
+- Zusätzlich gibt es eine Zeitüberprüfung: Wenn das Formular zu schnell abgesendet wird (was auf automatisiertes Ausfüllen hindeutet), wird die Anfrage ebenfalls abgelehnt.
+
+### **Verwendung:**
+Aktiviere das **Honeypot-Feld**, indem du es im Formular einfügst. Wenn ein Bot dieses Feld ausfüllt, wird die Anfrage automatisch abgelehnt.
+
+## 3. **Captcha (Google reCaptcha oder EasyCalcCheck)**
+
+Das **Captcha** stellt sicher, dass das Formular von einem echten Benutzer und nicht von einem Bot ausgefüllt wird. Das Modul unterstützt zwei verschiedene Captcha-Systeme: **Google reCaptcha** und **EasyCalcCheck** von Viktor Vogel.
+
+### **Funktionsweise:**
+- **reCaptcha**: Ein bekannter Dienst von Google, der eine kleine Herausforderung für den Benutzer stellt (z. B. Auswahl von Bildern oder Eingabe eines Textes), um sicherzustellen, dass der Benutzer ein Mensch ist.
+- **EasyCalcCheck**: Eine einfachere, aber ebenfalls wirksame Methode zur Verifizierung von menschlichen Benutzern. Diese Methode verwendet einfache mathematische Berechnungen, die der Benutzer lösen muss.
+
+### **Verwendung:**
+Aktiviere das Captcha, indem du die entsprechende Option im Formular auswählst und das gewünschte Captcha (reCaptcha oder EasyCalcCheck) konfigurierst. Das Formular wird den Benutzer auffordern, das Captcha zu lösen, bevor es abgeschickt werden kann.
+
+---
+
+## Zusammenfassung der Schutzmaßnahmen:
+
+- **Joomla Session Token**: Verhindert, dass unbefugte Benutzer das Formular absenden. Es stellt sicher, dass nur berechtigte Benutzer das Formular ausfüllen können.
+- **Honeypot-Feld**: Ein unsichtbares Feld, das automatisch von Bots ausgefüllt wird und dadurch ihre Anfragen erkennt und blockiert.
+- **Captcha**: Ein visueller Test, der sicherstellt, dass das Formular von einem echten Benutzer und nicht von einem Bot ausgefüllt wird.
+
+Diese Schutzmaßnahmen stellen sicher, dass dein Formular sicher vor Spam und Missbrauch ist. Wenn du zusätzliche Anpassungen oder eine detaillierte Erklärung zu einem dieser Schutzmechanismen benötigst, lass es mich wissen!

src/kicktemp-addons-for-yootheme-pro/module/form/index.md

@@ -1,7 +1,46 @@
-# Overview - Form
+# Formular-Modul für YOOtheme Pro
 
-## Einführung
+Das Formular-Modul für YOOtheme Pro ermöglicht dir, benutzerdefinierte Formulare zu erstellen und diese dynamisch in deine Templates zu integrieren. Es bietet eine leistungsstarke Möglichkeit, Formularfelder zu erstellen, zu konfigurieren und zu verarbeiten – ganz nach deinen Bedürfnissen.
 
-Mit dem Formular Addon kannst du Formulare erstellen. Dafür stellt dir das Addon zwei Elemente zur Verfügung: das Form- Element und das Toggle- Modal- Element. Es können verschiedene Felder erstellt und die Inhalte dieser Felder per E-Mail versendet werden.
+### Warum ist das Formular-Modul wichtig?
 
-## Video
+Formulare sind auf nahezu jeder Website unerlässlich – sei es für Kontaktformulare, Newsletter-Anmeldungen oder Umfragen. Das **Formular-Modul** für YOOtheme Pro bietet dir die Flexibilität, Formulare zu gestalten und mit dynamischen Inhalten zu füllen. Es ermöglicht dir, Felder anzupassen, die mit bestimmten Daten aus dem Backend, z.B. Benutzerinformationen oder Produktdaten, vorab gefüllt werden.
+
+Das Modul versendet beim Absenden des Formulars eine E-Mail, die an einen Empfänger gesendet wird. Dabei kannst du die Formularfelder nach Bedarf verarbeiten und anpassen, bevor sie abgesendet werden. Besonders wichtig ist, dass du sowohl vor als auch nach dem Absenden auf die Felder zugreifen kannst, um sie weiter zu verarbeiten.
+
+### Wichtige Features:
+
+- **Flexibilität**: Anpassbare Formulare mit verschiedenen Feldtypen wie Text, E-Mail, Dateiuploads und mehr.
+- **Dynamische Felder**: Felder können mit dynamischen Inhalten aus dem CMS befüllt werden.
+- **E-Mail-Benachrichtigungen**: Formulardaten können per E-Mail verschickt werden.
+- **Spam-Schutz**: Unterstützt verschiedene Mechanismen wie Captcha und Honeypot zur Spam-Vermeidung.
+- **Trigger vor und nach Absenden**: Vor und nach dem Absenden des Formulars können Trigger verwendet werden, um zusätzliche Felder zu verarbeiten.
+
+### Wie funktioniert das Formular-Modul?
+
+Das Formular-Modul funktioniert auf der Basis von benutzerdefinierten Feldern, die im Backend konfiguriert werden. Sobald ein Benutzer das Formular ausfüllt und absendet, wird eine E-Mail an die definierten Empfänger gesendet. Du kannst zudem entscheiden, ob nach dem Absenden eine Bestätigungsnachricht angezeigt wird oder ob der Benutzer auf eine andere Seite weitergeleitet wird.
+
+Die Konfiguration des Formulars erfolgt über eine benutzerfreundliche Oberfläche, die es dir ermöglicht, Formularelemente hinzuzufügen, zu bearbeiten und deren Verhalten anzupassen. Jedes Formularfeld kann durch die Verwendung von **Triggers** und **Ereignissen** vor und nach dem Absenden angepasst werden.
+
+### Funktionsweise der Formularverarbeitung
+
+Das Formular-Modul empfängt die Formulardaten und verarbeitet diese durch eine `submit`-Methode. Dabei wird eine Reihe von Validierungen und Verarbeitungsschritten durchgeführt:
+
+1. **Verarbeitung der Formulardaten**: Die Formulardaten werden nach dem Absenden durch die `submit`-Methode verarbeitet.
+2. **Überprüfung der Sicherheitsmerkmale**: Zunächst werden Sicherheitsmaßnahmen wie Token und Honeypot überprüft.
+3. **Datenweiterverarbeitung**: Nach der Validierung wird das Formular weiterverarbeitet. Es können Trigger wie `onKickyooaddonsBeforeSubmit` und `onKickyooaddonsAfterSubmit` genutzt werden, um auf die Formulardaten zuzugreifen und diese weiter zu verarbeiten.
+4. **E-Mail-Versand**: Sobald die Daten verarbeitet sind, wird eine E-Mail an die angegebenen Empfänger gesendet.
+5. **Benachrichtigungen**: Das Formular-Modul kann auch Benachrichtigungen an den Benutzer senden oder eine Weiterleitung auf eine andere URL vornehmen.
+
+### Flexibilität durch Trigger
+
+Ein besonders leistungsstarkes Feature des Formular-Moduls ist die Möglichkeit, auf die Formularfelder vor und nach dem Absenden zuzugreifen. Über die `before`- und `after`-Submit-Trigger kannst du benutzerdefinierte Logiken implementieren, bevor das Formular abgeschickt wird oder nachdem die Antwort versendet wurde. Das gibt dir die Flexibilität, Daten zu verarbeiten oder zu ändern, ohne die Formularstruktur selbst zu verändern.
+
+#### Beispiele:
+
+- **Vor dem Absenden**: Du kannst die Formulardaten vor dem Absenden validieren oder ergänzen.
+- **Nach dem Absenden**: Du kannst Benachrichtigungen anzeigen, Weiterleitungen vornehmen oder die E-Mail weiter anpassen.
+
+Das Formular-Modul ist daher besonders geeignet für dynamische Webanwendungen, in denen Formulardaten in Echtzeit verarbeitet und flexibel angezeigt werden müssen.
+
+---