Ich entwickle gerade meine TYPO3-Extension sm_employeelist neu, um sie um einige Funktionen zu erweitern, an TYPO3 4.x anzupassen und meine inzwischen gewachsenen Programmierkenntnisse einfließen zu lassen 😉
Als erstes habe ich heute getestet, wie ich in mehreren Plugins, die meine Extension bieten wird, eine einzige (quasi “globale”) Sprachdatei verwenden kann. Normalerweise hat nämlich jede Extension eine eigene locallang.xml und die gesamte Extension noch einmal eine locallang_db.xml, in der jedoch nur die Backend-Texte enthalten sind und die im Frontend (wo die Plugins ausgeführt werden) nicht (oder nur umständlich) zugreifbar ist.
Ich habe zu diesem Thema diese schöne Seite gefunden: TYPO3-Spickzettel von Pi-Phi-Productions. Dort wird vorgeschlagen, die Methode pi_loadLL() zu überschreiben und eine eigene Sprachdatei einzubinden. Dies müsste ich allerdings in jeder Plugin-Klasse (extkey_pi1, extkey_pi2 etc.) tun, was mir eindeutig missfällt.
Doch da wir ja objektorientiert programmieren, ist die Lösung recht einfach: Ich erstelle mir eine abstrakte Basisklasse für all meine Plugins, die von tslib_pibase abgeleitet ist und die Methode pi_loadLL() wie beschrieben überschreibt. Meine Plugin-Klassen leite ich dann wiederum von meiner eigenen Basisklasse ab und fertig ist die Laube. Zusätzlich kann ich diese Basisklasse dann noch verwenden um Funktionen zu implementieren, die auch in allen Plugin-Klassen benötigt werden (z.B. GET-Parameter prüfen, Flexform-Konfiguration auslesen etc.).
Quelltext
Zunächst einmal verwende ich die folgende Projektstruktur:
Wie sieht das Ganze nun im Code aus?
Meine abstrakte Plugin-Basisklasse
require_once(PATH_tslib.'class.tslib_pibase.php');
abstract class sm_testextension_pibase extends tslib_pibase
{
private $globalLocallangLoaded = false;
function pi_loadLL()
{
parent::pi_loadLL();
if (!$this->globalLocallangLoaded)
{
$basePath = t3lib_extMgm::extPath($this->extKey).'locallang_global.xml';
$tempLOCAL_LANG = t3lib_div::readLLfile($basePath, $this->LLkey);
//array_merge with new array first, so a value in locallang (or typoscript) can overwrite values from locallang_global.xml
$this->LOCAL_LANG = array_merge_recursive($tempLOCAL_LANG, is_array($this->LOCAL_LANG) ? $this->LOCAL_LANG : array());
if ($this->altLLkey)
{
$tempLOCAL_LANG = t3lib_div::readLLfile($basePath, $this->altLLkey);
$this->LOCAL_LANG = array_merge_recursive($tempLOCAL_LANG, is_array($this->LOCAL_LANG) ? $this->LOCAL_LANG : array());
}
$this->globalLocallangLoaded = true;
}
}
}
Eine Plugin-Klasse
require_once(t3lib_extMgm::extPath('sm_testextension').'class.sm_testextension_pibase.php');
class tx_smtestextension_pi2 extends sm_testextension_pibase
{
// übliche Plugin-Implementierung
}
Meine globale Sprachdatei locallang_global.xml
<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
<T3locallang>
<meta type="array">
<type>module</type>
<description>Global language labels for the plugins of extension 'sm_testextension'</description>
</meta>
<data type="array">
<languageKey index="default" type="array">
<label index="smte_test1">Test1 global</label>
</languageKey>
<languageKey index="de" type="array">
<label index="smte_test1">Test1 global deutsch</label>
</languageKey>
</data>
</T3locallang>