Für ein Projekt war es wichtig, dass die Bilder aus dem fileadmin referenziert werden und nicht kopiert werden. Ich schätze den TYPO3-Kopiermechanismus, da er sinnvoll ist, da Redakteure „aus Versehen“ Dateien löschen können, aber manchmal kann es auch sehr lästig sein. Gerade wenn man den fileadmin-Ordner versioniert mit SVN zum Beispiel, kann es so einfach sein: Datei austauschen, Checkout einspielen, fertig.

Es gibt eine Extension im TER – em_references. Leider ist die schon alt und die nutzt XCLASSES, um das Rendering von TCAFORMS im Backend zu ändern. XCLASS heißt, dass der Code zu einem Zeitpunkt rauskopiert und angepasst wurde. Das heißt, das alle Änderungen, die seitdem im Core an der Stelle stattgefunden haben, dort nicht zu finden sind. Daher fand ich die Variante nicht gut.

Man kann aber tatsächlich auch ohne Extension auskommen. Man braucht eine kleine eigene Extension, die im TCA den Uploads-Pfad anpasst. Dazu schreibt man in ext_tables.php der Extension folgendes:

t3lib_div::loadTCA('tt_content');
$TCA['tt_content']['columns']['image']['config']['uploadfolder'] = '';
// das ist optional
 
t3lib_div::loadTCA('fe_users');
$TCA['fe_users']['columns']['image']['config']['uploadfolder'] = '';

Dann muss man noch den Pfad über TypoScript anpassen, dazu brauch man folgende Zeile im TypoScript Template Setup:

tt_content.image.20.imgPath =

Der Nachteil dieser Methode gegenüber einer Extension ist, dass es nicht abwärts-kompatibel ist. d.h. hat man einmal diesen Weg gewählt, kann man nur dann wieder zurück, wenn man alle Bilder nach dem ändern dieses Pfades anfassen und neu zuweisen.

Für alle, die wie ich lange gesucht haben:

• Bilder nicht in uploads-Ordner kopieren
• uploads-Ordner für Bilder aus TYPO3 anpassen
• do not copy images in upload folder (without extension)

In diesem Artikel bin ich kurz auf die Feldkonfiguration im TCA eingegangen. Den zuletzt erwähnten Link-Wizard kann man konfigurieren und zwar so, dass nur bestimmte Dateitypen ausgewählt werden können. In meinem Beispiel brauche ich ihn, um auf mp3-Dateien zu verlinken. Der Nachteil, wenn man ein Feld als ‚group‘ deklariert ist, dass das referenzierte File in den Uploads-Ordner kopiert wird. Beim Verlinken passiert es nicht.

Diese Konfiguration ermöglicht es, nur auf mp3-Dateien zu verlinken. Zu beachten ist, dass man die blindLinkOptions nur dann verwenden kann, wenn der Browse-Links-Mode auf wizard gestellt ist.

'file' => array(
	'exclude' => 0,
	'label' => 'LLL:EXT:myextension/locallang_db.xml:file',
	'config' => array(
		'type' => 'input',
		'size' => '48',
		'wizards' => Array(
			'_PADDING' => 2,
			'link' => Array(
				'type' => 'popup',
				'title' => 'Link',
				'icon' => 'link_popup.gif',
				'script' => 'browse_links.php?mode=wizard',
				'JSopenParams' => 'height=300,width=500,status=0,menubar=0,scrollbars=1',
				'params' => Array(
					'blindLinkOptions' => 'page,url,mail,spec,folder',
					'allowedExtensions' => 'mp3,ogg',
				)
			),
		),
		'eval' => 'required,nospace',
		'softref' => 'typolink'
	),
),

Will man auf eine beliebige Datei verlinken, ohne die Dateiendung zu bestimmen, kann man den Mode direkt auf ‚file‘ stellen, weiter Konfiguration ist dann nicht möglich.

'link' => Array(
	'type' => 'popup',
	'title' => 'Link',
	'icon' => 'link_popup.gif',
	'script' => 'browse_links.php?mode=file',
	'JSopenParams' => 'height=300,width=500,status=0,menubar=0,scrollbars=1',
),

