Konfiguration: Unterschied zwischen den Versionen

Aus Contao Community Documentation

(Bereich Option recherchiert und angepasst)
 
(11 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 4: Zeile 4:
  
 
{{AppliesTo
 
{{AppliesTo
|Version=2.9.0}}
+
|Version=2.10.0}}
 +
 
 +
=Allgemein=
  
 
Hier soll eine Sammlung der Einstellungen entstehen, die in den Dateien localconfig, config, etc. eingestellt werden können.
 
Hier soll eine Sammlung der Einstellungen entstehen, die in den Dateien localconfig, config, etc. eingestellt werden können.
 
Also Einstellungen der Form:
 
Also Einstellungen der Form:
  
 +
Das Array $GLOBALS, in dem die Einstellungen gespeichert werden, hat folgende Schlüssel:
 +
 +
* '''BE_MOD''': Backend-Module
 +
* '''BE_FFL''': Backend Forumular-Felder
 +
* '''FE_MOD''': Frontend-Module
 +
* '''FE_FFL''': Frontend Formular-Felder
 +
* '''TL_PTY''': Seitentypen
 +
* '''TL_CACHE''': Cache-Tabellen
 +
* '''TL_CRON''': Zeitgesteuerte Skripts (cronjobs)
 +
* '''TL_HOOKS''': Erweiterungspunkte
 +
* '''TL_MIME''': MIME-Typen.
 +
* '''TL_DCA''': Data Container Array (Backend Formulare, Felder, Listen).
 +
 +
Beispiel:
 
<source lang="php">
 
<source lang="php">
$GLOBALS['BE_MOD'][SECTION][MODULE]['tables']
+
$GLOBALS['BE_MOD'];
 
</source>
 
</source>
  
==BE_MOD==
+
Sieht so aus:
 +
 
 +
[[Datei:BackendModule.jpg|frame|center|Backend-Module]]
 +
 
 +
=BE_MOD=
 +
<source lang="php">
 +
$GLOBALS['BE_MOD'];
 +
</source>
 +
Dieser Teil des Konfigurationarrays enthält alle Einstellungen für die Backendmodule. Es enthält das Sub-Array SECTION.
 +
 
 +
==SECTION==
 +
<source lang="php">
 +
$GLOBALS['BE_MOD'][SECTION];
 +
</source>
 +
Dieser Teil des Konfigurationarrays enthält standardmäßig die 5 folgenden Bereiche:
 +
 
 +
* content: Das sind jene Module, die unter dem Menüpunkt "Inhalte" im Contao-Backend erscheinen.
 +
* design: Das sind jene Module, die unter dem Menüpunkt "Layout" im Contao-Backend erscheinen.
 +
* accounts: Das sind jene Module, die unter dem Menüpunkt "Benutzerverwaltung" im Contao-Backend erscheinen.
 +
* system: Das sind jene Module, die unter dem Menüpunkt "System" im Contao-Backend erscheinen.
 +
* profile: Das sind jene Module, die unter dem Menüpunkt "Benutzerfunktionen" im Contao-Backend erscheinen.
 +
 
 +
Beispiel:
 +
<source lang="php">
 +
$GLOBALS['BE_MOD']['content'];
 +
</source>
 +
 
 +
Sieht so aus:<br>
 +
[[Datei:InhalteSektion.jpg|center|frame|Sektion "Inhalte"]]
 +
 
 +
Es können hier natürlich aus eigene (neue) Sektionen eingeführt werde, dazu muss man einfach das Array um den gewünschten Wert ergänzen, bzw. den gewünschten wert an der richtigen Stelle im Array einfügen.
 +
Jede Sektion enthält ein weiteres Sub-Array MODULE
 +
 
 +
===MODULE===
 +
<source lang="php">
 +
$GLOBALS['BE_MOD'][SEKTION][MODULE];
 +
</source>
 +
 
 +
Dieser Teil des Konfigurationarrays enthält die Bezeichnungen der Module, die unter den jeweiligen Sektionen geladen werden sollen.
 +
 
 +
<source lang="php">
 +
$GLOBALS['BE_MOD']['content']['article'];
 +
</source>
 +
 
 +
Sieht so aus:<br>
 +
[[Datei:ModuleArtikel.jpg|center|frame|Modul "Artikel"]]
 +
 
 +
Jedes Modul enthält wiederum ein Sub-Array, in dem die Einstellungen für dieses Modul zu finden sind. Siehe OPTION.
 +
 
 +
====OPTION====
 +
 
 
<source lang="php">
 
<source lang="php">
$GLOBALS['BE_MOD'][SECTION][MODULE][TOKEN]
+
$GLOBALS['BE_MOD'][SECTION][MODULE][OPTION] = Wert;
 
</source>
 
</source>
Hier können neue Backend-Module registriert werden. Dabei bezeichnet SECTION den Namen des Abschnitts unter der dieses Modul erscheint (z.B.: 'content' für den Abschitt Inhalte, 'layout' für den Abschnitt Layout). MODULE bezeichnet den Namen des Moduls das im Backend angezeigt werden soll.
+
Hier können die einzelnen Einstellungen für ein Modul vorgenommen werden. Die möglichen Einstellungen sind aus der unteren Tabelle ersichtlich.
Für die folgende Tabelle gilt, dass der Typ FUNKTION ein 2stelliges Array der Form
+
Es gilt dabei, dass der Typ FUNKTION ein Array der Form
 
<source lang="php">array('PHP-Klasse','Funktion der PHP-Klasse')</source>
 
<source lang="php">array('PHP-Klasse','Funktion der PHP-Klasse')</source>
ist.
+
ist:
Die einzelnen Einstellungen, die hier vorgenommen werden können:
+
  
 
<table style="border:1px #aaa solid;">
 
<table style="border:1px #aaa solid;">
 
<tr>
 
<tr>
<td>'''TOKEN'''</td>
+
<td>'''OPTION'''</td>
 
<td>'''Beschreibung'''</td>
 
<td>'''Beschreibung'''</td>
 
<td>'''Typ'''</td>
 
<td>'''Typ'''</td>
Zeile 35: Zeile 100:
 
<td><source lang="php">array('tl_article','tl_content')</source></td>
 
<td><source lang="php">array('tl_article','tl_content')</source></td>
 
</tr><tr>
 
</tr><tr>
<td>icon</td>
+
 
 +
<!-- konnte dieses nicht im Modul Backend->getBackendModule() finden -->
 +
<!--td>icon</td>
 
<td>Ein Pfad zu einem Bild, dass als icon für dieses Modul<br>
 
<td>Ein Pfad zu einem Bild, dass als icon für dieses Modul<br>
 
angezeigt wird.</td>
 
angezeigt wird.</td>
 
<td>STRING</td>
 
<td>STRING</td>
<td><source lang="php">'system/modules/newsletter/html/icon.gif'</source></td>
+
<td><source lang="php">'system/modules/newsletter/html/icon.gif'</source></td-->
 +
 
 +
<!-- Beginn: Neu seit Version 2.10 -->
 +
<td>stylesheet</td>
 +
<td>Der Pfad zu einer CSS-Datei, die dass aussehen des Moduls bestimmt.</td>
 +
<td>STRING</td>
 +
<td><source lang="php">'system/modules/comments/html/style.css'</source></td>
 +
</tr><tr>
 +
<td>javascript</td>
 +
<td>Der Pfad zu einer Javascript-Datei, welche von dem Modul benötigt wird.</td>
 +
<td>STRING</td>
 +
<td><source lang="php">'system/modules/anymodule/html/javascript.js'</source></td>
 +
<!-- Ende: Neu seit Version 2.10 -->
 +
 
 
</tr><tr>
 
</tr><tr>
 
<td>callback</td>
 
<td>callback</td>
 
<td>Eine eigene Klasse, die das komplette Aussehen des
 
<td>Eine eigene Klasse, die das komplette Aussehen des
 
Moduls steuert. Die Klasse muss eine Methode
 
Moduls steuert. Die Klasse muss eine Methode
<source lang="php">generate()</source> haben, die eine Form zurückgibt, die angezeigt werden soll.</td>
+
<source lang="php">generate()</source> haben, die ein Formular zurückgibt, das angezeigt werden soll.</td>
 
<td>STRING</td>
 
<td>STRING</td>
 
<td><source lang="php">'RepositoryCatalog'</source></td>
 
<td><source lang="php">'RepositoryCatalog'</source></td>
 
</tr><tr>
 
</tr><tr>
<td>import</td>
+
<td>''<custom-identifier>''</td>
<td>Funktion, dass den Datenimporter für die Kindtabelle implementiert.</td>
+
<td>Du kannst auch einen eigenen Bezeichner als OPTION angeben. Als Wert wird dann
<td>FUNKTION</td>
+
ein Array der Form
<td><source lang="php">array('Newsletter', 'importRecipients')</source></td>
+
<source lang="php">array('MeineKlasse','MeineFunktion')</source> erwartet.</td>
</tr><tr>
+
<td>ARRAY</td>
<td>importTheme</td>
+
<td>Funktion, dass einen Datenimporter für die Haupttabelle implementiert.</td>
+
<td>FUNKTION</td>
+
 
<td><source lang="php">array('Theme', 'importTheme')</source></td>
 
<td><source lang="php">array('Theme', 'importTheme')</source></td>
</tr><tr>
 
<td>exportTheme</td>
 
<td>Funktion, dass einen Datenexporter für die einzelnen Elemente der Haupttabelle implementiert.</td>
 
<td>FUNKTION</td>
 
<td><source lang="php">array('Theme', 'exportTheme')</source></td>
 
</tr><tr>
 
<td>table</td>
 
<td>UNKLAR: ???</td>
 
<td>FUNKTION</td>
 
<td><source lang="php">array('TableWizard', 'importTable')</source></td>
 
</tr><tr>
 
<td>list</td>
 
<td>UNKLAR: ???</td>
 
<td>FUNKTION</td>
 
<td>array('ListWizard', 'importList')</source></td>
 
 
</tr>
 
</tr>
 
</table>
 
</table>
 +
 +
=BE_FFL=
 +
<source lang="php">
 +
$GLOBALS['BE_FFL'];
 +
</source>
 +
 +
Dieser Teil des Konfigurationsarrays enthält alle Einstellungen für die Backend-Formular-Felder.
 +
Dieses Element hat ein Sub-Array mit den Backend-Formular-Widgets. Siehe BE_WIDGETS.
 +
 +
==BE_WIDGETS==
 +
<source lang="php">
 +
$GLOBALS['BE_FFL'][BE_WIDGET] = Wert;
 +
</source>
 +
 +
In diesem Teil können die neuen Backend-Formular-Widgets hinzugefügt werden. Dazu überträgt man als Werte einfach den Namen der Klasse, die dieses Widget implementiert.
 +
Standardmäßig sind die folgenden Elemente implementiert:
 +
 +
* '''text''': Einfaches Textfeld.
 +
* '''password''': Ein Passwortfeld in dem die Eingabe mit Punkten ersetzt wird.
 +
* '''textStore''': ???
 +
* '''textarea''': Ein mehrzeiliges Eingabefeld. (RTE Feld, etc.)
 +
* '''select''': Ein Auswahl-Menü (Dropdown-Box)
 +
* '''checkBox''': Eine Auswahlbox, die man anhaken kann.
 +
* '''checkboxWizard''': ???
 +
* '''radio''': Eine runde Auswahlbox
 +
...
 +
 +
Beispiel:
 +
<source lang="php">
 +
$GLOBALS['BE_FFL']['text'] = 'TextField';
 +
</source>
 +
 +
Sieht so aus<br>
 +
[[Datei:BackendTextField.jpg|center|frame|Backend-Text Field]]

Aktuelle Version vom 16. November 2011, 19:01 Uhr


MsgError.png Unvollständiger Artikel: dieser Artikel ist noch nicht sauber bearbeitet.

Bitte erweitere ihn und entferne erst anschliessend diesen Hinweis.


betrifft
Contao Version 2.10.0


Allgemein

Hier soll eine Sammlung der Einstellungen entstehen, die in den Dateien localconfig, config, etc. eingestellt werden können. Also Einstellungen der Form:

Das Array $GLOBALS, in dem die Einstellungen gespeichert werden, hat folgende Schlüssel:

  • BE_MOD: Backend-Module
  • BE_FFL: Backend Forumular-Felder
  • FE_MOD: Frontend-Module
  • FE_FFL: Frontend Formular-Felder
  • TL_PTY: Seitentypen
  • TL_CACHE: Cache-Tabellen
  • TL_CRON: Zeitgesteuerte Skripts (cronjobs)
  • TL_HOOKS: Erweiterungspunkte
  • TL_MIME: MIME-Typen.
  • TL_DCA: Data Container Array (Backend Formulare, Felder, Listen).

Beispiel:

$GLOBALS['BE_MOD'];

Sieht so aus:

Backend-Module

BE_MOD

$GLOBALS['BE_MOD'];

Dieser Teil des Konfigurationarrays enthält alle Einstellungen für die Backendmodule. Es enthält das Sub-Array SECTION.

SECTION

$GLOBALS['BE_MOD'][SECTION];

Dieser Teil des Konfigurationarrays enthält standardmäßig die 5 folgenden Bereiche:

  • content: Das sind jene Module, die unter dem Menüpunkt "Inhalte" im Contao-Backend erscheinen.
  • design: Das sind jene Module, die unter dem Menüpunkt "Layout" im Contao-Backend erscheinen.
  • accounts: Das sind jene Module, die unter dem Menüpunkt "Benutzerverwaltung" im Contao-Backend erscheinen.
  • system: Das sind jene Module, die unter dem Menüpunkt "System" im Contao-Backend erscheinen.
  • profile: Das sind jene Module, die unter dem Menüpunkt "Benutzerfunktionen" im Contao-Backend erscheinen.

Beispiel:

$GLOBALS['BE_MOD']['content'];

Sieht so aus:

Sektion "Inhalte"

Es können hier natürlich aus eigene (neue) Sektionen eingeführt werde, dazu muss man einfach das Array um den gewünschten Wert ergänzen, bzw. den gewünschten wert an der richtigen Stelle im Array einfügen. Jede Sektion enthält ein weiteres Sub-Array MODULE

MODULE

$GLOBALS['BE_MOD'][SEKTION][MODULE];

Dieser Teil des Konfigurationarrays enthält die Bezeichnungen der Module, die unter den jeweiligen Sektionen geladen werden sollen.

$GLOBALS['BE_MOD']['content']['article'];

Sieht so aus:

Modul "Artikel"

Jedes Modul enthält wiederum ein Sub-Array, in dem die Einstellungen für dieses Modul zu finden sind. Siehe OPTION.

OPTION

$GLOBALS['BE_MOD'][SECTION][MODULE][OPTION] = Wert;

Hier können die einzelnen Einstellungen für ein Modul vorgenommen werden. Die möglichen Einstellungen sind aus der unteren Tabelle ersichtlich. Es gilt dabei, dass der Typ FUNKTION ein Array der Form

array('PHP-Klasse','Funktion der PHP-Klasse')

ist:

OPTION Beschreibung Typ Beispielhafter Wert
tables Ein Array der Tabellen die dieses Modul verwendet. ARRAY
array('tl_article','tl_content')
stylesheet Der Pfad zu einer CSS-Datei, die dass aussehen des Moduls bestimmt. STRING
'system/modules/comments/html/style.css'
javascript Der Pfad zu einer Javascript-Datei, welche von dem Modul benötigt wird. STRING
'system/modules/anymodule/html/javascript.js'
callback Eine eigene Klasse, die das komplette Aussehen des

Moduls steuert. Die Klasse muss eine Methode

generate()
haben, die ein Formular zurückgibt, das angezeigt werden soll.
STRING
'RepositoryCatalog'
<custom-identifier> Du kannst auch einen eigenen Bezeichner als OPTION angeben. Als Wert wird dann

ein Array der Form

array('MeineKlasse','MeineFunktion')
erwartet.
ARRAY
array('Theme', 'importTheme')

BE_FFL

$GLOBALS['BE_FFL'];

Dieser Teil des Konfigurationsarrays enthält alle Einstellungen für die Backend-Formular-Felder. Dieses Element hat ein Sub-Array mit den Backend-Formular-Widgets. Siehe BE_WIDGETS.

BE_WIDGETS

$GLOBALS['BE_FFL'][BE_WIDGET] = Wert;

In diesem Teil können die neuen Backend-Formular-Widgets hinzugefügt werden. Dazu überträgt man als Werte einfach den Namen der Klasse, die dieses Widget implementiert. Standardmäßig sind die folgenden Elemente implementiert:

  • text: Einfaches Textfeld.
  • password: Ein Passwortfeld in dem die Eingabe mit Punkten ersetzt wird.
  • textStore: ???
  • textarea: Ein mehrzeiliges Eingabefeld. (RTE Feld, etc.)
  • select: Ein Auswahl-Menü (Dropdown-Box)
  • checkBox: Eine Auswahlbox, die man anhaken kann.
  • checkboxWizard: ???
  • radio: Eine runde Auswahlbox

...

Beispiel:

$GLOBALS['BE_FFL']['text'] = 'TextField';

Sieht so aus

Backend-Text Field
Ansichten
Meine Werkzeuge

Contao Community Documentation

Andreas, leg dich da hinten hin und schlaf, dann kommen wir vorwaerts.

Tristan Lins
Navigation
Verstehen
Verwenden
Entwickeln
Verschiedenes
Werkzeuge