Individualisierung von Kundensystemen#

TODO: Intro-Text

Contao-Einstellungen anpassen#

Die Contao-Einstellungen werden hauptsächlich über Konfigurationsdateien verwaltet. Für neu installierte Kunden-Systeme werden die wichtigsten Einstellungen bereits im Installationsprozess gesetzt.

Die gesetzten Einstellungen können im Contao-Backend im Bereich System → Einstellungen eingesehen werden.

Einige Einstellungen können hier auch direkt angepasst werden. Die Einstellungen der deaktiviert erscheinenden Felder können über eine Konfigurationsdatei in der Projekt-Struktur des Kundensystems überschrieben werden:

/config/config.yaml

Bei einem frisch installierten System ist diese Datei noch nicht vorhanden und muss neu angelegt werden.

Detaillierte Informationen zu den Contao-Einstellungen finden Sie in der Contao-Dokumentation.

Contao-Seitenstruktur anpassen#

Zunächst beim Startpunkt der Seite den Namen des Kunden-Systems hinterlegen und das Feld "Seitenalias" leeren und speichern.

Je nach Bedarf können weitere Seiten und Inhalte angelegt oder nicht benötigte Seiten und Inhalte entfernt werden.

Weitere Informationen hierzu finden Sie in der TOPAS-Anwender-Dokumentation.

Registrierungsprozess anpassen#

Die Texte der am Prozess beteiligten Seiteninhalte, Module und Benachrichtigungs-E-Mails sind mit Standard-Texten versehen und bereits durch die Verwendung von Platzhaltern individualisiert.

Bei Bedarf ist eine weitergehende Individualisierung möglich.

Registrierungs-Intro#

Der Text kann über das Contao-Backend auf der Seite "Registrierung" in dem entsprechenden Inhaltselement angepasst werden.

Registrierungs-Bestätigung#

Der Text kann über das Contao-Backend auf der Seite "Registrierung Bestätigung" in dem entsprechenden Inhaltselement angepasst werden.

Aktivierungs-Bestätigung#

Der Text kann über das Contao-Backend auf der Seite "Account aktiviert" in dem entsprechenden Inhaltselement angepasst werden.

E-Mail-Benachrichtigungen anpassen#

Die Anpassung erfolgt im Contao-Backend im Bereich "Benachrichtigungen".

  • Absender anpassen, falls abweichend von MAIL_FROM_ADDR und MAIL_FROM_NAME (s. 1)
  • Grußformel und Impressum anpassen

Willkommens-Nachricht#

Die Willkommensnachricht nach erfolgreicher Aktivierung des Benutzeraccounts kann über das Contao-Backend im Bereich Inhalte → Nodes → System-Nachrichten angepasst werden.

Inhalte anpassen#

Service-Seiten#

Sofern die Inhalte der Service-Seiten nicht über die automatische Artikel-Synchronisation erstellt werden, müssen ggf. die Inhalte folgender Seiten angepasst werden:

  • Hilfe-Texte
  • Impressum
  • AGB
  • Datenschutzerklärung
  • Netiquette

Tutorial#

Das Startseiten-Tutorial kann über das Contao-Backend im Bereich Inhalte → Nodes → System-Nachrichten angepasst werden.

Design anpassen#

Individuelle Design-Dateien werden in folgendenden Ordnern abgelegt:

Frontend-Assets (Styles, Webfonts, Bilder, Javascript)#

/files/theme/frontend/custom/

Frontend-Templates#

/templates/custom/

s. auch Projektstruktur und Contao-Dateiverwaltung

Stylesheets#

Um die vom TOPAS-Theme mitgelieferten Stylesheets zu überschreiben oder zu erweitern kann folgende Datei genutzt werden:

/files/theme/frontend/custom/scss/app.scss

Diese wird automatisch nach CSS konvertiert und im <head> der Seite geladen, wenn die Datei existiert und nicht leer ist.

Contao prüft automatisch das Änderungsdatum dieser Datei und sorgt bei Änderungen dafür, dass das CSS vom Browser neu geladen und nicht aus dem Browsercache geladen wird.

Je nach Umfang der Anpassungen oder zur besseren Strukturierung können weitere SCSS-Dateien erstellt werden, die dann in der app.scss importiert werden. Hierbei ist zu beachten, dass Änderungen an den importierten Dateien von Contao nicht automatisch erkannt werden und somit der Mechanismus zum erzwungenen Neuladen der CSS-Dateien durch den Browser nicht greift. Damit dies dennoch funktioniert, muss nach Änderungen an importierten SCSS-Dateien immer auch die app.scss neu gespeichert werden.

Schriften (Webfonts)#

Individuelle Webfonts gehören in den Ordner:

/files/theme/frontend/custom/fonts/

Bei Bedarf können innerhalb dieses Ordners weitere Unterordner angelegt werden, welche unterschiedliche Webfonts enthalten.

Die Webfonts können dann in den individuellen Stylesheets verwendet werden.

Bilder#

Bilder, wie beispielsweise Kundenlogos, können in diesem Ordner abgelegt werden:

/files/theme/frontend/custom/img/

Javascript#

Um das System im individuelles Javascript zu eweitern, kann folgende Datei genutzt werden:

/files/theme/frontend/custom/js/app.js

Diese wird automatisch vor dem schließenden </body>-Tag geladen, wenn diese existiert und nicht leer ist.

Contao prüft automatisch das Änderungsdatum dieser Datei und sorgt bei Änderungen dafür, dass das Javascript vom Browser neu geladen und nicht aus dem Browsercache geladen wird.

Templates#

In der Regel sollten keine Anpassungen an den Templates erforderlich sein.

Falls dies doch erforderlich sein sollte, setzt dies Programmierkenntnisse und ein tiefergehendes Verständnis des TOPAS-Systems voraus.

Um die vom TOPAS-System bereitgestellten Templates zu überschrieben, muss ein Template mit gleichem Namen wie das Original-Template im Ordner /templates/custom erstellt werden.

Am einfachsten geht dies über das Contao-Backend über Layout → Templates. Zuerst muss dort das zu überschreibende Original-Template gesucht werden. Anschließend muss dann der Zielordner custom gewählt werden.

Das individuelle Template kann dann entweder direkt in Contao oder aber besser mit einem Code-Editor bearbeitet werden.

Hintergrundbild anpassen#

Das Hintergrundbild kann über die Dateiverwaltung angepasst werden.

Voraussetzung ist eine PNG-Bilddatei mit mindestens folgender Auflösung: 4000x3000 px

Datei benennen nach page-background.png und in der Dateiverwaltung in den Ordner System\Layout hochladen. Hierdurch wird die vorhandene Datei ersetzt.

Logo anpassen#

Das Logo kann über die Dateiverwaltung angepasst werden.

Hierzu folgende eine Dateien mit Namen logo.svg in den Ordner System\Layout hochladen. Die bestehende Logo-Datei wird hierdurch überschrieben.

Favicon anpassen#

Das Favicon kann über die Dateiverwaltung angepasst werden.

Hierzu folgende Dateien zwei Dateien mit Namen favicon.ico und touchicon.png in den Ordner System\Layout hochladen.Die bestehenden Dateien werdeb hierdurch überschrieben.