In Fluid-Templates, die in TYPO3 Extensions mit Extbase verwendet werden, werden die Fehlermeldungen in der Regel in einem Block ausgegeben. Mit <f:form.errors /> können die Fehlermeldungen ausgegeben werden, die beim Validieren des Formulars aufgetreten sind. Der Kickstarter erstellt dabei einen Schnipsel, der ungefähr so aussieht:

<f:form.errors>
	<div class="error">
		{error.message}
		<f:if condition="{error.propertyName}">
			<p>
				<strong>{error.propertyName}</strong>:
				<f:for each="{error.errors}" as="errorDetail">
					{errorDetail.message}
				</f:for>
			</p>
		</f:if>
	</div>
</f:form.errors>

Und mit <f:render partial=“FormErrors“ /> wird dieses Partial in einem Template verwendet und gibt alle Fehler aus. Der Wert propertyName enthält in der äußeren Schleife den Namen des Formulars, im Beispiel Simpleblog also Blog oder Post. Und in der inneren Schleife den Namen des Feldes, z.B. title oder description.

Was ist aber, wenn man die Fehlermeldung direkt neben dem Feld ausgeben möchte. Es gibt natürlich die Möglichkeit einen ViewHelper zu schreiben. Ich wollte aber ohne zusätzlichen ViewHelper auskommen. Das Ergebnis ist ein Partial FieldError:

<f:form.errors for="{formName}">
    <f:if condition="{0:error.propertyName} == {0:'{fieldName}'}">
        <f:for each="{error.errors}" as="errorItem">
            <strong style="color: red;">{errorItem.message}</strong>
        </f:for>
    </f:if>
</f:form.errors>

Diese Partial kann in einem weiteren Partial oder einem Template einfach aufgerufen werden und gibt die Fehlermeldungen für ein Feld aus.

<f:render partial="FieldError" arguments="{ errors: errors, formName: 'blog', fieldName: 'title' }" />

Der erste Parameter sind die Fehlermelodungen, der zweite Parameter der Name des Formulars und der dritte der Name des Feldes.

So!

$settings = $this->templateVariableContainer->get('settings');

Ich habe ein wenig gesucht und es scheint mir, als würde die Select-Box von Fluid, die als View-Helper zur Verfügung gestellt wird, nur aus den Daten ein Auswahlfeld machen, die ihr gegeben werden. Wenn man z.B. Kategorien hat und man möchte nicht nur die Kategorien in der Auswahlliste anzeigen, sondern auch eine Option zum Zurücksetzen der Auswahl, also sowas wie „Alle Kategorien“, dann gibt es keinen Tag dafür.

Dazu habe ich einen View Helper erstellt, der von dem Select View Helper ableitet (Tx_Fluid_ViewHelpers_Form_SelectViewHelper). Dann habe ich einen zusätzlichen Parameter registriert in der Init-Function:

public function initializeArguments() {
	parent::initializeArguments();
	$this->registerArgument('additionalOptions', 'array', 'Associative array with values to prepend', FALSE);
}

Und die getOptions-Funktion so weit angepasst, dass die zusätzlichen Optionen vor die automatisch zusammengestellten angehängt werden:

protected function getOptions() {
	$options = parent::getOptions();
	$additionalOptions = array();
	foreach ($this->arguments['additionalOptions'] as $key => $value) {
		$additionalOptions[$key] = $value;
	}
	return array_merge($additionalOptions, $options);
}

Und so kann man es dann im eigenen Template verwenden:

<custom:advSelect name="category" options="{categories}" optionLabelField="title" additionalOptions="{0 : 'Alle Kategorien'}" />

UPDATE:
Es gibt mit dem Code ein kleines Problem, und zwar werden beim Zusammenfügen von Arrays die Schlüssel neu nummeriert. Daher:

protected function getOptions() {
	$options = parent::getOptions();
	if(empty($this->arguments['additionalOptions'])) {
		return $options;
	}
	foreach ($this->arguments['additionalOptions'] as $key => $value) {
		$additionalOptions[$key] = $value;
	}
	return $additionalOptions + $options;
}

Eine normale TYPO3 Downloadliste stellt normalerweise eine Liste von Dateien als Tabelle dar, die Dateinamen sind dabei verlinkt und der Beschreibungstext, den man zusätzlich angeben kann, erscheint darunter. Man kann das Rendering der Liste jedoch anpassen, wenn man weiß, was zur Verfügung steht.
Ein Blick in den Quellcode zeigt, dass viele Informationen ins TYPO3-Register geschoben werden, auf das Register kann mit dem Keyword „register:“ per TS zugegriffen werden. Folgende Informationen werden ins Register gespeichert: linkedIcon, linkedLabel, filename, path, description, fileSize, fileExtension
So kann man das Rendering anpassen, damit anstatt Dateinamen die Beschreibung angezeigt wird. Einziger Nachteil dieses Schnipsels: es muss immer eine Beschreibung angegeben werden.

(mehr …)