Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen der Seite angezeigt.

--- typo3:form [2017/07/04 19:58] – Finisher: SaveToDatabase admin
+++ typo3:form [2023/04/26 20:02] (aktuell) – [Finisher: SaveToDatabase und Datei-Upload] admin
@@ Zeile 21: / Zeile 21: @@
 ===== Konfigurationen =====
+==== Finisher Confirmation: Nachricht in Plugin ändern ====
+Mit der folgenden Konfiguration lässt sich die Nachricht, die nach Absenden des Formulars angezeigt wird, vom Redakteur über das Plugin individuell anpassen.
+<code yaml>
+TYPO3:
+  CMS:
+    Form:
+      prototypes:
+        standard:
+          finishersDefinition:
+            Confirmation:
+              FormEngine:
+                label: 'formEditor.element.AdvancedPassword.editor.confirmationLabel.predefinedDefaults'
+                elements:
+                  message:
+                    label: 'formEditor.elements.Form.finisher.Confirmation.editor.header.label'
+                    config:
+                      type: 'input'
+</code>
 ----
@@ Zeile 76: / Zeile 97: @@
             mapOnDatabaseColumn: 'message'
 </code>
+==== Finisher: SaveToDatabase und Datei-Upload ====
+Wenn das Formular ein Feld des Typs //FileUpload// oder //ImageUpload// enthält, wird beim Hochladen der Datei automatisch ein Eintrag in der Datenbanktabelle //sys_file// erzeugt.
+Mit dem ''SaveToDatabase'' Finisher lassen sich nun die benötigten Datei-Referenzen erzeugen:
+  * In einer eigenen Tabelle für Formular-Einträge wird die UID des //sys_file//-Eintrags gespeichert.
+  * In der Tabelle //sys_file_reference// wird diese UID auf das Feld ''uid_local'' gemappt. Außerdem werden in weiteren Feldern der eigene Tabellenname, das dazugehörige Feld und – unter ''uid_foreign'' – die UID des neu angelegten Datensatzes in der eigenen Tabelle referenziert.
+Im TYPO3-Backend ist die hochgeladene Datei damit korrekt dem Datensatz in der eigenen Datenbanktabelle zugeordnet.
+<code yaml>
+type: Form
+identifier: UploadForm
+label: 'Upload form'
+prototypeName: standard
+finishers:
+  -
+    identifier: SaveToDatabase
+    options:
+      -
+        table: 'tx_deine_datenbanktabelle'
+        mode: insert
+        databaseColumnMappings:
+          pid:
+            value: 6
+          crdate:
+            value: '{__currentTimestamp}'
+          tstamp:
+            value: '{__currentTimestamp}'
+          formtitle:
+            value: 'Upload form'
+        elements:
+          fileupload:
+            mapOnDatabaseColumn: 'feld_in_deiner_datenbanktabelle'
+      -
+        table: sys_file_reference
+        mode: insert
+        elements:
+          fileupload:
+            mapOnDatabaseColumn: 'uid_local'
+        databaseColumnMappings:
+          # Achtung: ab TYPO3 v12 müssen die beiden nachfolgenden Zeilen entfernt werden!
+          table_local:
+            value: 'sys_file'
+          tablenames:
+            value: 'tx_deine_datenbanktabelle'
+          fieldname:
+            value: 'feld_in_deiner_datenbanktabelle'
+          tstamp:
+            value: '{__currentTimestamp}'
+          crdate:
+            value: '{__currentTimestamp}'
+          uid_foreign:
+            value: '{SaveToDatabase.insertedUids.0}'
+renderables:
+  -
+    type: Page
+    identifier: page-1
+    label: Page
+    renderables:
+      -
+        properties:
+          saveToFileMount: '1:/user_upload/'
+          allowedMimeTypes:
+            - application/pdf
+          fluidAdditionalAttributes:
+            required: required
+        type: FileUpload
+        identifier: fileupload
+        label: 'Datei hochladen'
+        validators:
+          -
+            identifier: NotEmpty
+</code>
+Der Ruhm hierfür gilt **Olaf Schmidt-Wischhöfer**; er hat die Lösung am 26. Juni 2017 in Slack veröffentlicht!
 ----
