Inhaltsverzeichnis. Handbuch für Contao 3.4

Transkript

1 Inhaltsverzeichnis 1. Einleitung 2. Installation i. Contao installieren ii. Den Safe Mode Hack verwenden iii. Manuelles Update iv. Live Update Service v. Eine Installation umziehen vi. Den Live-Server konfigurieren 3. Administrationsbereich i. Datensätze auflisten ii. Datensätze bearbeiten iii. Backend-Tastaturkürzel 4. Seiten verwalten i. Komponenten ii. Themes iii. Stylesheets iv. Module v. Seitenlayouts vi. Seitentypen 5. Inhalte verwalten i. Artikel ii. Nachrichten iii. Termine iv. RSS-/Atom-Feed v. Newsletter vi. Formulare vii. Kommentare viii. Templates ix. Markdown x. Inserttags 6. Systemadministration i. Benutzer und Gruppen ii. Erweiterungen iii. Systemwartung 7. Data Container Arrays i. Referenz ii. Paletten iii. Callbacks 8. Contao anpassen i. Internen Cache umgehen ii. Konfiguration anpassen iii. Eigene Felder hinzufügen iv. TinyMCE anpassen v. Methoden überschreiben vi. Contao-Hooks 9. Das Extension Repository i. Eine Erweiterung anlegen ii. Eine Freigabe hinzufügen iii. Die Dateien hochladen 1

2 iv. Dateien aus einem GitHub-Repository hinzufügen v. Eine Übersetzung hinzufügen vi. Abhängigkeiten speichern vii. Die Erweiterung veröffentlichen 10. Contao-Entwicklungsprozess i. Tickets erstellen 2

3 Handbuch für Contao 3.4 Dies ist das offizielle Handbuch für Anwender und Entwickler. Die neuste Version ist unter docs.contao.org erhältlich. Inhaltsverzeichnis Einleitung Installation Contao installieren Den Safe Mode Hack verwenden Manuelles Update Live Update Service Eine Installation umziehen Den Live-Server konfigurieren Administrationsbereich Datensätze auflisten Datensätze bearbeiten Backend-Tastaturkürzel Seiten verwalten Komponenten Themes Stylesheets Module Seitenlayouts Seitentypen Inhalte verwalten Artikel Nachrichten Termine RSS-/Atom-Feed Newsletter Formulare Kommentare Templates Markdown Inserttags Systemadministration Benutzer und Gruppen Erweiterungen Systemwartung Data Container Arrays Referenz Paletten Callbacks Contao anpassen Internen Cache umgehen Konfiguration anpassen Eigene Felder hinzufügen TinyMCE anpassen Methoden überschreiben Einleitung 3

4 Contao-Hooks Das Extension Repository Eine Erweiterung anlegen Eine Freigabe hinzufügen Die Dateien hochladen Dateien aus einem GitHub-Repository hinzufügen Eine Übersetzung hinzufügen Abhängigkeiten speichern Die Erweiterung veröffentlichen Contao-Entwicklungsprozess Tickets erstellen Licence The Contao documentation is licensed under a Creative Commons Attribution 3.0 License license (CC BY-NC-SA 3.0). If you want to redistribute a modified or unmodified version of the documentation, you can do so under the license terms. If you contribute to the documentation, e.g. by creating pull requests, you grant us full usage rights of any content you create or upload. You also ensure that your content does not violate any third-party rights. We are not claiming exclusive usage rights, therefore you are free to use your contributed content (e.g. texts or images) in any other project as well. Einleitung 4

5 Installation Die folgenden Abschnitte erklären die Installation und Aktualisierung von Contao. Sie lernen wie man das Contao-Installtool verwendet, wie man eine Installation per FTP synchronisiert, wie man den Safe Mode Hack einrichtet und wie man einen Webserver für Contao konfiguriert. Installation 5

6 Contao installieren Laden Sie sich zunächst das aktuelle Contao-Archiv herunter und entpacken Sie es auf Ihrem lokalen Rechner. Verschieben Sie die Dateien in das htdocs -Verzeichnis Ihrer XAMPP-Installation oder kopieren Sie sie mit einem FTP- Programm (z.b. WinSCP) auf Ihren Server. Der Basisordner heißt wahrscheinlich htdocs, httpdocs, html oder public_html. Wenn Sie SSH-Zugriff auf den Server haben, können Sie alternativ folgende Befehle verwenden: curl -L tar -xzp Das Contao-Installtool Um das Contao-Installtool aufzurufen, hängen Sie einfach /contao/install.php an die URL Ihrer Contao-Installation an. Beachten Sie, dass das Installtool mit einem Passwort gegen Brute Force-Attacken geschützt ist und gesperrt wird, wenn dreimal hintereinander ein falsches Passwort eingegeben wurde. Um diese Sperre aufzuheben, öffnen Sie die Datei system/config/localconfig.php in einem Texteditor, finden Sie die folgende Zeile und setzen Sie sie auf 0. $GLOBALS['TL_CONFIG']['installCount'] = 0; // Hebt die automatische Sperre auf Datenbankverbindung herstellen Melden Sie sich an der Administrationsoberfläche Ihres Servers (z.b. "Plesk" oder "cpanel") an und erstellen Sie eine neue Datenbank für Contao. Geben Sie die Zugangsdaten im Contao-Installtool ein und beachten Sie die abweichende Schreibweise UTF8 anstatt UTF-8 in MySQL! Tabellen aktualisieren Contao prüft bei der Installation die Tabellen der Datenbank und gibt eine Liste empfohlener Änderungen aus, wenn diese nicht aktuell sind. Lesen Sie diese Empfehlungen aufmerksam, denn Contao kennt nur seine eigenen Tabellen und wird versuchen, vermeintlich nicht benötigte Tabellen anderer Programme "aufzuräumen". Bestätigen Sie die Änderungen durch Anklicken der "Datenbank aktualisieren"-schaltfläche. Ein Template importieren Ein Template ist eine vorkonfigurierte Webseite, die eine beispielhafte Seitenstruktur und verschiedene Stylesheets zur Formatierung der Contao Core-Module und -Inhaltselemente enthält. Seit Version ist die Beispiel-Webseite nicht mehr im Downloadpaket enthalten. Abhängig von der eingesetzten Version kann die neue Contao Official Demo oder die alte Music Academy als Erweiterung installiert werden. Aufschluss über Kompatibilität gibt das Erweiterungsverzeichnis. Vorgehen zur Installation der Demo: 1. Eine frische Contao Installation mit Admin-Account erstellen 2. Als Admin im Backend anmelden 3. Passende Erweiterung über das Extension Repository hinzufügen 4. Als Admin vom Backend abmelden 5. Installtool erneut aufrufen Contao installieren 6

