CW Forms

Version 0.2.0-beta14

Kompatibilitaet

• Mindeststand auf CW 3.0.0-beta8 angehoben.
• Erweiterte Formularbedingungen werden nun vollstaendig durch die Form Foundation aus CW 3.0.0-beta8 ausgewertet.
• Unterstuetzt kombinierte AND/OR-Bedingungen sowie equals, not_equals, contains, not_contains, empty und not_empty.

Wichtig

• Keine Formularschema-Migration erforderlich.
• Bestehende Formulare, Vorlagen und gespeicherte Anfragen bleiben unveraendert.
• Funktional entspricht das Modul beta13; beta14 korrigiert vor allem die reale Core-Abhaengigkeit und kennzeichnet die Beta8-Kompatibilitaet sauber.

Version 0.2.0-beta13

Neu

• Formular-Vorlagenbibliothek direkt im Backend.
• Klare Trennung zwischen Vorlagen und Beispielen.
• Jede Karte zeigt eine kurze Beschreibung, Funktions-Badges und den enthaltenen Formularaufbau.
• Vorlagen werden als unabhängige Kopie in project/storage/forms/forms.json angelegt.
• Mehrfaches Verwenden erzeugt automatisch freie Formular-Keys (z. B. kontakt-2).
• IDs von Schritten, Elementen, Feldgruppen und Aktionen werden beim Kopieren neu erzeugt.
• Mitgeliefert
• Vorlage: Kontaktformular
• Vorlage: Rückrufbitte
• Vorlage: Beratungsanfrage
• Beispiel: Bedingungen & Routing

Hinweis

• Beim Erstellen aus einer Vorlage werden keine bestehenden Formulare verändert.
• Vorbereitete Betreiber-Mail-Aktionen in Vorlagen sind standardmäßig deaktiviert, bis ein Empfänger konfiguriert wurde.

Version 0.2.0-beta12

Fix: Adaptive Routing wurde nach Modulupdates teilweise nicht aktiv, weil

• forms.js unter derselben cw-module-asset.php-URL bis zu 3600 Sekunden im
• Browsercache bleiben konnte.

Neu

• Frontend-CSS/JS erhalten einen dateibasierten Versions-Fingerprint.
• Auch Forms-Admin-CSS/JS werden versionssicher ausgeliefert.
• Ein Update auf eine neue Forms-Version lädt geänderte Assets daher sofort.
• Keine Änderung am Formularschema erforderlich.
• Das adaptive Routing aus beta11 bleibt unverändert:
• Schrittbedingungen (show_if)
• bedingte Feldgruppen
• required_if
• dynamische Fortschrittsanzeige
• Überspringen nicht relevanter Schritte

Version 0.2.0-beta11

• Adaptive Multi-Step-Formulare: Schritte können abhängig von Feldwerten in den Ablauf ein- oder ausgeschlossen werden.
• Weiter/Zurück überspringt automatisch nicht passende Schritte; die Fortschrittsanzeige wird dynamisch neu nummeriert.
• Bedingungsgruppen: mehrere Elemente eines Schritts gemeinsam anzeigen oder ausblenden.
• show_if und required_if erhalten Operatoren: ist gleich, ist nicht gleich, enthält, enthält nicht, ist leer, ist nicht leer.
• Bedingungen werden für die Versandpipeline mit Schritt- und Gruppenbedingungen kombiniert.
• Serverseitige Auswertung benötigt den zugehörigen CW-beta7 Adaptive-Conditions-Core-Hotfix.

Version 0.2.0-beta10

• Abschlussansicht: „Erneute Anfrage senden“ ist für neue Formulare standardmäßig aktiv.
• Alte Legacy-Abschlussansichten aus beta7-beta9 mit unverändertem Standard werden einmalig migriert.
• Der Neustart löscht nur den Abschlusszustand des betroffenen Formulars und startet wieder bei Schritt 1.
• Explizite success_completion-Aktionen mit bewusst deaktiviertem Neustart bleiben unverändert.
• Standardbeschriftung: „Erneute Anfrage senden“.

Version 0.2.0-beta9

• Neu: Felder besitzen optional eine eigene Mail-Bezeichnung (mail_label).
• Datenschutzfelder verwenden ohne eigene Mail-Bezeichnung automatisch „Datenschutzerklärung bestätigt“.
• Fix: {{link}} aus dem ausführlichen Frontend-Datenschutzlabel erscheint nicht mehr ungefiltert in internen Mails.
• Gespeicherte Anfragen verwenden dieselbe saubere Mail-Bezeichnung.
• Bestehende Formulare bleiben kompatibel; es ist keine Migration erforderlich.
• Kompatibel mit CW 3.0.0-beta7.

Version 0.2.0-beta8

