Contao Tutorial – Theming (Teil 3)
Im Folgenden gibt es einen kurzen Einblick, wie in Contao ein eigenes Theme erstellt werden kann (Best Practice).
Themes lassen sich als eine Datei mit der Endung .cto komprimiert exportieren und wieder importieren.
Datei läßt sich auf Windows mit Packprogramm wie 7-Zip entpacken. Auf dem Mac Datei einfach in .zip umrennen und dann entpacken.
Best Practice
Theme enthält | Nutzen |
---|---|
theme.xml | Infos zu Autor, Pfad zu Ordner files und templates, Infos zu Layouts, Modulen etc., weitere Konfigurationen |
Ordner files | CSS, Bilder und mehr. Dort mehrere Ordner z.B. css, js und scss |
Ordner template | html-Gerüste in .html5 |
1. Ordnerstruktur auf FTP anlegen
- Alles findet im Ordner
files
statt. In Contao Menüpunkt:Dateiverwaltung
. - Gut ist
/themes/themes-name/
, weil dadurch bessere Übersicht bei mehr Themes. Dort drin:css
,js
undscss
- Eventuell extra Ordner
system/images
außerhalb der Themes anlegen, auf die nur der Redakteur Zugriff hat z.B. um Logos auszutauschen. - Ordner
content
anlegen. Dort drin grobe Struktur: document, files, images
2. Neues Theme anlegen
- Theme ⇒ Neues Theme. Titel, Autor und Ordner-Pfad des Themes angeben. Bildschirmfoto optional (Screenshot des Themes im Backend).
- Keine Globalen Variablen nutzen, besser: SCSS nutzen.
3. Module anlegen
- Themes ⇒ Theme wählen ⇒ Frontend Module bearbeiten.
- Module Gruppieren in
layout
undnav
, z.Bnav - main
oderlayout - searchfield
4. Layout erstellen.
- Themes ⇒ Theme wählen ⇒ Seitenlayouts bearbeiten.
- Bennung z.B.
1-col default
. Module zuordnen. - Body-Klasse vergeben um jede Seite einzeln ansprechen zu können, am besten so:
{{page::alias}}
5. Themes Exportieren
- Themes ⇒ Theme wählen ⇒ Export Theme.