7 Um ein Template zu importieren, wählen Sie den Eintrag aus dem Drop-Down-Menü und klicken Sie auf die "Template importieren"-schaltfläche. Beim Import eines Templates werden bestehende Daten überschrieben! Administrator-Konto erstellen Wenn Sie kein Template importiert haben, müssen Sie ein Administrator-Konto erstellen, damit Sie sich am Contao- Backend anmelden können. Danach ist der Installationsprozess abgeschlossen. Der Link unten rechts leitet Sie zur Backend-Anmeldung weiter. Wenn Sie die Beispielwebseite importiert haben, können Sie sich dort als Benutzer "k.jones" mit dem Passwort "kevinjones" anmelden. Contao Demo installieren Siehe Vorgehen zur Installation der Demo im Abschnitt Ein Template importieren weiter oben. Suchmaschinenfreundliche URLs verwenden Wenn Sie einen Apache-Webserver haben und mod_rewrite verwenden dürfen, können Sie Contao dazu veranlassen, suchmaschinenfreundliche URLs zu generieren, die wie statische HTML-Seiten aussehen. Die dazu benötigten Rewrite- Regeln sind in der.htaccess.default -Datei im Contao-Verzeichnis gespeichert. Benennen Sie diese Datei um in.htaccess, damit sie vom Apache-Server erkannt wird, und rufen Sie anschließend das Modul "Einstellungen" im Contao- Backend auf. Wählen Sie die Option "URLs umschreiben" in der Gruppe "Frontend-Einstellungen" aus und speichern Sie Ihre Änderungen. Contao generiert jetzt statische URLs wie z.b. home.html anstatt index.php?id=12. Contao installieren 7