• Fix: Mail-Aktions-Provider übernimmt den Feldkontext korrekt.
• Fix: Multi-Step/Wizard-Formulare liefern wieder eine vollständige flache Felderliste an den CW-Form-Core.
• Fix: Kurzplatzhalter wie {{concern}} werden in Betreiber-Mails wieder korrekt aufgelöst.
• Fix: {{all_fields}} enthält bei Wizard-Formularen wieder die übermittelten Angaben.
• Kompatibel mit CW 3.0.0-beta7.

Version 0.2.0-beta7

• Neue Abschlussaktion „Abschlussansicht“: ersetzt das Formular nach erfolgreichem Versand vollständig.
• Konfigurierbar: Titel, Text, optionales Bild, Bildposition und „Neue Anfrage senden“-Button.
• Bestehende Inline-, Popup-, Danke-Seiten- und Redirect-Aktionen bleiben kompatibel.
• Mail-Platzhalter unterstützen zusätzlich die Kurzform {{feldname}} und übersetzen sie intern sicher in {{field.feldname}}.
• Sitzungsabschluss/Reset bleibt serverseitig geschützt und funktioniert auch ohne gespeicherte Inbox-Anfrage.
• Mindeststand: CW 3.0.0-beta7 / PHP 8.3.

Version 0.2.0-beta6

Administration / Lesbarkeit

• Formularübersicht deutlich besser lesbar: größere Titel, Metadaten, Kennzahlen und Statusinformationen.
• Formular bearbeiten überarbeitet: größere Beschriftungen und Hilfetexte in Basis, Erfolg, Fehlerbehandlung, Struktur, Aktionen sowie Ausgabe & Template.
• Feld- und Elementoptionen besser lesbar; Labels, Hilfetexte, Eingaben und erweiterte Optionen vergrößert.
• Fehlerprotokoll mit größeren Formularschlüsseln, Statusangaben, Zeitstempeln, Meldungen und Aktionen.
• Anfrage-Details mit größeren Gruppenbezeichnungen und Werten; Status-Aktion erhält mehr Abstand.
• Löschen einer Anfrage ist als eindeutige rote Gefahrenaktion mit X gekennzeichnet.
• Formular & Struktur
• Strukturansicht neu geordnet und visuell entzerrt.
• Hinzufügen neuer Elemente ist jetzt klar in „Formularfeld“ und „Layout & Inhalt“ gruppiert.
• Layout-Elemente wie Überschrift, Text, Hinweisbox, Trenner und Zusammenfassung sind schneller erfassbar.
• Elementtyp, Titel, technischer Name, Breite und Bearbeitungsaktion sind besser lesbar.
• Neues HTML-Layout-Element
• Freie HTML-Inhalte können als Layout-Element in ein Formular eingefügt werden.
• HTML wird serverseitig gefiltert.
• Erlaubt sind typische Inhalts-Tags wie Absätze, Überschriften, Listen, Links, Bilder, Hervorhebungen und CSS-Klassen.
• Entfernt bzw. blockiert werden unter anderem Script, Style, iframe, object/embed, Formularfelder, Event-Handler und unsichere URL-Schemata.
• target="_blank" wird automatisch mit rel="noopener noreferrer" abgesichert.
• PHP ist bewusst kein Formularelement; ausführbarer Projektcode gehört weiterhin in Custom Templates.

Kompatibilität

• Keine Schema-Migration.
• Bestehende Formulare bleiben kompatibel.
• Mindestversion CW: 3.0.0-beta1
• Mindestversion PHP: 8.2
• Getestet mit CW 3.0.0-beta2.

Version 0.2.0-beta5

Stabilität / Datenintegrität

• Parallele Frontend-Submits eines Formulars werden per Formular-Lock serialisiert; Lost Updates im JSON-Anfrage-Speicher werden verhindert.
• Anfrage-Update, Statuswechsel und Löschen verwenden denselben Lock.
• Formularlöschung verwendet denselben Submission-Lock, damit kein Submit in den Löschvorgang hineinlaufen kann.
• Beschädigte forms.json oder Submission-JSON werden nicht mehr still als leer interpretiert. Schreibvorgänge brechen stattdessen sicher ab, damit vorhandene Daten nicht überschrieben werden.
• Das Leeren des Forms-Fehlerprotokolls meldet einen echten Dateisystemfehler statt fälschlich Erfolg.
• Keine Schema-Migration. Keine neuen Formularfunktionen.
• Release-Kompatibilität
• Dieses öffentliche beta5-Paket setzt CW 3.0.0-beta1 oder neuer voraus.

Version 0.2.0-beta1

Erster Beta-Release

