Bild aus Media als Hintergrundbild ausgeben (FAL)

Vor langer Zeit hatte ich mal einen Beitrag geschrieben, wie man das verknüpfte Bild aus dem Feld ‚media‘ einer Seite als Hintergrundbild ausgeben kann.

Seit TYPO3 6.0 werden die Bilder nicht in den Upload-Ordner hochgeladen, sondern referenziert. Dafür reicht aber eine zusätzliche Zeile im Code. Dieser Schnipsel kann im Template-Setup verwendet werden:

10 = IMG_RESOURCE
10 {
	file.import = uploads/media/
	file.import.data = levelmedia:-1, slide
	file.import.listNum = 0
	file.treatIdAsReference = 1
	stdWrap.wrap = <div id="visual" style="background-image: url(|)">
}

Zusätzliche Informationen zum Plugin im BE

Ich finde es ja ziemlich cool, dass im Fall von tt_news im Backend anzeigt wird, welche Ansicht (CODE) im Plugin gewählt ist und auch mal Hinweise und Fehler anzeigt werden, falls das Plugin nicht vollständig konfiguriert ist. Denn das ist häufig der Nachteil an Plugins, sie sind wie eine Black Box, man sieht nur beim Bearbeiten, was da eingestellt ist.

Wenn man es weiß, ist es eigentlich ziemlich einfach. Zunächst muss man eine Klasse integrieren, die die erweiterten Informationen extrahieren soll. Dazu am besten folgende Zeile in ext_tables.php oder ext_localconf.php einsetzen (ja, list_type_Info):

$pluginSignature = strtolower($extensionName).'_pi1';
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['cms/layout/class.tx_cms_layout.php']['list_type_Info'][$pluginSignature]['my_extension'] 
= 'EXT:my_extension/Classes/Layout/Entry.php:Entry->getExtensionSummary';

In welchem Ordner man die Datei ablegt, ist einem selbst überlassen.

Dann sollte man eben diese Datei mit dem Namen anlegen, darin die entsprechende Klasse mit der Funktion. In meinem Fall heißt die Datei Entry.php, enthält die Klasse Entry und die Funktion getExtensionSummary.

class Entry {
	function getExtensionSummary($params, &$pObj) {
 
	}
}

Die Funktion bekommt zwei Parameter: $params ist ein Objekt, dass alle Infomationen zum Content Element enthält und $pObj ist eine Referenz auf Parent-Objekt. Als erstes sollte man den list_type nochmal prüfen. Der Wert XXX sollte mit der vorher angegebenen Plugin-Signatur übereinstimmen.

if($params['row']['list_type'] == 'XXX') {
	// Flexform parsen
	$data = \TYPO3\CMS\Core\Utility\GeneralUtility::xml2array($params['row']['pi_flexform']);
	if(is_array($data) && $data['data']['sDEF']['lDEF']['switchableControllerActions']) {
		$selectedAction = $data['data']['sDEF']['lDEF']['switchableControllerActions']['vDEF'];
		return $result;
	}
}

Die Rückgabe dieser Funktion wird an die normale Ausgabe im BE drangehängt.

Wenn man einen Datensatz braucht, um z.B. seinen Titel anzuzeigen, dann kann man es wie folgt tun:

$entry= \TYPO3\CMS\Backend\Utility\BackendUtility::getRecord('tx_myextension_domain_model_entry', $id);
$result = '<b>'.$entry['title'].'</b>';

Trim ViewHelper

Mir ist aufgefallen, dass es man den Fluid Code zwar sehr schön formatieren kann, es aber nicht unbedingt schön in der Ausgabe aussieht. Jedes If führt in der Ausgabe zu einem Zeilenumbruch, was im Endeffekt zu einem unnötig langen HTML-Code führt. Also habe ich einen Trim-ViewHelper geschrieben. Dieser geht ein bisschen über das einfache trim von PHP hinaus – es werden alle Zeilenumbrüche und doppelte Leerzeichen entfernt, da sie in der Darstellung von HTML keine Rolle spielen. Und das ist der Code von meinem ViewHelper (namespace bitte selbst einsetzen):

class TrimViewHelper extends \TYPO3\CMS\Fluid\Core\ViewHelper\AbstractViewHelper {
 
	/**
	 * @param mixed $value The value to output
	 * @return string
	 */
	public function render($value = NULL) {
		if ($value === NULL) {
			$value =  $this->renderChildren();
		}
		// remove new line - does not matter in html anyway
		$value = str_replace(chr(10), '', $value);
		// remove multiple whitespaces
		$value = preg_replace ('#\s+#' , ' ' , $value);
		return trim($value);
	}
}