8 Den Safe Mode Hack verwenden Eventuell haben Sie beim Aufruf des Contao-Installtools die Mitteilung erhalten, dass die lokale Konfigurationsdatei nicht beschreibbar ist. Dateizugriffsrechte Die Bezeichnung "Safe Mode Hack" ist eigentlich nicht korrekt, da sie impliziert, dass das Problem durch den PHP safe_mode verursacht würde. Tatsächlich wird es jedoch von unzureichenden Dateizugriffsrechten verursacht und tritt auch bei deaktiviertem safe_mode auf, daher sollte es richtiger "File Permission Hack" heißen. PHP als Apache-Modul läuft normalerweise als Benutzer wwwrun, www-data oder nobody, wohingegen die Dateien, die Sie per FTP hochgeladen haben, Ihrem Benutzer (z.b. web4 oder ab5678 ) gehören. Der Server verweigert Benutzern grundsätzlich den Zugriff auf fremde Dateien und macht auch für das PHP-Skript Contao keine Ausnahme. FTP für Dateioperationen verwenden Um das Rechteproblem zu umgehen, baut Contao eine FTP-Verbindung auf und legt die Ressourcen unter dem FTP- Benutzer an. Sie müssen dafür nur Ihre FTP-Zugangsdaten im Installtool eintragen. Achten Sie dabei besonders auf den korrekten relativen Pfad vom FTP-Basisordner zum Contao-Verzeichnis (z.b. html/, public_html/ oder httpdocs/ ). Ein paar wenige Verzeichnisse benötigen trotz Safe Mode Hack Schreibrechte, weil PHP direkt auf sie zugreift: assets/images assets/images/* Den Safe Mode Hack verwenden 8

9 system/logs system/tmp Die Schreibrechte (CHMOD 777) werden vom Installtool automatisch gesetzt und müssen in der Regel nicht manuell nachgearbeitet werden. Falls dies doch einmal notwendig sein sollte, passen Sie bitte nur diese drei Verzeichnisse an auch wenn Sie in einem Tutorial oder dem Contao-Forum etwas anderes gelesen haben sollten! Den Safe Mode Hack verwenden 9

10 Manuelles Update Bei der manuellen Aktualisierung einer Contao-Installation können Sie entweder das komplette Contao-Archiv auf den Server übertragen (Dateien ersetzen) oder nur die geänderten Dateien hochladen (Dateien synchronisieren). In jedem Fall sollten Sie vorher folgende Dateien und Ordner sichern - nur für den Fall, dass ein Fehler auftritt oder Sie sie versehentlich überschreiben: files/* system/config/dcaconfig.php system/config/initconfig.php system/config/langconfig.php system/config/localconfig.php templates/* Dieses Backup umfasst Ihre lokale Konfiguration, eventuell angepasste Templates sowie die hochgeladenen Dateien. Dateien ersetzen Die Dateien einer Contao-Installation zu ersetzen ist relativ simpel. Übertragen Sie einfach das Contao-Archiv auf Ihren Server oder entpacken Sie es auf Ihrem lokalen Rechner und kopieren Sie die Dateien anschließend mit einem FTP- Programm (wir empfehlen WinSCP). Danach stellen Sie die Dateien aus dem Backup wieder her und entfernen eventuelle Überbleibsel vorheriger Contao-Versionen. Achtung: Wenn Sie Third-Party-Erweiterungen installiert haben, müssen Sie diese ebenfalls sichern und nach dem Update wiederherstellen oder darauf achten, sie gar nicht erst zu überschreiben. Andernfalls müssen diese Module neu installiert werden, was bei einigen Erweiterungen zu Datenverlust führen kann! Dateien synchronisieren Um eine Contao-Installation zu synchronisieren, können Sie entweder das Unix Diff-Programm oder einen FTP-Client verwenden. Unix-Utilities werden normalerweise nur von Serveradministratoren verwendet, daher werden sie hier nicht erklärt. Um Dateien per FTP zu synchronisieren, öffnen Sie WinSCP und verbinden Sie sich mit dem Server. Erstellen Sie ein Backup der oben genannten Dateien und navigieren Sie dann zum Contao-Verzeichnis und klicken Sie auf die "Dateien synchronisieren"-schaltfläche. Manuelles Update 10

11 Treffen Sie Ihre Auswahl wie in der Abbildung und wählen Sie unbedingt die Option "Änderungsvorschau" aus, damit Sie die zu aktualisierenden Dateien noch einmal prüfen können. Bestätigen Sie danach die Einstellungen im Vorschaufenster und achten Sie besonders auf die zu löschenden Ressourcen! Klicken Sie "OK", um den Synchronisationsvorgang zu starten. Die Datenbank aktualisieren Nachdem Sie die Contao-Dateien aktualisiert haben, müssen Sie noch die Datenbank auf den neuesten Stand bringen. Diese Arbeit übernimmt das Contao-Installtool für Sie. Geben Sie Ihr Passwort ein, scrollen Sie bis zum Datenbank- Abschnitt und bestätigen Sie die Änderungen. Den internen Cache leeren Zum Schluss muss noch der interne Cache (DCA- und Sprachdateien) geleert und neu angelegt werden. Gehen Sie im Manuelles Update 11

12 Backend zur "Systemwartung" und wählen unter "Daten bereinigen" den Punkt "Internen Cache leeren" aus. Bestätigen Sie die Aktion mit "Daten bereinigen". Nun erscheint in der Kopfzeile vom Backend ein Hinweis, dass der interne Cache noch nicht aufgebaut wurde. Erstellen Sie den internen Cache in dem Sie in der Kopfzeile "Den Cache aufbauen" anklicken. Manuelles Update 12

13 Live Update Service Der Contao Live Update-Service ist ein kommerzielles Contao Add-on von inet Robots, der Firma des Contao-Gründers und Kernentwicklers, Leo Feyer. Es ermöglicht die Aktualisierung Ihrer Installation mit wenigen Klicks im Backend, ohne ein Contao-Archiv herunterzuladen oder die Dateien mit einem FTP-Programm zu synchronisieren. Eine Contao Live Update ID bestellen Das Live Update umfasst folgende Funktionen: Beliebige Up- und Downgrades auf alle Contao-Versionen Automatisches Backup der Datenbank vor dem Update Individuelle Prüfung und Vervollständigung der Contao-Installation Vergleich der angepassten Templates mit den Originaldateien Versionsauswahl Template-Unterschiede Live Update Service 13

14 Fehlersuche 99% aller Live Update-Probleme sind auf unzureichende Datei-Zugriffsrechte zurück zu führen. Contao benötigt Schreibrechte, um Dateien und Ordner zu verwalten, daher sollten Sie als erstes Ihre Serverkonfiguration prüfen und sicherstellen, dass der Safe Mode Hack so wie in diesem Handbuch beschrieben konfiguriert ist! Support erhalten Wenn Sie Probleme bei der Aktivierung Ihrer Live Update ID haben, wenden Sie sich bitte an den inet Robots-Support. Bei Problemen mit dem Safe Mode Hack oder der Benutzung von Contao, wählen Sie bitte eine passende Support-Option auf der Support-Seite. Live Update Service 14

15 Eine Installation umziehen Der Umzug einer Contao-Installation von einem lokalen Server auf einen Live-Server ist nicht viel anders als eine neue Installation, außer dass Sie die Dateien Ihrer lokalen Installation statt denen des Contao-Archivs sowie einen SQL-Dump Ihrer lokalen Datenbank verwenden. Dateien kopieren Öffnen Sie Ihr FTP-Programm, verbinden Sie sich mit dem Zielserver und übertragen Sie alle Dateien Ihrer lokalen Contao- Installation. Datenbank exportieren Ein MySQL-Dump lässt sich am einfachsten mit der Datenbankverwaltung "phpmyadmin" erstellen. Als Serveradministrator können Sie natürlich auch das Programm mysqldump verwenden. Melden Sie sich an "phpmyadmin" an, wählen Sie die zu exportierende Datenbank und klicken Sie auf die "Export"-Schaltfläche im oberen Menü. Um Kompatibilitätsprobleme zwischen verschiedenen MySQL-Versionen zu minimieren, ist es wichtig, die Einstellungen für den Export gemäß des folgenden Screenshots anzupassen: Datenbank importieren Öffnen Sie "phpmyadmin" auf dem Zielserver und erstellen Sie eine neue Datenbank für Contao. Je nach Eine Installation umziehen 15

16 Serverkonfiguration ist das eventuell nur über die Verwaltungsoberfläche (z.b. "Plesk" oder "cpanel") möglich. Wählen Sie die neue leere Datenbank aus und klicken Sie auf die "Import"-Schaltfläche im oberen Menü. Laden Sie dann den SQL- Dump der lokalen Datenbank hoch und starten Sie den Import. Datenbank-Konfiguration anpassen Als Letztes öffnen Sie das Contao-Installtool der neuen Installation (das Passwort ist dasselbe wie für Ihre lokale Installation) und passen wenn nötig die Datenbank-Zugangsdaten an. Danach können Sie sich wie gewohnt mit Ihrem Benutzernamen im Backend anmelden. Eine Installation umziehen 16

17 Den Live-Server konfigurieren In diesem Kapitel geht es nicht darum, den Apache-Dienst zu installieren oder PHP zu kompilieren, was auf einem Shared- Hosting-Server ohnehin nicht möglich ist. Stattdessen wird erklärt, wie man die Contao-Systemvoraussetzungen prüft und PHP 5 aktiviert. Contao-Systemvoraussetzungen Contao benötigt einen Webserver wie Apache oder IIS mit PHP- und MySQL-Support. PHP muss mindestens in der Version vorliegen und MySQL in der Version Außerdem benötigen Sie die PHP-Erweiterungen "GDlib" (Bildbearbeitung), "DOM" (XML-Dateien), "SOAP" (Extension Repository) und Phar (Live Update) sowie optional "mbstring" (internationale Zeichen) und "mcrypt" (Verschlüsselung). Contao wurde erfolgreich in allen modernen Browsern wie Firefox (ab Version 2) oder Internet Explorer (ab Version 8) getestet. Der Contao-Check Laden Sie den Contao-Check herunter und finden Sie heraus, ob Ihr Server die Contao-Systemvoraussetzungen erfüllt. Der Contao-Check prüft, ob Sie das Extension Repository und das Live Update nutzen können und ob Sie den Safe Mode Hack benötigen oder nicht. Je nach Systemkonfiguration können Sie mit Hilfe des Web-Installers eine neue Contao- Installation aufsetzen oder eine bestehende Installation prüfen. Entpacken Sie die Zip-Datei, übertragen Sie den Ordner check in Ihr Contao-Verzeichnis und öffnen Sie ihn in einem Browser. Den Contao-Check herunterladen Zum Projekt auf GitHub Provider-spezifische Einstellungen Es gibt ein paar wenige große Internet Service Provider, die spezielle Einstellungen für den Betrieb von Contao erfordern. Zum Glück sind sie nur die Ausnahme von der Regel. Die Provider-spezifische Einstellungen finden Sie im Contao-Forum. Sorgenfreies Contao-Hosting erhalten Sie bei den Contao Hosting-Partnern. Den Live-Server konfigurieren 17

18 Administrationsbereich Um den Administrationsbereich (Backend) aufzurufen, hängen Sie einfach /contao an die URL Ihrer Contao-Webseite an. Die Konten sind gegen Brute Force-Attacken geschützt und werden für 5 Minuten gesperrt, wenn dreimal hintereinander ein falsches Passwort eingegeben wurde. Beachten Sie dass die Groß-/Kleinschreibung bei Benutzername und Passwort berücksichtigt wird. Administrationsbereich 18

19 Datensätze auflisten Die Contao Core-Engine unterstützt drei Ansichten: eine einfache Liste ("list view"), eine nach der übergeordneten Tabelle gruppierte Liste ("parent view") und eine hierarchische Liste ("tree view"). Diese drei Ansichten werden zur Darstellung der Daten im Backend verwendet. List View Der "List View" listet die Datensätze einer Tabelle in einer bestimmten Reihenfolge auf, normalerweise gruppiert nach Anfangsbuchstabe. Parent View Der "Parent View" listet die Datensätze einer Kindtabelle auf, die sich auf einen Datensatz der Elterntabelle beziehen. Eltern-Kind-Relationen kommen häufig vor in Contao, z.b. bei Artikeln und Inhaltselementen, Archiven und Nachrichten oder Stylesheets und Formatdefinitionen. Datensätze auflisten 19

20 Tree View Der "Tree View" listet Datensätze auf, die in einer hierarchischen Struktur organisiert sind. Contao unterstützt sowohl hierarchische Beziehungen innerhalb einer Tabelle (z.b. Seitenstruktur) als auch Kindtabellen, die sich auf hierarchische Elterntabellen beziehen (z.b. Artikel und Seiten). Datensätze auflisten 20

21 Daten sortieren und filtern Contao bietet mehrere Möglichkeiten, Auflistungen zu sortieren und zu filtern, damit Sie auch bei mehreren tausend Datensätzen den Überblick behalten. Viele Listen können anhand eines oder mehrerer Felder eingeschränkt werden. Die meisten bieten zusätzlich eine Volltext-Suche an, die sogar reguläre Ausdrücke unterstützt. Um die Ladezeit zu optimieren, zeigt Contao immer nur 30 Datensätze auf einmal an. Datensätze auflisten 21

22 Datensätze bearbeiten Contao bietet etliche professionelle Funktionen, die das Bearbeiten von Daten so einfach und komfortabel wie möglich machen. Sie können zu früheren Versionen zurück gehen, gelöschte Datensätze wiederherstellen, Elemente via Clipboard verschieben und sogar mehrere Datensätze auf einmal bearbeiten. Die meisten dieser Funktionen sind über die Navigationssymbole aufrufbar. Icons im List View Der "List View" als einfachste Ansicht bietet nur die vier grundlegenden Befehle: bearbeiten, duplizieren, löschen und Info. Icons im Parent View Der "Parent View" bietet zwei zusätzliche Icons, um die Reihenfolge der Datensätze zu kontrollieren. Die Reihenfolge kann auch mittels Drag & Drop geändert werden. Dazu einfach auf das "Drag & Drop" Icon klicken und an die neue Position bewegen. Datensätze bearbeiten 22

23 Icons im Tree View Im "Tree View" werden weitere Icons benötigt, um die hierarchische Struktur abbilden zu können. Neben dem Kopieren eines einzelnen Datensatzes können auch ganze Teilbäume dupliziert und entweder in einen oder nach einem anderen Datensatz eingefügt werden. Datensätze bearbeiten 23

24 Frühere Versionen wiederherstellen Contao erstellt bei jedem Speichervorgang automatisch eine neue Version eines Datensatzes. Sobald es mehr als eine Version gibt, erscheint oberhalb des Formulars ein Drop-Down-Menü, mit dem Sie zu einer früheren Versionen zurück gehen können. Durch Klick auf das Icon rechts des Drop-Down-Menüs werden die Unterschiede zwischen der aktuellen und der gewählten Version angezeigt. Datensätze bearbeiten 24

25 Mehrere Datensätze bearbeiten Die Möglichkeit, mehrere Datensätze auf einmal zu bearbeiten, hebt Contao klar von den Mitbewerbern ab. Wechseln Sie den Bearbeitungsmodus durch Anklicken der "Mehrere bearbeiten"-schaltfläche und wählen Sie dann die zu bearbeitenden Datensätze und Felder aus. Datensätze bearbeiten 25

26 Datensätze bearbeiten 26

27 Datensätze bearbeiten 27

28 Backend-Tastaturkürzel Um den Workflow bei der Arbeit mit Contao zu beschleunigen, gibt es im Backend etliche Tastaturkürzel, mit denen sich bestimmte Befehle direkt aufrufen lassen. Zum Beispiel können Sie die Schaltfläche "Speichern" am Ende eines Eingabeformulars alternativ zur Bedienung mit der Maus auch mit dem Tastaturkürzel [Alt]+[s] ansteuern. Allgemeine Tastaturkürzel Tastaturkürzel Schaltfläche Erklärung [Alt]+[h] Startseite Zur Startseite des Backend (Home). [Alt]+[q] Abmelden Beendet die aktuelle Backend-Sitzung (Quit). [Alt]+[t] Nach oben Springt zum Anfang der Seite (Top). [Alt]+[b] Zurück Zurück zur vorherigen Seite (Back). [Alt]+[n] Neuer Datensatz Legt einen neuen Datensatz an (New). [Alt]+[e] [Alt]+[f] Mehrere bearbeiten Frontend-Vorschau Wechselt in den "mehrere bearbeiten"-modus (Edit multiple). Öffnet die Frontend-Vorschau in einem neuen Fenster (Front end preview). Tastaturkürzel im Bearbeitungsmodus Tastaturkürzel Schaltfläche Erklärung [Alt]+[s] Speichern Speichert das aktuelle Eingabeformular (Save). [Alt]+[c] [Alt]+[g] [Alt]+[e] [Alt]+[n] Speichern und schließen Speichern und zurück Speichern und bearbeiten Speichern und neu Speichert und schließt das aktuelle Eingabeformular (Save and close). Sie gelangen zurück zur vorherigen Seite. Speichert und schließt das aktuelle Eingabeformular (Save and go back). Sie gelangen zurück zur übergeordneten Seite, z.b. von einem Inhaltselement direkt zur Artikelübersicht. Speichert das aktuelle Eingabeformular (Save and edit) und wechselt zur Ansicht der Kind-Datensätze, z.b. beim Anlegen von Stylesheets. Speichert das aktuelle Eingabeformular und legt einen neuen Datensatz an (Save and new). Tastaturkürzel im Modus "mehrere bearbeiten" Tastaturkürzel Schaltfläche Erklärung [Alt]+[d] [Alt]+[x] [Alt]+[c] [Alt]+[v] Mehrere löschen Mehrere verschieben Mehrere kopieren Mehrere überschreiben Löscht alle ausgewählten Datensätze im Modus»mehrere bearbeiten«(delete). Verschiebt alle ausgewählten Datensätze im Modus»mehrere bearbeiten«. Kopiert alle ausgewählten Datensätze im Modus»mehrere bearbeiten«(copy). Überschreibt alle ausgewählten Datensätze im Modus»mehrere bearbeiten«. Backend-Tastaturkürzel 28

29 Die beschriebenen Tastaturkürzel funktionieren in dieser Form nur unter Windows. Mac-Nutzer müssen anstatt der [Alt] - Taste [Ctrl]+[ Opt] in Verbindung mit dem jeweiligen Kürzel verwenden. Zudem weicht Firefox unter Windows leider vom gewohnten Standard ab, dort müssen Sie [Alt]+[Umsch] in Verbindung mit dem gewünschten Kürzel drücken. Backend-Tastaturkürzel 29

30 Seiten verwalten Die folgenden Kapitel erklären, wie man Seiten in Contao verwaltet. Da Contao ein Seiten-basiertes CMS ist, sind Seiten und die Seitenstruktur die zentralen Elemente Ihrer Webseite und jeder Inhalt, der nicht mit einer Seite assoziiert ist, erscheint auch niemals im Frontend. Seiten verwalten 30

31 Komponenten Das Zusammenspiel von Seiten, Artikeln, Inhaltselementen und Modulen zu verstehen, ist der Schlüssel zum Erlernen von Contao. Wie bereits erwähnt, ist die Seitenstruktur das zentrale Element der Webseite. Besucher rufen grundsätzlich immer Seiten auf und niemals einzelne Artikel, wie es in einem Node-basierten Content Management System der Fall ist. Das Diagramm verdeutlicht, dass Artikel und Layouts die beiden wichtigsten Komponenten einer Seite sind. Während Artikel die Inhalte einer Seite speichern, legt das Seitenlayout fest, wie diese auf der Webseite dargestellt werden. Layouts in Contao sind natürlich CSS-basiert und verwenden keine Layout-Tabellen. Auf den folgenden Seiten wird erklärt, wie man Stylesheets und Frontend-Module anlegt, sie zu einem Layout kombiniert und sie anschließend einer neu erstellten Seite zuweist. Komponenten 31

32 Themes Das Design einer Webseite besteht normalerweise aus Stylesheets, Frontendmodulen, Seitenlayouts, Dateien und Templates, die Sie im Contao-Backend verwalten können. Der Theme-Manager ändert diesen Ansatz nicht, er fügt lediglich eine Möglichkeit hinzu, die Ressourcen zu exportieren und wieder zu importieren (Video-Einführung ansehen). Themes versus Frontend-Templates Der Hauptunterschied zwischen Themes und Frontend-Templates ist, dass ein Frontend-Template eine vollständig vorkonfigurierte Beispielwebseite mit einer beispielhaften Seitenstruktur, Artikeln, Inhaltselementen und sogar Benutzern und Gruppen enthält. Ein Theme enthält dagegen nur das eigentliche Design der Webseite und kann deswegen importiert werden, ohne dass bestehende Daten verloren gehen. Theme-Bestandteile Ein Theme ist eine Gruppe von Stylesheets, Frontend-Modulen und Seitenlayouts, die alle in der Datenbank gespeichert sind und automatisch vom Theme Exporter erkannt werden. Sie werden diese Elemente in den nächsten Abschnitten näher kennenlernen. Ein Theme beinhaltet darüber hinaus meistens auch Bilder und andere Dateien aus dem Files- Verzeichnis sowie optional angepasste Templates aus dem Templates-Verzeichnis. Diese Ressourcen sind jedoch nicht automatisch mit dem Theme verlinkt und müssen deswegen in den Theme-Einstellungen hinzugefügt werden, damit sie beim Theme-Export berücksichtigt werden. Themes 32

33 Theme-Export und -Import Um ein Theme zu exportieren, klicken Sie einfach auf die Export-Schaltfläche und speichern Sie die.cto-datei auf Ihrem lokalen Computer. Obwohl.cto eine proprietäre Dateiendung für Contao-Themes ist, handelt es sich dabei eigentlich um ZIP-Archive, die Sie mit jedem Programm entpacken können, das.zip-dateien unterstützt. Um ein Theme zu reimportieren, übertragen Sie die.cto-datei auf Ihren Webserver, öffnen Sie den Theme-Manager im Contao-Backend und klicken Sie auf "Theme importieren". Sie können mehrere Themes auf einmal importieren. Nachdem der Import abgeschlossen ist, können Sie das Seitenlayout des neuen Themes in der Seitenstruktur zuweisen. Themes 33

34 Stylesheets Barrierefreie Webseiten sollten immer mit CSS formatiert werden, daher enthält Contao ein "Stylesheets"-Modul, mit dem Sie Formatdefinitionen bequem im Backend verwalten können. Um die verschiedenen Contao-Elemente und -Module in einem Stylesheet zu referenzieren, müssen Sie deren Klassennamen kennen. Inhaltselement-Klassen beginnen mit "ce_" (z.b. "ce_text") und Modul-Klassen mit "mod_" (z.b. "mod_search"). Falls Sie sich nicht sicher sind, sehen Sie einfach im Quelltext der Webseite nach. Jedes Stylesheet kann auf einen oder mehrere Medientypen und/oder eine bestimmte Version des Internet Explorers beschränkt werden, falls Sie einen der vielen darin enthaltenen Fehler gesondert beheben müssen. Achten Sie dabei auf die Reihenfolge der Formatdefinitionen, da frühere Anweisungen von späteren überschrieben werden können. /* Zuerst den generellen Abstand setzen */.mod_search margin:24px; /* Danach die spezielle IE7-Anweisung */ *:first-child+html.mod_search margin:18px; Stylesheets 34

