'feld' => array(
            'exclude' => 0,
            'label' => 'Feld Name',
            'config' => array(
                'type' => 'select',
                'items' => Array (
                        Array("",0),
                    ),
                'foreign_table' => 'tx_deinetabelle',
                'size' => 1,
                'minitems' => 0,
                'maxitems' => 1,
            ),
        ),

Das Ganze wird also gelöst, indem man vor der „foreign_table“ bereits ein „item“ initialisiert. Dazu aus der Dokumentation:
„Contains the elements for the selector box unless the property “foreign_table” or “special” has been set in which case automated values are set in addition to any values listed in this array.“
(Quelle: Core Dokumentation, 4.6.0)
Die Werte „maxitems“ und „minitems“ müssen dabei nicht gesetzt sein, weil als Standard bereits 1 bzw. 0 eingestellt sind.

Anforderungen:

• eigene, schöne Markergrafiken (google.maps.MarkerImage)
• optimierte, per CSS stylebare Infofenster (InfoBubble)
• Lösung für das Problem der überlappenen Marker. Wie erreicht der User Marker, wenn viele übereinander (auf einer Koordinate) liegen? (OverlappingMarkerSpiderfier)
• Drop Animationseffekt beim Setzen der Marker (google.maps.Animation.DROP)
• Suchbox zum Anzeigen einer Adresse (google.maps.Geocoder)
• Filter mittels Links

Lösung

Alle diese Anforderungen wurden im folgenden Script berücksichtigt:

var map, infoBubble, styledcontent, oms;
var content = [];
var geocoder = new google.maps.Geocoder();
var default_zoom = 9;
var search_zoom = 14;
var global_filter = '';
var search_placeholder = 'Straße, Ort';

$(document).ready(function() {
    if ($('#map_canvas').length != 0) {

        var mapCenter = new google.maps.LatLng(50.22120, 8.63525); // Default
        map = new google.maps.Map(document.getElementById('map_canvas'), {
          zoom: default_zoom,
          center: mapCenter,
          mapTypeId: google.maps.MapTypeId.ROADMAP,
		  scrollwheel: false
        });
		oms = new OverlappingMarkerSpiderfier(map, {markersWontMove: true, markersWontHide: true, keepSpiderfied: true});

		// ------------------------------------------
		// function to show all relevant markers. filtered by 'filter'-parameter if set :-)
		runQuery = function(elements, filter) {

			// Is filter set?
			var filter = (typeof(filter) != 'undefined') ? filter : '';

			// create new filter
			var current_element = elements + filter; 

			// first of all, clear all markers already there:
			deleteOverlays();

			// loop through all given elements:
			$(current_element).each(function(index){

				// are coordinates set?
				var current_koordinaten_xy = ($(this).children('.koordinaten').text() != '') ? $(this).children('.koordinaten').text() : '';
				var current_koordinaten = '';

				// put together information for the bubble
				var gruppe = new Array();
				gruppe['foo'] = 'bar';
				content[index] = gruppe; // neue gruppe zum array aller gruppen hinzufügen

				// if there are coordinates: split them in x/y, create google position and add marker
				if(current_koordinaten_xy != ''){
					current_koordinaten_xy = current_koordinaten_xy.split(',');
					current_koordinaten = new google.maps.LatLng(current_koordinaten_xy[0], current_koordinaten_xy[1]);

					addMarker(current_koordinaten, content, index, $(this).children('.fachgruppe').text()); // do everything
				}

			});
		}

		// ------------------------------------------
		// Info Bubble Default Settings:
		infoBubble = new InfoBubble({
					map: map,
					maxWidth: 290,
					maxHeight: 320,
					shadowStyle: 0,
					padding: 0,
					backgroundColor: '#fff',
					borderRadius: 5,
					arrowSize: 20,
					borderWidth: 0,
					arrowPosition: 20,
					backgroundClassName: 'ejw-gruppe-infowindow',
					arrowStyle: 2,
					hideCloseButton: false
		});		

		// ------------------------------------------
		// for starters: show all
		runQuery('#adressenliste li');

		// ------------------------------------------
		// now filter by filters:
		$('#filters a').click(function(){
			var current_filter = $(this).attr('data-option-value');
			if(current_filter != 0) {
				global_filter = '.' + current_filter; // put together new global filter
			}else{
				global_filter = '';
			}

			// toggle '.selected'-class:
			$('.selected').removeClass('selected');
			$(this).toggleClass('selected');

			// add new markers:
			runQuery('#adressenliste li', global_filter);

			// if search box is not empty, add address marker as well:
			if( $('#finder-adresse').val() != '' && $('#finder-adresse').val() != search_placeholder){
				codeAddress( $('#finder-adresse').val(), false);
			}

			// prevent default action from happening (link href):
			return false;
		});

		// ------------------------------------------
		// find addresses by search and center map to this position:
		$('#finder-submit').click(function(){

			// clear markers and start over again:
			runQuery('#adressenliste li', global_filter);

			// geocode given address and add marker:
			codeAddress( $('#finder-adresse').val() );

			// zoom in
			map.setZoom(search_zoom);

		});

		// empty search box on focus if the value is equal to the placeholder text:
		$('#finder-adresse').val(search_placeholder);
		$('#finder-adresse').focus(function(){
			if ($(this).val() == search_placeholder) {
				$(this).val('');
			}
		});
		$('#finder-adresse').blur(function(){
			if ($(this).val() == '') {
				$(this).val(search_placeholder);
			}
		});

	}

	// ------------------------------------------
	// only add infobubble to the marker when it's clicked:
	oms.addListener('click', function(marker) {
		infoBubble.setContent(marker.content);
		infoBubble.open(map, marker);
	});	

});

