Templates bearbeiten: Unterschied zwischen den Versionen
Aus Contao Community Documentation
K (Warnung angepasst) |
K (Erweiterte Erklärung zu Contao V. 3.2.3 inkl. Bilder eingefügt) |
||
| (9 dazwischenliegende Versionen von 6 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
| − | {{AppliesTo|TLVersion=Alle Versionen| | + | {{AppliesTo|TLVersion=Alle Versionen|Version=ab 2.9}} |
| − | + | ||
| − | + | ||
[[Category: Admin_HOWTOS]] | [[Category: Admin_HOWTOS]] | ||
| − | Es gibt 2 Möglichkeiten, um in | + | Es gibt 2 Möglichkeiten, um in Contao Templates zu bearbeiten. |
| − | =Direkt in | + | =Direkt in Contao über das Backend= |
Die Template-Sektion ist im Backend unter Layout --> Templates zu finden. Um ein Template zu bearbeiten, klickt man im Main-Bereich auf ''Neues Template''. Im darauffolgend angezeigten Dropdown Feld findet man eine Liste aller z.Z. existierenden Templates (sowohl die des Cores als auch die der Erweiterungen, die man einsetzt). | Die Template-Sektion ist im Backend unter Layout --> Templates zu finden. Um ein Template zu bearbeiten, klickt man im Main-Bereich auf ''Neues Template''. Im darauffolgend angezeigten Dropdown Feld findet man eine Liste aller z.Z. existierenden Templates (sowohl die des Cores als auch die der Erweiterungen, die man einsetzt). | ||
| + | |||
| + | Das folgende Bild erklärt die Contao/TL Version 2.8.0 | ||
[[Datei:be_template_1.jpg|Templateauswahl]] | [[Datei:be_template_1.jpg|Templateauswahl]] | ||
| − | Man sucht sich das Template, das man bearbeiten will, aus dem Dropdown Feld aus und klickt anschliessend auf den Button ''Template erstellen'' (in diesem Fall das Template ''nav_default.tpl'', das für das Menü zuständig ist). | + | Das folgende Bild erklärt die Contao Version 3.2.3 |
| + | |||
| + | [[Datei:be_template_1_contao_3_x.jpg|Templateauswahl]] | ||
| + | |||
| + | |||
| + | Man sucht sich das Template, das man bearbeiten will, aus dem Dropdown Feld aus und klickt anschliessend auf den Button ''Template erstellen'' (in diesem Fall das Template ''nav_default.tpl'', das für das Menü zuständig ist - weitere mögliche Dateinamenserweiterungen für Systeme ab Contao 2.10.x sind *.xhtml und *.html5). | ||
| + | |||
| + | {{msgWarning|Die Dateinamenerweiterung *.tpl entfällt mit der Version 2.10.x! Es sind nur die Dateierweiterungen *.xhtml und *.html5 enthalten.}} | ||
| + | |||
| + | |||
| + | '''Ab Contao 3: Unter ''Zielverzeichnis'' werden der Ordner ''templates'' und ein Unterodner mit Deinen Themes angzeigt. Hier unbedingt Dein Theme wählen! Templates im Ordner ''Templates'' werden nicht eingebunden.''' | ||
| + | |||
| + | Das folgende Bild erklärt die Contao/TL Version 2.8.0 | ||
[[Datei:be_template_2.jpg]] | [[Datei:be_template_2.jpg]] | ||
| + | |||
| + | Das folgende Bild erklärt die Contao Version 3.2.3 | ||
| + | |||
| + | [[Datei:be_template_2_contao_3_x.jpg|Templateauswahl]] | ||
| + | |||
In der Übersicht sieht man nur das gewählte Template. Rechts davon sind 3 Icons zu finden. | In der Übersicht sieht man nur das gewählte Template. Rechts davon sind 3 Icons zu finden. | ||
| Zeile 18: | Zeile 35: | ||
* '''Template löschen:''' Löscht das entsprechende Template | * '''Template löschen:''' Löscht das entsprechende Template | ||
| − | =Mit | + | =Mit einem Editor über FTP= |
| − | Wer lieber mit einem Editor arbeitet, kann | + | Wer lieber mit einem Editor arbeitet, kann Templates auch manuell bearbeiten. Dazu eignet sich am besten ein Editor, welcher direkt auf dem FTP-Server arbeitet, die Template-Dateien von dort öffnet und auch wieder speichert. Z.B. [http://www.pspad.com/ PsPad], [http://notepad-plus-plus.org/ Notepad++] u.a. |
| + | {{Achtung| Niemals [[Contao-Core-Dateien|Core-Dateien]] verändern. Templates, welche man bearbeitet liegen immer im Ordner TL_ROOT/templates/}} | ||
=Mehrere Templates verwenden= | =Mehrere Templates verwenden= | ||
| − | + | Contao macht nun folgendes: Wenn bei der Modul-Erstellung das Orginal-Template (nav_default.tpl) ausgewählt wurde, schaut das System zuerst nach, ob in /template/ '''(Contao 3: /templates/DeinThemeName)''' ein modifiziertes nav_default.tpl liegt. Wenn ja, wird dieses verwendet. Wenn nein, wird das Orginal-Template von /system/modules/frontend/templates/ genommen. | |
Es ist auch möglich, mehrere modifizierte Templates zu erstellen, wenn z.B. mehrere Menü-Module angelegt werden, die unterschiedliche Templates benötigen. Hier ist es wichtig, beim Umbennenen das '''nav_''' zu erhalten. Die Templatenamen könnten z.B. so lauten: nav_custom1.tpl, nav_modify.tpl usw. Wenn man nun das Menü-Modul erstellt, werden bei der Templateauswahl alle Templates aufgelistet, die ein nav_ davor haben. | Es ist auch möglich, mehrere modifizierte Templates zu erstellen, wenn z.B. mehrere Menü-Module angelegt werden, die unterschiedliche Templates benötigen. Hier ist es wichtig, beim Umbennenen das '''nav_''' zu erhalten. Die Templatenamen könnten z.B. so lauten: nav_custom1.tpl, nav_modify.tpl usw. Wenn man nun das Menü-Modul erstellt, werden bei der Templateauswahl alle Templates aufgelistet, die ein nav_ davor haben. | ||
| − | {{Achtung| Nochmals zur Erinnerung: Alle modifizierten Templates, egal ob im Orginalnamen oder umbenannt, müssen im Ordner /templates/ abgespeichert werden. NIE das Orginaltemplate überschreiben!. Das hat den Vorteil, dass bei Updates die Templates in /templates/ nicht überschrieben werden, die Orginaltemplates (z.B. system/modules/frontend/templates/nav_default.tpl) jedoch schon.}} | + | {{Achtung| Nochmals zur Erinnerung: Alle modifizierten Templates, egal ob im Orginalnamen oder umbenannt, müssen im Ordner /templates/ '''(Contao 3: /templates/DeinThemeName)''' abgespeichert werden. NIE das Orginaltemplate überschreiben!. Das hat den Vorteil, dass bei Updates die Templates in /templates/ nicht überschrieben werden, die Orginaltemplates (z.B. system/modules/frontend/templates/nav_default.tpl) jedoch schon.}} |
| + | |||
| + | =Links zum Thema= | ||
| + | [[Eigene_Templates_trotz_fehlender_Auswahlmöglichkeit|Eigene Templates trotz fehlender Auswahlmöglichkeit]] | ||
| + | |||
| + | [[Template_Variablen_anzeigen|Template Variablen anzeigen]] | ||
| + | |||
| + | [[Templates|Templates]] | ||
Aktuelle Version vom 13. Januar 2014, 23:00 Uhr
| betrifft | |
|---|---|
| TYPOlight Version | Alle Versionen |
| Contao Version | ab 2.9 |
Es gibt 2 Möglichkeiten, um in Contao Templates zu bearbeiten.
Inhaltsverzeichnis
Direkt in Contao über das Backend
Die Template-Sektion ist im Backend unter Layout --> Templates zu finden. Um ein Template zu bearbeiten, klickt man im Main-Bereich auf Neues Template. Im darauffolgend angezeigten Dropdown Feld findet man eine Liste aller z.Z. existierenden Templates (sowohl die des Cores als auch die der Erweiterungen, die man einsetzt).
Das folgende Bild erklärt die Contao/TL Version 2.8.0
Das folgende Bild erklärt die Contao Version 3.2.3
Man sucht sich das Template, das man bearbeiten will, aus dem Dropdown Feld aus und klickt anschliessend auf den Button Template erstellen (in diesem Fall das Template nav_default.tpl, das für das Menü zuständig ist - weitere mögliche Dateinamenserweiterungen für Systeme ab Contao 2.10.x sind *.xhtml und *.html5).
Ab Contao 3: Unter Zielverzeichnis werden der Ordner templates und ein Unterodner mit Deinen Themes angzeigt. Hier unbedingt Dein Theme wählen! Templates im Ordner Templates werden nicht eingebunden.
Das folgende Bild erklärt die Contao/TL Version 2.8.0
Das folgende Bild erklärt die Contao Version 3.2.3
In der Übersicht sieht man nur das gewählte Template. Rechts davon sind 3 Icons zu finden.
- Template umbennenen: Man kann (muss aber nicht!) das gewählte Template umbenennen.
- Template bearbeiten: Über diesen Button kann man den Quellcode des Templates bearbeiten
- Template löschen: Löscht das entsprechende Template
Mit einem Editor über FTP
Wer lieber mit einem Editor arbeitet, kann Templates auch manuell bearbeiten. Dazu eignet sich am besten ein Editor, welcher direkt auf dem FTP-Server arbeitet, die Template-Dateien von dort öffnet und auch wieder speichert. Z.B. PsPad, Notepad++ u.a.
 |
Achtung: Niemals Core-Dateien verändern. Templates, welche man bearbeitet liegen immer im Ordner TL_ROOT/templates/ |
Mehrere Templates verwenden
Contao macht nun folgendes: Wenn bei der Modul-Erstellung das Orginal-Template (nav_default.tpl) ausgewählt wurde, schaut das System zuerst nach, ob in /template/ (Contao 3: /templates/DeinThemeName) ein modifiziertes nav_default.tpl liegt. Wenn ja, wird dieses verwendet. Wenn nein, wird das Orginal-Template von /system/modules/frontend/templates/ genommen.
Es ist auch möglich, mehrere modifizierte Templates zu erstellen, wenn z.B. mehrere Menü-Module angelegt werden, die unterschiedliche Templates benötigen. Hier ist es wichtig, beim Umbennenen das nav_ zu erhalten. Die Templatenamen könnten z.B. so lauten: nav_custom1.tpl, nav_modify.tpl usw. Wenn man nun das Menü-Modul erstellt, werden bei der Templateauswahl alle Templates aufgelistet, die ein nav_ davor haben.
| |
Achtung: Nochmals zur Erinnerung: Alle modifizierten Templates, egal ob im Orginalnamen oder umbenannt, müssen im Ordner /templates/ (Contao 3: /templates/DeinThemeName) abgespeichert werden. NIE das Orginaltemplate überschreiben!. Das hat den Vorteil, dass bei Updates die Templates in /templates/ nicht überschrieben werden, die Orginaltemplates (z.B. system/modules/frontend/templates/nav_default.tpl) jedoch schon. |