35 Wäre die Reihenfolge umgekehrt, würde der allgemeine Abstand den IE-spezifischen Wert überschreiben. Stylesheets 35

36 Module Modul CSS-Klasse Beschreibung Navigationsmenü mod_navigation Erzeugt ein Navigationsmenü aus der Seitenstruktur. Individuelle Navigation mod_customnav Erzeugt ein individuelles Navigationsmenü. Navigationspfad mod_breadcrumb Erzeugt einen Navigationspfad. Quicknavigation mod_quicknav Erzeugt ein Drop-Down-Menü aus der Seitenstruktur. Quicklink mod_quicklink Erzeugt ein individuelles Drop-Down-Menü. Buchnavigation mod_booknav Erzeugt ein Buchnavigationsmenü. Artikelnavigation mod_article_nav Erzeugt ein Seitenumbruch-Menü zur Artikelnavigation. Sitemap mod_sitemap Erzeugt eine Liste aller Seiten aus der Seitenstruktur. Login-Formular mod_login Erzeugt ein Anmeldeformular (Login). Automatischer Logout - Meldet einen Benutzer automatisch ab (Logout). Persönliche Daten mod_personaldata Erzeugt ein Formular zur Bearbeitung der Benutzerdaten. Registrierung mod_registration Erzeugt ein Formular zur Benutzerregistrierung. Passwort vergessen mod_password Erzeugt ein Formular zur Passwort-Anforderung. Konto schließen mod_closeaccount Erzeugt ein Formular zur Löschung eines Benutzerkontos. Nachrichtenliste mod_newslist Fügt der Seite eine Nachrichtenliste hinzu. Nachrichtenleser mod_newsreader Stellt einen einzelnen Nachrichtenbeitrag dar. Nachrichtenarchiv mod_newsarchive Fügt der Seite ein Nachrichtenarchiv hinzu. Mit Hilfe von Frontend-Modulen können Sie Ihre Webseite um fast jede erdenkliche Funktionalität erweitern. Der Contao- Core enthält Module, um verschiedene Navigationsmodule zu erstellen, die Benutzerregistrierung und -anmeldung zu ermöglichen, die Webseite zu durchsuchen, RSS-Feeds zu importieren und vieles mehr. Module können im Backend unter "Themes" -> "Frontend-Module" konfiguriert werden. Nachrichtenarchiv- Menü mod_newsmenu Erzeugt ein Menü zur Navigation des Nachrichtenarchivs. Kalender mod_calendar Fügt der Seite einen Kalender hinzu. Eventleser mod_eventreader Stellt ein einzelnes Event dar. Eventliste mod_eventlist Listet alle Events eines bestimmten Zeitraums auf. Eventliste-Menü mod_eventmenu Erzeugt ein Menü zur Navigation der Eventliste. Abonnieren mod_subscribe Erzeugt ein Formular zum Abonnieren von Verteilern. Kündigen mod_unsubscribe Erzeugt ein Formular zum Kündigen von Abonnements. Newsletterliste mod_nl_list Fügt der Seite eine Newsletterliste hinzu. Newsletterleser mod_nl_reader Stellt einen einzelnen Newsletter dar. FAQ-Liste mod_faqlist Fügt der Seite eine Liste häufig gestellter Fragen hinzu. FAQ-Leser mod_faqreader Stellt die Antwort zu einer häufig gestellten Frage dar. FAQ-Seite mod_faqpage Gibt die FAQ-Liste und den FAQ-Leser auf derselben Seite aus. Module 36