Ich nutze dabei jQuery, weil die Daten für die Marker (z.B. die Koordinaten) erst bei Aufruf der Website ausgelesen, also generiert, werden. Das ist sicherlich nicht sehr performant, kann aber auch nützlich sein, wenn man zum Beispiel unter der Karte eine Liste der gefilterten Einträge anzeigen möchte.

Die folgende Funktion fügt der Map einen Marker hinzu. Ihr wird die Position (als Google Map Koordinaten) sowie einige weitere Parameter speziell für das EJW-Projekt mitgegeben:

function addMarker(location, content, index, fachgruppe, openbubble) {

	// Is openbubble set?
	var openbubble = (typeof(openbubble) != 'undefined') ? openbubble : true;

	// check for marker images:
	switch(fachgruppe) {
		case "HP":
			markerImg = new google.maps.MarkerImage('***.png');
			break;
		case "HMP":
			markerImg = new google.maps.MarkerImage('***.png');
			break;
		case "Standort":
			markerImg = new google.maps.MarkerImage('***.png');
			break;
		default:
			markerImg = new google.maps.MarkerImage('***.png');
			break;
	}

	// marker content
	if(fachgruppe == 'Standort') {
		styledcontent = '<div>Deine Standorteingabe.</div>';
	} else {
		styledcontent = "<div>...</div>";
	}

	var marker = new google.maps.Marker({
		position: location,
		map: map,
		icon: markerImg,
		content: styledcontent,
		animation: google.maps.Animation.DROP
	});	

	// add to marker array
	oms.addMarker(marker);

	// if is standort, show bubble
	if(fachgruppe == 'Standort' && openbubble) {
		infoBubble.setContent(marker.content);
		infoBubble.open(map, marker);
	}

}

Diese Funktion löscht alle Marker von der Map:

// Deletes all markers in the array by removing references to them
function deleteOverlays() {

	var markers = oms.getMarkers();

	if (markers) {
		for (i in markers) {
			markers[i].setMap(null);
		}
		markers.length = 0;
	}

	oms.clearMarkers();

}

Die nächste Funktion sorgt für die Geokodierung, also das Umsetzen einer Adresse zu Koordinaten:

function codeAddress(address, openbubble) {

	// Is openbubble set?
	var openbubble = (typeof(openbubble) != 'undefined') ? openbubble : true;

	if (geocoder) {
		  geocoder.geocode({
				'address': address,
				'region': 'de',
	            'language': 'de_DE'}, function(results, status) {
			if (status == google.maps.GeocoderStatus.OK) {

				// set marker to this location
				addMarker(results[0].geometry.location, '', '', 'Standort', openbubble);

				// center to the given location:
				map.setCenter(results[0].geometry.location);

			} else {

				// hier könnte noch ein schönerer fehler hin:
				console.log("Geokodierung nicht erfolgreich: " + status + ".");
				return false;
			}
		  });
	}
}

Resultat

Das Resultat lässt sich auf der Website des EJW Hessen begutachten:

Kommentare und Optimierungsvorschläge sind natürlich jederzeit willkommen! :-)

Bei allen Fehler gilt zunächst einmal:

• Cache leeren
• typo3conf/temp_* Dateien löschen
• Rechtschreibfehler überprüfen
• Ruhe bewahren :-) Meistens sind es nur Kleinigkeiten, die schnell wieder stimmen!

Default controller can not be determined

Fehlermeldung:

The default controller can not be determined.
Please check for Tx_Extbase_Utility_Extension::configurePlugin() in your ext_localconf.php.

Tritt auf, wenn man im Frontend die Seite mit dem Plugin öffnet.

Lösung:
Bei mir half es, das Plugin einfach neu einzubinden. Also: Plugin löschen, neuen Datensatz anlegen und Plugin erneut auswählen. Ich kann mir nicht recht erklären, warum es so klappt, aber TYPO3 scheint da intern noch irgendetwas zu speichern. (Hat jemand eine Idee?)

Validation errors

Fehlermeldung:

An error occurred while trying to call Tx_Yourextkey_Controller_YourController->showAction(). Error: Validation errors for argument “variable”.

Dieser Fehler tritt zum Beispiel auf, wenn man die Einzelansicht (showAction) eines Controllers aufruft. Hier muss dann ja das aktuelle Objekt mit übergeben werden.

Lösung:
Mit den PHPDoc annotations experimentieren. Zum Beispiel:

	/**
	 * action show
	 *
	 * @param mixed $variable
	 * @return void
	 * @dontvalidate $variable
	 * @dontverifyrequesthash
	 */
	public function showAction(Tx_Yourextkey_Domain_Model_YourModel $variable) {
		...
	}

Required property does not exist

Fehlermeldung:

An error occurred while trying to call Tx_Yourextkey_Controller_GemeindeController->showAction(). Error: Required property ‘variable’ does not exist.

Dieser Fehler kann auftreten, wenn man die Einzelansicht (showAction) eines Controllers aufruft (s.o.).

Lösung:
Dem Controller werden meist Parameter über GET/POST mitgegeben. Der obige Fehler taucht auf, wenn ein nötiger Parameter nicht übergeben wurde. Am besten noch einmal überprüfen, wo der Controller aufgerufen wurde. Eventuell wurden dem Link oder Formular keine Argumente mit übergeben.

< ?php
/***************************************************************
*  Copyright notice
*
*  (c) 2011 Paul Rohrbeck
*  All rights reserved
*
*  This script is part of the TYPO3 project. The TYPO3 project is
*  free software; you can redistribute it and/or modify
*  it under the terms of the GNU General Public License as published by
*  the Free Software Foundation; either version 2 of the License, or
*  (at your option) any later version.
*
*  The GNU General Public License can be found at
*  http://www.gnu.org/copyleft/gpl.html.
*
*  This script is distributed in the hope that it will be useful,
*  but WITHOUT ANY WARRANTY; without even the implied warranty of
*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
*  GNU General Public License for more details.
*
*  This copyright notice MUST APPEAR in all copies of the script!
***************************************************************/

class Tx_Yourextkey_ViewHelpers_Format_StrftimeViewHelper extends Tx_Fluid_Core_ViewHelper_AbstractViewHelper {

	/**
	 * Render the supplied DateTime object as a formatted date using strftime.
	 *
	 * @param mixed $date either a DateTime object or a string (UNIX-Timestamp)
	 * @param string $format Format String which is taken to format the Date/Time
	 * @return string Formatted date
	 */
	public function render($date = NULL, $format = '%A, %d. %B %Y') {

		if ($date === NULL) {
			$date = $this->renderChildren();
			if ($date === NULL) {
				return '';
			}
		}

		if ($date instanceof DateTime) {
			try {
				//return strftime($format, $date->getTimestamp()); funktioniert nur mit PHP > 5.3
				return strftime($format, $date->format('U'));
			} catch (Exception $exception) {
				throw new Tx_Fluid_Core_ViewHelper_Exception('"' . $date . '" was DateTime and could not be converted to UNIX-Timestamp by DateTime.', 200000001);
			}
		}

		return strftime($format, (int)$date);
	}
}
?>

sunixzs nutzt in seiner Variante $date->getTimestamp() (oben auskommentiert). Diese Funktion gibt es PHP aber erst ab der Version 5.3. Mit Hilfe von $date->format(‘U’) funktioniert sein ViewHelper bereits ab 5.2, was die meisten Server unterstützen sollten.