Extbase Plugin per TypoScript einbinden

Wenn man ein auf Extbase/Fluid-Basis erstelltes Plugin auf jeder Seite einsetzen möchte, dann braucht man folgenden Code im Setup des Seitentemplates:

temp.myPlugin = USER
temp.myPlugin {
   userFunc = tx_extbase_core_bootstrap->run
   pluginName = MyPlugin
   extensionName = MyExtension
 
   settings =< plugin.tx_myextension.settings
   persistence =< plugin.tx_myextension.persistence
   view =< plugin.tx_myextension.view
}

Statt MyPlugin und MyExtension muss man natürlich den Namen des eigenen Plugins und der Extension einsetzen. Wichtig ist, dass das Plugin mit configurePlugin und registerPlugin in ext_localconf.php bzw. ext_tables.php registriert und konfiguriert ist. In meinem Fall ist MyPlugin so konfiguriert, dass TestController->listAction aufgerufen werden soll.

Nun hatte ich das Problem, dass ich meine Klassen bereits nach TYPO3 6 Manier also mit Namespaces geschrieben habe. Wenn der Extbase Bootstrapper aber aus den Angaben den Controller-Klassennamen zusammenbaut, dann bekommt er folgendes: Tx_MyExtension_Controller_TestController. Die Klasse existiert natürlich nicht, denn sie heißt genamespaced ja so: \Vendor\MyExtension\Controller\TestController.

Ich habe rausgefunden, dass es eine ClassAliasMapper.php gibt, in der die alten Klassennamen auf die neuen Namen mit Namespace gemappt werden. So funktioniert ja z.B. der Aufruf Tx_Extbase_Core_Bootstrap immer noch, obwohl es die Klasse nicht gibt. Dann hab ich rausgefunden, dass alle Extensions nach der gleichen Datei durchsucht werden und diese Mapping-Liste erweitert wird. Im Extension-Ordner die Ordnerstruktur Migrations/Code/ und darin die Datei ClassAliasMap.php anlegen. Die Datei hat folgenden Inhalt:

return array(
	'Tx_MyExtension_Controller_TestController' => 'Vendor\\MyExtension\\Controller\\TestController'
);

Extbase-Klassen auf bestehende Tabellen mappen

Wenn man noch ohne Namespaces arbeitet, dann fügt man folgenden Code ins Setup der eigenen Extension ein:

config.tx_extbase.persistence.classes {
	Tx_MyExtension_Domain_Model_Page {
		mapping {
			tableName = pages
		}
	}
}

Seit TYPO3 6.0 sind nun Namespaces hinzugekommen, und nun sieht es so aus:

config.tx_extbase.persistence.classes {
	Vendor\MyExtension\Domain\Model\Page {
		mapping {
			tableName = pages
		}
	}
}

Wichtig ist, dass vor dem Vendor kein Slash steht.

Geschrieben in TYPO3 | Kommentare deaktiviert für Extbase-Klassen auf bestehende Tabellen mappen

Mehrspaltigkeit in TYPO3 6.0

Ich habe mich letzte Woche mit Mehrspaltigkeit in TYPO3 auseinandergesetzt. Ich habe bisher in 4er-Versionen gearbeitet und wollte nun der neuen Version 6 eine Chance geben. Da die Layouts, die ich serviert bekomme, meistens abwechslungsreich sind (2 oder 3 Spalten innerhalb einer Content-Spalte), habe ich bisher immer TemplaVoila genutzt. Die Flexibilität von TV und der Einsatz von FCEs macht TV zu einem mächtigen Templating-Tool in TYPO3.

(mehr …)

„Page not configured“ Fehler bei Extension pagerating

Zum Testen hatte ich die Extension „pagerating“ installiert auf meinem XAMPP. Habe das Template inkludiert, jQuery meiner Seite hinzugefügt. Dann klickt man auf den Link zum Voten (es kommt ein Alert) und die Konsole zeigt eine Fehlermeldung an. Hab auf den Link geklickt – es kommt eine TYPO3 Fehlermeldung „Page type not configured“. In der Configuration der Extension wird ein Seitenobjekt definiert – sieht soweit alles richtig aus, komisch, dass es nicht funktioniert.
Dann hab ich mir mal die typeNums der Seiten anzeigen lassen. In der Extension ist es so gesetzt:
pageTypeNum = 43873923824
Wir auch in den Links so generiert. Aber in der Fehlermeldung steht folgendes:
The page is not configured! [type=2147483647]