37 Formular mod_form Fügt der Seite ein Formular hinzu. Suchmaschine mod_search Fügt der Seite ein Suchfomular hinzu. Kommentare mod_comments Kommentare bzw. Gästebuch-Einträge verwalten. Auflistung mod_listing Listet die Daten einer beliebigen Tabelle auf. Flash-Film mod_flash Bindet einen Flash-Film in eine Seite ein. Artikelliste mod_article_list Erzeugt eine Liste aller Artikel einer Spalte. Zufallsbild mod_random_image Fügt der Seite ein zufällig ausgewähltes Bild hinzu. Eigener HTML-Code - Erlaubt das Hinzufügen von eigenem HTML-Code. RSS-Reader mod_rss_reader Fügt der Seite einen RSS-Feed hinzu. Zugriffsschutz Jedes Frontend-Modul kann geschützt werden, so dass es nur Gäste oder Benutzer einer bestimmten Mitgliedergruppe sehen können. Module 37

38 Seitenlayouts Seitenlayouts definieren den grundsätzlichen Aufbau einer Seite, wie z.b. die Anzahl der Spalten oder die Gesamtbreite, und sie legen fest, welche Frontend-Module in welcher Spalte angezeigt werden. Sie ermöglichen zudem das Einbinden von Stylesheets und RSS- bzw. Atom-Feeds sowie das Einfügen einer Google Analytics ID oder beliebigem JavaScript- Code, der für die Steuerung interaktiver Elemente und Plugins benötigt wird. Das Contao CSS-Framework teilt das Browserfenster automatisch in mehrere Layoutbereiche auf. Das impliziert, dass Sie zum Zeitpunkt der Erstellung eines Seitenlayouts bereits die benötigten Stylesheets und Frondend- Module angelegt haben müssen. Daher wird folgende Reihenfolge beim Anlegen von Ressourcen empfohlen: Erstellen der benötigten Stylesheets Erstellen der benötigten Frontend-Module Optionale Erstellung von Nachrichtenarchiven oder Kalendern Erstellen eines neuen Seitenlayouts und Einbindung der Komponenten Seitenlayouts 38