@@ Zeile 87: / Zeile 185: @@
 Ein möglicher Anwendungsfall ist, den Titel der aktuellen Seite im Formular mit zu übergeben. Oder einen GET-Parameter auszulesen und damit ein Feld vorauszufüllen. Mit TypoScript, ''formDefinitionOverrides'' und //getText// können Formularfelder dynamisch befüllt werden.
-Die Anzahl und Verschachtelung der ''renderables'' sowie die Indexnummer des Feldes ist für jedes Formular individuell verschieden, da es von den verwendeten Feldern und der Nutzung von Fieldsets und Grids abhängt. Im Zweifelsfall kann man im Fluid-Template mit ''<f:debug>{form.currentPage}</f:debug>'' die Verschachtelung im Frontend ausgeben.
+Die Anzahl und Verschachtelung der ''renderables'' sowie die Indexnummer des Feldes ist für jedes Formular individuell verschieden, da es von den verwendeten Feldern und der Nutzung von Fieldsets und Grids abhängt.
+<WRAP center round tip 100%>
+Die korrekte Verschachtelung entnimmt man am besten direkt der Konfiguration. Im folgenden Beispiel habe ich versucht, dies zu verdeutlichen. Die Indexnummern der ''renderables'' beginnen immer bei ''0''.
+Mit ''<f:debug>{form.currentPage}</f:debug>'' lassen sich zwar auch die renderables ausgeben, hier werden aber noch versteckte Felder wie der Honeypot hinzugefügt, wodurch sich die Indexnummer ändern kann.
+</WRAP>
+**ContactForm.yaml**
+<code yaml>
+identifier: contactForm
+label: ContactForm
+type: Form
+prototypeName: standard
+renderables:
+  -
+    identifier: page-1
+    label: 'Contact Form'
+    type: Page
+    renderables:
+      -
+        defaultValue: ''
+        identifier: name
+        label: Name
+        type: Text
+        properties:
+          fluidAdditionalAttributes:
+            placeholder: Name
+        validators:
+          -
+            identifier: NotEmpty
+      -
+        defaultValue: ''
+        identifier: subject
+        label: Subject
+        type: Text
+        properties:
+          fluidAdditionalAttributes:
+            placeholder: Subject
+        validators:
+          -
+            identifier: NotEmpty
+      -
+        defaultValue: ''
+        identifier: email
+        label: Email
+        type: Text
+        properties:
+          fluidAdditionalAttributes:
+            placeholder: 'Email address'
+        validators:
+          -
+            identifier: NotEmpty
+          -
+            identifier: EmailAddress
+      -
+        defaultValue: ''
+        type: Hidden
+        identifier: pagetitle
+        label: Page title
+      -
+        defaultValue: ''
+        identifier: message
+        label: Message
+        type: Textarea
+        properties:
+          fluidAdditionalAttributes:
+            placeholder: ''
+        validators:
+          -
+            identifier: NotEmpty
+</code>
+**TypoScript:**
 <code typoscript>
 plugin.tx_form.settings {
     formDefinitionOverrides {
-        // bitte den richtigen Identifier eintragen:
+        // bitte den richtigen Formular-Identifier eintragen:
-        identifier_des_formulars {
+        contactForm {
+            // auf root-Ebene der Formular-Definition:
             renderables {
+                // Erstes Element - identifier: page-1
 {
                     renderables {
-                        // Indexnummer
+                        // Viertes Element unterhalb von page-1 - identifier: pagetitle
  {
                             defaultValue = TEXT
                             defaultValue.data = page:title
-                        }
-{
-                            label = TEXT
-                            label.value = Alternatives Label für Feld
                         }
                     }
@@ Zeile 113: / Zeile 282: @@
     }
 }
+</code>
+----
+===== Templating =====
+==== Formular in Fluid-Template rendern ====
+Aufgrund eines Bugs können Formulare nur mit einem Workaround in Website-Templates integriert werden.
+- Issue: https://forge.typo3.org/issues/92406
+**TypoScript:**
+<code typoscript>
+lib.embeddedForm = FLUIDTEMPLATE
+lib.embeddedForm {
+    template = TEXT
+    template {
+        value = <formvh:render persistenceIdentifier="EXT:sitepackage/Resources/Private/Forms/embeddedForm.form.yaml" />
+    }
+    extbase {
+        pluginName = Formframework
+        controllerExtensionName = Form
+        controllerName = FormFrontend
+        controllerActionName = perform
+    }
+}
+</code>
+**Fluid:**
+<code html>
+<f:cObject typoscriptObjectPath="lib.embeddedForm" />
+</code>
+Danke an Daniel Siepmann, der die Lösung am 6. Oktober 2020 in Slack gepostet hat!
+----
+==== templateRootPaths für Formulare einrichten ====
+<code yaml>
+TYPO3:
+  CMS:
+    Form:
+      prototypes:
+        myCustomForm:
+          __inheritances:
+: 'TYPO3.CMS.Form.prototypes.standard'
+          formElementsDefinition:
+            Form:
+              renderingOptions:
+                templateRootPaths:
+: 'EXT:form_distribution/Resources/Private/Frontend/Templates/'
+                partialRootPaths:
+: 'EXT:form_distribution/Resources/Private/Frontend/Partials/'
+                layoutRootPaths:
+: 'EXT:form_distribution/Resources/Private/Frontend/Layouts/'
+</code>
+==== Eigene Templates für E-Mails ====
+Aktuell ist das Form Framework so eingerichtet, dass die o.g. templateRootPaths **nicht** für die E-Mail-Templates gelten.
+Bis dies behoben ist, können alternative Templates direkt im Finisher des Formulars verknüpft werden.
+**ContactForm.yaml**
+<code yaml>
+finishers:
+  -
+    identifier: EmailToSender
+    options:
+      subject: '{subject}'
+      recipientAddress: your.company@example.com
+      recipientName: '{name}'
+      senderAddress: '{email}'
+      senderName: ''
+      replyToAddress: ''
+      carbonCopyAddress: ''
+      blindCarbonCopyAddress: ''
+      format: html
+      attachUploads: 'true'
+      templatePathAndFilename: 'EXT:form_distribution/Resources/Private/Frontend/Templates/Finishers/Email/{@format}.html'
+</code>
+Forge: [[https://forge.typo3.org/issues/80974|Bug #80974: Form Email finisher doesn't support templateRootPaths]]
+----
+===== Personalisierte Anrede in E-Mails =====
+**Form Definition**:
+<code yaml>
+renderables:
+  -
+    identifier: page-1
+    label: 'Contact Form'
+    type: Page
+    renderables:
+      -
+        properties:
+          options:
+            Herr: Herr
+            Frau: Frau
+          prependOptionLabel: 'Bitte wählen ...'
+          fluidAdditionalAttributes:
+            required: required
+        type: SingleSelect
+        identifier: title
+        label: Title
+        validators:
+          -
+            identifier: NotEmpty
+      -
+        defaultValue: ''
+        type: Text
+        identifier: lastname
+        label: 'Nachname'
+        properties:
+          fluidAdditionalAttributes:
+            required: required
+            placeholder: 'Nachname'
+        validators:
+          -
+            identifier: NotEmpty
+</code>
+**/Finishers/Email/Html.html:**
+<code html>
+<f:switch expression="{form.formState.formValues.title}">
+    <f:case value="Herr">Sehr geehrter Herr {form.formState.formValues.lastname},</f:case>
+    <f:case value="Frau">Sehr geehrte Frau {form.formState.formValues.lastname},</f:case>
+    <f:defaultCase>Sehr geehrte Damen und Herren,</f:defaultCase>
+</f:switch>
 </code>

Snippets + Wiki

Benutzer-Werkzeuge

Webseiten-Werkzeuge

Unterschiede

Seiten-Werkzeuge