Bearbeiten von „Formulare mit Extbase und Fluid“

== Links ==
 http://docs.typo3.org/typo3cms/ExtbaseGuide/Fluid/ViewHelper/Form/Index.html

== Überblick ==
* Falls nicht vorhanden gewünschte Action registrieren (localconf) und im Controller anlegen
* Fluid Form erstellen
* Mit Absenden oder AJAC Call ausführen
=== Formular Felder im Fluid Template ===
 http://wiki.typo3.org/Fluid#f:form
 http://wiki.typo3.org/Fluid#form_fields
==== Input Feld ====
 <f:form.textfield property="rmaType" />
==== Radio Buttons ====
 http://wiki.typo3.org/Fluid#f:form.radio
 http://docs.typo3.org/typo3cms/ExtbaseGuide/Fluid/ViewHelper/Form/Radio.html

==== Form Tag (Action)====
'''Beispiel'''
<pre>
<f:form action="BestimmteFormAction" controller="BestimmterControllerName" extension="AndererExtensionName" enctype="multipart/form-data">
Form-Felder
</f:form>
</pre>
'''Beispiel'''
<pre>
<f:form action="create" object="{newProject}">
 Projektname: <f:form.textbox property="name" />
 <f:form.submit value="Speichern" />
</f:form>
</pre>
Das '''Controller Attribut''' benötigt man '''nur dann, wenn der Controller der die Daten auswerten soll nicht zum aktuellen View gehört.'''

==== Name Attribute ====
Das '''name-Attribut''' wird automatisch für das Plugin passend umgewandelt.
 <f:form.textfield name="myField" /> 
wird zu 
 <input type="text" name="tx_registierung_pi1[myField]" />
Sendet das Formular nun z.B. an einen Controller: showAction, stehen die Werte als Argumente zur Verfügung:
<pre>
public function showAction() {
  $args = $this->request->getArguments();
  echo $args['myField];
}
</pre>
Extbase vergleicht dabei zusätzlich automatisch die Felder aus dem Formular mit dem Model '''validiert automatisch'''.

== Tipps und Tricks ==
=== Zusätzliche Argumente im <f:link.action> View Helper ===
Standardmäßig sieht ein Action Link z.B. in der Listenansicht etwa so aus:
<syntaxhighlight lang="html5">
<f:for each="{dinge}" as="ding">                 
    <f:link.action action="show" arguments="{ding : ding}">Los</f:link.action>
</f:for>
</syntaxhighlight>
Es wird also ein ding-Objekt mit dem Bezeichner "ding" übergeben.
Möchte man weitere Argumente außer dem Objekt absetzen, z.B. ein String geht das so:
 arguments="{ding : ding, key : 'wert'}"
Es wird zusätzlich eine Variable key mit dem Wert 'wert' übergeben.

Im Controller holt man sich den Wert wieder raus:

Als Argument in der Controller Deklarierung
<syntaxhighlight lang="php">
public function showAction(\TYPO3\Extension\Domain\Model\Dinge $dinge, $key)
</syntaxhighlight>
oder im Controller selbst
<syntaxhighlight lang="php">
$key = $this->request->getArgument('key');
</syntaxhighlight>

=== Dynamisch validieren je nach Auswahl ===
http://blog.teamgeist-medien.de/2015/05/typo3-extbase-dynamische-validierung-von-models-je-nach-formularauswahl.html
=== Typo3/Fluid: Verschiedene Models über ein Formular bedienen ===
Quelle: http://www.muenster-webdesign.net/blog/typo3fluid-verschiedene-models-ueber-ein-formular-bedienen/ (2015-03)

Dank der form-ViewHelper lassen sich Formulare mittels Extbase/Fluid recht zügig umsetzen. Bei komplexeren Szenarien, bei denen in einem Formular mehrere verschiedene Models bedient werden sollen, stellt sich jedoch die Frage, wie sich dies umsetzen lässt.

Die Lösung liegt darin, mit “namebased input”-Felder zu arbeiten. '''Statt also wie üblich eine Eigenschaft im Fluid-Formular per “property”-Attribut an ein Objekt zu binden, definiert man stattdessen die Argumente “name” und “value” manuell.'''

Ein Beispiel. Ein Formular ist per “object”-Attribut an ein Objekt “schornsteinfeger” gebunden. Soll im Formular nun gleichzeitig eine Eigenschaft “aussentemperatur” eines Objekts “wetter” bedient werden, könnte das Ganze etwa so aussehen:

<pre>
<f:form method="post" action="create" name="schornsteinfeger" enctype="multipart/form-data" object="{schornsteinfeger}">
  <f:form.textbox name="wetter[aussentemperatur]" value={wetter.aussentemperatur} />
</f:form>
</pre>

=== Felder validieren die nicht im Domain-Model vorhanden sind ===
Wenn man z.B. ein Captcha einbauen möchte braucht man Felder die nicht im Model sind. Die eingebauten Sicherheitsmechanismen in Extbase lassen dass aber nicht ohne weiteres zu. Hier wird ja automatisch jeder Wert mit dem Model abgeglichen.  
Möglichkeit 1 - Dummy Felder in das Model einbauen:
<pre>
/**
 * CAPTCHA
 *
 * @var string
 * @validate NotEmpty, Tx_MyExt_Validation_Validator_CaptchaValidator
 */
protected $captcha;
</pre>
Möglichkeit 2 - Validierer im Controller initialisieren

http://blog.sebastiaandejonge.com/articles/2013/january/17/form-validation-of-non-domain-model-properties-with-extbase/

=== Statische Optionen in Selectboxen ===
http://docs.typo3.org/typo3cms/ExtbaseGuide/stable/Fluid/BestPractice/OptionsForSelect.html