39 Seitentypen Der Typ einer Seite legt fest, ob sie statische Inhalte ausgibt, zu einer anderen Seite weiterleitet oder den Startpunkt einer Webseite innerhalb der Seitenstruktur markiert. Contao unterstützt folgende 6 Seitentypen: Seitentyp Reguläre Seite Externe Weiterleitung Interne Weiterleitung Startpunkt einer Webseite 403 Zugriff verweigert 404 Seite nicht gefunden Beschreibung Eine reguläre Seite enthält Artikel und Inhaltselemente. Sie verhält sich wie eine statische HTML- Seite. Diese Seite leitet Besucher automatisch zu einer externen Webseite um (entspricht einem Hyperlink). Diese Seite leitet Besucher automatisch zu einer anderen Seite innerhalb der Seitenstruktur um. Diese Seite kennzeichnet den Startpunkt einer neuen Webseite innerhalb der Seitenstruktur. Beim Aufruf einer geschützten Seite ohne Zugriffsrechte wird stattdessen die 403-Fehlerseite geladen. Diese Seite muss direkt unterhalb des Startpunktes einer Webseite angelegt werden. Beim Aufruf einer nicht vorhandenen Seite wird stattdessen die 404-Fehlerseite geladen. Diese Seite muss direkt unterhalb des Startpunktes einer Webseite angelegt werden. Multidomain-Betrieb Contao unterstützt mehrere Webseiten innerhalb der Seitenstruktur und leitet Besucher je nach DNS- und Spracheinstellungen automatisch auf einen bestimmten Startpunkt einer Webseite weiter. Nehmen wir an, Sie betreiben eine zweisprachige Firmenwebseite unter " und eine kleine private Webseite unter der Domain " Sie benötigen dafür drei Startpunkte: Typ DNS Sprachenkürzel Fallback-Sprache Deutsche Firmenseite keine de nein Englische Firmenseite keine en ja Private Webseite de ja Die folgende Tabelle zeigt, zu welcher Seite ein Besucher abhängig von der Domain und seiner Browsersprache weitergeleitet wird. Domain Browsersprache Weiterleitung Englisch Englische Firmenseite Deutsch Deutsche Firmenseite Spanisch Englische Firmenseite egal Persönliche Webseite Beachten Sie, dass die persönliche Webseite ohne die Option "Sprachen-Fallback" nur für deutsche Benutzer sichtbar wäre! Zugriffsrechte Seitentypen 39

40 Zugriffsrechte legen fest, was Backend-Benutzer mit einer Seite und ihren Artikeln machen dürfen. Sie haben nichts mit dem Zugriffsschutz zu tun, der den Zugriff auf eine Seite im Frontend limitiert! Ähnlich dem Unix-Rechtesystem gibt es drei Zugriffsebenen: Zugriff als Besitzer einer Seite Zugriff als Mitglied der Gruppe einer Seite Zugriff als unprivilegierter Benutzer Für jede Zugriffsebene können gesonderte Rechte vergeben werden. Standardmäßig darf der Besitzer einer Seite sowohl die Seite selbst, als auch die damit verbundenen Artikel bearbeiten. Ein Mitglied der Gruppe einer Seite darf hingegen nur die Artikel bearbeiten und ein unprivilegierter Benutzer hat überhaupt keine Schreibrechte. Seitentypen 40

41 Inhalte verwalten Die folgenden Kapitel erklären, wie man Inhalte in Contao verwaltet. Der Contao-Core beinhaltet bereits die grundlegenden Inhaltstypen wie z.b. Artikel, Nachrichten, Events, Newsletter oder Formatdefinitionen. Weitere Inhaltstypen wie Banner, Tickets, Produkte oder Empfehlungen sind über das Extension Repository verfügbar. Inhalte können im Backend mit den entsprechenden Modulen angelegt werden. Inhalte verwalten 41

42 Artikel Artikel sind Container für Inhaltselemente. Das Gruppieren zusammengehöriger Inhaltselemente macht es einfach, sie alle auf einmal zu verschieben, zu veröffentlichen, zu kopieren oder zu exportieren, anstatt jedes einzelne Element zu bearbeiten. Jeder Artikel ist mit einer bestimmten Seite und einem Layoutbereich assoziiert und hat daher eine feste Position innerhalb der Seitenstruktur und auf der Webseite. Inhaltselemente Inhaltselemente sind ein einfacher und intuitiver Weg, um Inhalte zuerstellen. Anstatt nur den Rich Text Editor zu verwenden, bietet Contao für jeden Inhaltstyp wie z.b. Texte, Listen, Tabellen, Hyperlinks, Bilder oder Downloads ein eigenes Element. Nachfolgend finden Sie eine Übersicht über die im Contao-Core enthaltenen Inhaltselemente. Name CSS-Klasse Beschreibung Überschrift ce_headline Erzeugt eine Überschrift (h1 - h6). Text ce_text Erzeugt einen Rich Text, der mit TinyMCE formatiert werden kann. HTML - Erlaubt das Hinzufügen von eigenem HTML-Code. Aufzählung ce_list Erzeugt eine geordnete oder ungeordnete Liste. Tabelle ce_table Erzeugt eine optional sortierbare Tabelle. Code ce_code Gibt formatierten Programmcode auf dem Bildschirm aus. Markdown ce_markdown Erzeugt HTML-Code aus einem Markdown-Text. Akkordeon (Einzelelement) ce_accordion Erzeugt ein einzelnes Akkordeon-Element (Mit MooTools). Akkordeon (Umschlag Anfang) ce_accordionstart Erzeugt den öffnenden Teil des Akkordeon-Umschlags. Akkordeon (Umschlag Ende) - Erzeugt den schließenden Teil des Akkordeon-Umschlags. Content-Slider (Umschlag Anfang) ce_sliderstart Erzeugt den öffnenden Teil des Slider-Umschlags. Content-Slider (Umschlag Ende) - Erzeugt den schließenden Teil des Slider-Umschlags. Hyperlink ce_hyperlink Erzeugt einen Verweis auf eine andere Webseite. Top-Link ce_toplink Erzeugt einen Link zum Seitenanfang. Bild ce_image Erzeugt ein einzelnes Bild. Galerie ce_gallery Erzeugt eine lightbox Bildergalerie. Video/Audio ce_player Erzeugt einen Video- bzw. Audio-Player. YouTube ce_youtube Fügt ein YouTube-Video ein. Download ce_download Erzeugt einen Link zum Download einer Datei. Downloads ce_downloads Erzeugt mehrere Links zum Download von Dateien. Artikel - Fügt einen anderen Artikel ein. Inhaltselement (parent class) Fügt ein anderes Inhaltselement ein. Formular ce_form Fügt ein Formular ein. Modul (parent class) Fügt ein Frontend-Modul ein. Artikel 42