• CW Forms erreicht mit diesem Stand die erste öffentliche Beta.
• Der Funktionsumfang wurde gegenüber 0.2.0-alpha20 bewusst nicht erweitert.
• Alpha20 wurde als feature-complete eingefroren; Beta1 setzt diesen getesteten Stand
• auf die neue CW-Basis 3.0.0-alpha12.
• Mindestanforderungen
• CW 3.0.0-alpha12
• PHP 8.2.0
• Enthalten
• strukturierter Formular-Builder mit beliebig vielen Schritten
• freie Feld- und Layout-Elemente
• Einspaltig / Mehrspaltig über 12er-Raster
• Radio, Select, Einzelcheckbox und echte Mehrfachauswahl
• Darstellungen Standard, Buttons, Karten und Bildkarten
• Optionstexte, Beschreibungen, Bilder, Badges und CW Icon Library
• Conditional Logic mit show_if und required_if
• Prüfen-/Zusammenfassungs-Element für den letzten Schritt
• Standardwerte sowie min/max für geeignete Feldtypen
• Datenschutzfeld mit {{link}}
• Speicherung von Anfragen pro Formular
• Status Neu / Gelesen / Erledigt
• Betreiber-Mail und Kundenbestätigung
• Erfolgsverhalten: Inline, Popup, Dankeseite oder Redirect
• Session-Abschluss nach erfolgreicher Übermittlung
• Submission-Token gegen versehentliche Doppelübermittlung
• array-sichere Verarbeitung von Mehrfachwerten
• Template-System mit Built-ins und Projekt-Templates
• integrierter Template-Editor auf Basis der CW Editor Foundation
• zentraler CW Icon Library Selector im Options-Builder
• Wichtige Submit-Semantik
• Eine bereits sicher gespeicherte Anfrage bleibt erfolgreich, auch wenn eine
• nachgelagerte Betreiber-Mail fehlschlägt. Der Mailfehler wird protokolliert und
• am Submission-Status geführt.

Kompatibilität

• Dieser Beta-Stand benötigt die Forms Core Foundation aus CW 3.0.0-alpha12.
• Ältere CW-Versionen sind für 0.2.0-beta1 nicht freigegeben.
• Release-Grenze
• Vor 0.2.0 final werden keine neuen großen Feld- oder Workflow-Funktionen mehr
• aufgenommen. Bis dahin folgen nur Fehlerkorrekturen, Härtung und Praxistests.

Version 0.2.0-alpha1

• Forms 2 / Phase 2A: gespeicherte Anfragen je Formular mit eigener Inbox.
• Neue Anfragen werden vor Betreiber- und Kundenmail gespeichert.
• Anfrage-Status: Neu, Gelesen, Erledigt; Neu-Zähler in Formularübersicht.
• Detailansicht mit Feldgruppen sowie Betreiber-/Kunden-Versandstatus und Outbox-ID.
• Fehlerprotokoll für Submit- und Versandfehler.
• Betreiber-Mail-Template jetzt im Form Manager editierbar.
• Kundenbestätigung mit E-Mail-/Namensfeld, Betreff, Text und auswählbaren Feldern konfigurierbar.
• Erfolgsmodi: Infobox, Popup, Danke-Seite oder Redirect.
• Legacy-Import erweitert: Steps, required_if, Optionen, Layout-Metadaten und Kommunikation.
• Bedingte Pflichtfelder im Editor und im Frontend ergänzt.
• Neuer kleiner Core-Lifecycle-Hook für Submit-Handler; wird als separater CW-Patch geliefert.
• Dashboard-Integration bewusst noch nicht enthalten.

Version 0.1.0-alpha1

• Erstes öffentliches Alpha-Release von CW Forms.
• Form Manager zum Anlegen, Bearbeiten, Duplizieren und Verwalten von Formularen.
• Single-Page- und Multi-Step-Formulare aus demselben Schema.
• Feldtypen: Text, E-Mail, Telefon, URL, Zahl, Datum, Zeit, Textarea, Select, Radio, Checkbox, Datenschutz und Hidden.
• Layout-Elemente: Überschrift, Text und Trenner.
• Neutrale 12er-Breiten und optionale CSS-Klassen für freie Frontend-Layouts.
• Formular-Grundeinstellungen für Empfänger, Betreff, Reply-To, Erfolgsmeldung und Bestätigungsmail.
• Legacy-Import aus project/config/forms.php.
• Nutzung der CW Form Foundation, Security-, Validation- und Mail-Pipeline.
• Universelle Frontend-Einbindung über cw_form().
• Neues Modul-Icon und neues 1200x600-Cover nach CW Modul-CI.
• Mindestanforderung: CW 3.0.0-alpha11 und PHP 8.2.
• Paketbereinigung: keine .htaccess- oder anderen Server-Konfigurationsdateien im Modul.
• Forms-Storage verlässt sich nicht auf Apache-spezifische Laufzeit-Konfiguration.