Die Ursache dieser unterschiedlichen Zahlen ist der Typ des pageTypeNum-Wertes. Dieser ist nämlich int. Und der maximale Wert für einen int-Wert (zumindest in Windows) ist eben 2147483647. Das Problem ist somit behoben, wenn man über Konstanten-Editor den pageTypeNum auf einen geringeren Wert setzt als eben den maximalen int-Wert.

TYPO3 6.0 Inhaltselemente anlegen nicht möglich

Hab mir das TYPO3 6.0 Government Package installiert. Als ich versucht habe, ein Inhaltselement anzulegen, kam folgende Fehlermeldung:

Call to undefined method TYPO3\CMS\Core\Utility\GeneralUtility::readLLXMLfile()

TYPO3 ist scheinbar in der Lage aus t3lib_div die korrekte Klasse zu ermittelt, aber der Funktionsname hat sich inzwischen geändert. Zwei Lösungsvarianten:

Datei typo3conf/ext/tt_news/pi/class.tx_ttnews_wizicon.php

Variante 1) Nur den Funktionsnamen ändern

function includeLocalLang()	{
	$llFile = t3lib_extMgm::extPath('tt_news').'locallang.xml';
	$LOCAL_LANG = t3lib_div::readLLfile($llFile, $GLOBALS['LANG']->lang);
	return $LOCAL_LANG;
}

Variante 2) Auch die Klassennamen ändern (mit Namespaces)

function includeLocalLang()	{
	return \TYPO3\CMS\Core\Utility\GeneralUtility::readLLfile(\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::extPath('tt_news') .
		'locallang.xml', $GLOBALS['LANG']->lang);
}

TYPO3 6.0 Extension Manager funktioniert nicht

Habe mir TYPO3 Version 6.0 zum Anschauen installiert (XAMPP 1.8.1, Windows 7). Bisher funktioniert alles, außer dass beim Aufruf des Extension Managers der Apache abstürzt und eine leere Seite mit der Fehlermeldung angezeigt wurde, dass die Seite nicht geladen werden konnte. Hab dann ein bisschen gesucht und folgende Lösung gefunden, die tatsächlich schnell geholfen hat.
Ursache „Fluid uses complex regular expressions which require a lot of stack space during the first processing. On Windows the default stack size for Apache is a lot smaller than on unix. You can increase the size to 8MB (default on unix) by adding to the httpd.conf:“.

Also am Ende der httpd.conf-Datei folgendes einfügen und Apache neu starten:
ThreadStackSize 8388608

Quelle: Probleme beim Zugriff auf den Erweiterungsmanager typo3forum.net

Colorbox Href dynamisch setzen

Ich bin ein großer Fan der jQuery Colorbox und setze sie sehr häufig ein. Die Colorbox ist sehr flexibel, kann sehr gut überall integriert werden und kann fast alle Arten von Inhalten ohne Probleme darstellen.

Normalerweise verwendet die Colorbox die URL aus dem Link, d.h. in diesem Fall würde die URL seite.html geöffnet werden:

<a href="seite.html">Link</a>
<script>
$('a').colorbox();
</script>

Man kann die URL für mehrere Links statisch auf eine andere URL setzen, in diesem Fall würde bei beiden Links die andereseite.html geöffnet werden:

<a href="seite1.html">Link 1</a>
<a href="seite2.html">Link 2</a>
<script>
$('a').colorbox({href: 'andereseite.html'});
</script>

In meinem Fall hatte ich folgendes vor: Für Benutzer ohne JavaScript, bzw. für welche, die den Link in einem neuen Fenster oder Tab öffnen wollen, soll auf die normale Version der Seite verlinkt werden. Und falls JavaScript aktiviert ist und auf den Link geklickt wird, so soll eine Popup-Version der Seite aufgerufen werden. In diesem Fall kann man an href eine Funktion übergeben, die dynamisch die URL setzt. d.h. beim ersten Link wird andereseite1.html geöffnet, beim zweiten andereseite2.html:

<a href="seite1.html" data-cboxhref="andereseite1.html">Link 1</a>
<a href="seite2.html" data-cboxhref="andereseite2.html">Link 1</a>
<script>
$('a').colorbox({href: function() {
return $(this).attr('data-cboxhref');
}});
</script>