43 Artikelteaser ce_teaser Zeigt den Teasertext eines Artikels an. Kommentare ce_comments Fügt ein Kommentar-Formular ein. Zugriffsschutz Jedes Inhaltselement kann geschützt werden, so dass es nur Gäste oder Benutzer einer bestimmten Mitgliedergruppe sehen können. Flash-Inhalte Flash-Inhalte sind spezielle Inhalte, die nicht als Artikel auf der Webseite ausgegeben, sondern mittels loadvars() in einen dynamischen Flash-Film geladen werden. Fügen Sie folgendes Skript in Ihren Flash-Film ein, um die Kommunikation mit Contao zu ermöglichen: TextField.prototype._loadArticle = function(flashid) tf = this; // HTML-Mode aktivieren tf.html = true; tf.htmltext = ""; // LoadVars-Objekt instantiieren lv = new LoadVars(); lv["flashid"] = flashid; lv.sendandload(url + "flash.php", lv, "POST"); lv.onload = function(success) if (success) tf.htmltext = lv["content"]; // Den Flash-Inhalt "myarticle" in das Textfeld "mytextbox" laden mytextbox._loadarticle("myarticle"); Ein Stylesheet importieren Das folgende ActionScript erlaubt das Importieren eines Stylesheets zur Formatierung des Textfeldes: Artikel 43

44 TextField.prototype._addCSS = function(style_sheet) tf= this; tf.stylesheet = null; // StyleSheet-Objekt instantiieren st = new TextField.StyleSheet(); st.load(url + style_sheet); st.onload = function(success) if (success) tf.stylesheet = st; // Das Stylesheet "basic.css" zum Textfeld "mytextbox" hinzufügen mytextbox._addcss("basic.css"); Beachten Sie, dass Flash nur einen kleinen Teil der HTML-Tags unterstützt und manche Formatierungen daher nicht angezeigt werden können. Artikel 44

45 Nachrichten Die News/Blog-Erweiterung ermöglicht die Verwaltung von Nachrichten bzw. Blog-Einträgen und deren Darstellung im Frontend. Im Gegensatz zu Artikeln, die mit einer bestimmten Seite assoziiert sind, werden Nachrichten in Archiven organisiert und können so einfach gruppiert, kategorisiert oder als RSS- bzw. Atom-Feed exportiert werden. Nachrichtenarchive Archive werden zur Gruppierung und/oder Kategorisierung von Nachrichten verwendet. Jedes Archiv kann sich auf eine bestimmte Sprache oder ein bestimmtes Thema beziehen. Frontend-Module Mit den Frontend-Modulen der News/Blog-Erweiterung können Nachrichten auf der Webseite dargestellt werden. Module können im Backend unter "Layout" -> "Module" konfiguriert werden und müssen anschließend in einem Artikel oder Seitenlayout eingebunden werden. Modul CSS-Klasse Beschreibung Nachrichtenliste mod_newslist Fügt der Seite eine Nachrichtenliste hinzu. Nachrichtenleser mod_newsreader Stellt einen einzelnen Nachrichtenbeitrag dar. Nachrichtenarchiv mod_newsarchive Fügt der Seite ein Nachrichtenarchiv hinzu. Nachrichtenarchiv-Menü mod_newsmenu Erzeugt ein Menü zur Navigation des Nachrichtenarchivs. Permalinks Jede Nachricht hat eine eindeutige URL (Permalink), die zur Referenzierung des Beitrags verwendet werden kann: Die oben genannte URL fordert den Beitrag "james-wilson-returns" auf der Seite "news" an. Denken sie daran, dass Contao ein Seiten-basiertes CMS ist; gäbe es die Seite "news" nicht oder enthielte sie nicht das Modul Nachrichtenleser, würde der Beitrag auch nicht angezeigt. Nachrichten 45

46 Termine Die Kalender-Erweiterung ermöglicht die Verwaltung von Terminen und deren Darstellung als Kalender oder Eventliste im Frontend. Im Gegensatz zu Artikeln, die mit einer bestimmten Seite assoziiert sind, werden Termine in Kalendern organisiert und können so einfach gruppiert, kategorisiert oder als RSS- bzw. Atom-Feed exportiert werden. Kalender Kalender werden zur Gruppierung und/oder Kategorisierung von Terminen verwendet. Jeder Kalender kann sich auf eine bestimmte Sprache oder ein bestimmtes Thema beziehen. Frontend-Module Mit den Frontend-Modulen der Kalender-Erweiterung können Termine bzw. Events auf der Webseite dargestellt werden. Module können im Backend unter "Layout" -> "Module" konfiguriert werden und müssen anschließend in einem Artikel oder Seitenlayout eingebunden werden. Modul CSS-Klasse Beschreibung Kalender mod_calendar Fügt der Seite einen Kalender hinzu. Eventleser mod_eventreader Stellt einen einzelnen Event dar. Eventliste mod_eventlist Listet alle Events eines bestimmten Zeitraums auf. Eventliste-Menü mod_eventmenu Erzeugt ein Menü zur Navigation der Eventliste. Permalinks Jeder Termin hat eine eindeutige URL (Permalink), die zur Referenzierung des Events verwendet werden kann: Die oben genannte URL fordert den Event "final-exams" auf der Seite "events" an. Denken sie daran, dass Contao ein Seiten-basiertes CMS ist; gäbe es die Seite "events" nicht oder enthielte sie nicht das Modul Eventleser, würde der Beitrag auch nicht angezeigt. Termine 46

47 RSS-/Atom-Feed Diese Funktion ist für News Archive und Kalender verfügbar. Hier ein Beispiel der Kalender-Liste. Einstellungen Ein oder mehrere Kalender können gruppiert und als RSS- bzw. Atom-Feed ausgegeben werden. Genau gleich funktioniert es bei News Archiven. Hier kann auch gewählt werden, ob nur der Teaser oder der komplette Artikel des Events bzw. der News ausgegeben werden soll. RSS-/Atom-Feed 47

48 XML Dateien Die XML Dateien werden automatisch generiert und im share Verzeichnis Ihrer Contao Installation abgelegt. In diesem Beispiel: share/events.xml. RSS-/Atom-Feed 48

49 Newsletter Die Newsletter-Erweiterung ermöglicht das Versenden von Newslettern, die Verwaltung von Abonnements sowie die optionale Ausgabe versendeter Nachrichten im Frontend. Im Gegensatz zu Artikeln, die mit einer bestimmten Seite assoziiert sind, werden Newsletter in Verteilern organisiert und können so einfach gruppiert oder kategorisiert werden. Abonnenten Newsletter-Abonnements werden normalerweise automatisch über die entsprechenden Frontend-Module verwaltet, ohne dass Sie in den Prozess eingreifen müssten. Aus datenschutzrechtlichen Gründen muss das Abonnieren eines Verteilers mittels Double Opt-In erfolgen und es wird nur die -Adresse des Abonnements gespeichert. Falls Sie bereits einen Verteiler haben, können Sie die Abonnenten aus einer CSV-Datei in Contao importieren. Newsletter personalisieren Insofern Sie Newsletter an registrierte Mitglieder verschicken, können Sie diese mit Hilfe der sogenannten "Simple Tokens" personalisieren. Simple Tokens funktionieren ähnlich wie Inserttags und können sowohl im HTML- als auch im Text-Inhalt eines Newsletters verwendet werden. Sehr geehrte(r) ##firstname## ##lastname##, bitte prüfen und aktualisieren Sie Ihre Daten: Anschrift: ##street## PLZ/Ort: ##postal## ##city## Telefon: ##phone## ## ## Ihr Administrator Im Gegensatz zu Inserttags können Sie mit Simple Tokens aber nicht nur auf die Daten der Mitgliedertabelle tl_member zugreifen, sondern auch einfache If-Else-Abfragen realisieren und so beispielsweise die Anrede präzisieren. if gender=="male" Sehr geehrter Herr ##lastname##, Newsletter 49