Alles, was man im TCA als PHP angeben kann, kann man auch in XML-Form angeben, dann kann man es im Flexform oder in Data Structures von TemplaVoila verwenden.

<link type="array">
	<type>popup</type>
	<title>Link</title>
	<icon>link_popup.gif</icon>
	<script>browse_links.php?mode=wizard</script>
	<JSopenParams>height=300,width=500,status=0,menubar=0,scrollbars=1</JSopenParams>
	<params>
		<blindLinkOptions>page,url,mail,spec,folder</blindLinkOptions>
		<allowedExtensions>mp3</allowedExtensions>
	</params>
</link>

Wenn man eine Extension schreibt und dort Felder angibt, oder das bestehende TCA anpasst oder in einem Flexform Felder erstellt, mit der richtigen Konfiguration im TCA kann man sich das Leben einfach machen. Die Konfiguration, die man im TCA (also als PHP Array) angeben kann, kann man genauso in einem Flexform angeben, dann allerdings im Format XML. Diese Aufstellung ist nur ein kleiner Auszug aus der Liste aller Möglichkeiten.

Einfachstes Textfeld, da kann man fast alles eingeben, was man möchte, Hilfen gibt es keine.

'myfield' => array (		
	'exclude' => 1,		
	'label' => 'LLL:EXT:my_extension/locallang_db.xml:myfield',		
	'config' => array (
		'type' => 'input',	
		'size' => '30',
	)
)

Auswahlfeld (Select), aus einer Reihe von Optionen kann in diesem Fall eine gewählt werden. Unter ‚items‘ gibt man die auswählbaren Optionen an. An erster Stelle jeder Option steht das Label (kann aus Locallang kommen, muss aber nicht), an zweiter Stelle steht der Wert, der in die Datenbank geschrieben wird.

'myfield' => array (		
	'exclude' => 1,		
	'label' => 'LLL:EXT:myextension/locallang_db.xml:myfield',		
	'config' => array (
		'type' => 'select',
		'items' => array (
			array('', ''),
			array('LLL:EXT:myextension/locallang_db.xml:myfield.option1', 'option1'),
			array('LLL:EXT:myextension/locallang_db.xml:myfield.option2', 'option2'),
			array('LLL:EXT:myextension/locallang_db.xml:myfield.option3', 'option3'),
		),
		'size' => 1,	
		'maxitems' => 1,
	)
),

Wenn man ein Feld vom Typ group verwendet in Kombination mit internal_type ‚file‘ kann der Benutzer in dem Feld ein z.B. ein Bild auswählen. Von diesem Bild wird, falls show_thumbs gesetzt ist, eine Vorschau angezeigt. Problem ist – das Bild (oder die Datei anderen Typs) wird in den Ordner uploads kopiert. Wenn man also nachträglich das Bild erneut in fileadmin hochlädt, wirkt sich diese Änderung nicht aus, da ja die Kopie in uploads referenziert wird. Der Vorteil ist, dass die Redakteure nicht aus Versehen das Bild löschen können, um sich dann zu wundern, warum es denn weg ist.

'myfield' => array (		
	'exclude' => 1,		
	'label' => 'LLL:EXT:myextension/locallang_db.xml:myfield',		
	'config' => array (
		'type' => 'group',
		'internal_type' => 'file',
		'allowed' => $GLOBALS['TYPO3_CONF_VARS']['GFX']['imagefile_ext'],	
		'max_size' => $GLOBALS['TYPO3_CONF_VARS']['BE']['maxFileSize'],	
		'uploadfolder' => 'uploads/myextension',
		'show_thumbs' => 1,	
		'size' => 1,	
		'minitems' => 0,
		'maxitems' => 1,
	)
),

Was tun, wenn man diesen Kopiermechanismus umgehen möchte. Vielleicht möchte man ein Bild (oder eine andere Datei) auswählbar machen, sie soll aber tatsächlich nur referenziert werden (und nicht kopiert). Mein Trick ist, statt ‚group‘ ein Input-Feld in Kombination mit dem Link-Wizard zu verwenden.