Anwendung:

<tx:format .strftime format="%e. %B">{timestamp}</tx:format>

Man beachte den anderen Syntax bzw. die anderern Platzhalter der Funktion strftime.

Und wieder der Hinweis zum Schluss: ext_autoload.php nicht vergessen. Am einfachsten über extdeveval automatisch erstellen lassen. ;-)

< ?php
/***************************************************************
*  Copyright notice
*
*  (c) 2011 Paul Rohrbeck
*  All rights reserved
*
*  This script is part of the TYPO3 project. The TYPO3 project is
*  free software; you can redistribute it and/or modify
*  it under the terms of the GNU General Public License as published by
*  the Free Software Foundation; either version 2 of the License, or
*  (at your option) any later version.
*
*  The GNU General Public License can be found at
*  http://www.gnu.org/copyleft/gpl.html.
*
*  This script is distributed in the hope that it will be useful,
*  but WITHOUT ANY WARRANTY; without even the implied warranty of
*  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
*  GNU General Public License for more details.
*
*  This copyright notice MUST APPEAR in all copies of the script!
***************************************************************/

class Tx_Yourextkey_ViewHelpers_StrreplaceViewHelper extends Tx_Fluid_Core_ViewHelper_AbstractViewHelper {

	/**
	 * Ersetzt alle Vorkommen des Suchstrings durch einen anderen String
	 *
	 * @param string $search
	 * @param string $replace
	 * @return string
	 */
    public function render($search = '', $replace = '') {

		$subject = $this->renderChildren();
		return str_replace($search, $replace, $subject);

    }

}
?>

Anwendung im Fluid Template:

{namespace tx = Tx_Ejwintern_ViewHelpers}

<tx:strreplace search="@" replace="(at)">{personen.email}</tx:strreplace>

In diesem konkreten Fall wird das @ in einer E-Mail-Adresse zum SPAM-Schutz durch (at) ersetzt.

Hinweis: ext_autoload.php nicht vergessen. Am einfachsten über extdeveval automatisch erstellen lassen. ;-)

Die Flexform-Konfigurationsdateien finden sich im Ordner Configuration/FlexForms/. Hier kann man dann seine eigenen XML Dateien anlegen. Ich habe Daniels Code um die Felder ‘Listenansicht (pid)’ und ‘Einzelansicht (pid)’ erweitert, damit man jeweils die Seiten-ID des anderen PlugIns angeben kann:

<t3datastructure>
	<sheets>
		<sdef>
			<root>
				<tceforms>
					<sheettitle>Verhalten</sheettitle>
				</tceforms>
				<type>array</type>
				<el>
					<switchablecontrolleractions>
						<tceforms> Standardaktion des Plugins
							<config>
							<type>select</type>
								<items>
									<numindex index="0">
										</numindex><numindex index="0">Listenansicht</numindex>
										<numindex index="1">Freizeit->list</numindex>

									<numindex index="1">
										</numindex><numindex index="0">Einzelansicht</numindex>
										<numindex index="1">Freizeit->show</numindex>

								</items>
							</config>
						</tceforms>
					</switchablecontrolleractions>
					<settings .listpid>
					   <tceforms>
						  <label>Listenansicht (pid)</label>
						  <config>
							 <type>input</type>
							 <size>5</size>
							 <eval>int</eval>
							 <default></default>
						  </config>
					   </tceforms>
					</settings>
					<settings .showpid>
					   <tceforms>
						  <label>Einzelansicht (pid)</label>
						  <config>
							 <type>input</type>
							 <size>5</size>
							 <eval>int</eval>
							 <default></default>
						  </config>
					   </tceforms>
					</settings>
				</el>
			</root>
		</sdef>
	</sheets>
</t3datastructure>

Natürlich ließe sich der obige Code noch optimieren durch den Einsatz der korrekten Verweise auf Language (locallang)-Dateien, aber es soll an dieser Stelle auch nur das Prinzip verdeutlicht werden.

Die angelegte Flexform-Datei muss im Anschluss in der ext_tables.php referenziert werden. Der neue Extension Builder legt dafür schon einmal die entsprechenden drei Zeilen an, die aber auskommentiert sind:

$pluginSignature = str_replace('_','',$_EXTKEY) . '_' . deinpluginname;
$TCA['tt_content']['types']['list']['subtypes_addlist'][$pluginSignature] = 'pi_flexform';
t3lib_extMgm::addPiFlexFormValue($pluginSignature, 'FILE:EXT:' . $_EXTKEY . '/Configuration/FlexForms/flexform_' .deinpluginname. '.xml');

Im Fluid View/Template kann man nun über {settings.showpid} auf die gemachten Einstellungen zugreifen und z.B. steuern, auf welcher Seite die Singleansicht der Einträge (showAction) liegt:

<f:link .action action="show" arguments="{model: model}" pageUid="{settings.showpid}">» Mehr Informationen</f:link>

Oben im ‘types’ array die einfache Bezeichnung ‘beschreibung’ ersetzen durch:

	// aus 'beschreibung' wird:
	// beschreibung;;;richtext:rte_transform[mode=ts_css]

	'types' => array(
		'1' => array(..., beschreibung;;;richtext:rte_transform[mode=ts_css], ...),
	),

Folgendes bei der Auflistung der Felder bearbeiten, man beachte das hinzugekommene ‘wizards’ array:

		'beschreibung' => array(
			'exclude' => 1,
			'label' => 'LLL:EXT:deinextkey/Resources/Private/Language/locallang_db.xml:tx_deinextkey_domain_model_deinmodel.beschreibung',
			'config' => array(
				'type' => 'text',
				'cols' => 40,
				'rows' => 15,
				'eval' => 'trim',
        		'wizards' => array(
        			'_PADDING' => 4,
        			'RTE' => array(
        				'notNewRecords' => 1,
        				'RTEonly' => 1,
        				'type' => 'script',
        				'title' => 'LLL:EXT:cms/locallang_ttc.php:bodytext.W.RTE',
        				'icon' => 'wizard_rte2.gif',
        				'script' => 'wizard_rte.php',
        			),
        		),
			),
		),

Im Fluid View/Template muss man dann beachten, dass man das Feld als HTML rendert:

	<f:format .html>{deinmodel.beschreibung}</f:format>

Ich hoffe das hilft dem ein oder anderen.. ;-)

### Sitebar ###
marks.sitebar = COA
marks.sitebar {
	10 = CONTENT
	10 {
   		table = tt_content
   		select.where = colPos = 0
   		select.languageField = sys_language_uid
    	renderObj = COA
  		renderObj {
      		10 = TEXT
      		10.field = header
     		10.wrap = <li>|</li>
     		10.typolink {
       			parameter.data = TSFE:id
       			 section.field = uid
      		}
    	}
    	stdWrap.required = 1
		stdWrap.wrap = <div><ul>|</ul></div>
  	}
}

< ?php the_content(); ?>

wurde also falsch befüllt.

Da ich in letzter Zeit sehr viel umgebaut habe, war nicht sofort klar, woran es liegt. Zu guter letzt habe ich den Fehler aber doch gefunden. Das Plugin „Category Posts Widget“ in der aktuellen Version 3.2 (siehe im Plugin Directory), ein an sich echt nützliche Extension um die neusten Posts einer Kategorie auszugeben, war der Übeltäter. Dieses hatte ich in der Sitebar der Artikel eingebunden und scheinbar beeinflusst es den WP-Loop in irgendeiner Weise.

Auch wenn ich den Fehler noch nicht ganz nachvollziehen kann, habe ich das Widget aus dem Bereich Artikel zunächst entfernt und es funktioniert wieder alles prima.

Im folgenden Beispiel wird auf der Startseite (id = 2) der Marker „header_left“ anders gefüllt als auf den anderen Seiten:

[globalVar = TSFE:id=2]
        page.10.marks.header_left = CONTENT
        page.10.marks.header_left {
            table = tt_content
            select.where = colPos = 1
            select.pidInList = 58
            select.languageField = sys_language_uid
        }
[global]

Wenn die Einstellung auch auf den Unterseiten (in diesem Fall der Startseite) gelten soll, kann in der ersten Zeile auch folgendes verwendet werden:

[PIDinRootline = 2]

Die genannten Codeschnipsel verwenden Sie am besten im TypoScript-Setup, wo sie auch das rechtliche Layout mit Markern zusammensetzen. Wichtg zu betonen ist, dass Bedingungen immer auf oberster Ebene stehen müssen. Sie können auch eine kommaseparierte Liste mit IDs angeben.