Version vom 15. Juli 2010, 13:47 Uhr

Unvollständiger Artikel: dieser Artikel ist noch nicht sauber bearbeitet. Bitte erweitere ihn und entferne erst anschliessend diesen Hinweis.

Mit der Methode getTemplateGroup ist es in einem Modul möglich, im Backend die Auswahl von Templates dem Nutzer zu ermöglichen, die im Frontend dann verwendet werden sollen. Damit ist es möglich, eigene Templates zu erstellen und zu verwenden.
Bis Contao 2.8.4 wurden die Templates im Verzeichnis templates des Moduls gesucht und anschließend im Verzeichnis TL_ROOT/templates.
Ab Contao 2.9 wurde auf Grund des Theme-Managers diese Methode erweitert, damit diese nun auch im Template Verzeichnis des Themes gesucht werden.

Hier nun beide Varianten kurz erläutert. Beide funktionieren dabei in Contao 2.9, die erste nur bis Contao 2.8.4

getTemplateGroup in Contao 2.8.x

In Contao 2.8.x (und früher) spielt es keine Rolle, an welcher Stelle man die Aufwahl für ein Template einbaut, das muss nicht beim Anlegen des Frontend Moduls sein.
Beispielsweise wird/wurde im Modul Banner unter dem Punkt Inhalte als erstes eine Kategorie angelegt, in dieser dann kam die Template Auswahl.
Das Frontend Modul wurde dann eine Kategorie zugewiesen, über diese konnte das Modul dann das gewählte Template erfahren.

Tabellen Angaben

Zum Abspeichern benötigt man natürlich ein Feld in der jeweiligen Tabelle, hier ein Auszug aus dem Banner Modul.
Für die Kategorie:

CREATE TABLE `tl_banner_category` (
  `id` int(10) unsigned NOT NULL auto_increment,
  `tstamp` int(10) unsigned NOT NULL default '0',
...
  `banner_template` varchar(32) NOT NULL default '', 
...
  PRIMARY KEY  (`id`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8;

Für das Frontend Modul in tl_module:

CREATE TABLE `tl_module` (
...
  `banner_categories` varchar(255) NOT NULL default '',
...
) ENGINE=MyISAM DEFAULT CHARSET=utf8; 

Dieses Felder müssen nun über die DCA Datei gesteuert werden.

DCA Angaben

In der DCA, hier "tl_banner_category.php", erfolgte nun im Abschnitt "fields" dieser Teil:

	'banner_template'            => array
	(
           'label'                   => &$GLOBALS['TL_LANG']['tl_banner_category']['banner_template'],
           'default'                 => 'mod_banner_list_all',
           'exclude'                 => true,
           'inputType'               => 'select',
           'options'                 => $this->getTemplateGroup('mod_banner_list_'),
           'eval'                    => array('tl_class'=>'w50')
	),

Hier nun zu sehen, ein Select Feld, welches als Default das Template "mod_banner_list_all" nimmt, gesucht werden Templates die beginnen mit "mod_banner_list_" und enden mit ".tpl", die Endung kann dabei hier nicht angegeben werden.
In dem Fall wird vom Framework zuerst im Verzeichnis "templates" vom Modul gesucht, und dann im Verzeichnis "TL_ROOT/templates". Liegen im letzterem Templates mit gleichem Namen werden diese bevorzugt. Damit wurde die Möglichkeit geschaffen, updatesichere Templates anzulegen auch für Module die keine Auswahlmöglichkeit bieten.
Der Name wird nach Auswahl und Speicherung in der Datenbank abgelegt und kann un vom Frontend Modul ausgelesen werden.

Zuvor muss im Frontend Modul natürlich die Kategorie abgelegt werden, dazu auch hier eine DCA Field Angabe:

/**
 * Add fields to tl_module
 */ 
$GLOBALS['TL_DCA']['tl_module']['fields']['banner_categories'] = array
(
	'label'                   => &$GLOBALS['TL_LANG']['tl_module']['banner_categories'],
	'exclude'                 => true,
	'inputType'               => 'checkbox',
	'foreignKey'              => 'tl_banner_category.title',
	'eval'                    => array('multiple'=>true, 'mandatory'=>true)
);

Hier als Checkbox, da die Möglichkeit sein sollte, mehrere Kategorien zu wählen.

Modul Auswertung

Das Frontend Modul schaut nun per SQL nach, welches Template verwendet werden soll. Um beim Beispiel Banner Modul zu bleiben, erst wird die Kategorie ermittelt und damit dann das Template.
Wenn der Name des Templates vom Default abweicht, muss innerhalb der eigenen Methode "compile" das neue Template aktiviert werden.
Hier mal kurze Code Sequenzen die das ganze etwas deutlicher machen sollten.

class ModuleBanner extends Module
{

	/**
	 * Template
	 * @var string
	 */
	protected $strTemplate = 'mod_banner_list_all'; // Das Default Template wie in der DCA definiert
....
        /**
	 * Generate module
	 */
	protected function compile()
	{
            // Contao legt checkbox Felder als serialisiertes Array ab in der DB (darin die IDs der Kategorien)
            $this->arrBannerCategories = deserialize($this->banner_categories, true);  

...
            $objBanners = $this->Database->prepare("SELECT TLB.id FROM tl_banner AS TLB "
	                                            . " LEFT JOIN tl_banner_category ON (tl_banner_category.id=TLB.pid)"
	                                            . " WHERE pid IN(" . implode(',', $this->arrBannerCategories) . ")"
                                                    // und noch viel mehr, aber hier nicht wichtig :-)
					 ->execute();
...
            

            //Wenn nötig, dann neues Template aktivieren
	    if (($objBanners->banner_template != $this->strTemplate) && ($objBanners->banner_template != '')) 
            {
	              $this->strTemplate = $objBanners->banner_template;
	              $this->Template = new FrontendTemplate($this->strTemplate);
	    }

        }

}

So bekommt also das Frontend Modul über einige Ecken das Template.

Natürlich kann man die Template Auswahl direkt im Frontend Modul machen. Das und die Änderung für Contao 2.9 zeigt der nächste Abschnitt.

getTemplateGroup in Contao 2.9.x