dmk/mkforms

Making HTML forms for TYPO3

v11.0.8 2023-11-13 11:29 UTC

Requires

• php: ^7.4 || ^8.0
• digedag/rn-base: ~1.16.12
• typo3/cms-core: ^10.4.23 || ^11.5.5

Requires (Dev)

• dmk/mklib: ^11.0
• friendsofphp/php-cs-fixer: ^3.3
• nimut/testing-framework: ^6.0
• php-parallel-lint/php-parallel-lint: ^1.3
• phpcompatibility/php-compatibility: ^9.3.5

Suggests

• dmk/mksanitizedparameters: keeps your parameters clean and safe

Replaces

• typo3-ter/mkforms: v11.0.8

GPL-2.0-or-later

• Michael Wagner
• René Nitzsche

• Forms
• TYPO3 CMS
• formidable

README

What does it do?

Die TYPO3-Extension MKFORMS ermöglicht es HTML-Formulare für das Frontend zu erstellen. Das komplette Formular wird dabei in einer XML-Datei (oder alternativ per Typoscript) beschrieben.

Fork von ameos_formidable

Bei MKFORMS handelt es sich um einen Fork der TYPO3-Extension ameos_formidable. Ein Ziel der Entwicklung ist es weitestgehend kompatibel zu dieser Extension zu bleiben. Das Format der XML-Datei wird dabei nur in dringenden Fällen geändert, nach Möglichkeit aber höchstens erweitert. Die Dokumentation und die Beispiele für ameos_formidable sollten daher fast immer funktionieren.

• http://formidable.typo3.ug/
• http://formidable.typo3.ug/reference.html
• http://wiki.typo3.org/index.php/Formidable_documentation

Zur Online Dokumentation

Ziele des Forks

Obwohl ameos_formidable einen extrem hohen Entwicklungsgrad hat, gibt es einige Punkte, die den Einsatz der Extension erschweren bzw. verhindern. Der Fork soll folgende Probleme beheben:

• Einsatz verschiedener JS-Bibliotheken wie JQuery. Ameos verwendet ausschließlich Prototype.
• Verzicht auf die PHP-Session. Damit ist der Einsatz in Cluster-Umgebungen nicht möglich.
• Einfachere Einbindung weiterer Formular-Elemente durch Auto-Loading Mechanismen. Ameos hat bisher ein sehr starres System.
• Vereinfachung der API und Refactoring des Codes. Die Haupt-Formularklasse hat inzwischen über 8000 Zeilen Code.
• es wird weiter entwickelt
• TYPO3 6.2 kompatibel
• Migration von ameos_formidable Formularen relativ einfach möglich
• Erweiterung der Widgets einfach möglich
• Caching
• mehr Sicherheitsfeatures
• rn_base Plugin zur Ausgabe
• Uploadwidget für DAM und FAL
• Fluidviewhelper
• generischer Datahandler
• verbesserter userfunc Ausruf innerhalb von Formularen

Breaking Changes since 10.4

• template paths have changed and need to be changed in all xml files and TypoScript configuration:
  • EXT:mkforms/templates/formonly.html is now EXT:mkforms/Resources/Private/Templates/formonly.html
    • May be used in plugins. So use this SQL query to migrate old paths in plugins:

      UPDATE tt_content SET pi_flexform = REPLACE(pi_flexform, 'mkforms/templates/formonly.html', 'mkforms/Resources/Private/Templates/formonly.html');

  • EXT:mkforms/widgets/lister/res/html/default-template.html is now EXT:mkforms/Resources/Private/Templates/Widgets/Lister/default-template.html