Konfiguration: Unterschied zwischen den Versionen

Aus Contao Community Documentation

(Anlegen des Artikels)
 
(Bereich Option recherchiert und angepasst)
 
(17 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
−
=Konfiguration=
 
 
[[Category:Dev HOWTOS]]
 
[[Category:Dev HOWTOS]]
  
Zeile 5: 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: <pre>$GLOBALS['BE_MOD'][SECTION][MODULE]['tables']</pre>
+
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">
 +
$GLOBALS['BE_MOD'];
 +
</source>
 +
 
 +
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">
 +
$GLOBALS['BE_MOD'][SECTION][MODULE][OPTION] = Wert;
 +
</source>
 +
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
 +
<source lang="php">array('PHP-Klasse','Funktion der PHP-Klasse')</source>
 +
ist:
 +
 
 +
<table style="border:1px #aaa solid;">
 +
<tr>
 +
<td>'''OPTION'''</td>
 +
<td>'''Beschreibung'''</td>
 +
<td>'''Typ'''</td>
 +
<td>'''Beispielhafter Wert'''</td>
 +
</tr><tr>
 +
<td>tables</td>
 +
<td>Ein Array der Tabellen die dieses Modul verwendet.</td>
 +
<td>ARRAY</td>
 +
<td><source lang="php">array('tl_article','tl_content')</source></td>
 +
</tr><tr>
 +
 
 +
<!-- 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>
 +
angezeigt wird.</td>
 +
<td>STRING</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>
 +
<td>callback</td>
 +
<td>Eine eigene Klasse, die das komplette Aussehen des
 +
Moduls steuert. Die Klasse muss eine Methode
 +
<source lang="php">generate()</source> haben, die ein Formular zurückgibt, das angezeigt werden soll.</td>
 +
<td>STRING</td>
 +
<td><source lang="php">'RepositoryCatalog'</source></td>
 +
</tr><tr>
 +
<td>''<custom-identifier>''</td>
 +
<td>Du kannst auch einen eigenen Bezeichner als OPTION angeben. Als Wert wird dann
 +
ein Array der Form
 +
<source lang="php">array('MeineKlasse','MeineFunktion')</source> erwartet.</td>
 +
<td>ARRAY</td>
 +
<td><source lang="php">array('Theme', 'importTheme')</source></td>
 +
</tr>
 +
</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
 +
...
  
−
==BE_MOD==
+
Beispiel:
−
<pre>$GLOBALS['BE_MOD'][SECTION][MODULE]['tables']</pre>
+
<source lang="php">
−
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.
+
$GLOBALS['BE_FFL']['text'] = 'TextField';
−
Die einzelnen Einstellungen, die hier vorgenommen werden können:
+
</source>
  
−
* ''tables'': Ein array von Tabellen, die dieses Modul verwendet.
+
Sieht so aus<br>
−
* ''icon'': Ein Pfad zum einem Sybol relativ zum Contao-Verzeichnis, das im Backend bei diesem Modul erscheint.
+
[[Datei:BackendTextField.jpg|center|frame|Backend-Text Field]]
−
* ''callback'': Eine PHP-Klasse, die die Ausgabe des Moduls steuert.
+
−
* ''import'': ???
+
−
* ''importTheme'': ??
+
−
* ''exportTheme'': ??
+
−
* ''table'': ??
+
−
* ''list'': ??
+

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
Von „https://de.contaowiki.org/index.php?title=Konfiguration&oldid=4526“
Ansichten
Meine Werkzeuge

Contao Community Documentation

Das hier ist eine abstrakte Konversation

Marc A. Harnos
Navigation
Verstehen
Verwenden
Entwickeln
Verschiedenes
Werkzeuge