Verwendung von FAL (File Abstraction Layer) mit TemplaVoila

Seit TYPO3 6.0 gibt es einen eingebauten File Abstraction Layer (kurz FAL) mit dem es möglich ist, eine Datei als Referenz statt einer Kopie zu erstellen. Üblicherweise wird beim auswählen eines Bildes oder Datei in TYPO3 immer eine Kopie im Ordner „uploads/tx_extension“ erstellt. Wenn man aber nun mit vielen hundert Dateien arbeiten muss, ist abzusehen, dass über einen längeren Zeitraum alle Verzeichnisse gelinde gesagt „zumüllen“. Um dieses Problem zu verhindern, gibt es nun den FAL, der dazu dient Dateien zu indizieren und zu referenzieren. Ebenso ist es mit diesem Layer ohne weiteres möglich, eine Verbindung zu einer externen Datenquelle wie Google Drive, Dropbox oder Amazon herzustellen.

Ich allerdings, bin starker Benutzer von TemplaVoila und dort ist dieses Feature des FAL noch nicht angekommen (wird bestimmt bald passieren). Möchte man aber trotzdem das Referenzieren von Bildern in TemplaVoila verwenden, gibt es eine Möglichkeit, die allerdings etwas Geschick erfordert.

Zuerst sollte man im TemplaVoila-Wizard für das Feld den Typ „Benutzerdefinierte Formularkonfiguration (keine Voreinstellung)“ auswählen. Damit die gemachten Einstellungen nicht gelöscht werden, sollte man das Objekt nochmal bearbeiten. Nun editiert die „TemplaVoilà-Datenstruktur“ in der Listenansicht des Template-Ordners und sucht sich das XML-Tag heraus, dass so heißt wie das Feld auf dem die Dateireferenz liegen soll.

Beispielsweise das Feld „field_image“:

<field_image type="array">

Nun sucht man den Knoten <TypoScript type="NULL"> und entfernt das type="NULL". Als Inhalt zwischen „<TypoScript></TypoScript>“ trägt man folgenden Code ein:

<![CDATA[
10 = FILES
10 {
	references {
		table = tt_content
		uid.data = TSFE:register|tx_templavoila_pi1.parentRec.uid
		fieldName = field_image
	}
	renderObj = IMAGE
	renderObj {
		file {
			import.data = file:current:publicUrl
			width = 150
		}
	}
}
]]>

Einstellungen:
table = tt_content: tt_content bei einem Flexiblen Inhaltselement und pages bei einer Seitenvorlage.
uid.data = TSFE:register|tx_templavoila_pi1.parentRec.uid: TSFE:register|tx_templavoila_pi1.parentRec.uid bei einem Flexiblen Inhaltselement und page : uid bei einer Seitenvorlage.
fieldName = field_image: muss mit dem aktuellen Feldnamen übereinstimmen.
file { }: hier kann man die gewünschten Einstellungen für das angezeigte Bild bzw. die Bilder vornehmen.

Nun muss das Formularfeld definiert werden. Die TCA-Einstellungen für die Referenzdateien findet man in den TYPO3-Sources unter „typo3/sysext/core/Classes/Utility/ExtensionManagementUtility.php::getFileFieldTCAConfig“. Dort befindet sich allerdings nur die Definition als Array, TemplaVoila verwendet in seinen Datenstrukturen aber ein XML-Format. Die Konvertierung habe ich hier einmal vorgenommen.

Zwischen </tx_templavoila> und </field_image> folgende Zeilen hinzufügen:

<TCEforms type="array">
	<label>Bild</label>
	<config type="array">
		<type>inline</type>
		<maxitems>1</maxitems>
		<foreign_table>sys_file_reference</foreign_table>
		<foreign_field>uid_foreign</foreign_field>
		<foreign_sortby>sorting_foreign</foreign_sortby>
		<foreign_table_field>tablenames</foreign_table_field>
		<foreign_match_fields>
			<fieldname>field_image</fieldname>
		</foreign_match_fields>
		<foreign_label>uid_local</foreign_label>
		<foreign_selector>uid_local</foreign_selector>
		<foreign_selector_fieldTcaOverride>
			<config>
				<appearance>
					<elementBrowserType>file</elementBrowserType>
					<elementBrowserAllowed>jpg,png</elementBrowserAllowed>
				</appearance>
			</config>
		</foreign_selector_fieldTcaOverride>
		<appearance>
			<useSortable>TRUE</useSortable>
			<headerThumbnail>
				<field>uid_local</field>
				<width>64</width>
				<height>64</height>
			</headerThumbnail>
			<showPossibleLocalizationRecords>TRUE</showPossibleLocalizationRecords>
			<showRemovedLocalizationRecords>TRUE</showRemovedLocalizationRecords>
			<showSynchronizationLink>TRUE</showSynchronizationLink>

			<enabledControls>
				<info>FALSE</info>
				<new>FALSE</new>
				<dragdrop>TRUE</dragdrop>
				<sort>FALSE</sort>
				<hide>TRUE</hide>
				<delete>TRUE</delete>
				<localize>TRUE</localize>
			</enabledControls>
		</appearance>
		<behaviour>
			<localizationMode>select</localizationMode>
			<localizeChildrenAtParentLocalization>TRUE</localizeChildrenAtParentLocalization>
		</behaviour>
	</config>
</TCEforms>

Einstellungen:
<label>jpg,png</label>: Titel des Feldes im Backend.
<maxitems>1</maxitems>: Anzahl an Bildern, die ausgewählt werden können.
<fieldname>field_image</fieldname>: Feldname aus TemplaVoila.
<elementBrowserAllowed>jpg,png</elementBrowserAllowed>: Erlaubte Dateiendungen für den Dateibrowser.

Nun muss noch der Eintrag <HSC>1</HSC> in <HSC>0</HSC> geändert werden. Dies verhindert, dass der entstandene Inhalt durch PHPs-Htmlspecialchars kodiert wird.

Nach dem Speichern sollte nun im Backend das neue Modell zum auswählen der Dateien erscheinen

Ich hoffe, dass das Feature bald komplett in TemplaVoila eingebaut wird, eine Ankündigung gab es bereits vor einigen Wochen.