50 elseif gender=="female" Sehr geehrte Frau ##lastname##, else Sehr geehrte Damen und Herren, endif [Inhalt des Newsletters] if phone=="" Bitte aktualisieren Sie Ihre Daten und geben Sie Ihre Telefonnummer an. endif Ihr Administrator Newsletter versenden Speziell auf Shared-Hosting-Servern gibt es normalerweise Limits für die maximale Skriptlaufzeit und/oder die Anzahl der s, die pro Minute versendet werden dürfen. Contao versucht, diese beiden Probleme zu umgehen, indem der Versendungsprozess in mehreren Teilschritten mit einer bestimmten Wartezeit dazwischen erfolgt und so die Anzahl der E- Mails pro Minute kontrolliert werden kann. Frontend-Module Mit den Frontend-Modulen der Newsletter-Erweiterung können Abonnements verwaltet und optional Newsletter angezeigt werden. Module können im Backend unter "Layout" -> "Module" konfiguriert werden und müssen anschließend in einem Artikel oder Seitenlayout eingebunden werden. Modul CSS-Klasse Beschreibung Newsletter 50

51 Abonnieren mod_subscribe Erzeugt ein Formular zum Abonnieren von Verteilern. Kündigen mod_unsubscribe Erzeugt ein Formular zum Kündigen von Abonnements. Newsletterliste mod_nl_list Fügt der Seite eine Newsletterliste hinzu. Newsletterleser mod_nl_reader Stellt einen einzelnen Newsletter dar. Permalinks Jeder Newsletter hat eine eindeutige URL (Permalink), die zur Referenzierung der Nachricht verwendet werden kann: Die obige URL fordert den Newsletter "james-wilson-returns" auf der Seite "newsletters" an. Denken sie daran, dass Contao ein Seiten-basiertes CMS ist; gäbe es die Seite "newsletters" nicht oder enthielte sie nicht das Modul Newsletterleser, würde der Beitrag auch nicht angezeigt. Newsletter 51

52 Formulare Mit dem Formulargenerator lassen sich interaktive Formulare erstellen, die per verschickt oder in der Datenbank gespeichert werden können. Hochgeladene Dateien werden als Anhang versendet oder auf dem Server gespeichert. Folgende Datenformate werden unterstützt: Format Rohdaten XML file CSV file Beschreibung Die Formulardaten werden als einfache Textnachricht mit einer Zeile pro Feld versendet. Die Formulardaten werden der als XML-Datei angefügt. Die Formulardaten werden der als CSV-Datei angefügt. Ignoriert alle Felder außer " ", "subject", "message" und "cc" (Carbon Copy) und verschickt die Daten als wären sie mit einem -Programm versendet worden. Datei-Uploads sind erlaubt. Formularfelder Ähnlich wie bei Inhaltselementen, enthält Contao ein eigenes Element für jedes Formularfeld, wie z.b. Textfelder, Auswahlmenüs, Dateiuploads, versteckte Felder oder Schaltflächen. Folgende Formularfelder sind im Contao-Core enthalten: Feld CSS-Klasse Beschreibung Überschrift headline Ein individuelles Feld zum Einfügen einer Bereichsüberschrift. Erklärung explanation Ein individuelles Feld zum Einfügen eines Erklärungstexts. HTML - Ein individuelles Feld zum Einfügen von HTML-Code. Fieldset - Ein Container für Formularfelder mit einer optionalen Legende. Textfeld text Ein einzeiliges Eingabefeld für einen kurzen oder mittellangen Text. Passwortfeld password Ein einzeiliges Eingabefeld für ein Passwort. Contao fügt automatisch ein Bestätigungsfeld hinzu. Textarea textarea Ein mehrzeiliges Eingabefeld für einen mittellangen oder langen Text. Select-Menü select/multiselect Ein ein- oder mehrzeiliges Drop-Down-Menü. Radio-Button- Menü Checkbox- Menü Datei-Upload radio checkbox upload Eine Liste mehrerer Optionen, von denen eine ausgewählt werden kann. Eine Liste mehrerer Optionen, von denen beliebig viele ausgewählt werden können. Ein einzeiliges Eingabefeld zur Übertragung lokaler Dateien auf den Server. Verstecktes Feld - Ein einzeiliges Eingabefeld, das im Formular nicht sichtbar ist. Sicherheitsfrage captcha Eine einfache Rechenaufgabe zur Prüfung ob das Formular von einem Menschen abgesendet wurde (CAPTCHA). Absendefeld submit Eine Absende-Schaltfläche zur Versendung des Formulars. Frontend-Modul Mit dem Frontend-Module des Formulargenerators können Formulare angezeigt werden. Module können im Backend unter "Layout" -> "Module" konfiguriert werden und müssen anschließend in einem Artikel oder Seitenlayout eingebunden Formulare 52

53 werden. Modul CSS-Klasse Beschreibung Formular mod_form Fügt ein Formular auf der Seite ein. Inhaltselement Das Inhaltselement bietet dieselben Funktionen wie das Modul, lässt sich aber direkt im Artikel einbinden und konfigurieren. Der Formulargenerator stellt ein Inhaltselement zur Verfügung: Inhaltselement CSS-Klasse Beschreibung Formular ce_form Fügt ein Formular ein. Formulare 53

54 Kommentare Kommentare sind eine weitere Form von Inhalt, welcher über das Backend verwaltet werden kann. Kommentare können in Kalendern und News-Archiven aktiviert werden. Frontend-Modul Mit dem Frontend-Module der Kommentar-Erweiterung können Kommentare ein- und ausgegeben werden. Module können im Backend unter "Layout" -> "Module" konfiguriert werden und müssen anschließend in einem Artikel oder Seitenlayout eingebunden werden. Modul CSS-Klasse Beschreibung Kommentare mod_comments Bietet Kommentare oder eine Gästebuch-Funktion. Inhaltselement Das Inhaltselement bietet dieselben Funktionen wie das Modul, lässt sich aber direkt im Artikel einbinden und konfigurieren. Die Kommentar-Erweiterung stellt ein Inhaltselement zur Verfügung: Inhaltselement CSS-Klasse Beschreibung Kommentare ce_comments Fügt das Kommentar-Formular auf der Seite ein. BBCode Der Besucher kann ausserdem die BBCode Sprache verwenden. Contao versteht folgende Tags: BBCode Beschreibung [b][/b] [i][/i] [u][/u] [img][/img] [code][/code] [color=#ff0000][/color] [quote][/quote] [quote=john]hallo[/quote] [url][/url] [url= [ ][/ ] Der enthaltene Text wird fett dargestellt. Der enthaltene Text wird kursiv dargestellt. Der enthaltene Text wird unterstrichen. Ersetzen das Tag durch ein Bild (Bild-Pfad zwischen den Tags). Der enthaltene Text wird in einer Schrift mit fester Laufweite dargestellt. Der enthaltene Text wird in der entsprechenden Farbe dargestellt. Stellt den entsprechenden Text als Zitat dar. Stellt den entsprechenden Text als Zitat eines Autors dar. Die enthaltene URL wird als Link dargestellt. Der enthaltene Text wird mit der entsprechenden URL verlinkt. Die enthaltene -Adresse wird als Link dargestellt. Der enthaltene Text wird mit der -Adresse verknüpft. Kommentare 54