'myfield' => array (
	'exclude' => 1,        
	'label' => 'LLL:EXT:myextension/locallang_db.xml:myfield',        
	'config' => array (
		'type'     => 'input',
		'size'     => '15',
		'max'      => '255',
		'checkbox' => '',
		'eval'     => 'trim',
		'wizards'  => array(
			'_PADDING' => 2,
			'link'     => array(
				'type'         => 'popup',
				'title'        => 'Link',
				'icon'         => 'link_popup.gif',
				'script'       => 'browse_links.php?mode=wizard',
				'JSopenParams' => 'height=300,width=500,status=0,menubar=0,scrollbars=1',
			)
		)
	)
)

TYPO3 ist geil und beängstigend zugleich:

Es wird eine Navigation erzeugt, bei der jedes Element mit einem li umgeben ist. Das div darin hat eine Klasse, die über die Seiteneingenschaften zugewiesen werden kann. Darin ist ein Bild, das ebenfalls über die Seiteneingenschaften gesetzt werden kann. Darunter wird der Locallang-Wert ausgegeben, der aus einem Feld aus Seiteneingenschaften stammt. Und zum Schluss dann der Titel der Seite.

1 = TMENU
1 {
	expAll = 1
	wrap = <ul>|</ul>
	NO = 1
	NO {
		field = title
		wrapItemAndSub = <li>|</li>
		stdWrap.dataWrap = <div class="{field:myclass}">|</div>
		stdWrap.cObject = COA
		stdWrap.cObject {
			10 = IMAGE
			10.file.import.dataWrap = uploads/myextension/{field:myimage}
			10.wrap = <div class="image">|</div>
			20 = TEXT
			20.dataWrap = LLL:EXT:myextension/locallang_db.xml:pages.mytype.{field:mytype}
			20.wrap3 = {|}
			20.insertData = 1
			30 = TEXT
			30.field = title
			30.wrap = <span class="text">|</span>
		}
	}
}

In TYPO3 kann man in der TCA Konfiguration der eigenen Extension festlegen, welches Feld im Standardfall als Label für die Elemente benutzt wird. Es ist eigentlich ganz einfach: Man erstellt eine Datei mit der Klasse, die das Label erzeugt:

require_once(PATH_t3lib.'class.t3lib_befunc.php');
 
class user_TimeslotLabelClass {
 
	function getUserLabel($params, &$pObj) {
		$course = $params['row']['course'];
		$mylabel = $params['row']['time_start'];
 
		if ($course) {
			$item = t3lib_BEfunc::getRecord('tx_nptimetable_course', $course);
			$mylabel.= ', '.$item['title'];
		}
		$params['title'] = $mylabel;
	}
}

Dann muss man in der TCA-Datei die Datei mit der Klasse inkludieren und aufrufen:

$TCA['tx_nptimetable_timeslot'] = array (
	'ctrl' => array (
		'title'     => 'LLL:EXT:np_timetable/Resources/Private/Language/locallang_db.xml:tx_nptimetable_timeslot',		
		'label'     => 'time_start',
		'label_alt'	=> 'course,time_end',
		'label_userFunc' => "user_TimeslotLabelClass->getUserLabel",
...

Die Anleitung gibt es auf der Seite von Stefan Meissner.

Damit es wirklich funktioniert, muss man allerdings ein paar Kleinigkeiten beachten: Die Felder, die man der Funktion verwenden möchte, müssen zur Verfügung stehen, und das passiert erst dann, wenn sie als label oder label_alt angegeben sind. In dem Code-Schnipsel von mir habe ich das Feld course als label_alt angegeben, und das obwohl das Label danach mit einer Funktion gesetzt wird. Ansonsten steht es in $params nicht zur Verfügung.

Schon wieder. Es ist nur eine kleine Klammer, aber mit großer Wirkung. Zumindest wurde bei mir nicht korrekt sortiert, wenn ich eine Eigenschaft ausgewählt habe (was anderes als name). Der Grund dafür ist die viel zu sehr verschachtelte Abfrage, um die Sortier-Reihenfolge festzulegen.
Was nicht funktioniert (class.tx_address_pi1.php Zeilen 140ff):

$this->conf['sortByColumn'] = $this->ffData['sortBy'] ?
	$this->ffData['sortBy'] :
		$this->conf['sortByColumn'] ?
			$this->conf['sortByColumn'] :
			'name';

Was aber funktioniert:

$this->conf['sortByColumn'] = $this->ffData['sortBy'] ?
	$this->ffData['sortBy'] :
		($this->conf['sortByColumn'] ?
			$this->conf['sortByColumn'] :
			'name');

Die fehlende Klammer sorgt dafür, dass die Sortierung immer auf „name“ gesetzt wird, egal was ausgewählt wurde.

In der neuen TYPO3 Version werden die Formulare mit einem neuen Formularwizard erstellt. Im Vergleich zum alten Wizard kann man Felder mit Drag-and-Drop hinzufügen und diese mit Validierungsregeln überprüfen lassen, Felder in Fieldsets gruppieren und das Formular nicht nur per Mail verschicken, sondern mit eigenen Post-Prozessoren die Daten in die Datenbank speichern.
Im Frontend gefallen mir die neuen Formulare viel besser als die vom alten Wizard. Zum einen sind wir alle diese leidige Feld-Validierung mit JavaScript los, die mit einem alert etwas penetrant darauf hingewiesen hat, dass Felder nicht ausgefüllt sind. Zum zweiten kann man die Felder endlich gruppieren und dadurch das Formular evtl. individueller gestalten als vorher.
Leider ist der Wizard so neu, dass es dafür noch keine deutsche Übersetzung gibt. Zumindest habe ich keine gefunden. Und es gab noch keine Forumsbeiträge zu dem Thema. Ich hatte bei schlauen Leute nachgefragt, ob ich denn etwas übersehen hätte, aber sie hatten mir auch nur geraten, es so zu machen, wie ich es schon vorhatte: Die Übersetzung selbst im typo3conf/l10n Ordner einpflegen.
Die Übersetzungen mancher (vor allem neueren) Extensions befinden sich in Dateien, die im Order typo3conf/l10n gespeichert sind. Für jede Sprache und für jede Extension, zu der eine Übersetzung vorliegt, wird in diesem Ordner die folgende Struktur angelegt:
typo3conf/l10n/[sprache]/[extension]. So dass die Übersetzung für die Formularextension (alias der neue Form Wizard) in typo3conf/ext/de/form liegen müsste, dieser Ordner existiert aber nicht.
Und so übersetzt man selbst in freudiger Erwartung die Extension form wie folgt: Eine existierende Sprache für die Form-Extension aus dem TER laden (z.B. französisch). Dann den Ordner form aus typo3conf/ext/l10n/fr/ kopieren und in typo3ext/l10n/de einfügen. Im Ordner form navigiert man zu Resources/Private/Language und benennt die Dateien dort um, so dass sie mit de. anstatt fr. beginnen. Zum Testen kann man den Form-Wizard aufrufen und feststellen, dass alles auf französisch ist. Und dann kann man die Texte übersetzen. Die XML-Dateien sind die alte Art Extensions zu übersetzen, die XLF-Dateien die neue, die anscheinend bevorzugt wird. Daher die XML-Dateien ignorieren und nur die Labels in den XLF-Dateien anpassen.

<trans-unit id="title" xml:space="preserve" approved="yes">
    <source>Form Wizard</source>
<target state="translated">HIER DIE DEUTSCHE ÜBERSETZUNG REIN</target></trans-unit>

Ich bin nicht wirklich zufrieden mit dieser Übersetzungsmöglichkeit. Ein Update und die ganzen eingepflegten Texte sind hin, sie werden dann mit den Übersetzungen aus dem Repository überschrieben. Vielleicht gibt es ja eine Möglichkeit, die Texte per TypoScript zu setzen mit _LOCAL_LANG? Werde das mal weiter untersuchen.

UPDATE: Es gibt eine Möglichkeit, zumindest den Text, der nach dem Absenden angezeigt wird, per TypoScript zu setzen.

postProcessor {
	1 = mail
	1 {
		recipientEmail = receiver@domain.coom
		senderEmail = sender@domain.com
		subject = Contact Form
		messages.success = Das ist ein Text, der über TypoScript gesetzt wird
	}
}