d 2 4. ge flackt aOb3 AuDe .1YP e 2. Pu5Tsch e e PlHz ut ab g el e sg fla tu D Au . Au 3 Ak er Tipps & Rezepte von TYPO...

Author: Peter Niederlag

88 downloads 2704 Views 8MB Size Report

This content was uploaded by our users and we assume good faith they have the permission to share this book. If you own the copyright to this book and it is wrongfully on our website, we offer a simple DMCA procedure to remove your content from our site. Start by pressing the button below!

Report copyright / DMCA form

DOWNLOAD PDF

d

2 4. ge flackt aOb3 AuDe .1YP e 2. Pu5Tsch e e PlHz ut ab g el e sg fla tu D Au . Au 3 Ak er Tipps & Rezepte von TYPO3-Experten

Lizensiert für Markus Mueller

TYPO3 Kochbuch

Christian Trabold, Jo Hasenau & Peter Niederlag

O’Reilly

Lizensiert für Markus Mueller

2. AUFLAGE

TYPO3 Kochbuch

Lizensiert für Markus Mueller

Christian Trabold, Jo Hasenau & Peter Niederlag

Beijing · Cambridge · Farnham · Köln · Sebastopol · Taipei · Tokyo

Die Informationen in diesem Buch wurden mit größter Sorgfalt erarbeitet. Dennoch können Fehler nicht vollständig ausgeschlossen werden. Verlag, Autoren und Übersetzer übernehmen keine juristische Verantwortung oder irgendeine Haftung für eventuell verbliebene Fehler und deren Folgen. Alle Warennamen werden ohne Gewährleistung der freien Verwendbarkeit benutzt und sind möglicherweise eingetragene Warenzeichen. Der Verlag richtet sich im Wesentlichen nach den Schreibweisen der Hersteller. Das Werk einschließlich aller seiner Teile ist urheberrechtlich geschützt. Alle Rechte vorbehalten einschließlich der Vervielfältigung, Übersetzung, Mikroverfilmung sowie Einspeicherung und Verarbeitung in elektronischen Systemen. Kommentare und Fragen können Sie gerne an uns richten: O’Reilly Verlag Balthasarstr. 81 50670 Köln Tel.: 0221/9731600 Fax: 0221/9731608 E-Mail: [email protected] Copyright: © 2009 by O’Reilly Verlag GmbH & Co. KG 1. Auflage 2006 2. Auflage 2009 Lizensiert für Markus Mueller

Die Darstellung einer Ameive im Zusammenhang mit dem Thema TYPO3 ist ein Warenzeichen von O’Reilly Media, Inc.

Bibliografische Information Der Deutschen Bibliothek Die Deutsche Bibliothek verzeichnet diese Publikation in der Deutschen Nationalbibliografie; detaillierte bibliografische Daten sind im Internet über http://dnb.ddb.de abrufbar.

Lektorat: Alexandra Follenius, Köln Korrektorat: Sibylle Feldmann, Düsseldorf Satz: G&U e.Publishing Services GmbH, Flensburg Umschlaggestaltung: Marcia Friedman, Boston & Michael Oreal, Köln Produktion: Andrea Miß, Köln Belichtung, Druck und buchbinderische Verarbeitung: Druckerei Kösel, Krugzell; www.koeselbuch.de

ISBN 978-3-89721-851-2 Dieses Buch ist auf 100% chlorfrei gebleichtem Papier gedruckt.

First

Inhalt

Einleitung . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . XI 1

Installation und Konfiguration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Lizensiert für Markus Mueller

1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 1.10

2

Vorüberlegungen zu einem TYPO3-Projekt . . . . . . . . . . . . . . . . . . . . . . . . . Das richtige TYPO3-Paket auswählen und installieren . . . . . . . . . . . . . . . . Eine Entwicklerversion von TYPO3 verwenden . . . . . . . . . . . . . . . . . . . . . . Die Ordnerstruktur verstehen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Systemparameter ermitteln und verstehen . . . . . . . . . . . . . . . . . . . . . . . . . Systemparameter anpassen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Größere Dateiuploads ermöglichen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Mehrere Websites mit TYPO3 verwalten . . . . . . . . . . . . . . . . . . . . . . . . . . UTF-8 als Standardzeichensatz verwenden . . . . . . . . . . . . . . . . . . . . . . . . Der richtige Umgang mit Fehlermeldungen . . . . . . . . . . . . . . . . . . . . . . . .

2 5 8 10 17 22 24 27 29 32

Wartung und Systempflege . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 2.1 2.2 2.3 2.4 2.5 2.6 2.7 2.8 2.9 2.10

TYPO3 auf eine neue Version aktualisieren . . . . . . . . . . . . . . . . . . . . . . . . Die aktuell verwendete TYPO3-Version ermitteln . . . . . . . . . . . . . . . . . . . Den Kompatibilitätsmodus nutzen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Die Website temporär für Wartungsarbeiten sperren . . . . . . . . . . . . . . . . Die Datenbank prüfen und warten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Im Dateisystem aufräumen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Den Referenzindex aktuell halten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Den Referenzindex nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ein Backup der TYPO3-Installation erstellen . . . . . . . . . . . . . . . . . . . . . . . Den Zeichensatz einer bestehenden TYPO3-Installation prüfen und auf UTF-8 umstellen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

42 45 47 49 52 58 59 61 63 66

Max. Linie

Max. Linie | III This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Links 2.11 Systemprozesse mit dem Syslog protokollieren . . . . . . . . . . . . . . . . . . . . . 75 2.12 Inhalte im Backend schnell finden . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78 2.13 Verloren geglaubte Dateien wiederfinden. . . . . . . . . . . . . . . . . . . . . . . . . . 80

3

Der richtige Zugang zum Backend . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81 3.1 3.2 3.3 3.4 3.5 3.6 3.7 3.8 3.9 3.10 3.11 3.12

Lizensiert für Markus Mueller

4

IV |

Seiten schnell erzeugen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Die Inhaltseingabe beschleunigen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Standardwerte für Felder vorgeben. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Werte anderer Datensätze übernehmen . . . . . . . . . . . . . . . . . . . . . . . . . . Seiten und Inhalte standardmäßig verstecken . . . . . . . . . . . . . . . . . . . . . Datensätze nur in bestimmten Seiten erlauben. . . . . . . . . . . . . . . . . . . . . Inhaltseingabe über das Frontend ermöglichen . . . . . . . . . . . . . . . . . . . . Den interaktiven Texteditor RTE konfigurieren . . . . . . . . . . . . . . . . . . . . Mehrsprachige Inhalte mit TYPO3 einpflegen . . . . . . . . . . . . . . . . . . . . . Sich in einem Workspace zurechtfinden. . . . . . . . . . . . . . . . . . . . . . . . . . Die Veröffentlichung von Inhalten über einen Workflow kontrollieren. .

118 120 122 123 125 127 131 137 150 154 157

Inhalte verwalten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 163 5.1 5.2 5.3 5.4 5.5 5.6 5.7 5.8 5.9

Max. Linie

82 84 86 88 93 95 96 99 105 109 112 113

Inhalte eingeben . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117 4.1 4.2 4.3 4.4 4.5 4.6 4.7 4.8 4.9 4.10 4.11

5

Yeah, that’s a classic – Den Browser richtig einstellen . . . . . . . . . . . . . . . . Am Backend anmelden . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ein verlorenes Passwort für das Backend wiederherstellen. . . . . . . . . . . . . Das Backend absichern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Die Beschriftung im Anmeldeformular ändern . . . . . . . . . . . . . . . . . . . . . . Eigene Bilder im Anmeldeformular anzeigen . . . . . . . . . . . . . . . . . . . . . . . Das Layout der Anmeldemaske ändern . . . . . . . . . . . . . . . . . . . . . . . . . . . Aktuelle Meldungen unter dem Anmeldeformular anzeigen . . . . . . . . . . . Tipp des Tages auf der Anmeldeseite anzeigen. . . . . . . . . . . . . . . . . . . . . Backend-Benutzer auf das Frontend umleiten . . . . . . . . . . . . . . . . . . . . . Einen bestimmten Backend-Benutzer simulieren . . . . . . . . . . . . . . . . . . . Benutzereinstellungen vorgeben . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Inhalt

Datensätze effektiv verwalten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Wiederkehrende Arbeiten beschleunigen . . . . . . . . . . . . . . . . . . . . . . . . . Datensätze verschieben oder kopieren . . . . . . . . . . . . . . . . . . . . . . . . . . . Seiteninhalt auf mehrere Seiten verteilen . . . . . . . . . . . . . . . . . . . . . . . . . Die Zwischenablage erweitern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Mehrere Datensätze gleichzeitig bearbeiten . . . . . . . . . . . . . . . . . . . . . . . Einen oder mehrere Datensätze löschen . . . . . . . . . . . . . . . . . . . . . . . . . . Dateien oder Ordner verschieben oder löschen . . . . . . . . . . . . . . . . . . . . Gelöschte Inhalte wiederherstellen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

164 166 168 171 172 173 175 178 180

Max. Linie

Rechts 5.10 5.11 5.12 5.13 5.14

6

Lizensiert für Markus Mueller

Max. Linie

Die Seitenaufteilung im Backend beeinflussen . . . . . . . . . . . . . . . . . . . . . Anzahl der Inhaltsspalten erhöhen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Anzahl der Inhaltsspalten verringern . . . . . . . . . . . . . . . . . . . . . . . . . . . . Inhaltsspalten umbenennen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Auswahllisten optimieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Eingabefelder und Bearbeitungsmöglichkeiten reduzieren. . . . . . . . . . . . Eingabefelder anpassen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Die Auswertung von Eingabefeldern anpassen. . . . . . . . . . . . . . . . . . . . . Die Anordnung von Eingabefeldern ändern . . . . . . . . . . . . . . . . . . . . . . . Eingabeformulare mehrspaltig darstellen . . . . . . . . . . . . . . . . . . . . . . . . .

201 202 203 204 206 209 211 213 220 225

Die Übersicht im Backend erhöhen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229 7.1 7.2 7.3 7.4 7.5 7.6 7.7 7.8

8

184 187 188 190 193

Das Backend anpassen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 199 6.1 6.2 6.3 6.4 6.5 6.6 6.7 6.8 6.9 6.10

7

Inhalte lokal sichern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Inhalte zwischen unterschiedlichen TYPO3-Instanzen austauschen . . . . Eine Suche auf der Website integrieren . . . . . . . . . . . . . . . . . . . . . . . . . . Inhalte mit der Indexsuche von TYPO3 suchen und finden. . . . . . . . . . . Mit IRRE verknüpfte Datensätze bearbeiten . . . . . . . . . . . . . . . . . . . . . .

Oft verwendete Datensätze schnell erreichen . . . . . . . . . . . . . . . . . . . . . . Zuletzt bearbeitete Datensätze anzeigen. . . . . . . . . . . . . . . . . . . . . . . . . . Seiten-IDs ermitteln . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Längere Seitentitel im Seitenbaum ermöglichen . . . . . . . . . . . . . . . . . . . . Tabelleninhalte nur bei Bedarf anzeigen. . . . . . . . . . . . . . . . . . . . . . . . . . Anzahl der Datensätze im Listenmodus erhöhen . . . . . . . . . . . . . . . . . . . Eigene Datensätze im Seitenmodul anzeigen . . . . . . . . . . . . . . . . . . . . . . Eigene Seiten-Icons anzeigen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

230 233 235 237 238 240 241 243

TypoScript verstehen und verwalten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247 8.1 8.2 8.3 8.4 8.5 8.6 8.7 8.8 8.9 8.10 8.11

TypoScript anstatt eigener PHP-Funktionen nutzen . . . . . . . . . . . . . . . . TypoScript-Templates sinnvoll aufteilen . . . . . . . . . . . . . . . . . . . . . . . . . Den TypoScript-Object-Browser und den Template-Analyzer nutzen. . . Den TypoScript-Debugger nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TypoScript aus externen Dateien einbinden. . . . . . . . . . . . . . . . . . . . . . . Den TypoScript-Editor nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . TypoScript-Konstanten zentral verwalten . . . . . . . . . . . . . . . . . . . . . . . . Extension-Templates und Conditions nutzen . . . . . . . . . . . . . . . . . . . . . Template-Ressourcen effektiv einsetzen . . . . . . . . . . . . . . . . . . . . . . . . . . Mit Wraps Inhalte für die Ausgabe verpacken . . . . . . . . . . . . . . . . . . . . . TypoScript-Werte beim Parsen dynamisch ändern – der Operator := . . .

This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

251 254 259 264 268 271 272 278 282 284 286

Inhalt | V

Max. Linie

Links 9

Die Seitenausgabe steuern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 291 9.1 9.2 9.3 9.4 9.5 9.6 9.7 9.8 9.9

Das Seiten-Grundgerüst aufbauen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . CSS-Styles in den Seitenkopf einbinden . . . . . . . . . . . . . . . . . . . . . . . . . . CSS-Stylesheets dynamisch aus Vorlagen erzeugen . . . . . . . . . . . . . . . . . Die Ausgabe mehrsprachiger Websites steuern . . . . . . . . . . . . . . . . . . . . Das Frontend-Editing optimieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . URL-Parameter an Menüs und Links übergeben . . . . . . . . . . . . . . . . . . . Links wie statische HTML-Dateien darstellen . . . . . . . . . . . . . . . . . . . . . Webseiten nur bestimmten Besuchern zeigen . . . . . . . . . . . . . . . . . . . . . Benutzerfreundliche Fehlerseiten integrieren und sinnvoll gestalten . . . .

294 304 307 311 317 322 324 327 331

10 Der stdWrap-Baukasten: Grundlegende TypoScript-Funktionen . . . . . . . . . . . . . . . . . 335

Lizensiert für Markus Mueller

10.1 10.2 10.3 10.4 10.5 10.6 10.7 10.8 10.9

Daten auslesen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Die getText-Funktionen data, dataWrap und insertData verwenden . . . Bedingungen abfragen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Daten verarbeiten und formatieren. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HTML und Text parsen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Inhalte verpacken . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Links mit typolink erzeugen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Spezielle stdWrap-Funktionen verwenden . . . . . . . . . . . . . . . . . . . . . . . . Die Hierarchie von Wraps und anderen Funktionen kennenlernen. . . . .

337 348 364 372 383 389 395 401 406

11 Funktionale TypoScript-Elemente verwenden . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411 11.1 11.2 11.3 11.4 11.5 11.6 11.7 11.8 11.9 11.10 11.11 11.12

Mit COA Inhalte zusammenfassen und mit stdWrap versehen . . . . . . . . Das Caching von Inhalten deaktivieren . . . . . . . . . . . . . . . . . . . . . . . . . . Inhalt nur bei Bedarf zweispaltig anzeigen . . . . . . . . . . . . . . . . . . . . . . . . Mit LOAD_REGISTER und RESTORE_REGISTER Elemente zwischenspeichern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Links im Fließtext als Fußnoten ausgeben . . . . . . . . . . . . . . . . . . . . . . . . Hierarchische Abschnittsübersichten . . . . . . . . . . . . . . . . . . . . . . . . . . . . Vorhandene TypoScript-Register finden und nutzen . . . . . . . . . . . . . . . . Mit dem GIFBUILDER einfache Grafiken erstellen . . . . . . . . . . . . . . . . . Zugängliche grafische Header anlegen . . . . . . . . . . . . . . . . . . . . . . . . . . . Mehrschichtige Grafiken für Überschriften oder Menüs erstellen . . . . . . Grafiken mit mehrzeiligem Text erzeugen . . . . . . . . . . . . . . . . . . . . . . . . Eigene PHP-Funktionen als TypoScript-Element einbinden . . . . . . . . . .

412 414 417 420 424 430 436 441 446 452 457 461

12 Navigationselemente erstellen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 467 12.1 Startpunkt für Menüs festlegen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 469 12.2 Geschützte Seiten im Menü anzeigen und auf Login-Seite umleiten . . . . 475 12.3 Zustände von Menüeinträgen erkennen und individuell formatieren . . . 477

Max. Linie VI |

Inhalt

This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts 12.4 12.5 12.6 12.7 12.8 12.9 12.10 12.11 12.12 12.13 12.14 12.15 12.16 12.17 12.18

Menüeinträge in Abhängigkeit von ihrer Position konfigurieren . . . . . . . Spezielle Menütypen: Brotkrumen- oder Rootline-Navigation . . . . . . . . Spezielle Menütypen: Liste zuletzt aktualisierter Seiten . . . . . . . . . . . . . . Spezielle Menütypen: Liste themenverwandter Seiten . . . . . . . . . . . . . . . Spezielle Menütypen: Sprachauswahl. . . . . . . . . . . . . . . . . . . . . . . . . . . . Spezielle Menütypen: Blätternavigation . . . . . . . . . . . . . . . . . . . . . . . . . . Erweiterte Menüeigenschaften individuell anpassen . . . . . . . . . . . . . . . . Ein einfaches Textmenü auf Basis einer ungeordneten Liste erstellen . . . Ein Textmenü mit komfortablen Erweiterungen erzeugen. . . . . . . . . . . . Ein Teaser-Menü mit Bildern und Kurzbeschreibung erzeugen . . . . . . . . Menü und Titel mit hierarchischer Nummerierung erzeugen . . . . . . . . . Ein einfaches Grafikmenü auf Basis einer ungeordneten Liste erstellen. . Ein Grafikmenü mit Effekten und Erweiterungen erzeugen . . . . . . . . . . . Ein Jumpmenü als textbasiertes Menü konstruieren . . . . . . . . . . . . . . . . TypoScript-Menüs als Standard-Setup für das Inhaltselement Menü/Sitemap hinterlegen . . . . . . . . . . . . . . . . . . . . . . . . .

482 486 488 492 497 500 507 512 515 518 524 529 531 536 540

13 Statische und dynamische Inhalte ausgeben . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 545 Lizensiert für Markus Mueller

13.1 13.2 13.3 13.4 13.5 13.6 13.7 13.8 13.9 13.10 13.11 13.12

Textbausteine in der Seite fest verankern . . . . . . . . . . . . . . . . . . . . . . . . . Bild auf jeder Seite anzeigen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Klick-Vergrößern mithilfe eines separaten Lupen-Icons realisieren . . . . . Vergrößerte Bilder mit Copyright-Vermerk versehen . . . . . . . . . . . . . . . . Inhalt einer Seite und ihrer Unterseiten zusammenfassen . . . . . . . . . . . . Inhaltselemente mit optionSplit verpacken . . . . . . . . . . . . . . . . . . . . . . . Inhaltselemente in der Seite fest verankern. . . . . . . . . . . . . . . . . . . . . . . . Verankerte Elemente unabhängig vom sonstigen Inhalt rendern . . . . . . . Wiederkehrende Inhalte zeitabhängig anzeigen . . . . . . . . . . . . . . . . . . . . Statische Formulare individuell erstellen . . . . . . . . . . . . . . . . . . . . . . . . . Formulare mit Fieldset zusammenfassen . . . . . . . . . . . . . . . . . . . . . . . . . Eine HTML-Vorlage verwenden . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

547 548 551 554 558 562 566 567 571 574 584 589

14 TypoScript ausreizen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 597

Max. Linie

14.1 14.2 14.3 14.4 14.5 14.6 14.7 14.8 14.9

TypoScript-Elemente intelligent als Hilfsmittel nutzen . . . . . . . . . . . . . . Die Ausgabe in Abhängigkeit von Bedingungen dynamisch anpassen . . . Ein alphabetisches Inhaltsverzeichnis anlegen . . . . . . . . . . . . . . . . . . . . . Eine mehrseitige Navigation mit Seitenbrowser erstellen. . . . . . . . . . . . . Den Backend-Seitenbaum als Frontend-Navigation simulieren . . . . . . . . Kopfgrafiken mit halbtransparenten Textboxen erstellen . . . . . . . . . . . . Pseudotransparenzen für Überschriften oder Menüs erstellen . . . . . . . . . Inhalte von Extensions unabhängig von Plugins ausgeben . . . . . . . . . . . Ein auf Seiten basierendes Newssystem erzeugen. . . . . . . . . . . . . . . . . . .

This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Inhalt |

598 608 612 620 628 635 639 647 651

VII

Max. Linie

Links 15 Vorhandene Extensions nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 663 15.1 15.2 15.3 15.4 15.5 15.6 15.7 15.8 15.9 15.10

Installierte Extensions ermitteln . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Eine Extension installieren und konfigurieren . . . . . . . . . . . . . . . . . . . . . Eine Extension aktualisieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Nach Extensions recherchieren. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Extensions importieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Extensions exportieren oder sichern. . . . . . . . . . . . . . . . . . . . . . . . . . . . . Extensions deinstallieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Den Zugriff auf ein Repository konfigurieren . . . . . . . . . . . . . . . . . . . . . . Extensions über das TER veröffentlichen . . . . . . . . . . . . . . . . . . . . . . . . . Sprachpakete verwalten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

666 670 672 675 677 680 681 682 684 685

16 Extensions kickstarten und ausarbeiten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 689

Lizensiert für Markus Mueller

16.1 16.2 16.3 16.4 16.5 16.6 16.7 16.8 16.9 16.10 16.11

Einen passenden Extension-Key wählen. . . . . . . . . . . . . . . . . . . . . . . . . . Ein Extension-Grundgerüst anlegen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Zusätzliche Datenbanktabellen und Felder hinzufügen . . . . . . . . . . . . . . Eigene Inhaltselemente einbinden . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Neue Überschriftentypen integrieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . Eigene Tags in Seiteninhalten umsetzen . . . . . . . . . . . . . . . . . . . . . . . . . . Backend-Module erstellen und erweitern . . . . . . . . . . . . . . . . . . . . . . . . . Unterverzeichnisse umbenennen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Abhängigkeiten und Voraussetzungen für Extensions definieren. . . . . . . Das Extension-Icon anpassen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Änderungen am Code protokollieren . . . . . . . . . . . . . . . . . . . . . . . . . . . .

692 693 700 708 715 716 719 726 727 730 731

17 Einstieg in die TYPO3-API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 733 17.1 17.2 17.3 17.4 17.5 17.6 17.7 17.8 17.9 17.10 17.11 17.12 17.13 17.14

Max. Linie VIII

Sich im Quellcode zurechtfinden . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Extensions sicher und standardkonform entwickeln . . . . . . . . . . . . . . . . Dateien aus dem Dateisystem einbinden . . . . . . . . . . . . . . . . . . . . . . . . . Fehler im Programmcode analysieren . . . . . . . . . . . . . . . . . . . . . . . . . . . . Die Datenbank-API nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Mehrere Datenbanken über die Datenbank-API abfragen . . . . . . . . . . . . Mehrsprachigkeit in eigenen Extensions unterstützen . . . . . . . . . . . . . . . Datensätze in Workspaces versionierbar machen. . . . . . . . . . . . . . . . . . . IRRE für eigene Extensions nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tabellen mit IRRE über mehrere Ebenen verschachteln . . . . . . . . . . . . . Kernfunktionen und Prozesse individuell anpassen . . . . . . . . . . . . . . . . . TYPO3-Klassen mit XClass erweitern. . . . . . . . . . . . . . . . . . . . . . . . . . . . Prozesse mit Hooks beeinflussen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Extension-Parameter zentral verwalten. . . . . . . . . . . . . . . . . . . . . . . . . . .

| Inhalt

This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

735 737 740 742 744 748 754 758 759 768 772 774 779 785

Max. Linie

Rechts 18 Frontend-Plugins weiter entwickeln . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 791 18.1 18.2 18.3 18.4 18.5 18.6 18.7

TypoScript in eigenen Frontend-Plugins verwenden . . . . . . . . . . . . . . . . Werte aus Flexform-Feldern auswerten . . . . . . . . . . . . . . . . . . . . . . . . . . Hyperlinks erzeugen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Eigene Datensätze mit individuellen Linkfunktionen verlinken . . . . . . . . Benutzerdaten in Sessions speichern . . . . . . . . . . . . . . . . . . . . . . . . . . . . CSS- und JavaScript-Dateien einbinden . . . . . . . . . . . . . . . . . . . . . . . . . . Schnelle Ajax-Schnittstellen per eID-Tag ermöglichen. . . . . . . . . . . . . . .

792 798 799 803 806 808 810

19 Backend-Erweiterungen verfeinern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 815 19.1 TSconfig-Optionen in eigenen Backend-Modulen nutzen und auswerten . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19.2 Flexform-Felder einbinden und konfigurieren . . . . . . . . . . . . . . . . . . . . . 19.3 Backend-Module individuell gruppieren . . . . . . . . . . . . . . . . . . . . . . . . . 19.4 Unterschiedliche Icons je nach Zustand des Datensatzes anzeigen . . . . . 19.5 Vorschautexte von Plugins anpassen . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19.6 Backend-Formulare mit einer kontextsensitiven Hilfe ausstatten . . . . . . 19.7 Bearbeitungsfelder mit Ajax-Funktionalität versehen. . . . . . . . . . . . . . . .

816 818 824 826 829 832 837

Lizensiert für Markus Mueller

20 TYPO3 erleben . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 847 20.1 20.2 20.3 20.4 20.5 20.6 20.7 20.8

Skårhøj richtig aussprechen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Das TYPO3-Projekt unterstützen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Handbücher schreiben . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Übersetzungen anfertigen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Bugs melden oder neue Features vorschlagen . . . . . . . . . . . . . . . . . . . . . Die TYPO3-Newsgroups nutzen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Den aktuellen Projektfortschritt verfolgen . . . . . . . . . . . . . . . . . . . . . . . . Weiterführende Quellen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

848 850 852 854 857 860 862 863

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 865

Max. Linie

Max. Linie This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Inhalt

| IX

Lizensiert für Markus Mueller

First

Einleitung

TYPO3 konnte seine Position unter den Enterprise-Content-Management-Systemen in den letzten Jahren behaupten und weiter ausbauen. Zunächst durch das starke Engagement und die Überzeugung des Dänen Kasper Skårhøj angetrieben, wird TYPO3 heute durch die breite Unterstützung einer aktiven Community getragen und ist im deutschsprachigen Raum zweifelsohne zu einer festen Größe unter den Open Source-CM-Systemen geworden. Lizensiert für Markus Mueller

TYPO3 ist aufgrund der verwendeten GPL-Lizenz lizenzkostenfrei erhältlich und wird konsequent von einer weltumspannenden und sehr engagierten Community begleitet und vorangetrieben, sodass stets zahlreiche aktuelle Entwicklungen im Bereich der Internettechnologie in das Projekt einfließen. Mit der Vision Inspiring People to share ist dadurch im Laufe der Jahre ein flexibles und vielschichtiges System entstanden, das mit seinem großen Funktionsumfang unzählige Möglichkeiten zur Umsetzung erfolgreicher Webprojekte bietet. Diese Flexibilität bringt jedoch ohne Frage auch ein hohes Maß an Komplexität mit sich. Geht es darum, bestimmte Anforderungen umzusetzen und Redakteuren ein auf ihre Bedürfnisse optimiertes System zur Verfügung zu stellen, dann sind Sie als TYPO3-Entwickler oder Administrator gefordert, das System entsprechend einzurichten und anzupassen. TYPO3 gibt Ihnen alle dazu erforderlichen Mittel an die Hand.

Max. Linie

In diesem Buch finden Sie eine umfangreiche Sammlung von Lösungen zu verschiedenen Anforderungen, die wir in den letzten Jahren in einer Vielzahl von Projekten entwickelt und eingesetzt haben. Wir haben uns bemüht, die Konzepte und Hintergründe jeweils so zu beleuchten, dass die Zusammenhänge zwischen den verschiedenen Thematiken deutlich werden. Zahlreiche Querverweise sorgen dabei dafür, dass die häufigsten Fragen und Problemstellungen beim Arbeiten mit TYPO3 schnell beantwortet werden können. Gleichzeitig ermöglichen diese ineinander verzahnten Inhalte einen tieferen Einblick in die Hintergründe von TYPO3. Bei den Rezepten, die sich intensiv mit Programmierung beschäftigen, haben wir sehr viel Wert darauf gelegt, die Beispiele und Herangehensweisen so generisch wie möglich zu

| XI This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

gestalten. Da die Anforderungen hier individuell sehr unterschiedlich sind, sollen vorrangig die allgemeine Funktionsweise sowie der Aufbau von TYPO3 im Gesamten beleuchtet werden. Auf diesem Fundament können Sie dann weiter aufbauen und Ihrer Kreativität freien Lauf lassen.

Links

Wir würden uns freuen, Ihnen mit diesem Buch einen nützlichen Ratgeber für Ihre Arbeit mit TYPO3 an die Hand zu geben, und hoffen, dass wir Ihnen mit diesem Kochbuch darüber hinaus auch etwas von der Faszination von TYPO3 vermitteln können. Über Feedback, Kritik sowie über Anregungen für weitere Rezepte freuen wir uns, Sie können uns unter der Adresse [email protected] erreichen.

An wen sich dieses Buch richtet Mit dem TYPO3 Kochbuch sprechen wir Entwickler und Dienstleister an, die professionelle Projekte mit TYPO3 realisieren möchten und dafür praktische Lösungen suchen. Sie sollten dabei idealerweise schon die ersten Schritte mit TYPO3 unternommen haben und mit dem grundsätzlichen Umgang mit der TYPO3-Benutzeroberfläche vertraut sein. Sollten Sie noch keinerlei Erfahrung mit TYPO3 haben, empfehlen wir Ihnen für den Einstieg das Buch Praxiswissen TYPO3 von Robert Meyer, das ebenfalls im O’Reilly Verlag erschienen ist. Lizensiert für Markus Mueller

TYPO3 ist eine Datenbankanwendung, daher sollten für Sie Begriffe wie Tabelle und Feld nicht nur mit Fußball verbunden sein. Der Schwerpunkt der meisten Rezepte liegt auf der entsprechenden Nutzung des TYPO3-spezifischen Sprachkonstrukts TypoScript oder der Nutzung der TYPO3-Benutzeroberfläche. Da die Rezepte jeweils in sich geschlossene Lösungen beschreiben, sollten sie mit allgemeinen Kenntnissen der einschlägigen Webtechnologien nachvollziehbar sein. Ein Teil der Rezepte, insbesondere diejenigen zur Extension-Entwicklung, setzen Kenntnisse in der PHP-Programmierung voraus. Da die Rezepte bewusst ausführlich gehalten sind und deutlich erläutert werden, sind sie aber auch ohne tieferes Fachwissen nachvollziehbar. Lesen Sie das TYPO3 Kochbuch ... • wenn Sie Ihr TYPO3-Wissen vertiefen möchten. • wenn Sie gern anhand von erläuterten Praxisbeispielen lernen. • wenn Sie Inspirationen zur Lösung Ihrer individuellen Problemstellungen suchen. • wenn Sie TYPO3 im Zusammenhang erfahren möchten. • wenn Sie es satt haben, Hunderte von Seiten der umfangreichen TYPO3-Dokumentation lesen zu müssen, um einen einfachen Zusammenhang zu verstehen. • wenn Sie schnelle Antworten auf dringende Fragen zu TYPO3 benötigen, dabei auch gern ein bisschen mehr als nötig lernen möchten und Querverweise schätzen.

Max. Linie

Max. Linie XII |

Einleitung

This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Rechts

Wir haben in diesem Buch bewusst auf die Behandlung von Extensions außerhalb des Standardpakets von TYPO3 4.2 verzichtet, weil wir Ihnen möglichst umfassend die Kernfunktionen des Systems erläutern wollen. Selbst die Behandlung nur der beliebtesten Extensions hätte zum einen den Rahmen dieses Buchs gesprengt, weil sie ausreichend Material für ein eigenes Buch zu diesem Thema geliefert hätten. Zum anderen werden Sie nach der Lektüre dieses Kochbuchs feststellen, dass sich viele Dinge ganz ohne separate Extensions sehr einfach und komfortabel mit den Bordmitteln des TYPO3-Kerns lösen lassen. Wenn Sie detaillierte Informationen über TemplaVoilà, News, Direct Mail, Shops, Foren oder andere Extensions suchen, sollten Sie sich auf typo3.org umsehen. Sie finden in diesem Buch ausschließlich Rezepte, die sich in der Praxis bewährt haben und Ihnen eine wirkliche Hilfe beim Erstellen eigener TYPO3-Projekte bieten. Abschließend sei darauf hingewiesen, dass dieses Kochbuch kein »Definitive Guide« sein kann und will. Wir erheben daher keinen Anspruch auf Vollständigkeit. Das eine oder andere TypoScript-Element wird beispielsweise nicht erwähnt werden, wobei dies meistens daran liegt, dass diese Elemente selten verwendet werden oder laut Referenz nicht mehr verwendet werden sollten.

Die verwendete TYPO3-Umgebung Lizensiert für Markus Mueller

TYPO3 ist ein sehr umfangreiches Projekt, das sich ständig weiterentwickelt. Die Grundlage für dieses Buchs ist TYPO3 in der Version 4.2. Fast alle Rezepte sind aber auch in älteren Versionen anwendbar, gegebenenfalls wird in den Rezepten explizit auf TYPO3versionsspezifische Besonderheiten hingewiesen. Beachten Sie, dass die TYPO3-Version 4.2 PHP 5.2 voraussetzt. Für TYPO3 sind neben dem Installationspaket zusätzlich Tausende weiterer Extensions verfügbar, mit denen TYPO3 auf verschiedenste Weisen beeinflusst oder erweitert werden kann. Wir behandeln in diesem Rahmen ausschließlich Extensions, die als System-Extensions bereits Bestandteil des TYPO3-Kerns sind. An geeigneten Stellen wird auf zusätzliche, optionale Extensions aus dem Extension-Repository hingewiesen. Da es sich bei TYPO3 um ein webbasiertes System handelt, werden entsprechende Systemumgebungen bestehend aus Betriebssystem, Webserver, Datenbankserver und PHP vorausgesetzt. Als Client dient dabei ein beliebiger Webbrowser.

Aufbau dieses Buchs Das TYPO3 Kochbuch ist eine Sammlung von Lösungen für gängige und manchmal auch nicht ganz alltägliche Aufgaben bei der Arbeit mit TYPO3. Sie werden erfahren, wie man mit TYPO3 umgeht und selbst knifflige Probleme zügig lösen kann.

Max. Linie

Max. Linie Aufbau dieses Buchs | XIII This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Sie müssen das Buch nicht von vorne bis hinten durcharbeiten, jedes Rezept ist in sich abgeschlossen und behandelt die Lösung eines spezifischen Problems. Oftmals gibt es dabei vielfältige Optionen oder Alternativen zur Lösung eines Problems. Unter der Überschrift Lösung wird zunächst der direkte und einfachste Weg beschrieben, danach gehen wir in der Diskussion auf weitere Möglichkeiten und Alternativen sowie deren Vor- und Nachteile ein.

Links

Wenn für das jeweilige Rezept Vorwissen nötig ist, wird dies entsprechend über Querverweise innerhalb des Texts verdeutlicht. Über diese Querverweise können Sie dann je nach Wissensstand bestimmte Themenbereiche vertiefen und ausbauen. Im Abschnitt Siehe auch enthalten die Rezepte außerdem Verweise auf weitere für die angesprochene Problemstellung relevante Rezepte sowie auf andere Online- und Offline-Ressourcen. Die einzelnen Kapitel dieses Buchs können in sechs große inhaltliche Abschnitte eingeteilt werden. Dabei steigt der Schwierigkeitsgrad innerhalb der Kapitel von leicht bis schwer, sodass die ersten Rezepte meist leichter sind als die Rezepte am Ende eines Kapitels. Suchen Sie einen allgemeinen Einstieg in die Thematik eines Kapitels, sollten Sie zunächst die jeweilige Einführung lesen. Hier ein Überblick über die einzelnen Abschnitte und Kapitel: Lizensiert für Markus Mueller

Der erste Abschnitt besteht aus zwei Kapiteln und widmet sich Aspekten rund um die Installation und Wartung einer TYPO3-Umgebung: • Kapitel 1, Installation und Konfiguration, behandelt wichtige Arbeitsschritte bei der Installation von TYPO3 und bietet zusätzlich einige Informationen zum technischen Hintergrund Ihrer TYPO3-Installation. • Kapitel 2, Wartung und Systempflege, setzt den Fokus auf administrative Arbeitsschritte, die im laufenden Betrieb einer TYPO3-Installation anfallen. Im zweiten Abschnitt wird der grundlegende Umgang mit dem TYPO3-Backend behandelt: • Kapitel 3, Der richtige Zugang zum Backend, erläutert nützliche Handgriffe rund ums TYPO3-Backend und die Benutzerverwaltung. • Kapitel 4, Inhalte eingeben, zeigt Ihnen, wie Sie Ihre Website zügig mit Inhalten füllen, und geht auf die Verwendungsmöglichkeiten von Workspaces ein. • Kapitel 5, Inhalte verwalten, erklärt, wie Sie die Inhalte in Ihrer Website effektiv handhaben, verwalten und für Ihre Besucher durchsuchbar machen können. Der dritte Abschnitt zeigt Ihnen, wie Sie das TYPO3-Backend an Ihre eigenen Bedürfnisse anpassen können:

Max. Linie

• Kapitel 6, Das Backend anpassen, beleuchtet die wesentlichen Punkte, mit denen Sie mit wenigen Handgriffen das TYPO3-Backend für Ihre eigenen Bedürfnisse optimieren können. • Kapitel 7, Die Übersicht im Backend erhöhen, behandelt Arbeitsschritte, die Ihnen die tägliche Arbeit im TYPO3-Backend erheblich erleichtern können.

XIV |

Einleitung

This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Im vierten Abschnitt werden die Möglichkeiten diskutiert, Inhalte mit TYPO3 auszugeben: • Kapitel 8, TypoScript verstehen und verwalten, bringt Ihnen die Konfigurationssprache von TYPO3 näher. Hier erhalten Sie die nötigen Grundlagen, um die weiteren Kapitel verstehen zu können. • Kapitel 9, Die Seitenausgabe steuern, behandelt zahlreiche Möglichkeiten, anhand derer Sie Seiteninhalte in unterschiedlichen Ausgabeformaten präsentieren können. • Kapitel 10, Der stdWrap-Baukasten: Grundlegende TypoScript-Funktionen, beschäftigt sich mit dem umfangreichen Funktionsangebot, das Ihnen TYPO3 im Rahmen von stdWrap zur Verfügung stellt. Es dient auch als Nachschlagewerk, um die Funktionsweise der in den weiteren Kapiteln genutzten stdWrap-Funktionen nachlesen zu können. Die Beispiele sind daher etwas knapper gehalten als die der sonstigen Rezepte zum Thema TypoScript. • Kapitel 11, Funktionale TypoScript-Elemente verwenden, beschreibt TypoScript-Elemente, die verschiedene Hilfsfunktionen übernehmen, wenn es darum geht, TypoScript zu strukturieren, die Zwischenablage zu verwenden, Grafiken zu erzeugen oder eigene PHP-Funktionen einzubinden.

Lizensiert für Markus Mueller

• Kapitel 12, Navigationselemente erstellen, erläutert die komfortablen Möglichkeiten, mithilfe von TypoScript Menüstrukturen zu erstellen. Dabei kommen sowohl textbasierte als auch grafikbasierte Versionen zum Einsatz. In den ersten Rezepten des Kapitels werden zunächst die Grundlagen der Menüelemente erläutert. Danach folgen konkrete, umfangreichere Anwendungsbeispiele. • Kapitel 13, Statische und dynamische Inhalte ausgeben, beschäftigt sich mit den inhaltsbezogenen TypoScript-Elementen, mit deren Hilfe Sie Texte, Bilder und Formulare ausgeben sowie HTML-Vorlagen zuweisen können. • Kapitel 14, TypoScript ausreizen, zeigt Ihnen, wie Sie mithilfe des in den vorigen Kapiteln erworbenen Wissens auch äußerst komplexe Problemstellungen ausschließlich durch den Einsatz von TypoScript lösen können. Der fünfte Abschnitt zeigt Ihnen, wie Sie TYPO3 nach eigenen Wünschen erweitern können: • Kapitel 15, Vorhandene Extensions nutzen, beleuchtet, wie Sie in eigenen Projekten auf vorhandene Extensions zurückgreifen können, und unterstützt Sie bei der Recherche nach der richtigen Extension. • Kapitel 16, Extensions kickstarten und ausarbeiten, gibt Ihnen die grundlegenden Kenntnisse für den Kickstarter an die Hand, mit denen Sie dann leicht eigene Extensions erstellen und Basiseinstellungen von TYPO3 anpassen können.

Max. Linie

• Kapitel 17, Einstieg in die TYPO3-API, zeigt Ihnen tiefer gehende Möglichkeiten und Techniken bei der Extension-Entwicklung und führt Sie an die Nutzung der TYPO3API heran.

Aufbau dieses Buchs This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| XV

Max. Linie

• Kapitel 18, Frontend-Plugins weiter entwickeln, behandelt spezielle Entwicklungstechniken, mit denen Sie Ihre Frontend-Plugins ausbauen können.

Links

• Kapitel 19, Backend-Erweiterungen verfeinern, geht auf weiterführende Methoden ein, die sich bei der Entwicklung von Backend-Modulen bewährt haben. Im sechsten Abschnitt erhalten Sie zu guter Letzt tiefere Einblicke in die TYPO3-Community: • Kapitel 20, TYPO3 erleben, stellt Ihnen wichtige Quellen und Anlaufstellen vor, die Ihnen den Umgang mit TYPO3 erleichtern können.

Neues in der zweiten Auflage Seit der ersten Auflage, die auf der TYPO3-Version 4.0 basierte, haben sich in TYPO3 einige Neuerungen ergeben, die wir natürlich in dieser Neuauflage berücksichtigen. Ohne auf die kleinen Detailveränderungen einzugehen, sind vor allem die folgenden Neuerungen aus den TYPO3-Versionen 4.1 und 4.2 erwähnenswert: Neues Backend Mit Version 4.2 hat ein komplett überarbeitetes Backend in TYPO3 Einzug gehalten. Lizensiert für Markus Mueller

Workspaces Das Workspaces-Feature ist mittlerweile von einem rein experimentellen Status zu einem produktiv einsetzbaren Feature herangewachsen. Im deutschen Backend wird der Begriff Workspace mit Arbeitsumgebung übersetzt. Der Einfachheit halber verwenden wir oft den englischen Begriff Workspace. IRRE Mit IRRE, dem Inline Relational Record Editing, steht eine mächtige neue Funktion bereit, um verknüpfte Datensätze auf sehr einfache Weise zu bearbeiten. Ajax Der Hype geht auch an TYPO3 nicht spurlos vorbei, und so hat Ajax, vom Benutzer meist unbemerkt, im TYPO3-Backend ebenfalls Einzug gehalten. Mit Version 4.2 steht dabei im Backend auch eine nützliche Ajax-API bereit, die für Backend-Erweiterungen genutzt werden kann; ebenso gibt es mit eIb für das Frontend ein neues für Ajax geeignetes Feature. In der vorliegenden Auflage haben wir diese Neuerungen berücksichtigt und mit ins Buch aufgenommen. Alle bestehenden Rezepte wurden vollständig überarbeitet und auf die TYPO3-Version 4.2 angepasst. Zudem haben wir den Bereich Installation und Wartung ausgebaut und in zwei Kapitel aufgeteilt.

Max. Linie

Die Kernfunktionen IRRE und Workspaces haben wir mit mehreren Rezepten nahtlos integriert. Hierdurch werden zahlreiche Arbeitsschritte im Backend möglich bzw. vereinfacht, die vorher gar nicht oder nur über Extensions möglich waren. Ebenso erfahren Sie,

XVI

|

Einleitung

This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

wie Sie Ihre Website für Ihre Besucher mit interaktiven Suchen und geschützten Bereichen attraktiver gestalten können. In Kapitel 13 erhalten Sie noch mehr spannende und inspirierende TypoScript-Beispiele, die Sie in Ihren eigenen Projekten weiter ausbauen können. Den Bereich Extension-Entwicklung haben wir aufgrund des Feedbacks der Leser erheblich ausgebaut. Dieser Bereich umfasst nun vier statt vormals zwei Kapitel. Im ersten Teil finden Sie Rezepte, die grundlegende Techniken für die Extension-Entwicklung beschreiben. In den darauf folgenden Kapiteln gehen wir dann detailliert auf die Ausbaumöglichkeiten Ihrer Frontend- und Backend-Erweiterungen ein. Dabei finden Sie zum Beispiel Anregungen dazu, wie Sie Ajax-Funktionalitäten in TYPO3 integrieren oder über Hooks eigene Funktionalitäten in den TYPO3-Kern implementieren können, ohne auch nur eine Zeile im TYPO3-Kern zu ändern. Wir möchten uns bei allen Lesern bedanken, die uns mit dem durchweg positiven Feedback ermuntert haben, diese zweite Auflage in Angriff zu nehmen. Wir hoffen, dass wir mit dieser Überarbeitung einige Ihrer Vorschläge umsetzen können, und freuen uns weiterhin über Ihre Kommentare und Anregungen.

Die CD-ROM und die Codebeispiele Lizensiert für Markus Mueller

Auf der beiliegenden CD-ROM finden Sie die Codebeispiele aus dem TYPO3 Kochbuch. Anhand dieses Quellcodes können Sie die in den Rezepten beschriebenen Vorgänge direkt nachvollziehen, eine kurze Erklärung zum jeweiligen Code erleichtert Ihnen dabei den Einstieg. Die Beispiele sind lauffähig ab TYPO3-Version 4.2 und können meist bequem als Extension oder eigener Seitenbaum in jede bestehende TYPO3-Installation integriert werden. Im Ordner doc finden Sie die wichtigsten Dokumente für TYPO3-Entwickler im OpenOffice- und PDF-Format (Stand: 15. September 2008). Der Ordner html enthält die Beispiele aus den Rezepten des TYPO3 Kochbuchs als statische HTML-Seiten. Wir haben dabei sehr viel Wert darauf gelegt, dass die Beispiele einfach und intuitiv nachvollziehbar bleiben. Sie lassen sich schnell über die Übersichtsseite index.html erreichen und durch einen Klick auf den Rezepttitel öffnen. Klicken Sie nach dem Einlegen der CD auf die Datei index.html und erkunden Sie die Beispiele über Ihren Webbrowser. Auf diese Weise können Sie sich schnell einen guten Überblick verschaffen. Im Ordner typo3packages finden Sie aktuelle TYPO3-Pakete (Stand: 15. September 2008). Eine Möglichkeit zum Download der Codebeispiele des TYPO3 Kochbuchs finden Sie außerdem auf der Website des O’Reilly Verlags unter folgender Adresse: http://www.oreilly.de/catalog/typo3ckbk2ger/

Max. Linie

Max. Linie Die CD-ROM und die Codebeispiele | XVII This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Verwendung der Codebeispiele

Links

Sinn und Zweck dieses Buchs ist es, Ihnen bei Ihrer Arbeit zu helfen. Sie dürfen generell den Code aus diesem Buch in Ihren Programmen und Dokumentationen verwenden, ohne uns um Erlaubnis zu fragen, es sei denn, Sie verwenden einen bedeutenden Teil des Codes. Beispielsweise brauchen Sie keine Erlaubnis, wenn Sie ein Programm schreiben, das mehrere Codestücke aus diesem Buch verwendet, doch wenn Sie eine CD-ROM mit Codebeispielen aus O’Reilly-Büchern verteilen oder verkaufen, müssen Sie eine Genehmigung einholen. Sie können nach Belieben dieses Buch und Beispielcode daraus zitieren, um Fragen zu beantworten, aber wenn Sie einen großen Teil des Beispielcodes in Ihre Produktdokumentation übernehmen, bedarf dies einer Genehmigung. Auch wenn wir es nicht verlangen, so freuen wir uns doch über eine Quellenangabe, wenn wir zitiert werden. Zu einer Quellenangabe gehören normalerweise Titel, Autor, Verlag sowie ISBN des Werks, zum Beispiel: »TYPO3 Kochbuch, 2. Auflage, von Christian Trabold, Jo Hasenau & Peter Niederlag. Copyright 2009 O’Reilly Verlag, ISBN 3-89721851-2.« Wenn Sie den Eindruck haben, Ihre Verwendung unseres Codes übersteige die Grenzen des Erlaubten, sprechen Sie uns bitte an unter [email protected]. Lizensiert für Markus Mueller

Typografische Konventionen In diesem Buch gelten folgende typografische Konventionen: Kursiv Wird für Datei- und Verzeichnisnamen, E-Mail-Adressen und URLs, aber auch bei der Definition neuer Fachbegriffe und für Hervorhebungen verwendet. Nichtproportionalschrift

Wird für Codebeispiele sowie für Variablen, Funktionen, Befehlsoptionen, Parameter, Klassennamen und HTML-Tags verwendet, wenn sie im Text auftauchen. Nichtproportionalschrift fett

Wird in den Codebeispielen für Benutzereingaben sowie zur Hervorhebung einzelner Zeilen oder Abschnitte im Code verwendet. Dieses Symbol kennzeichnet einen Tipp, Vorschlag oder allgemeinen Hinweis mit nützlichen Zusatzinformationen zum Thema.

An diesem Symbol erkennen Sie eine Warnung, die zur Vorsicht rät.

Max. Linie

Max. Linie XVIII

|

Einleitung

This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Rechts

Danksagung Der größte Dank geht an alle, die mit ihrer Zeit, Energie und ihrem Engagement zur Weiterentwicklung von TYPO3 beitragen. Vor allem möchten wir dem Kernentwicklerteam für seinen unermüdlichen Einsatz danken, ohne den es TYPO3 nicht gäbe. Besonderer Dank geht an Kasper Skårhøj, Sebastian Kurfürst, Michael Stucki, Karsten Dambekalns, Robert Lemke, Rene Fritz, Martin Kutschker, Dmitry Dulepov, Ingmar Schlecht, Stanislas Rolland, Andreas Otto, Thorsten Kahler, Bernhard Kraft, Christian Jul Jensen, Rupert Germann, Wolfgang Klinger, Franz Holzinger und alle anderen hilfsbereiten Menschen aus Newsgroup und Bugtracker für ihre Geduld und Aufmerksamkeit. Ihr habt uns stets inspiriert und dazu angespornt, unser Bestes zu geben. Ganz herzlich danken wir auch den Lesern, die das Manuskript der 1. Auflage vorab begutachtet haben: Sacha Vorbeck für seine Hilfe bei der Vorbereitung, Recherche und Konzeption der ersten Auflage dieses Buchs, David Zschille für seine kritischen Anmerkungen und seine unbändige Lust, uns Löcher in den Bauch zu fragen, sowie Julian Kleinhans und Sven Hartmann für ihre hilfreichen Kommentare. Zudem danken wir Birgitte Laisen für die Hilfe bei der Aussprache von »Skårhøj«, die als Grundlage für das Rezept 20.1 diente. Tak!

Lizensiert für Markus Mueller

Ein ganz besonderes Dankeschön geht an unsere Lektorin Alexandra Follenius und ihr Team für ihre unermessliche Geduld und Unterstützung während der gesamten Entstehungszeit des TYPO3 Kochbuchs.

Jo Mein persönlicher Dank geht zunächst mal an Christian Trabold für das Vertrauen, mich als Autor für dieses Buch mit ins Team zu holen. Ebenso möchte ich Peter Niederlag danken, der bei der 1. Auflage erst später zum Team dazugestoßen ist und trotz der kurzen Zeit in hohem Maße zur Qualität der Inhalte beigetragen hat.

Christian Besonderen Dank sende ich an Friederike, Ursel, Albrecht und Gaby – ohne eure Unterstützung hätte ich das Buch in dieser Form nicht schreiben können. Dank auch an Daniel und David für die aufmunternden Gespräche und Tracks zwischendurch. Einen ganz herzlichen Dank auch an meine Kollegen, besonders an Chris, Olivier und Götz, für das flexible Projektmanagement. Ebenso danke ich meinen Freunden für die Geduld und das Verständnis, mich beim Schreiben ungestört zu lassen. Danke für euer Vertrauen!

Max. Linie

Max. Linie This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Danksagung

| XIX

Links

Peter Mein persönlicher Dank gilt Annelena, Julian und Fabio. Ihr habt wieder mal mit viel Geduld mein Arbeitspensum ertragen, und eure zwischenzeitlichen Aufmunterungen haben mir die Kraft gegeben durchzuhalten. Vielen Dank auch an Christian und Jo für die unendlichen, spannenden und streitbaren Diskussionen und die fruchtbare Zusammenarbeit.

Lizensiert für Markus Mueller

Max. Linie

Max. Linie XX

|

Einleitung

This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

First

Kapitel 1

KAPITEL 1

Installation und Konfiguration

1.0

Einführung

Lizensiert für Markus Mueller

Einer der großen Vorteile von TYPO3 liegt darin, dass auf Anwender- wie Entwicklerseite keinerlei Softwareinstallation notwendig ist, denn TYPO3 ist ein serverbasiertes Content Management-System. Die Nutzer benötigen zur Arbeit mit TYPO3 lediglich einen gewöhnlichen Webbrowser. Die eigentliche TYPO3-Anwendung ist in der Skriptsprache PHP implementiert und wird zentral von einem Server im Internet oder Intranet bereitgestellt. Für die Einrichtung einer TYPO3-Serverumgebung und einen produktiv nutzbaren, sicheren und verlässlichen Betrieb der dazu notwendigen Komponenten sind entsprechende Kompetenzen und Erfahrungen im Betrieb von Servern empfehlenswert, zumindest wenn das System an das Internet angekoppelt wird. Hier müssen Sie abwägen, ob der Betrieb einer eigenen Plattform wirtschaftlich und sicherheitstechnisch sinnvoll ist oder ob auf die entsprechenden Leistungen eines im TYPO3-Hosting erfahrenen Anbieters zurückgegriffen werden sollte. Die Anforderungen für eine TYPO3-Serverumgebung können von entsprechenden Discount-Hosting-Angeboten allerdings oftmals nicht erfüllt werden. Das Rezept 1.1 gibt Ihnen hierzu entsprechende Hinweise, die Sie zu Beginn eines TYPO3Projekts berücksichtigen sollten. TYPO3 wird derzeit stark weiterentwickelt, und es erscheinen regelmäßig neue Versionen, die neue Features implementieren oder auftretende Probleme beseitigen. Zu jedem TYPO3-Release gibt es mehrere Pakete, die verschiedenen Zwecken dienen. In Rezept 1.2 erfahren Sie mehr über die Bedeutung dieser TYPO3-Installationspakete und wie Sie deren Installation vornehmen. Wenn Sie vorab neue Features oder Bugfixes in einer neuen TYPO3-Version testen möchten, hilft Ihnen Rezept 1.3. Dort wird detailliert auf die Verwendung von Entwicklerversionen eingegangen. Die Bedeutung der einzelnen Ordner und Dateien einer TYPO3-Installation wird in Rezept 1.4 dargestellt.

Max. Linie

Max. Linie | 1 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Entsprechend dem Framework-Charakter von TYPO3 gibt es sehr viele Parameter, die das Verhalten des Systems beeinflussen. In Rezept 1.5 erfahren Sie, wie Sie die in Ihrer Installation gesetzten Parameter prüfen können und welchem Zweck sie dienen. Das Rezept 1.6 erklärt, wie Sie die wichtigsten Grundeinstellungen, und damit einen Teil dieser Parameter, über das Install-Tool anpassen können. Ein häufig vorkommender Anwendungfall ist, die maximale Größe für Dateien zu erhöhen. Die dazu nötigen Schritte werden in Rezept 1.7 näher beschrieben. Wenn Sie planen, mehrere Websites in einer TYPO3-Instanz zu betreiben, finden Sie in Rezept 1.8 die notwendigen Tipps, um diese Aufgabe zu erfüllen. Außerdem sollten Sie vor der Installation Ihrer Website klären, in welchem Zeichensatz die Inhalte in der Datenbank gespeichert werden. Wir empfehlen als Standardzeichensatz UTF-8 und erläutern in Rezept 1.9 die nötigen Schritte, um TYPO3 und die Datenbank entsprechend einzurichten.

Links

Sollten Sie Probleme mit Ihrer Installation haben oder beim Aufruf Ihrer Website Fehlermeldungen erhalten, können Sie in Rezept 1.10 erfahren, wie Sie Ihre Grundeinstellungen überprüfen und mit auftretenden Fehlermeldungen umgehen sollten.

1.1

Vorüberlegungen zu einem TYPO3-Projekt

Lizensiert für Markus Mueller

Problem Sie möchten TYPO3 als CMS in Ihrem Projekt einsetzen und benötigen Tipps zur geplanten Einführung.

Lösung Zeitplanung Planen Sie ausreichend Zeit für das Projekt ein. Unterschätzen Sie die Komplexität eines solchen Projekts nicht. Eine effiziente Projektumsetzung mit TYPO3 erfordert einiges an Erfahrung, für Neulinge entsteht ein hoher Einarbeitungsaufwand.

Vorgehen In jedem Fall sollten Sie vor der Umsetzung mit TYPO3 ein Konzept mit einem Layout erstellen, das Sie zunächst losgelöst von TYPO3 anhand einiger statischer (X)HTMLund CSS-Dateien implementieren sollten. Bedenken Sie, dass die Inhalte einer Website zu den Ressourcen einer Organisation zählen. Um diese Ressourcen langfristig zu erhalten, ist eine entsprechende Trennung in Struktur- und Layoutinformationen, wie Sie mit XHTML und CSS erreicht werden, sinnvoll. Außerdem schaffen Sie damit die Grundlagen, um barrierearme Websites und verschiedene Ausgabeformate zu erzeugen. Neben

Max. Linie

Max. Linie 2 | Kapitel 1: Installation und Konfiguration This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Rechts

der statischen Umsetzung ist auch ein Konzept- oder Pflichtenheft nützlich, in dem Sie die Anforderungen, Zielgruppen und Funktionalitäten, die die Website betreffen, dokumentieren.

Know-how und Beratung Aus wirtschaftlichen Gründen sollten Sie in Erwägung ziehen, professionelle Dienstleistungen im Rahmen von Beratung, Schulung oder Support von TYPO3-Spezialisten in Anspruch zu nehmen. In der Praxis hat sich gezeigt, dass sich solche Investitionen im Projektverlauf rentieren. Dabei sollten Sie auch auf Referenzen achten. Eine Auflistung von TYPO3-Dienstleistern finden Sie unter: http://typo3.com/Consultancies.1248.0.html

Open Source

Lizensiert für Markus Mueller

Die Verwendung von TYPO3 als Open Source-Produkt ist lizenzkostenfrei. Die Entwicklung von TYPO3 wird dabei nicht direkt von einem Unternehmen getragen, sondern von einer weltweiten Gemeinschaft aus Entwicklern. Die TYPO3 Association übernimmt als gemeinnützige Organisation entsprechende Aufgaben zur Koordination der Entwicklung und Außendarstellung. Über die TYPO3 Association ist es möglich, das Projekt finanziell zu unterstützen. Die Website der TYPO3 Association ist unter http://association.typo3.org/ zu erreichen.

Diskussion TYPO3 als komplexes Softwareprodukt TYPO3 ist ein leistungsfähiges CMS-Framework. Die Bezeichnung Framework macht deutlich, dass es sich bei TYPO3 eigentlich um einen Baukasten handelt, mit dem Sie das CMS nach Ihren Bedürfnissen gestalten können. Ein Vorteil für Sie als Anwender gegenüber anderen Frameworks ist dabei, dass der Baukasten TYPO3 bereits mit einer sinnvollen, einsatzbereiten Grundkonstruktion ausgeliefert wird. Anders ausgedrückt, verfügt das CMS TYPO3 bereits im Standardinstallationspaket über eine endbenutzertaugliche Konfiguration und Oberfläche. Für den Projekterfolg ist es jedoch wichtig, dass TYPO3 an die für die jeweiligen Anwender maßgeblichen Anforderungen angepasst wird. Eine solche Anpassung erfordert umfangreiche Kenntnisse und Erfahrungen, die wir mit diesem Buch vermitteln möchten. In der Praxis sollten Sie sich bei Projektbeginn überlegen, ob Sie das notwendige Knowhow organisationsintern aufbauen wollen oder stattdessen lieber auf externe Dienstleister mit entsprechenden Referenzen zurückgreifen.

Max. Linie

Max. Linie 1.1 Vorüberlegungen zu einem TYPO3-Projekt | 3 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Überlegungen zum laufenden Betrieb

Links

TYPO3 besteht aus einer Sammlung von PHP-Skriptdateien. Zum Betrieb von TYPO3 werden die folgenden Komponenten benötigt: Ein Webserver mit einer Schnittstelle für die Skriptsprache PHP Dies ist die Komponente, auf die die Benutzer und Anwender mit ihrem Browser zugreifen, wenn sie mit dem CMS TYPO3 arbeiten. In den meisten Fällen wird diese Komponente vom Open Source-Webserver Apache (http://httpd.apache.org) bereitgestellt, es sind aber auch andere Produkte verwendbar. PHP-Skriptinterpreter Die TYPO3-Anwendungslogik wird von dem PHP-Skriptinterpreter (http://www. php.net) ausgeführt, der – für den Benutzer nicht direkt zugreifbar – in Zusammenarbeit mit dem Webserver seine Dienste tut. Ab TYPO3 4.2.x ist mindestens PHPVersion 5.1 erforderlich. Datenbankdienst Die eigentliche Datenhaltung von TYPO3 erfolgt in einem relationalen DatenbankManagement-System (RDBMS). In den meisten Fällen wird hier auf das weit verbreitete RDBMS MySQL (http://www.mysql.com) zurückgegriffen. Lizensiert für Markus Mueller

Für einen produktiv nutzbaren, sicheren und verlässlichen Betrieb dieser Komponenten sind entsprechende Kompetenzen im Betrieb von Internet-Services unabdingbar, zumindest wenn das System an das Internet angekoppelt wird. Auch hier sollten Sie abwägen, ob der Betrieb einer eigenen Plattform wirtschaftlich sinnvoll ist oder ob auf die Leistungen eines auf entsprechendes Hosting spezialisierten Anbieters zurückgegriffen werden soll.

Migration Sollten Sie bereits eine umfangreiche Website betreiben, müssen Sie überlegen, wie Sie die bereits vorhandenen Inhalte in das TYPO3-System übernehmen. Hierbei stehen derzeit noch keine wirklich nutzbaren freien Werkzeuge zur Verfügung. Viele TYPO3-Agenturen verfügen aber über entsprechene Verfahren und zum Teil auch über entsprechende interne Tools. Sollte für Sie die Übernahme eines größeren Datenbestands Thema sein, könnten Sie sich möglicherweise an einer solchen Entwicklung für das TYPO3-Projekt beteiligen, siehe dazu auch Rezept 20.2.

Siehe auch Eine Liste mit Links zu Informationen über TYPO3 finden Sie in Rezept 20.8.

Max. Linie

Max. Linie 4 | Kapitel 1: Installation und Konfiguration This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Rechts

1.2

Das richtige TYPO3-Paket auswählen und installieren

Problem Sie möchten TYPO3 installieren und benötigen eine Hilfestellung bei der Auswahl des richtigen Pakets.

Lösung Einen Überblick über die aktuell verfügbaren und stabilen TYPO3-Pakete finden Sie auf der offiziellen Webseite unter: http://typo3.org/download/packages/ Und hier erhalten Sie eine Liste mit den verschiedenen Installationspaketen: Dummy package Die dummy-*-Pakete enthalten ein leeres Gerüst und ergeben erst zusammen mit einem TYPO3 Source-Paket eine lauffähige TYPO3-Installation. Lizensiert für Markus Mueller

TYPO3 Source Die typo3_src-*-Pakete enthalten alle notwendigen Quellcodedateien für TYPO3. Die typo3_src+dummy-*-Pakete enthalten zusätzlich bereits das Dummy-Paket. Diese Aufteilung in TYPO3 Source- und Dummy-Paket kommt vor allem auf Unix-artigen Betriebssystemen zum Tragen. Dort ist es möglich, über sogenannte Symlinks (symbolische Links) einen TYPO3-Quellcode für mehrere TYPO3-Installationen zu nutzen. Unter Windows ist dieses Vorgehen ohne besondere Betriebssystemerweiterungen nicht möglich. Jedes dieser Pakete steht in den beiden Archivformaten ZIP (.zip) und TAR (.tgz) zur Verfügung. Prinzipiell gilt dabei: • Wählen Sie für Windows-Server das ZIP-Archiv, weil dieses für einen Einsatz ohne Symlinks gedacht ist. • Wählen Sie für Linux- und Mac-Systeme das TAR-Archiv, weil dieses für die Verwendung von Symlinks vorbereitet ist. Alle diese Pakete setzen voraus, dass die benötigten Komponenten Webserver, PHPSkriptinterpreter und Datenbank bereits funktionsfähig auf Ihrem System vorhanden sind.

Max. Linie

Max. Linie 1.2 Das richtige TYPO3-Paket auswählen und installieren This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 5

Links

Windows Zur Installation auf einem Windows-System wählen Sie folgendes Paket: typo3_src+dummy-*.zip

Das Paket entpacken Sie in das Hauptverzeichnis Ihres Webservers, das typischerweise mit htdocs/ bezeichnet ist.

Linux/Mac OS X Zur Installation auf einem Unix-System laden Sie am besten die folgenden Pakete getrennt herunter: typo3_src*.tgz dummy-*.tgz

Die beiden Pakete entpacken Sie jeweils in das Hauptverzeichnis Ihres Webservers. In diesem Fall brauchen Sie keine weiteren Anpassungen am Symlink des dummy-Pakets vorzunehmen.

Install-Tool aufrufen Lizensiert für Markus Mueller

Sind alle Dateien ausgepackt und befinden sich an der passenden Stelle, sollten Sie in Ihrem Browser die URL http://www.ihre-website.tld/typo3/install/ aufrufen. Bei einer Neuinstallation begrüßt Sie das Install-Tool mit dem 1-2-3-Modus, in den Sie die wichtigsten Parameter eingeben, um Ihre Installation abzuschließen. Wenn TYPO3 nicht auf dem lokalen Rechner installiert, ist müssen Sie zunächst noch im Verzeichnis typo3conf eine leere Datei mit der Bezeichnung ENABLE_INSTALL_TOOL anlegen. Dies ist eine zusätzliche Sicherheitsmaßnahme, um unberechtigte Zugriffe zu verhindern. Nach einer erfolgten Installation wird empfohlen, die Datei wieder zu löschen.

• Geben Sie den Benutzernamen, das Passwort und den Rechnernamen zur Verbindung mit der Datenbank ein. • Wählen Sie, so gewünscht, eine vorhandene Datenbank für Ihre TYPO3-Installation aus. Beachten Sie dabei, dass möglicherweise vorhandene Inhalte in dieser Datenbank dadurch verloren gehen! Alternativ können Sie eine Bezeichnung für eine neu zu erstellende Datenbank angeben. • Importieren Sie die notwendigen Datenbankdaten. Im 1-2-3-Modus wird dabei automatisch der Benutzer admin mit dem Passwort password angelegt. • Nach diesen ersten Schritten wechseln Sie in die Normalansicht des Install-Tools. Sie sollten nun unbedingt das Passwort Ihres Install-Tools ändern und unter Basic Configuration sowie All Configuration die Systemparameter prüfen und anpassen.

Max. Linie

• Nach dem ersten Login ins Backend mit dem Benutzer admin und dem Passwort password sollten Sie auf alle Fälle das Passwort ändern.

6 | Kapitel 1: Installation und Konfiguration This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts In Rezept 1.6 erhalten Sie Hilfestellung, um die Installation über den 1-2-3Modus hinaus anzupassen.

Weitere Hilfe zur Installation erhalten Sie im TYPO3-Wiki unter der folgenden URL: http://wiki.typo3.org/index.php/Category:Topic/installation

Diskussion Installer-Pakete Neben den reinen Source-Paketen gibt es einige Ready-to-go-Installationspakete. Diese stellen eine komplett lauffähige Umgebung bereit und beinhalten auch die benötigten Komponenten Apache, MySQL und PHP. Diese Pakete sollen einen einfachen Einstieg auch für diejenigen mit gar keiner bis wenig Erfahrung im Betrieb von Webservern ermöglichen. Grundsätzlich sind sie nicht für den Produktivbetrieb gedacht, vereinfachen die Nutzung von TYPO3 aber auf wenige Mausklicks. Eine Übersicht über diese Pakete finden Sie unter: Lizensiert für Markus Mueller

http://typo3.org/download/installers/

Beispielprojekte Neben den Basis-Installationspaketen gibt es spezielle TYPO3-Pakete, mit denen Sie Beispielprojekte in Ihre TYPO3-Installation einspielen können. Diese sind vor allem zur Analyse und als Anschauungsbeispiele hilfreich: QuickStart package Die Website eines fiktiven Fußballvereins. Ein Paket, das zum Ausprobieren und Stöbern einlädt. Besondere Merkmale: Ein Admin-Benutzer und ein Redakteur sind schon vorhanden. Mehrere Extensions sind dabei, sodass umgehend gearbeitet werden kann. Nicht für den Produktivbetrieb gedacht. Testsite package Dieses Paket enthält mehrere Websites, in denen exemplarisch unterschiedliche Szenarien und Beispiele vorinstalliert sind. Besondere Merkmale: Enthält zahlreiche Beispiele zur Lösung unterschiedlicher Problemstellungen mit TypoScript und PHPErweiterungen, Muster für alle Arten von Menüs und die dynamische Grafikerzeugung. Ebenfalls nicht für den Produktivbetrieb gedacht.

Max. Linie

Diese beiden Pakete enthalten möglicherweise noch TYPO3-Sourcen in Version 3.8.1 Nach der Installation kann aber problemlos wie in Rezept 2.1 beschrieben ein Update der Sourcen auf eine aktuelle TYPO3-Version vorgenommen werden.

1.2 Das richtige TYPO3-Paket auswählen und installieren This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie | 7

Siehe auch

Links

In Rezept 1.6 erfahren Sie, wie Sie Ihre Installation über den 1-2-3-Modus hinaus anpassen. Sollten Sie bei der Installation Fehlermeldungen erhalten, lernen Sie in Rezept 1.10 die Gründe für die am häufigsten auftretenden Meldungen kennen. In Rezept 2.1 erfahren Sie, wie Sie Ihre TYPO3-Installation aktualisieren. Bleiben Sie auf dem aktuellsten Stand, indem Sie sich den RSS-Feed auf der Website http://news.typo3.org/xml-feeds/ abonnieren.

1.3

Eine Entwicklerversion von TYPO3 verwenden

Problem Sie möchten die aktuellste TYPO3-Version testen, bevor sie öffentlich zum Download angeboten wird, etwa um ein neues Feature frühzeitig zu evaluieren oder Bugfixes zu testen. Wenn Sie selbst Bugfixes erstellen möchten, sollten Sie dafür auch die aktuellste Entwicklerversion nutzen, um sicherzustellen, dass Ihre Änderungen auch mit den anderen Änderungen am Code zusammenspielen. Die Entwicklerversionen sind zwar in aller Regel stabil, von einem produktiven Einsatz ist jedoch abzusehen. Lizensiert für Markus Mueller

Lösung Holen Sie sich die aktuellsten Quelldateien aus dem TYPO3-Subversion-Repository von dieser Adresse: https://svn.typo3.org/ Um die Dateien herunterladen zu können, müssen Sie die Adresse noch entsprechend erweitern: Die veröffentlichten stabilen Releases von TYPO3 4.x finden Sie unter: https://svn.typo3.org/TYPO3v4/Core/tags/ Die Entwicklungszweige für die stabilen Releases von TYPO3 4.x befinden sich in: https://svn.typo3.org/TYPO3v4/Core/branches/ Den jeweils aktuellsten Entwicklungsstand für das nächste Release von TYPO3 4.x erhalten Sie hier: https://svn.typo3.org/TYPO3v4/Core/trunk/ Legen Sie mit Ihrem Subversion-Client eine lokale Arbeitskopie des gewünschten SourceZweigs an.

Max. Linie

Mit dem folgenden svn-Kommando laden Sie den aktuellen Stand des Release-Zweigs 4.2 in das lokale Verzeichnis TYPO3_4-2: svn co https://svn.typo3.org/TYPO3v4/Core/branches/TYPO3_4-2

8 | Kapitel 1: Installation und Konfiguration This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Diskussion TYPO3 ist ein Open Source-Projekt mit einer weltweiten Entwicklergemeinde. Mehrere Entwickler arbeiten von verschiedenen Orten aus gleichzeitig am Programmcode. Diese verteilte Entwicklung ist nur mithilfe von Source-Code-Management (kurz SCM) zu bewältigen. TYPO3 setzt als SCM-Werkzeug das freie Subversion (SVN) ein. Subversion versioniert den Programmcode und protokolliert detailliert alle Änderungen am Code. Änderungen können dadurch zum Beispiel sichtbar und notfalls auch rückgängig gemacht werden. Über den Subversion-Server https://svn.typo3.org/ besteht jederzeit lesender Zugriff auf die aktuellen Ressourcen des TYPO3-Projekts. Wenn Sie die Adresse in Ihren Webbrowser eingeben, können Sie sich durch die Verzeichnisstruktur der einzelnen Projekte klicken. Um sich die Quelldaten auf den lokalen Rechner zu laden, benötigen Sie jedoch entweder einen sogenannten Subversion-Client, also ein Programm, das mit dem SVN-Protokoll umgehen kann, oder Sie greifen über die WebDav-Schnittstelle Ihres Betriebssystems direkt auf den Webserver zu und laden sich die gewünschten Verzeichnisse herunter.

Lizensiert für Markus Mueller

Der Subversion-Client ist in vielen aktuellen Entwicklungsumgebungen für PHP bereits enthalten. Eine ausführliche Liste an Subversion-Clients finden Sie unter http://subversion.tigris.org/. In Mac OS X und Windows kann das SVN-Repository auch als Netzwerklaufwerk eingebunden werden. Unter Max OS X richten Sie die Netzwerkressource mit diesen Schritten ein: • Öffnen Sie im Finder mit Apfel + K das Fenster Mit Server verbinden. • Geben Sie dort in das Feld Serveradresse die gewünschte URL ein. • Bestätigen Sie Ihre Eingabe mit dem Button Verbinden. • Danach steht Ihnen unter Freigaben ein neues Laufwerk zur Verfügung. Um die Netzwerkressource unter Windows einzurichten, gehen Sie wie folgt vor: • Öffnen Sie die Windows-Netzwerkumgebung und wählen Sie den Punkt Netzwerkumgebung hinzufügen. Klicken Sie dann zweimal auf den Button Weiter. • Geben Sie die gewünschte URL in das Eingabefeld ein. Bestätigen Sie Ihre Eingabe wieder durch einen Klick auf Weiter. • Ändern Sie die Bezeichnung der Ressource nach Wunsch. Bestätigen Sie das Anlegen mit einem Klick auf Fertigstellen. Auf diese Weise haben Sie jederzeit bequemen Zugriff auf den aktuellsten Quelltext und können wie gewohnt Dateien lesen und auf die Festplatte kopieren.

Max. Linie

Eine lokale Versionskontrolle ist jedoch im Gegensatz zum Checkout mit dem SVN-Client bei dieser Methode nicht möglich, da die Daten nur vom Server geladen werden und lokal keine automatische Versionierung angelegt wird.

1.3 Eine Entwicklerversion von TYPO3 verwenden | 9 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Siehe auch

Links

Weitere Informationen zu Subversion finden Sie unter der Webadresse http://subversion. tigris.org. Viele TYPO3-Extensions werden auch mit Subversion verwaltet und können unter https://svn.typo3.org/TYPO3v4/Extensions/ abgerufen werden. Als weiterführende Literatur zum Thema Subversion empfehlen wir das Buch Versionskontrolle mit Subversion von Ben Collins-Sussman, Brian W. Fitzpatrick & C. Michael Pilato, O’Reilly Verlag.

1.4

Die Ordnerstruktur verstehen

Problem Sie möchten sich in Ihrer TYPO3-Installation zurechtfinden und Dateien oder Ordner richtig zuordnen.

Lösung Lizensiert für Markus Mueller

Die Ordnerstruktur einer TYPO3-Installation ist in zwei Teile aufgeteilt: Zum einen gibt es Dateien und Ordner, die den TYPO3-Kern über das sogenannte Source-Paket bilden. Zum anderen enthält die TYPO3-Installation bestimmte Ordner, die projektspezifische Daten speichern. Diese Ordner werden auch als Dummy-Paket bezeichnet und zusammengefasst. Der TYPO3-Kern besteht aus den Ordnern misc, t3lib und typo3 sowie deren Unterordnern und der Datei index.php. Die Textdateien enthalten spezielle Informationen zur Verwendung von TYPO3. • Im Ordner misc liegen diverse Dateien, die für den Betrieb von TYPO3 nicht notwendig sind. Wenn Sie keine dieser Dateien benötigen, können Sie diesen Ordner auch ruhigen Gewissens entfernen. • Im Ordner t3lib finden Sie sämtliche Programmbibliotheken und Vorgaben, die essenziell für die Kernfunktionen von TYPO3 sind. • Im Ordner typo3 liegen die Dateien, über die das TYPO3-Backend sowie wichtige System-Extensions bereitgestellt werden, die notwendig sind, damit Sie über das Backend komfortabel Inhalte eingeben und wieder über die TypoScript-Engine ausgeben können. Besonderes Augenmerk gilt dabei der System-Extension cms im Ordner typo3/sysext/.

Max. Linie

• Die Dateien README.txt und INSTALL.txt geben Antworten auf allgemeine Fragen zu TYPO3 und der Installation. In den beiden Dateien LICENSE.txt und GPL.txt werden lizenztechnische Belange beschrieben. Wenn Sie unsicher sind, ob Sie TYPO3 in Ihrem gewünschten Umfeld einsetzen dürfen, sollten Sie diese Dateien lesen.

10 | Kapitel 1: Installation und Konfiguration This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Die Dateien des TYPO3-Kerns sollten Sie unberührt lassen und mit einem Schreibschutz versehen, um sie vor versehentlichen Änderungen zu schützen. Wenn Sie allerdings globale Extensions installieren möchten, sollte der Webserver für den Ordner typo3/ext/ Schreibrechte besitzen. Den TYPO3-Kern können Sie über Extensions sehr flexibel erweitern und anpassen (in Kapitel 15 und folgenden erfahren Sie mehr über diese Erweiterungsmöglichkeiten). Änderungen an diesen Dateien sind nur in sehr speziellen Fällen nötig und sollten ausschließlich von sehr erfahrenen Anwendern durchgeführt werden. Bei einem Update werden nur diese Ordner und Dateien aktualisiert. Projektspezifische Dateien werden hingegen in den Ordnern fileadmin, typo3conf, typo3temp und uploads gespeichert. Hier werden TYPO3-Erweiterungen (Extensions), CacheDateien sowie sämtliche Konfigurations- und Grafikdateien abgelegt. Diese Ordner müssen vom Webserver beschrieben werden können. Die Datei _.htaccess können sie als Vorlage für eine individuelle .htaccess-Datei verwenden oder löschen, wenn Sie nicht benötigt wird. Die Datei clear.gif dient als Platzhaltergrafik für Positionierungen und ist vor allem noch aus historischen Gründen vorhanden, da sie beispielsweise im Backend oft zur Positionierung von Formularelementen genutzt wird. Bei einem Update auf eine neue TYPO3-Version bleiben diese Ordner und die genannten Dateien unberührt.

Lizensiert für Markus Mueller

Diskussion TYPO3 ist sehr modular aufgebaut. So besteht der TYPO3-Kern aus weit über 500 PHPDateien und -Klassen, die beispielsweise die Basisfunktionalitäten zur Benutzerverwaltung, für Datenbankoperationen, das Dateihandling oder die Formularerzeugung bereitstellen. Diese Dateien sind je nach Anwendungsbereich in mehrere Unterordner gegliedert. Im Folgenden finden Sie Informationen zu den Aufgaben und Funktionen der einzelnen Ordner und Dateien, die Sie dabei unterstützen sollen, sich in der Struktur von TYPO3 besser zurechtzufinden. Diese Informationen dienen auch als Grundlage für eine Reihe von Rezepten in diesem Kochbuch – hier können Sie nach Bedarf die Details nachlesen. Diese Struktur finden Sie standardmäßig wieder, wenn Sie das Wurzelverzeichnis Ihrer TYPO3Installation öffnen: fileadmin misc/ t3lib typo3/ typo3conf typo3temp uploads

Max. Linie

Alle hervorgehobenen Ordner oder Dateien befinden sich im Source-Paket, das Sie mit einem Schreibschutz versehen sollten. Die restlichen Ordner müssen inklusive aller Unterordner für den Webserver beschreibbar sein.

1.4 Die Ordnerstruktur verstehen | 11 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

fileadmin/ In diesem Ordner können Sie beliebige Dateien ablegen und verwalten. Sämtliche Unterordner können Sie mit dem Modul Dateiliste über das Backend verwalten. Der Webserver muss diesen Ordner samt Unterordner beschreiben können, wenn Sie dieses Modul einsetzen möchten.

Links

misc/ In diesem Ordner finden Sie diverse Vorlagen für Sprach-, SQL- und .htaccessDateien. Außerdem gibt Ihnen die Datei superadmin.php nützliche Funktionen an die Hand, mit denen Sie mehrere TYPO3-Installationen komfortabel verwalten können. Dieser Ordner sollte daher nicht öffentlich zugänglich sein und in Produktivumgebungen gelöscht werden. Weitere Informationen zur Datei superadmin.php finden Sie im Quellcode der Datei.

Lizensiert für Markus Mueller

t3lib/ In diesem Ordner befinden sich sämtliche TYPO3-Codebibliotheken, die für den Betrieb von TYPO3 essenziell sind. Diese Funktionen bilden das TYPO3-Framework, auf das Sie beispielsweise auch in eigenen Projekten zugreifen können. Da es sich um eine Bibliothek handelt, werden diese PHP-Dateien nie direkt vom Browser aufgerufen. In der Datei config_default.php werden sämtliche Voreinstellungen für die Systemparameter festgelegt. Diese Standardwerte können Sie bequem über das Install-Tool anpassen. Sämtliche Werte, die Sie hierüber festlegen, werden in die Datei localconf.php geschrieben und überschreiben damit automatisch diese Standardwerte. Im Unterordner stddb finden Sie die grundlegende Tabellenkonfiguration, die für den Betrieb von TYPO3 notwendig ist. Diese Minimalkonfiguration wird anschließend über Extensions ausgebaut. Ändern Sie niemals Werte direkt in der Datei config_default.php. Um die Werte anzupassen, sollten Sie das Install-Tool oder eigene Extensions verwenden. Die Werte überschreiben Sie dann entweder über die Datei localconf.php im Ordner typo3conf oder über ext_localconf.php-Dateien in den Extension-Ordnern. t3lib/interfaces/ In diesem Ordner liegen Interface-Definitionen, die von TYPO3 genutzt werden, um Schnittstellen in der TYPO3-API fest zulegen.

Max. Linie

t3lib/stddb/ In diesem Ordner finden Sie Dateien, in denen die Vorgabewerte für die grundlegenden TYPO3-Tabellen gesetzt werden (daher auch der Name stddb für standard database). Dazu gehören beispielsweise die Standardwerte für Seitentypen, Backend-Farben sowie Feldbeschriftungen und die wichtigsten Inhalte für die Kontexthilfe. Ändern Sie diese Voreinstellungen niemals direkt in diesen Dateien, sondern verwenden Sie dazu Extensions. Die Werte der Datei tables.php überschreiben Sie über ext_tables. php-Dateien, die Sie in den Extension-Ordnern anlegen. In diesem Kochbuch finden Sie zahlreiche Anwendungsbeispiele dazu, wie Sie diese Methode effektiv einsetzen. In den Kapiteln 15, 16 und 17 erfahren Sie mehr über Extensions Rezept 6.7 zeigt beispielsweise, wie Sie Eingabeformulare im Backend anpassen können.

12 | Kapitel 1: Installation und Konfiguration This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

typo3/ In diesem Ordner sind sämtliche Dateien abgelegt, die für Darstellung und Funktionen des TYPO3-Backends zuständig sind. Wenn Sie diesen Ordner über die Adresszeile in Ihrem Browser ansprechen, erreichen Sie das Backend Ihrer TYPO3Installation und können Ihre Website bearbeiten und verwalten. In Rezept 3.4 erfahren Sie, wie Sie diesen Ordner gegen Fremdzugriffe absichern oder umbenennen können. typo3/classes/ Der Ordner enthält Klassen, die Kernfunktionen im Backend bereitstellen, wie zum Beispiel die seitenübergreifende Suche oder das Menü zum Leeren der unterschiedlichen Caches. typo3/contrib/ In diesem Ordner werden Softwarebibliotheken von Drittanbietern abgelegt. typo3/css/ In diesem Ordner werden separate modulare CSS-Dateien verwaltet, die für die Darstellung des Backends verantwortlich sind.

Lizensiert für Markus Mueller

typo3/ext/ In diesem Ordner legen Sie global verfügbare Extensions ab. Global verfügbar bedeutet, dass diese Extensions für sämtliche TYPO3-Installationen zur Verfügung stehen, die diesen TYPO3-Kern verwenden. Dieses Verzeichnis muss existent sein, auch wenn keine globalen Extensions vorhanden sind. Außerdem muss der Webserver in dieses Verzeichnis schreiben können, wenn Sie globale Extensions installieren möchten. typo3/gfx/ In diesem Ordner finden Sie alle Grafiken, die im TYPO3-Backend verwendet werden. Manche davon werden auch im Frontend benutzt, beispielsweise wenn Sie Seiteninhalte im Frontend bearbeiten (in Rezept 4.7 erfahren Sie mehr über diese Bearbeitungsmöglichkeit). typo3/install/ In diesem Ordner befindet sich die Installationsroutine von TYPO3. Wenn Sie das TYPO3-Backend zum ersten Mal aufrufen, werden Sie automatisch zu diesem Ordner geführt, um Ihre TYPO3-Installation einzurichten. In Rezept 1.2 erfahren Sie mehr über die grundlegenden Installationsschritte. Haben Sie die Installation abgeschlossen, sollten Sie diesen Ordner entfernen oder zumindest gegen Fremdzugriff schützen, indem Sie die Datei ENABLE-INSTALL-TOOL aus dem Verzeichnis typo3conf/ entfernen. typo3/interfaces/ In diesem Ordner liegen Interface-Definitionen, die dazu genutzt werden, Schnittstellen im TYPO3-Backend zu vereinheitlichen.

Max. Linie

Max. Linie 1.4 Die Ordnerstruktur verstehen | 13 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

typo3/js/ Dieser Ordner dient der Speicherung von JavaScript-Dateien, die für Benutzeraktionen im Backend verantwortlich sind.

Links

typo3/sysext/cms/tslib/ In diesem Ordner finden Sie Dateien, die für die Darstellung der Inhalte auf den einzelnen Webseiten sorgen, daher erwähnen wir diese Extension explizit. Sie bildet die Grundlage für die CMS-Eigenschaften von TYPO3 sowie für die TypoScript-Implementierung. Beispielsweise werden in der Datei class.tslib_content.php sämtliche Inhaltsobjekte definiert, die Sie über TypoScript verwenden können. Die Kapitel 8-14 befassen sich eingehend mit den Möglichkeiten von TypoScript. typo3/templates/ In diesem Ordner finden Sie HTML-Templates, die für die Darstellung des TYPO3Backends eingesetzt werden.

Lizensiert für Markus Mueller

typo3conf/ In diesem Ordner liegen Konfigurationsdateien, über die Sie Einstellungen für die lokale TYPO3-Installation vornehmen können. Außerdem speichert TYPO3 in diesem Ordner standardmäßig die Konfiguration aller aktiven Extensions in CacheDateien. Diese Cache-Dateien beginnen mit dem Präfix temp_CACHED_. In der Datei localconf.php speichert TYPO3 sämtliche Einstellungen, die Sie über das InstallTool vornehmen, wie etwa das Passwort für das Install-Tool, die Zugangsdaten für die Datenbank oder die Liste der momentan aktiven Extensions. Über die Datei extTables.php können Sie zusätzliche Einstellungen an den tables.php-Werten vornehmen. Wir empfehlen die Verwendung dieser Datei nur sehr erfahrenen Benutzern und ziehen hier im TYPO3 Kochbuch Anpassungen von tables.php-Inhalten über eigene Extensions vor. Der Webserver muss dieses Verzeichnis sowie die Datei localconf.php beschreiben können, da TYPO3 sonst keine Cache-Dateien anlegen kann und Konfigurationseinstellungen nicht in der Datei localconf.php verwaltet werden können. typo3conf/ext/ In diesem Ordner finden Sie sämtliche lokalen Extensions. Diese Extensions sind ausschließlich für die jeweilige TYPO3-Installation gültig und stehen nicht – wie beispielsweise globale oder System-Extensions – für weitere Installationen zur Verfügung (in Kapitel 15 erfahren Sie mehr über die unterschiedlichen Extension-Typen). Dieser Ordner muss vom Webserver beschrieben werden können, damit es möglich ist, lokale Extensions zu installieren.

Max. Linie

typo3conf/l10n/ In diesem Ordner befinden sich die jeweiligen Sprachdateien für die Übersetzungen der TYPO3-Oberfläche. Dabei enthält dieser Ordner, je nachdem, welche Sprachpakete Sie installiert haben, weitere Unterordner, die wiederum – abhängig von den installierten Extensions – in unterschiedliche Ordner gegliedert sind. Der Ordnername l10n steht für den englischen Begriff »localization« (die 10 Zeichen zwischen l und n werden dabei der Einfachheit halber durch die 10 ersetzt). Dieser Ordner muss

14 | Kapitel 1: Installation und Konfiguration This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

vom Webserver beschrieben werden können, wenn Sie lokale Sprachpakete installieren möchten. typo3temp/ In diesem Ordner finden Sie temporäre Dateien, die von TYPO3 erzeugt werden, um Daten zwischenzuspeichern. Dies können beispielsweise Bilddateien sein, die TYPO3 für grafische Menüs oder Bildverkleinerungen erzeugt. Da der Ordner im Laufe der Zeit sehr umfangreich wird, sollten Sie daraus in regelmäßigen Abständen nicht benötigte Dateien entfernen (Rezept 2.6 beschreibt Funktionen, die Ihnen diese Arbeit erleichtern). Dieser Ordner muss vom Webserver beschrieben werden können, damit TYPO3 diese temporären Dateien anlegen kann.

Lizensiert für Markus Mueller

uploads/ In diesem Ordner befinden sich Dateien, die über das Backend mit Inhaltselementen verknüpft wurden. Der Hintergrund hierfür ist folgender: TYPO3 kopiert standardmäßig jede Datei, die mit einem Inhaltselement verknüpft wird, in diesen Ordner (oder einen entsprechenden Unterordner). Ist die Datei dort schon vorhanden – etwa, weil sie bereits mit einem anderen Inhaltselement verknüpft wurde –, fügt TYPO3 dem Dateinamen einen fortlaufenden Zahlenwert an. Außerdem legt TYPO3 in der Datenbanktabelle eine entsprechende Verknüpfung zu dieser eindeutigen Datei ab. So ist sichergestellt, dass die Datei stets eindeutig zugeordnet werden kann und der Inhalt auf der Website auch dann vollständig erhalten bleibt, wenn die ursprüngliche Datei gelöscht wird. Zusätzlich ordnet TYPO3 diese Dateien je nach Verwendung in weitere Unterordner. So finden Sie beispielsweise Bilder im Unterordner pics. PDF-Dokumente und Multimedia-Dateien speichert TYPO3 im Ordner media. Dateien, die mit Datensätzen von Extensions verknüpft sind, werden wiederum in Ordnern gespeichert, deren Namen sich aus einem tx_ sowie dem Extension-Key zusammensetzen. Der Ordner uploads/ muss samt Unterordnern vom Webserver beschrieben werden können, damit die Dateien mit den Inhaltselementen verknüpft werden können. Im Wurzelverzeichnis liegen noch folgende Dateien: /_.htaccess In dieser Datei finden Sie eine vollständig kommentierte Vorlage für eine individuelle .htaccess-Datei, mit der Sie für die jeweilige TYPO3-Installation Einstellungen am Apache-Webserver vornehmen können. Die Vorgaben dienen als Orientierung für die gebräuchlichsten Einstellungen am Apache-Webserver und können je nach Anforderungen angepasst und erweitert werden. Um die Datei zu verwenden, müssen Sie den Unterstrich vor dem Dateinamen entfernen. /clear.gif Eine 1 x 1 Pixel große, transparente GIF-Grafik, die – mehr aus historischen Gründen – vor allem im Backend und im Admin-Panel für die Positionierung oder Darstellung von Eingabeformularen verwendet wird.

Max. Linie

Max. Linie 1.4 Die Ordnerstruktur verstehen | 15 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

/index.php Diese Datei bindet die zentrale Datei index_ts.php der System-Extension cms ein und wird bei jedem Seitenaufruf im Frontend verarbeitet. In der Datei index_ts.php werden zentrale Prozesse für die Erstellung der Webseite koordiniert und Seiteninhalte gemäß der jeweiligen TypoScript-Anweisungen ausgegeben. Sie spielt daher in der Darstellung der Website eine entscheidende Rolle. Die ursprüngliche Quelldatei finden Sie im Ordner typo3/sysext/cms/tslib/.

Links

Zusätzlich können noch weitere Dateien vorhanden sein, die für das Verständnis der Ordnerstruktur nicht entscheidend sind, jedoch nützliche Hintergrundinformationen über das TYPO3-Projekt oder die verwendete TYPO3-Version liefern und erste Schritte erläutern: ChangeLog In dieser Datei werden von sämtlichen Kernentwicklern die Änderungen am Programmcode protokolliert. Wenn Sie erfahren möchten, was sich zwischen zwei Versionen geändert hat, sollten Sie einen Blick in diese Datei werfen. GPL.txt Diese Datei enthält eine vollständige Kopie der GNU GENERAL PUBLIC-Lizenz, unter der TYPO3 vertrieben wird. Lizensiert für Markus Mueller

INSTALL.txt Diese Datei beschreibt erste Installationsschritte. Tiefer gehende Details zur Installation können Sie Rezept 1.2 entnehmen. LICENSE.txt Diese Datei enthält weitere Anmerkungen über die Lizenzbestimmungen von TYPO3. Details zu diesen Bestimmungen erfahren Sie auch auf der Webseite http://typo3.com/ License.1316.0.html. NEWS.txt Diese Datei erläutert Änderungen und Verbesserungen im Programmcode, gegliedert in Kategorien wie Backend, TypoScript oder wichtige Bugfixes. README.txt Diese Datei liefert viele allgemeine Hintergrundinformationen zu TYPO3. RELEASE_NOTES.txt Diese Datei liefert Anmerkungen und Hinweise zur aktuellen Version. Wenn Sie ein Update auf eine neue Version planen, sollten Sie vorab die Release-Notes lesen, um sich über die Neuerungen dieser Version einen Überblick zu verschaffen. Alle ReleaseNotes werden im TYPO3-Wiki gespeichert. Unter dieser Adresse finden Sie eine Liste aller Release-Notes: http://wiki.typo3.org/Category:ReleaseNotes.

Max. Linie

TODO.txt Diese Datei dient den Entwicklern als Notizblock für offene Punkte. Lesen Sie Rezept 20.2, um zu erfahren, wie Sie mithelfen können, diese Liste zu verkleinern.

16 | Kapitel 1: Installation und Konfiguration This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Siehe auch In Rezept 3.4 wird erläutert, wie Sie den Ordner typo3/ umbenennen können. In Rezept 2.5 erfahren Sie mehr über die Datenbankstruktur von TYPO3. Weiterführende Informationen zu Interfaces finden Sie im PHP-Handbuch unter der Adresse http://www. php.net/manual/de/language.oop5.interfaces.php.

1.5

Systemparameter ermitteln und verstehen

Problem Sie möchten die aktuellen TYPO3-Einstellungen einsehen oder suchen eine Möglichkeit, die passenden Optionen zu finden, beispielsweise um einen bestimmten Systemparameter anzupassen.

Lösung Lizensiert für Markus Mueller

Wechseln Sie in das Modul Konfiguration im Bereich Admin-Werkzeuge. Dort erhalten Sie Einblick in sämtliche Wert der aktuellen Systemvariablen, mit denen TYPO3 momentan arbeitet. Über den Baum können Sie komfortabel alle Wertepaare einsehen. Klicken Sie auf einen Wert, erscheint ein Feld, aus dem Sie die entsprechende Variable samt Wert kopieren können. Diesen Wert können Sie wiederum in eigenen Extensions anpassen. Entscheiden Sie nun über die Auswahlliste, welchen Variablenbereich Sie über die Baumstruktur einsehen wollen. $TYPO3_CONF_VARS Im Array $TYPO3_CONF_VARS werden alle grundlegenden TYPO3-Einstellungen gespeichert. Dazu zählen Installationsoptionen und Extension-Parameter. In der Diskussion dieses Rezepts werden die einzelnen Unterbereiche dieses Arrays tiefer gehend beleuchtet. Die Werte innerhalb von $TYPO3_CONF_VARS können Sie über eigene Extensions in der Datei ext_localconf.php anpassen. $TCA (tables.php) Im Bereich $TCA (tables.php) finden Sie sämtliche Informationen über das Table Configuration Array, in dem TYPO3 Informationen über die vorhandenen Datenbanktabellen und deren Felder speichert. Das TCA spielt außerdem eine zentrale Rolle im Zusammenspiel von Datenbanken mit der Eingabemaske (Näheres über die einzelnen TCA-Eigenschaften erfahren Sie in Rezept 16.3). Werte im TCA können Sie über eigene Extensions in der Datei ext_tables.php anpassen.

Max. Linie

$TYPO3_LOADED_EXT $TYPO3_LOADED_EXT zeigt eine Übersicht der momentan aktiven Extensions. Wenn Sie die Einträge mit dem Pluszeichen öffnen, erhalten Sie weitere Informationen, und zwar zum Extension-Typ, den Pfadangaben und den Pfaden zu den relevanten Dateien der Extension, wie etwa ext_tables.php, ext_tables.sql und ext_localconf.php.

1.5 Systemparameter ermitteln und verstehen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 17

Max. Linie

$TBE_STYLES Im Array $TBE_STYLES speichert TYPO3 sämtliche Angaben, die das Erscheinungsbild des Backends beeinflussen (der Variablenname liest sich daher auch TYPO3 Backend-Styles). Indem Sie diese Werte anpassen, beeinflussen Sie die Darstellung und können beispielsweise eine völlig neue Farbumgebung schaffen.

Links

Wenn Sie sich mit dem grundlegenden Aufbau der hier aufgeführten Arrays vertraut machen, können Sie über dieses Modul sehr schnell Werte ermitteln, die Sie dann über eigene Extensions anpassen.

Diskussion Bevor Sie Änderungen an den oben genannten TYPO3-Einstellungen vornehmen, sollten Sie genau wissen, was Sie tun. Die folgende Übersicht zeigt die Anwendungsbereiche mit Schwerpunkt auf der Extension-Entwicklung. Sie soll Ihnen helfen, sich schneller innerhalb der umfangreichen Einstellungsmöglichkeiten zurechtzufinden. Vor allem die Bereiche $TYPO3_CONF_VARS und $TCA (tables.php) spielen bei der Extension-Entwicklung eine entscheidende Rolle und werden daher im Folgenden genauer beleuchtet.

$TYPO3_CONF_VARS Lizensiert für Markus Mueller

Wie der Name schon andeutet, speichert dieses Array sämtliche Konfigurationsvariablen von TYPO3. Wenn Sie mit den Installationsoptionen aus Rezept 1.6 schon vertraut sind, werden Sie feststellen, dass die Einstellungen, die Sie im Install-Tool oder über Extensions vornehmen, hier übersichtlich als Baum dargestellt werden. Die Unterbereiche von $TYPO3_CONF_VARS haben dabei folgende Bedeutung: GFX Einstellungen für die grafischen Bearbeitungsfunktionen. SYS Grundlegende Systemeinstellungen, die sowohl das Backend als auch das Frontend betreffen. EXT Einstellungen für den Umgang mit Extensions, die sowohl das Backend als auch – indirekt – das Frontend betreffen. BE Backend-Einstellungen. FE Frontend-Einstellungen.

Max. Linie

MODS Hier wurden früher Einstellungen für Backend-Module gespeichert. Dieses Vorgehen ist veraltet, da diese Einstellungen nun in den Backend-Modulen selbst vorgenommen werden. Dieser Punkt wird daher nur der Vollständigkeit halber erwähnt.

18 | Kapitel 1: Installation und Konfiguration This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

USER Hier wurden früher Parameter für eingebundene PHP-Skripten gespeichert. Dieses Vorgehen wird seit der Version 3.5 durch den Extension-Mechanismus ersetzt, dieser Punkt wird daher nur der Vollständigkeit halber erwähnt. In Rezept 18.1 erfahren Sie, wie Sie diesen Mechanismus effektiv nutzen und TypoScript als zentralen Konfigurationsmechanismus in eigenen Extensions verwenden können. SC_OPTIONS Script-Class-Optionen, über die TYPO3 die Verwendung von sogenannten Hooks verwaltet. EXTCONF Extension-Parameter, mit denen Sie Eigenschaften in Ihren Extensions beeinflussen können (in Rezept 17.14 erfahren Sie mehr über diese Möglichkeiten). SVCONF Parameter, mit denen TYPO3-Services gesteuert und konfiguriert werden.

Lizensiert für Markus Mueller

Mit den Pluszeichen öffnen und schließen Sie die jeweiligen Unterbereiche des Arrays. Wenn Sie einen Wert anklicken, öffnen Sie am Seitenanfang ein Textfeld, das die entsprechende Variable samt Wert ausgibt. Den Feldinhalt können Sie nun ausschneiden und beispielsweise in Ihrer Extension verwenden. Dadurch, dass TYPO3 automatisch die richtige Array-Struktur zu dem gewünschten Wert mit angibt, stellen Sie sicher, dass Sie den Wert eindeutig adressieren und problemlos in eigenen Skripten verwenden können. Achten Sie darauf, dass Sie die Werte in die Datei localconf.php oder ext_localconf.php einfügen, um sie zu verwenden. Beispielsweise können Sie über die Konfigurationseinstellungen den Cache für ExtensionEinstellungen deaktivieren. Besonders beim Entwickeln von Extensions können Sie so viel Zeit sparen, da Änderungen am Code umgehend ausgegeben werden (ansonsten müssten Sie nach jeder Codeänderung die den Konfiguratons-Cache manuell löschen). Stellen Sie sicher, dass Sie in der Menüauswahl die Option $TYPO3_CONF_VARS aktiviert haben. Öffnen Sie dann über das Plussymbol den Bereich EXT. Dort finden Sie nun sämtliche Einstellungen für die Extension-Verwaltung. Klicken Sie hier auf den Wert extCache, um sich die aktuelle Einstellung in dem Textfeld anzusehen. Standardmäßig zeigt dieses Feld $TYPO3_CONF_VARS['EXT']['extCache'] = 1;, was bedeutet, dass der Extension-Cache aktiviert ist. Kopieren Sie diesen Wert aus dem Textfeld in die Zwischenablage und öffnen Sie die Datei localconf.php. Fügen Sie den Wert nun unterhalb der bestehenden Konfigurationsparameter in einer neuen Zeile an und ändern Sie die 1 zu einer 0, um den Cache zu deaktivieren. Am Dateiende steht nun folgende Zeile, mit der Sie die Standardeinstellung überschreiben: $TYPO3_CONF_VARS['EXT']['extCache'] = 0;

Max. Linie

Wenn Sie das Modul Konfiguration neu laden, werden Sie sehen, dass der neue Wert nun auch hier angezeigt wird. Achten Sie darauf, dass Sie diese Einstellung wieder rückgängig machen, wenn Sie Ihre Website veröffentlichen, da Ihre Extension-Einstellungen ansonsten von TYPO3 nicht gecacht werden, was sich negativ auf die Serverperformance auswirkt.

1.5 Systemparameter ermitteln und verstehen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 19

Max. Linie

Links Um den jeweiligen Parameter besser zu verstehen, hat sich folgender Weg bewährt: Notieren Sie sich den Parameter, über den Sie mehr erfahren möchten. Wechseln Sie danach in das Install-Tool und wählen Sie dort den Menüpunkt All Configuration. Suchen Sie hier nach dem Parameter. Dieser wird in eckigen Klammern aufgeführt und ist in der Regel mit einer sehr ausführlichen Erklärung versehen. Nachdem Sie die Einstellungsmöglichkeiten kennen, können Sie den Parameter entsprechend anpassen.

$TCA (tables.php) Die Abkürzung $TCA steht für Table Configuration Array. In diesem Array speichert TYPO3 sämtliche Einstellungen für die in TYPO3 verwendeten Datenbanktabellen. Der geklammerte Dateiname tables.php symbolisiert, dass in diesem Array sämtliche Informationen aus der Datei tables.php gesammelt werden.

Lizensiert für Markus Mueller

Dabei hat dieser Dateiname eher einen symbolischen Charakter, denn TYPO3 erstellt das endgültige TCA über mehrere Schritte: Zuerst wird die Standardkonfiguration in der Datei t3lib/stddb/tables.php festgelegt. Dort werden grundlegende Tabelleneinstellungen vorgenommen. Zusätzlich werden auch noch andere Werte initialisiert, die für die Verwendung von TYPO3 unbedingt notwendig sind, jedoch keinen Einfluss auf das TCA haben. Über Extensions wird diese Grundkonfiguration dann weiter ausgebaut. TYPO3 liest nach der Initialisierung zuerst die Informationen der aktiven System-Extensions aus. Daraufhin werden die globalen Extensions und am Ende die lokalen Extensions berücksichtigt. Innerhalb der Extensions wird die Tabellenstruktur automatisch durch die jeweilige Datei ext_tables.php erweitert, sofern diese vorhanden ist. Anhand des Dateinamens erkennt TYPO3 diese Dateien und sammelt sie nacheinander zu einer großen tables.php-Datei, in der letztendlich die vollständigen Tabelleninformationen aller in TYPO3 verwendeten Tabellen gespeichert sind. In Wirklichkeit setzt sich diese Datei also aus der ursprünglichen tables.php im Ordner t3lib/stddb/ und sämtlichen ext_tables.php-Dateien der aktiven Extensions zusammen. Im Modul Konfiguration werden die Tabellen der relevanten Extensions als erste Baumebene dargestellt. Wenn Sie diese Tabellen mit der eigentlichen Datenbankstruktur vergleichen, werden Sie feststellen, dass einige Tabellen hier ausgeblendet sind. Bei diesen Tabellen handelt es sich um Systemtabellen, die TYPO3 ausschließlich für interne Prozesse benötigt und die daher über keine TCA-Eigenschaften verfügen.

Max. Linie

Tabellen müssen im TCA registriert sein, damit Sie beispielsweise deren Datensätze über Backend-Eingabeformulare pflegen können. Erst durch die TCA-Informationen kann TYPO3 die Backend-Formulare erzeugen. Außerdem wird im TCA auch gespeichert, wie sich die Datenbanktabelle im Backend verhalten soll. All diese Tabelleninformationen können Sie einsehen, wenn Sie auf das Pluszeichen einer Tabelle klicken. Unterhalb des Tabellennamens werden dann die einzelnen Unterbereiche aufgelistet, die alle einem

20 | Kapitel 1: Installation und Konfiguration This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Muster folgen und einen ganz bestimmten Sinn und Zweck haben. Die folgende Übersicht gibt Ihnen einen groben Überblick darüber. In Rezept 16.3 erfahren Sie mehr über den Aufbau des TCA, dessen Einstellungsmöglichkeiten und wie Sie eigene Tabellen in TYPO3 integrieren und dabei automatisch die entsprechenden TCA-Informationen anlegen. ctrl Legt die grundlegende Tabellendarstellung im Backend fest und wie die jeweiligen Datensätze von der TCE (der TYPO3 Core Engine) behandelt werden. interface Legt die Darstellung der einzelnen Datensätze im Backend fest. feInterface Legt die Felder fest, die über das Frontend angepasst werden können. columns Speichert sämtliche Einstellungen der Datenbankfelder für die Formulardarstellung im Backend. types Speichert die Feldkonfigurationen der einzelnen Datentypen.

Lizensiert für Markus Mueller

palettes Speichert die Feldkonfigurationen der zweiten Optionspalette. Die hier gezeigten Einstellungsmöglichkeiten sind sehr flexibel erweiterbar – in vielen Rezepten dieses Kochbuchs finden Sie Beispiele, in denen Sie die Grundeinstellungen über eigene Extensions anpassen. Bei der Extension-Erstellung werden Sie erfahrungsgemäß immer wieder auf diese Parameter zurückgreifen. Mit dem Modul Konfiguration haben Sie ein nützliches Tool an der Hand, das Ihnen bei der Suche nach dem richtigen Parameter sehr schnell weiterhelfen kann. Wenn Sie sich mit dieser Struktur vertraut machen, finden Sie die nötigen Parameter in kürzester Zeit. Beachten Sie, dass alle Werte aus der Datei localconf.php auch durch Extensions überschrieben werden können. Falls Ihre Einstellung einmal nicht übernommen wird, sollten Sie kontrollieren, ob eine andere Extension diese Einstellung überschreibt. Dafür ist es hilfreich zu wissen, dass Extensions in der Reihenfolge abgearbeitet werden, in der sie im Wert von $TYPO3_CONF_VARS ['EXT']['extList'] angegeben sind. Bevor Sie eine Extension installieren, sollten Sie daher stets prüfen, ob diese Systemparameter oder TCA-Angaben ändert, und stellen Sie dann sicher, dass Ihre Extension am Ende der Liste aufgeführt wird, damit diese Einstellung dann von Ihnen wieder überschrieben werden kann.

Siehe auch

Max. Linie

In Kapitel 16 erfahren Sie, wie Sie TYPO3 über Extensions an eigene Bedürfnisse anpassen können. Das Rezept 16.3 geht in der Diskussion detailliert auf die einzelnen Bereiche des TCA ein.

1.5 Systemparameter ermitteln und verstehen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 21

Max. Linie

1.6

Systemparameter anpassen

Links

Problem Sie möchten nachträglich Änderungen an den Grundeinstellungen von TYPO3 vornehmen, um so beispielsweise bestimmte Funktionen zu aktivieren oder individuell zu konfigurieren.

Lösung Ändern Sie die Systemparameter über das Modul Installation im Bereich Admin-Werkzeuge. Dieses Modul wird auch allgemein als Install-Tool bezeichnet. Dort können Sie Systemeinstellungen und die Zugangsdaten für die Datenbank anpassen. Außerdem stehen Ihnen nützliche Datenbankoperationen und Bearbeitungsfunktionen für Systemdateien zur Verfügung. Das Install-Tool läuft dabei völlig unabhängig von Ihrer eigentlichen TYPO3-Installation als eigenständige Applikation und kann dadurch auch direkt über die URL http://www.example.com/typo3/install/ aufgerufen werden.

Lizensiert für Markus Mueller

Wenn TYPO3 nicht auf dem lokalen Rechner installiert ist, müssen Sie zunächst noch im Verzeichnis typo3conf eine leere Datei mit der Bezeichnung ENABLE_INSTALL_TOOL anlegen. Dies ist eine zusätzliche Sicherheitsmaßnahme, um unberechtigte Zugriffe zu verhindern. Nach einer erfolgten Installation wird empfohlen, die Datei wieder zu löschen.

Bestätigen Sie den nun folgenden Hinweis und geben Sie das Passwort für den Zugang zum Install-Tool ein. Für diesen Zugang benötigen Sie besondere Rechte bzw. ein separates Passwort, das sich vom Administratorpasswort unterscheiden sollte (standardmäßig ist das Passwort joh316 voreingestellt). Je nachdem, welche Einstellungen Sie nun ändern möchten, wählen Sie über einen entsprechenden Menüeintrag den gewünschten Bereich. Diese Bereiche sind wie folgt aufgeteilt: Basic Configuration Hier können Sie die Zugriffsrechte des Webservers auf die wesentlichen Ordner kontrollieren oder Zugangsdaten für den Datenbankserver einrichten. Außerdem finden Sie hier Einstellungsmöglichkeiten für die Grafikfunktionen von TYPO3. Falls Sie hier ein gelbes Warndreieck oder ein rotes Stoppzeichen sehen, lesen Sie bitte die Lösung von Rezept 1.10. Dort werden diese Zeichen erklärt. Database Analyzer Hier kann die Datenbankstruktur überprüft werden (in Rezept 2.5 erfahren Sie Näheres zu diesem Menüpunkt).

Max. Linie

Update Wizard Ab Version 4.0 können ältere TYPO3-Versionen mit dem sogenannten Kompatibilitätsmodus simuliert werden (dieser Modus wird in Rezept 2.3 näher erläutert).

22 | Kapitel 1: Installation und Konfiguration This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Ebenso werden hier Update-Prozesse aufgelistet, die für die jeweilige TYPO3-Version notwendig sind, zum Beispiel Aktualisierungen der Datenbankinhalte. Image Processing Bildbearbeitungsfunktionen von TYPO3 testen. All configuration Diese Einstellungen repräsentieren die eigentlichen Installationsoptionen. Hier finden Sie sämtliche Einstellungsmöglichkeiten für TYPO3 (dort können Sie zum Beispiel individuelle Fehlerseiten festlegen oder das Cache-System beeinflussen). typo3temp/ Temporäre Dateien kontrollieren oder löschen. Clean up database Funktionen, um bestimmte Systemtabellen zu leeren. phpinfo() Allgemeine Informationen über Ihre TYPO3-Installation. Edit files in typo3conf/ Bearbeitungsmöglichkeiten für Dateien im Ordner typo3conf/.

Lizensiert für Markus Mueller

About Allgemeine Erklärungen zum Install-Tool. Außerdem können Sie hier das Passwort für den Zugang zum Install-Tool ändern. Um Zugriff auf alle Installationseinstellungen zu haben, wählen Sie nun den Eintrag All configuration. Dort finden Sie zahlreiche Einstellungsmöglichkeiten, die wiederum je nach Funktionsbereich in einzelne Abschnitte aufgeteilt sind. Im Abschnitt GFX (gesprochen Graphics) nehmen Sie beispielsweise Einfluss auf die grafischen Bearbeitungsfunktionen von TYPO3. Im Abschnitt FE finden Sie Einstellungen, die hauptsächlich die Darstellung der Website im Frontend betreffen. Wenn Sie Ihre Änderungen über den Button Write to localconf.php bestätigen, werden die Einstellungen in die Datei localconf.php geschrieben. Diese Datei liegt standardmäßig im Ordner typo3conf/. Sämtliche Parameter, die Sie über das Install-Tool einstellen, werden dort gespeichert. Nachdem Sie Ihre Änderungen durchgeführt haben, sollten Sie das InstallTool wieder deaktivieren. Es sollte nicht aktiv sein, wenn Ihre TYPO3-Installation öffentlich erreichbar ist.

Diskussion

Max. Linie

Die Standardeinstellungen werden von TYPO3 vorgegeben und entsprechen den allgemein gültigen Werten, die sich bei der Verwendung von TYPO3 bewährt haben. Diese Standardwerte werden in der Datei t3lib/config_default.php voreingestellt und können alle von eigenen Angaben in der Datei localconf.php überlagert werden. Da TYPO3 diese beiden Dateien nacheinander verarbeitet, werden die Standardwerte aus der Datei t3lib/config_

1.6 Systemparameter anpassen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 23

Max. Linie

default.php mit den Einstellungen in der Datei localconf.php überschrieben. Die Standardeinstellungen sollten Sie daher unberührt lassen und immer über die Installationsoptionen anpassen.

Links

Wenn Sie Installationsoptionen über das Install-Tool anpassen, werden die neuen Werte immer am Dateiende angefügt. Bestehende Optionen werden überschrieben und nicht neu eingefügt. Sämtliche Installationsoptionen werden dabei im Array $TYPO3_CONF_VARS gespeichert. Wie der Name schon verdeutlicht, speichert dieses Array sämtliche TYPO3Konfigurationsvariablen. Es ist nochmals in einzelne Bereiche aufgeteilt, deren Verwendung in Rezept 1.5 besprochen wird. Dadurch, dass Sie im Laufe der Zeit mit diesem Prinzip vertraut werden, können Sie die Optionen auch von Hand in die Datei localconf.php einfügen. Achten Sie dann darauf, dass Sie eigene Optionen stets am Dateiende anfügen. Wir empfehlen Ihnen, die neuen Optionen mit einem aussagekräftigen Kommentar zu versehen und dadurch deren Verwendung deutlich zu machen. Vergewissern Sie sich vor dem Abspeichern dieser Datei, dass Sie alle Parameter richtig geschrieben haben und keine PHP-Fehler vorhanden sind. Sie können TYPO3 nicht verwenden, wenn sich ein Parsefehler in diese Datei eingeschlichen hat. Lizensiert für Markus Mueller

Siehe auch In Rezept 1.5 erfahren Sie, wie Sie mit dem Modul Konfiguration die Systemparameter einsehen können. Außerdem zeigt Ihnen dieses Rezept, wie das Array $TYPO3_CONF_VARS genau aufgebaut ist und wie Sie dessen Werte auch über eigene Extensions beeinflussen können. In den Rezepten von Kapitel 5, 6 und 7 finden Sie zahlreiche Beispiele dafür, wie Sie diese Parameter ändern und so TYPO3 an Ihre Bedürfnisse anpassen können.

1.7

Größere Dateiuploads ermöglichen

Problem Sie möchten größere Dateien hochladen, als es TYPO3 Ihnen momentan erlaubt.

Lösung

Max. Linie

Die maximale Größe für Dateiuploads wird in TYPO3 durch eine Vielzahl von Faktoren beeinflusst. Je nachdem, wo Sie Dateien hochladen möchten, gibt es unterschiedliche Stellen, an denen Sie diese Einstellung anpassen müssen. Dabei ist zum einen die maximal erlaubte Dateigröße für das jeweilige Dateifeld wichtig, zum anderen spielen die Grundeinstellungen von TYPO3 und PHP eine Rolle. Prüfen Sie zuerst Ihre PHP-Einstellungen, bevor Sie Änderungen an TYPO3 vornehmen.

24 | Kapitel 1: Installation und Konfiguration This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Diese Einstellungen können Sie über das Modul Installation kontrollieren. Wählen Sie dort den Menüeintrag Basic Configuration und anschließend php.ini configuration checked. Ist Ihre Einstellung zu klein, deutet TYPO3 mit der Frage Max Upload filesize too small? auf diesen Punkt hin. Erhöhen Sie daraufhin den entsprechenden Wert upload_ max_filesize in der Konfigurationsdatei php.ini von PHP auf einen ausreichend hohen Wert: upload_max_filesize = 20M

Kontrollieren Sie zusätzlich die Einstellungen für Max Execution Time. Bei langsamen Verbindungen kann die maximale Ausführungszeit eines Skripts auch überschritten werden. Diesen Wert können Sie mit der PHP-Option max_execution_time heraufsetzen. max_execution_time = 120

Starten Sie anschließend den Webserver neu. Wenn diese Einstellungen noch nicht ausreichend sind, können Sie sie in TYPO3 anpassen.

Lizensiert für Markus Mueller

Die globalen Voreinstellungen für TYPO3 kontrollieren Sie über das Modul Installation. Wählen Sie dort den Menüeintrag All Configuration und suchen Sie nach dem Begriff maxFileSize. Mit diesem Wert legen Sie die maximale Dateigröße in KByte fest, die TYPO3 bei sämtlichen Dateioperationen, wie etwa Kopieren, Verschieben oder Hochladen, erlaubt. Der Standardwert beträgt 10000, was 10 MByte entspricht. Geben Sie nun Ihren gewünschten Wert ein. Ein ausreichender Wert könnte 20000 sein, was 20 MByte entspricht. Speichern Sie Ihre Eingabe mit dem Button Write to localconf.php am Seitenende, um die Änderung zu übernehmen. Alternativ dazu können Sie folgenden Wert auch direkt in die Datei localconf.php schreiben. $TYPO3_CONF_VARS['BE']['maxFileSize'] = '20000';

Ändern Sie nun die Feldeigenschaften der Inhaltselemente. Wenn Sie eine Datei mit einem Inhaltselement verknüpfen möchten, hat dieses Inhaltselement eigene Einschränkungen bezüglich der maximalen Dateigröße. Standardmäßig können Sie Bilder von maximal 1 MByte oder Dateien von 10 MByte verknüpfen. Diese Beschränkung können Sie über die TCA-Einstellungen für das jeweilige Feld anpassen. Analysieren Sie mit dem Modul Konfiguration die TCA-Struktur und legen Sie fest, welche Dateifelder Sie erweitern möchten (in Rezept 1.6 erfahren Sie, wie Sie das Modul nutzen). Eine typische erweiterte Feldkonfiguration können Sie der folgenden Liste entnehmen. Hiermit legen Sie die neue maximale Dateigröße für die Felder auf 20 MByte fest (der Code muss pro Feld in einer Zeile stehen): // Seiten: Dateien $TCA['pages']['columns']['media']['config']['max_size'] = 20*1024; // Seitenübersetzungen: Dateien $TCA['pages_language_overlay']['columns']['media']['config']['max_size'] =

Max. Linie

20*1024;

// Inhaltselemente: Bilder $TCA['tt_content']['columns']['image']['config']['max_size'] = 20*1024;

1.7 Größere Dateiuploads ermöglichen | 25 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Links // Inhaltselemente: Dateiverweise $TCA['tt_content']['columns']['media']['config']['max_size'] = 20*1024; // Inhaltselemente: Multimedia $TCA['tt_content']['columns']['multimedia']['config']['max_size'] = 20*1024; // Frontend-Benutzer: Bilder $TCA['fe_users']['columns']['image']['config']['max_size'] = 20*1024; // TypoScript-Templates: Ressourcen $TCA['sys_template']['columns']['resources']['config']['max_size'] = 20*1024;

Seit der Version 4.1 können Sie die Feldeigenschaften auch per Seiten-TSconfig überschreiben. Die so festgelegten Werte gelten dann für einzelne Seiten bzw. Seitenbäume, während die oben genannten Methoden die Feldeigenschaften für das gesamte Projekt festlegen. Per Seiten-TSconfig können Sie die Parameter dieser Feldtypen beeinflussen. Die Einstellungen im TSconfig-Feld in den Seiteneigenschaften nehmen Sie dann nach diesem Muster vor: TCEFORM.tt_content.feldname.config.max_size = 100240

Für die oben genannten Felder sähe die Konfiguration folgendermaßen aus: Lizensiert für Markus Mueller

TCEFORM.pages.media.config.max_size = 20*1024 TCEFORM.pages_language_overlay.media.config.max_size = 20*1024 TCEFORM.tt_content.image.config.max_size = 20*1024 TCEFORM.tt_content.media.config.max_size = 20*1024 TCEFORM.tt_content.multimedia.config.max_size = 20*1024 TCEFORM.fe_users.image.config.max_size = 20*1024 TCEFORM.sys_template.resources.config.max_size = 20*1024

Danach können Sie auch größere Dateien über das Backend hochladen und verwalten.

Diskussion Beachten Sie, dass die TYPO3-Einstellungen immer von PHP überschrieben werden. Alle Werte sollten daher unterhalb des Maximalwerts sein, den Sie in den PHP-Einstellungen angegeben haben. Gleiches gilt übrigens für Uploads, die über das Frontend getätigt werden. Auch hier greifen die PHP-Einstellungen, jedoch nicht die oben genannten TCA-Modifikationen. Wenn Sie das Inhaltselement Formular verwenden, um Dateiuploads im Frontend zu ermöglichen, können Sie die maximale Größe der Dateien mit dem Wert formmailMaxAttachmentSize beeinflussen. Diesen Wert können Sie über das Install-Tool im Bereich All Configuration oder direkt in der Datei localconf.php anpassen: $TYPO3_CONF_VARS['FE']['formmailMaxAttachmentSize'] = '250000';

Max. Linie

Nach der Umstellung können dann auch größere Dateien mit dem Formular versendet werden.

26 | Kapitel 1: Installation und Konfiguration This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Sie sollten sich darüber bewusst sein, dass das HTTP-Protokoll nicht für große Dateitransfers gedacht ist. Standardmäßig können Sie im Modul Dateiliste Dateien von einer Größe bis 10 MByte hochladen, kopieren und verschieben. Größere Dateien sollten Sie per FTP oder SCP (SecureCopy) hochladen. Zu große Dateiuploads werden nach 10 MByte abgebrochen, und es besteht keine Möglichkeit, angefangene Uploads wieder aufzunehmen. Wenn Sie mit größeren Dateien umgehen müssen, empfehlen wir Ihnen die Verwendung von WebDav. Im TYPO3-Wiki finden Sie eine Anleitung dazu, wie Sie eine WebDav-Ressource in TYPO3 integrieren: http://wiki.typo3.org/Apache2_Typo3_WebDAV.

Siehe auch Weitere Informationen zur PHP-Option upload_max_filesize finden Sie unter der Adresse http://php.net/manual/ini.sect.file-uploads.php. Die Option max_execution_time wird im PHP-Handbuch unter der Adresse http://php.net/manual/info.configuration.php näher beleuchtet. Der WebDav-Standard wird in Wikipedia ausführlich unter dieser Adresse beschrieben: http://de.wikipedia.org/wiki/WebDAV. Weiterführende Informationen zum Inhaltselement Formular finden Sie in Rezept 13.10.

1.8

Mehrere Websites mit TYPO3 verwalten

Lizensiert für Markus Mueller

Problem Sie möchten mehrere Websites mit TYPO3 verwalten, beispielsweise um weitere Subdomains einer Website über ein Backend zu administrieren.

Lösung Legen Sie für jede Domain einen eigenen Datensatz vom Typ Domain an und legen Sie diesen in die gewünschten Seiten im Seitenbaum. Dadurch verknüpfen Sie die Domain mit den jeweiligen Seiten, sodass diese über den Browser aufgerufen werden können. Wechseln Sie dafür zuerst in das TYPO3-Backend und aktivieren Sie das Modul Liste. Klicken Sie anschließend auf die Seite, die der ersten Domain zugewiesen werden soll. Erfahrungsgemäß ist dies die Startseite Ihrer jetzigen Website. Legen Sie dort einen neuen Datensatz vom Typ Domain an. In das Feld Domain geben Sie die gewünschte Adresse ein, unter der die Seite gefunden werden soll. Achten Sie darauf, dass Sie hier die komplette Adresse (inkl. Subdomain) ohne Protokoll eingeben und sämtliche Adressen eindeutig sind. TYPO3 ergänzt mehrfach vorkommende Adressen mit einer Null (www.example.com0).

Max. Linie

Wählen Sie anschließend eine weitere Ursprungsseite Ihrer Website an und wiederholen Sie diesen Schritt. Dadurch ordnen Sie die andere Adresse ebenfalls einer bestimmten Seite zu. Wiederholen Sie diesen Vorgang, bis Sie sämtliche Domains in den Seitenbaum

1.8 Mehrere Websites mit TYPO3 verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 27

Max. Linie

integriert haben. TYPO3 kann nun eindeutig zwischen den vorhandenen Domains unterscheiden und die Anfragen des Browsers auf den entsprechenden Teil des Seitenbaums weiterleiten.

Links

Wenn Sie unter zwei Domains eine Website finden möchten, also sowohl unter der Adresse www.example.net als auch unter der Adresse www.example. org, brauchen Sie diesen Schritt nicht durchzuführen. Dann genügt die Umleitung der Domain auf die gleiche IP-Adresse.

Sie haben damit die Grundvoraussetzung dafür geschaffen, dass Ihre Domains nach der Umstellung der DNS-(Domain Name System)Server von TYPO3 der entsprechenden Website korrekt zugeordnet werden können. Richten Sie nun den DNS-Server so ein, dass der Hostname auf dieselbe IP-Adresse zeigt, auf der Ihre existierende TYPO3-Installation liegt. Anschließend registrieren Sie auf dem Server den neuen virtuellen Host. Dadurch wird die Domain auf das gewünschte Verzeichnis auf dem Server umleitet.

Lizensiert für Markus Mueller

Max. Linie

Hierzu müssen Sie Ihren Webserver entsprechend konfigurieren. Beim Apache-Webserver erfolgt diese Konfiguration normalerweise in der Datei httpd.conf. Das genaue Vorgehen weicht aber je nach Distribution bzw. Betriebssystem stark ab. Die beiden Domains werden dann in einer TYPO3-Installation verwaltet und greifen auf die Dateien einer TYPO3Installation zu. TYPO3 analysiert beim Aufruf der Webseite den Domainnamen und liefert dann die entsprechenden Seiten für diese Domain aus.

Diskussion Mit TYPO3 können Sie beliebig viele Domains über eine Oberfläche verwalten. Die jeweiligen Websites bleiben dabei über das durchgängige Seitenbaumprinzip auch bei zahlreichen Domains leicht administrierbar. Wenn Sie mehrere Domains in einer TYPO3-Installation verwalten, die unterschiedliche Websites repräsentieren, sollten Sie für jede Domain einen eigenen Seitenbaum anlegen. In der Praxis hat sich dafür folgendes Prinzip bewährt: Legen Sie für jede Domain eine eigene Hauptseite an, unter der Sie die weiteren Unterseiten einfügen. Die Hauptseite verknüpfen Sie dann über den Seitentyp Verweis mit der Unterseite. Erst diese Unterseite enthält die eigentlichen Webseiten, die über ein entsprechendes Root-Template die Seiteninhalte im Frontend darstellen. Dadurch bleibt die Seitenstruktur sauber und übersichtlich. Wenn der Seitenbaum mit der Zeit umfangreicher wird, können Sie auch sogenannte temporäre Einstiegspunkte im Seitenbaum definieren. Klicken Sie dazu auf das Seitensymbol einer solchen Hauptseite und aktivieren Sie im Kontextmenü die zweite Optionsebene über Weitere Einstellungen. Wählen Sie dort die Option Als Startpunkt für den Seitenbaum festlegen. TYPO3 zeigt danach nur den Seitenbaum dieser Seite an. Um wieder in die reguläre Ansicht zu wechseln, klicken Sie auf den Link Temporären Einstiegspunkt aufheben.

28 | Kapitel 1: Installation und Konfiguration This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Sämtliche Verlinkungen werden weiterhin über die IDs der Seiten oder Inhaltselemente erzeugt. Auch auf gemeinsame Dateien können Sie über das Modul Dateiliste zugreifen. Jedoch sollten Sie dabei beachten, dass TYPO3 standardmäßig nicht kontrolliert, in welcher Domain diese Seite liegt. So kann es vorkommen, dass bei Verknüpfungen über mehrere Domains hinweg die Domain der aktuellen Website übernommen wird. Da die gewünschte Seite jedoch nicht in den Seiten der aktuellen Domain liegt, führt der Klick auf den Link nicht auf die korrekte Seite. Dieses Phänomen umgehen Sie, indem Sie folgende Option in Ihrem TypoScript-Setup aktivieren: config { typolinkCheckRootline = 1 }

TYPO3 kontrolliert nun für jeden internen Link die dazugehörige Domain. So stellen Sie sicher, dass TYPO3 bei internen Links zusätzlich zu den Sichtbarkeitseinstellungen auch die jeweilige Domain berücksichtigt, in der die Seite liegt. Für die Umsetzung der Links wird dabei der zuerst gefundene Domain-Datensatz ausgewertet. Achten Sie darauf, wenn Sie mehrere Domain-Datensätze für einen Seitenbaum angelegt haben.

Lizensiert für Markus Mueller

Um Verknüpfungen zu internen Seiten zu erstellen, sollten Sie weiterhin ausschließlich die IDs der Datensätze und niemals die absoluten Adressen verwenden. Nur dadurch ist sichergestellt, dass eine Verknüpfung unabhängig von der Position im Seitenbaum hergestellt werden kann. Außerdem kontrolliert TYPO3 automatisch die Sichtbarkeitseinstellungen der Zielseite, sodass die Verknüpfung beispielsweise ausgeblendet wird, wenn die Seite unsichtbar ist oder der aktuelle Benutzer nicht über die nötigen Zugriffsrechte verfügt. Vermeiden Sie unbedingt hardcodierte Verknüpfungen zu internen Seiten. Dies kann zu großen Schwierigkeiten führen, wenn die Seite verschoben oder ausgeblendet wird.

1.9

UTF-8 als Standardzeichensatz verwenden

Problem Sie möchten ein neues TYPO3-Projekt anlegen und für die Datenhaltung und -verarbeitung von vornherein durchgängig UTF-8 als Zeichensatz verwenden. Das ist vor allem dann sinnvoll, wenn Ihre Webseite nicht lateinische Sprachen oder Sonderzeichen – wie das Euro-Symbol – enthält.

Lösung

Max. Linie

Legen Sie die Datenbank für TYPO3 in der MySQL-Konsole oder phpMyAdmin mit dem folgenden SQL-Befehl an:

1.9 UTF-8 als Standardzeichensatz verwenden This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 29

Max. Linie

CREATE DATABASE datenbank_name DEFAULT CHARACTER SET = utf8;

Links

Aktivieren Sie anschließend in TYPO3 UTF-8 als Standardkodierung und sorgen Sie dafür, dass bei der Datenbankverbindung ebenso UTF-8 verwendet wird. Setzen Sie dazu im Install-Tool die Option forceCharset auf utf-8 und die Option setDBinit auf SET NAMES utf8. Sie können diese Eingaben mit folgendem Code auch direkt in der Datei localconf.php vornehmen: $TYPO3_CONF_VARS['BE']['forceCharset'] = 'utf-8'; $TYPO3_CONF_VARS['SYS']['setDBinit'] = 'SET NAMES utf8';

Beachten Sie die unterschiedliche Schreibweise von utf-8 mit und ohne Bindestrich. Der Zeichensatz wird für die TYPO3-Einstellung mit Bindestrich angegeben, im SQL-Befehl hingegen wird der Zeichensatz ohne Bindestrich geschrieben.

Auf diese Weise verwendet TYPO3 UTF-8 als Zeichenkodierung und initialisiert auch die SQL-Verbindung entsprechend automatisch für UTF-8. Damit wird die gesamte Kommunikation mit dem MySQL-Server auf UTF-8 gestellt. Lizensiert für Markus Mueller

Sobald Sie die Datei gespeichert haben, wechseln Sie in das Install-Tool und legen über den Database Analyser die Tabellen für TYPO3 an. Wählen Sie dort die Funktion COMPARE, um die nötigen Tabellen anzulegen. Danach können Sie über das Backend Ihre Inhalte eingeben und auf der Webseite anzeigen lassen. TYPO3 kodiert nun den gesamten Datentransfer vom Speichern der Datensätze bis hin zur Ausgabe der Inhalte im Browser im UTF-8-Zeichensatz. Im Backend und im Frontend werden die Zeichen ab sofort im UTF-8-Zeichensatz angezeigt und verarbeitet. Sämtliche Inhalte, die Sie nun über das Backend eingeben, werden UTF-8-kodiert in der Datenbank abgespeichert.

Diskussion UTF-8 bietet Unterstützung für die verschiedensten internationalen Sprachen und Sonderzeichen. Mit der Zeichenkodierung UTF-8, dem 8-bit Unicode Transformation Format, wird es möglich, kyrillische, griechische und asiatische Inhalte und Sonderzeichen jeglicher Art einheitlich in einer Datenbank oder in einem Dokument zu handhaben, ohne zwischen den Zeichensätzen konvertieren oder Sonderzeichen maskieren zu müssen. Das Einzige, was Sie dafür benötigen, ist eine TYPO3-Version höher als 4.0, mindestens einen MySQL-5.1-Datenbankserver und mindestens PHP 5. Moderne Browser und alle gängigen Betriebssysteme unterstützen UTF-8 auf breiter Front.

Max. Linie

Der MySQL-Server unterstützt Zeichensatzeinstellungen auf verschiedenen Ebenen, wie auf der Verbindung, der Anfrage, dem Ergebnis, der Datenbank, der Tabelle, bis hinunter zu abweichenden Zeichensatzeinstellungen einzelner Felder. Die Konfigurationsmög-

30 | Kapitel 1: Installation und Konfiguration This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

lichkeiten sind sehr komplex, der MySQL-Server nimmt dabei teilweise automatisch selbstständig entsprechende Zeichenkonvertierungen vor. Hierdurch schleichen sich sehr leicht Fehler ein, die nicht sofort sichtbar werden. Beachten Sie, dass alle Datenbankverbindungen zum MySQL-Server von PHP aus immer mit dem LATIN1-Zeichensatz aufgebaut werden. Das PHPMySQL-Modul berücksichtigt dabei auch keinerlei abweichende Einstellungen in den MySQL-Konfigurationsdateien. Aus diesem Grund ist es bei der Verwendung von UTF-8 sehr wichtig, mit der Einstellung setDBinit eine entsprechende Initialisierungssequenz zu verwenden. Sonst wird MySQL möglicherweise die Anfragen und Ergebnisse von und zu TYPO3 zwischen UTF-8 und LATIN1 konvertieren, was innerhalb der TYPO3-Umgebung nicht auffallen wird, aber zu falsch kodierten Zeichen in der Datenbank führt.

Wenn Sie Zugriff auf die MySQL-Konfigurationsdatei haben, gibt es über die Option init-connect noch eine alternative Möglichkeit, einen entsprechenden InitialisierungsString global festzulegen. Dazu sind die folgenden Parameter in der Datei my.conf zu setzen:

Lizensiert für Markus Mueller

[client] default-character-set=utf8 [mysqld] default-character-set=utf8 init-connect=SET NAMES `utf8`

Starten Sie anschließend den MySQL-Server neu. MySQL wird nun bei der Kommunikation immer UTF-8 als Standardkodierung nutzen. Bedenken Sie aber, dass dies wieder Stolperfallen mit sich bringen kann, beispielsweise wenn das TYPO3-Projekt auf einen anderen Server übertragen wird, etwa vom Test- auf den Produktionsserver des Kunden. Dann muss sichergestellt sein, dass die Kodierung auf dem Zielserver exakt so eingestellt ist wie zuvor. Wir empfehlen auch in diesem Fall, die TYPO3-Konfigurationsoption setDBinit beizubehalten, um die Einstellung im Kontext des Projekts zu speichern. Das hilft, Problemen bei einem späteren Umzug von vornherein aus dem Weg zu gehen.

Max. Linie

Sobald Sie die oben genannte Einstellung vorgenommen haben, ist TYPO3 so konfiguriert, dass die Inhalte Ihrer Website in UTF-8 gespeichert und ausgegeben werden. Bei der Ausgabe der Inhalte auf der Website gibt es jedoch noch eine kleine Stolperfalle: Sie können per TypoScript festlegen, in welcher Zeichenkodierung Ihre Webseiten ausgegeben werden. Wenn Sie die Zeichenkodierung per TypoScript fest vorgeben, wird TYPO3 diese Zeichenkodierung verwenden. Kontrollieren Sie daher (am besten über den TypoScript-Object-Browser), ob die folgenden beiden Parameter im TypoScript-Setup gesetzt sind, da diese den Zeichensatz für die Ausgabe an den Browser ändern:

1.9 UTF-8 als Standardzeichensatz verwenden This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 31

Max. Linie

config { renderCharset = iso-8859-1 metaCharset = iso-8859-1 }

Links

Entfernen Sie diese Einstellungen – sofern vorhanden –, um auch bei der Seitenausgabe UTF-8 zu verwenden. Soweit die von Ihnen verwendeten Zeichen in einem anderen Zeichensatz als UTF-8 abgebildet werden können, ist es aber auch durchaus möglich, diesen über renderCharset für die Frontend-Ausgabe zu verwenden.

Siehe auch MySQL unterstützt UTF-8 ab Version 5.1. Für UTF-8 ist utf8_general_ci die Standard-Sortierreihenfolge. Das bedeutet, dass deutsche Umlaute korrekt sortiert werden. Zum Beispiel wird ein »Ö« mit einem »O« gleichgestellt. Weitere Details zu Zeichenkodierungen in MySQL finden Sie im MySQL-Handbuch unter http://dev.mysql.com/doc/refman/5.1/de/ charset-syntax.html. Unter http://dev.mysql.com/doc/refman/4.1/en/charset-collation-effect. html finden Sie eine Gegenüberstellung der Effekte verschiedener Sortierreihenfolgen. Rezept 2.10 zeigt Ihnen, wie Sie eine vorhandene TYPO3-Installation auf UTF-8 konvertieren. Lizensiert für Markus Mueller

1.10 Der richtige Umgang mit Fehlermeldungen Problem Sie erhalten beim Aufruf einer Seite eine Fehlermeldung und möchten diesen Fehler beheben beziehungsweise die Ursache für diese Meldung verstehen.

Lösung TYPO3 bietet Ihnen die Möglichkeit, viele Fehlerquellen schon über das Install-Tool zu analysieren. Wenn Sie sicherstellen, dass Ihre Installationseinstellungen korrekt sind, können Sie erfahrungsgemäß die meisten Fehler bereits beheben. Wechseln Sie dazu in das Install-Tool Ihrer TYPO3-Installation und melden Sie sich mit dem entsprechenden Passwort an (das Standardpasswort lautet joh316). Wählen Sie anschließend den Menüpunkt Basic Configuration. Dort können Sie die grundlegenden Einstellungen kontrollieren, die für den Einsatz von TYPO3 notwendig sind.

Max. Linie

Jede Einstellungsmöglichkeit ist dort in einzelne Funktionsbereiche eingeteilt. So erhalten Sie hier beispielsweise Informationen zu den jeweiligen Zugriffsrechten der Ordner sowie den wesentlichen PHP-, Grafik- und Datenbankeinstellungen. Viele dieser Einstellungen sind mit einem Icon versehen, anhand dessen Sie sehr leicht den aktuellen Status erkennen können. Diese Fehlersymbole haben folgende Bedeutung:

32 | Kapitel 1: Installation und Konfiguration This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Rotes Stoppzeichen – Schwerer Fehler Hierbei handelt es sich um eine fehlerhafte Einstellung, die Sie umgehend beheben sollten. Gelbes Warndreieck – Warnung Hierbei handelt es sich um eine Einstellung, die entweder ungültig ist oder früher oder später zu Problemen führt. Lesen Sie in jedem Fall die entsprechende Erklärung unterhalb der Meldung. Weiße Sprechblase – Hinweis Hierbei handelt es sich nicht um eine Fehlermeldung, sondern um einen Hinweis. TYPO3 weist Sie damit auf wichtige Einstellungen oder einen Bereich hin, dem Sie besondere Aufmerksamkeit widmen sollten. Grünes Häkchen – Alles okay Die Einstellung ist korrekt. So soll es sein. TYPO3 kann mit der Einstellung problemlos laufen.

Lizensiert für Markus Mueller

Damit gibt TYPO3 Ihnen Hinweise auf mögliche Fehlerquellen und macht Ihnen Probleme bewusst. Achten Sie daher im Install-Tool darauf, dass Sie keine Fehlersymbole mehr sehen. Im ersten Abschnitt können Sie die Zugriffsrechte auf die Verzeichnisse kontrollieren. Der Webserver benötigt für die folgenden Verzeichnisse und deren Unterverzeichnisse Schreibrechte: uploads/ typo3temp/ typo3conf/

In diese Verzeichnisse sollte der Webserver schreiben dürfen, wenn Sie Dateien über das Modul Dateiliste verwalten oder lokale Extensions installieren möchten: fileadmin/ typo3conf/ext/

Um Extensions global installieren zu können, benötigt der Webserver zusätzlich Schreibrechte für folgendes Verzeichnis: typo3/ext/

Im nächsten Abschnitt php.ini configuration checked kontrolliert TYPO3 die PHP-Einstellungen. Falls Sie hier Fehlermeldungen sehen, sollten Sie Ihre Einstellungen in der Datei php.ini überprüfen. TYPO3 arbeitet sehr eng mit der Datenbank zusammen, daher müssen Sie den Zugriff auf die Datenbank sicherstellen. Stimmt die Adresse des Datenbankservers? Sind die Zugangsdaten korrekt? Überprüfen Sie, ob sämtliche Tabellen in der Datenbank vorhanden sind. Vor allem, wenn Sie Ihre TYPO3-Instanz aktualisiert haben, müssen Sie die Tabellen in der Datenbank aktualisieren.

Max. Linie

Speichern Sie abschließend diese Werte über den Button Update localconf.php und kontrollieren Sie nochmals die entsprechenden Einstellungen.

1.10 Der richtige Umgang mit Fehlermeldungen | 33 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Achten Sie besonders darauf, dass Sie auf öffentlichen Websites keine PHP-Fehlermeldungen auf den Webseiten ausgeben, sondern diese in einer eigenen Fehlerprotokolldatei speichern. Die Ausgabe von PHP-Fehlern in Ihrer TYPO3-Installation können Sie ebenfalls über das Install-Tool anpassen, indem Sie unter All Configuration die Option displayErrors auf 0 setzen. Alternativ dazu können Sie auch direkt folgende Zeile in die Datei localconf.php einfügen:

Links

$TYPO3_CONF_VARS['SYS']['displayErrors'] = '0';

Richten Sie danach in der PHP-Konfigurationsdatei über den Wert error_log eine entsprechende Protokolldatei ein.

Diskussion Es gibt viele und sehr unterschiedliche Arten von Fehlermeldungen. Sämtliche Szenarien können hier nicht abgebildet werden, daher behandelt dieses Rezept nur die am häufigsten vorkommenden Fehlermeldungen, die TYPO3 beim Aufruf einer Seite im Frontend ausgeben kann. Bevor Sie hier weiterlesen, sollten Sie sicherstellen, dass Sie Ihren Browser korrekt eingestellt haben, um diese Fehlerquellen auszuschließen (um TYPO3 zu verwenden, muss Ihr Browser beispielsweise Cookies für die Website zulassen). In Rezept 3.1 erfahren Sie mehr über diese Einstellungsmöglichkeiten. Lizensiert für Markus Mueller

Nachdem Sie die grundlegenden Fehlerquellen ausgeschlossen haben, können bei der Benutzung von TYPO3 Meldungen erscheinen, die erfahrungsgemäß vor allem mit einer falschen Konfiguration von TYPO3 zu tun haben, beispielsweise wenn Sie noch keine Seiten im Seitenbaum angelegt oder die Seiten noch nicht mit einem TypoScript-Template verknüpft haben. TYPO3 gibt Ihnen dann im Frontend eine entsprechende Fehlermeldung aus, um Sie darauf hinzuweisen, diesen Schritt nachzuholen. Meist sind diese Meldungen sehr kurz und auf Englisch. Daher finden Sie im Folgenden eine Auflistung der häufigsten Meldungen, die Ihnen helfen soll, die Ursache der Meldung besser zu verstehen:

Database Error (Datenbankfehler) The current username, password or host was not accepted when the connection to the database was attempted to be established! Diese Meldung erscheint, wenn TYPO3 die Verbindung zum Datenbankserver nicht herstellen konnte. Überprüfen Sie die Daten für Ihre Datenbankverbindung, indem Sie in das Install-Tool Ihrer TYPO3-Installation wechseln und unter dem Menüpunkt Basic Configuration im Abschnitt Update localconf.php die Felder Username, Password und Host die Zugangsdaten kontrollieren.

Max. Linie

Über das Feld Username legen Sie den Benutzernamen fest. Im Feld Password speichern Sie das Passwort für die Verbindung. Beachten Sie, dass das Passwort im Klartext angezeigt wird. Stellen Sie daher sicher, dass Ihnen niemand über die Schulter guckt. Im Feld Host speichern Sie die Host-Adresse des Datenbankservers. Speichern

34 | Kapitel 1: Installation und Konfiguration This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Sie abschließend diese Werte über den Button Update localconf.php und kontrollieren Sie dann die gewünschte Seite im Frontend. No database selected Diese Meldung taucht auf, wenn TYPO3 zwar eine Verbindung zum Datenbankserver herstellen kann, aber keine Datenbank findet. Kontrollieren Sie, ob Sie im Install-Tool eine Datenbank angegeben haben, auf die TYPO3 zugreifen kann. Wechseln Sie dazu in das Install-Tool Ihrer TYPO3-Installation. Unter dem Menüpunkt Basic Configuration finden Sie den Abschnitt Update localconf.php. Wählen Sie dort im Auswahlfeld Database eine bestehende Datenbanktabelle aus oder legen Sie über das Eingabefeld unterhalb der Auswahlliste eine neue, leere Datenbank an. Bestätigen Sie die Einstellungen anschließend mit einem Klick auf den Button Update localconf.php. Wenn Sie eine neue Datenbank angelegt haben, muss diese nun noch mit den nötigen Tabellen gefüllt werden. Wählen Sie dazu den Menüpunkt Database Analyzer und führen Sie bei dem Punkt Update required tables den Befehl compare aus. TYPO3 vergleicht danach die bestehende Tabellenstruktur in der zuvor gewählten Datenbanktabelle mit den benötigten Tabellen. Über den Button Write to database schreiben Sie dann diese Angaben in die neue Datenbank.

Lizensiert für Markus Mueller

Cannot connect to the current database datenbank_name. Diese Meldung erscheint, wenn der Zugang zur Datenbank nicht hergestellt werden kann. Prüfen Sie, ob die Datenbank auf dem Datenbankserver vorhanden ist und der angegebene Benutzer Zugriff auf diese Datenbank hat. TYPO3 kann ansonsten nicht auf die benötigten Tabellen zugreifen.

Seitenkonfiguration Page is being generated. If this message does not disappear within 30 seconds, please reload. Diese Meldung wird ausgegeben, wenn die Seite gerade von TYPO3 erstellt wird und noch nicht angezeigt werden kann. Häufig taucht diese Meldung auch auf, wenn die Cache-Einstellungen der Seite nicht optimal eingestellt sind oder zwei Anfragen in kurzen Abständen auf eine Seite erfolgen. Die Meldung kann ebenfalls erscheinen, wenn sich ein Skriptfehler in einer Extension eingeschlichen hat und dadurch die Cache-Datei nicht erstellt werden kann oder wenn der Server schlichtweg überlastet ist. Tritt diese Meldung bei bestimmten Seiten häufiger auf, sollten Sie dort über die Seiteneigenschaften die Cache-Einstellungen kontrollieren. Diese Meldung können Sie über TypoScript anpassen. Geben Sie dazu folgenden Code in das Setup-Feld Ihres TypoScript-Templates ein: config { message_page_is_being_generated = HTML-Code fuer Seiteninhalt }

Max. Linie

Beachten Sie, dass der Wert in das HTML-Gerüst eingefügt wird und daher kein eigener -Bereich angegeben werden sollte. In dem Wert können Sie zwei dyna-

1.10 Der richtige Umgang mit Fehlermeldungen | 35 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

mische Marker nutzen. Mit ###TITLE### steht Ihnen der Titel der jeweiligen Seite zur Verfügung. Der Marker ###REQUEST_URI### wird mit der URL ersetzt, die zur Seite führte.

Links

No pages are found on the rootlevel! Diese Meldung erscheint, wenn im Seitenbaum Ihrer TYPO3-Installation noch keine Seiten vorhanden sind oder die bestehenden Seiten ausgeblendet wurden. Überprüfen Sie, ob in Ihrem Seitenbaum schon Seiten vorhanden sind. Bei bestehenden Seiten sollten Sie in den Seiteneigenschaften im Bereich Allgemeine Optionen die Sichtbarkeitseinstellungen wie Start, Stopp und Zugriff überprüfen. Falls noch keine Seite vorhanden ist, legen Sie eine neue Seite vom Typ Standard oder Erweitert an (in Rezept 4.1 erfahren Sie, wie Sie Seiten schnell erzeugen). No template found! Überprüfen Sie, ob für die gewünschte Seite ein TypoScript-Template vorhanden ist. In diesem Template muss unbedingt das Kontrollkästchen Rootlevel aktiviert sein (in Rezept 8.2 erfahren Sie mehr über die Grundeigenschaften von TypoScript-Templates).

Lizensiert für Markus Mueller

Um solch ein Template zu erstellen, wechseln Sie im Backend in das Modul Template und wählen im Seitenbaum die gewünschte Seite aus, auf der Sie das Template speichern möchten. Stellen Sie sicher, dass in der Auswahlliste in der rechten oberen Ecke der Eintrag Info/Modify aktiviert ist. Im rechten Fenster erscheint nun eine Meldung, die besagt, dass auf der gewünschten Seite noch kein Template vorhanden ist. Klicken Sie anschließend im Abschnitt Create new website auf den Button Create template for a new site. Nachdem Sie das folgende Dialogfenster mit OK bestätigt haben, erzeugt TYPO3 das neue Template, und es erscheinen unterhalb des Bereichs Template information die grundlegenden Informationen über das Template. Wenn Sie nun zurück in das Frontend wechseln, werden Sie sehen, dass die Fehlermeldung dem Ausruf HELLO WORLD! gewichen ist. Da dies wahrscheinlich nicht dem Inhalt entspricht, den Sie auf Ihrer Website anzeigen möchten, wechseln Sie zurück in das Backend und passen über die Bearbeitungssymbole den Titel und den Inhalt dieses Templates nach eigenen Wünschen an. Sie benötigen für jeden Seitenbaum prinzipiell nur ein Template, da TYPO3 bei jedem Seitenaufruf den Pfad zu dieser Seite nach Templates durchsucht. Dabei werden die Templates von der Startseite bis zur aktuellen Seite abgearbeitet. Da es mit der Zeit sehr unübersichtlich werden kann, den gesamten TypoScript-Code Ihrer Website in einem Template zu speichern, bietet Ihnen TYPO3 Möglichkeiten, diese komfortabel aufzuteilen.

Max. Linie

The requested page does not exist! Diese Meldung erscheint, wenn die aufgerufene Seite nicht existiert. Standardmäßig sucht TYPO3 automatisch in der Rootline nach der nächstgelegenen Seite, wenn die gewünschte Seite nicht gefunden werden kann (mehr über den Begriff Rootline erfahren Sie in Rezept 12.5). Kontrollieren Sie über das Backend, ob die gewünschte

36 | Kapitel 1: Installation und Konfiguration This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Seite vorhanden ist. Diese Meldungen können Sie serverseitig abfangen, indem Sie eine eigene 404-Seite einrichten. Wechseln Sie dazu in das Install-Tool und wählen Sie die Option All Configuration. Suchen Sie dort nach der Option pageNotFound_handling und geben Sie in dem Feld die Seite an, auf die TYPO3 weiterleiten soll, wenn die gewünschte Seite nicht gefunden werden konnte. The requested page didn't have a proper connection to the tree-root! Diese Meldung taucht auf, wenn die angeforderte Seite keine Verknüpfung zum RootTemplate der Ursprungsseite hat. TYPO3 kann in diesem Fall keine Verknüpfung zum Template mit der Eigenschaft Rootlevel herstellen. Kontrollieren Sie, ob die Seite im richtigen Seitenbaum liegt und dort auf das korrekte TypoScript-Template zugreifen kann. Beachten Sie, dass die Wurzelseite Ihrer Website ausschließlich über die Template-Eigenschaft Rootlevel aktiviert wird und nicht über die Position im Seitenbaum. The page is not configured! [type=aufgerufener_typ][] Diese Meldung erscheint, wenn die angeforderte Seite nicht dem gewünschten Seitentyp zugeordnet werden kann. Meist ist in diesem Fall der Get-Parameter type mit einem Zahlenwert in der Adresszeile vorhanden. Kontrollieren Sie, ob das Seitenobjekt im TypoScript-Template mit der Eigenschaft typeNum für diesen Seitentyp angelegt wurde. In Kapitel 9 erfahren Sie mehr über die Möglichkeiten von Seitentypen.

Lizensiert für Markus Mueller

This page is temporarily unavailable. Es ist ein Systemfehler aufgetreten, oder die Seite wird gerade Wartungsarbeiten unterzogen.

Sprachbezogen Error. Reason: Page is not available in the requested language. Diese Meldung wird ausgegeben, wenn die Systemeinstellungen vorgeben, dass Seiten standardmäßig ausgeblendet werden sollen, wenn sie mit einem Sprachparameter aufgerufen werden und noch keine Inhalte in der gewünschten Sprache vorliegen. Kontrollieren Sie, ob die Seite schon übersetzt wurde und ob Sie die folgende Systemeinstellung aktiviert haben: $TYPO3_CONF_VARS['FE']['hidePagesIfNotTranslatedByDefault'] = '1';

In Rezept 1.5 erfahren Sie, wie Sie diesen Wert kontrollieren können.

Max. Linie

Error. Reason: Page is not available in the requested language (strict). Diese Meldung erscheint, wenn Sie die Ausgabe von übersetzten Inhalten über TypoScript so begrenzt haben, dass eine Seite nur dann ausgeliefert wird, wenn in der gewünschten Sprache Inhalte vorliegen. Kontrollieren Sie, ob die Seite in der gewünschten Übersetzung vorliegt (in Rezept 4.9 erfahren Sie, wie Sie Übersetzungen Ihrer Inhalte komfortabel überprüfen können) und ob Sie folgenden Wert in Ihrem TypoScript-Setup gesetzt haben:

1.10 Der richtige Umgang mit Fehlermeldungen | 37 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

config { sys_language_mode = strict }

Links

Der empfohlene Wert dieser Option ist content_fallback. TYPO3 würde in diesem Fall die Seiteninhalte in der Standardsprache ausgeben und keine Fehlermeldung erzeugen. Error. Reason: Page is not available in default language. Diese Meldung taucht auf, wenn Sie über die Seiteneigenschaften der aufgerufenen Seite die Option Standard-Übersetzung verstecken aktiviert haben und der Seitenaufruf ohne Sprachparameter erfolgte. Wird bei einem Seitenaufruf kein Sprachparameter übergeben, gibt TYPO3 die Inhalte in der Standardsprache aus. Mit der Option Standard-Übersetzung verstecken unterbinden Sie, dass TYPO3 die Seite in der Standardsprache anzeigt, und erzwingen damit gleichzeitig, dass die Seite immer nur in einer Übersetzung angezeigt wird. Vergewissern Sie sich, ob die Seite in Ihrem Seitenbaum in der gewünschten Übersetzung vorliegt und ob die Option StandardÜbersetzung verstecken aktiv ist.

Besondere Fehlermeldungen Lizensiert für Markus Mueller

Could not set logfile path. Check filepath and permissions. Diese Meldung wird ausgegeben, wenn bei der Erzeugung der Apache-Statistiken im gewünschten Logverzeichnis ein Fehler aufgetreten ist. Kontrollieren Sie, ob das gewünschte Verzeichnis sowie die Datei vorhanden sind und vom Webserver beschrieben werden dürfen. Die Einstellungen für den Logmechanismus nehmen Sie über Systemparameter und das TypoScript-Setup vor. Geben Sie folgenden Code in Ihr TypoScript-Setup ein, um den Namen der Logdatei festzulegen: config.stat_apache_logfile = log_datei.log

Der Webserver benötigt Schreibrechte auf diese Datei. Den Pfad zu dieser Datei geben Sie über die Option logfile_dir an. Sie können den Pfad anpassen, indem Sie in das Install-Tool wechseln, im Bereich All Configuration nach der Option logfile_dir suchen und in das entsprechende Feld den gewünschten Pfad eingeben. Alternativ dazu können Sie auch folgende Zeile direkt in die Datei localconf.php schreiben: $TYPO3_CONF_VARS['FE']['logfile_dir'] = 'pfad';

Das Verzeichnis muss innerhalb Ihrer TYPO3-Installation liegen. Wenn Sie den Pfad zu der Logdatei absolut angeben, achten Sie darauf, dass der Pfad in der Option lockRootPath freigeschaltet wurde. Kontrollieren Sie dazu die Option lockRootPath im Install-Tool und geben Sie in das entsprechende Feld den Pfad zum Ordner an, in dem die Logdatei liegt. Alternativ dazu können Sie den Wert auch hier mit folgendem Code direkt in die Datei localconf.php schreiben:

Max. Linie

$TYPO3_CONF_VARS['BE']['lockRootPath'] = 'pfad_zum_logfile_dir';

38 | Kapitel 1: Installation und Konfiguration This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Zusätzlich gibt es noch spezielle Hinweise, mit denen TYPO3 auf Besonderheiten hinweist: PREVIEW! Diese Meldung erscheint, wenn Sie im Vorschaumodus arbeiten – etwa indem Sie im Admin-Panel die Option Versteckte Datensätze anzeigen aktivieren. Einige Inhalte auf der aktuellen Seite sind dann für andere Besucher nicht in dem Umfang sichtbar, wie sie momentan für Sie erscheinen (wenn Sie die Option Versteckte Seiten anzeigen aktiviert haben, können diese Seiten sogar für andere Benutzer unsichtbar sein). Das Erscheinungsbild dieser Nachricht können Sie per TypoScript anpassen. Geben Sie dazu folgenden Code in das Setup-Feld Ihres TypoScript-Templates ein: config { message_preview = HTML-Code }

Preview of workspace XY (XY) Diese Meldung taucht auf, wenn Sie einen nicht öffentlichen Bereich eines Workspace betrachten und im Vorschaumodus arbeiten – etwa indem Sie im Admin-Panel die Option Versteckte Datensätze anzeigen aktiviert haben. Kontrollieren Sie die Sichtbarkeitseinstellungen für diesen Workspace und schalten Sie ihn bei Bedarf für die Öffentlichkeit frei. Lizensiert für Markus Mueller

Page shortcuts were looping in uids X,Y...! Diese Meldung erscheint, wenn Sie eine Seite vom Typ Verweis aufrufen und dieser Verweis auf sich selbst zeigt. Dann entsteht eine Endlosschleife, da die Seite sich immer wieder selbst aufruft. Kontrollieren Sie die Seiteneigenschaften der jeweiligen Seite und ändern Sie die Einstellungen für den Verweis. Im Feld Verweis zur Seite können Sie die Verknüpfung anpassen.

Umgang mit PHP-Fehlermeldungen Neben den von TYPO3 erzeugten Fehlermeldungen treten oft Fehler im PHP-Skriptinterpreter selbst auf. Diese werden je nach Einstellung in $TYPO3_CONF_VARS['SYS']['displayErrors']

am Bildschirm oder in einer speziellen Logdatei ausgegeben. Zur Bedeutung einzelner Fehlermeldungen bietet sich eine entsprechende Recherche über eine Suchmaschine an. Oft treten Fehler in Verbindung mit den für PHP verfügbaren Ressourcen auf. Diese können Sie wie folgt umgehen:

PHP-Ressourceneinstellungen

Max. Linie

TYPO3 ist eine ressourcenintensive Anwendung. Die für PHP zur Verfügung stehenden Ressourcen werden in der Datei php.ini festgelegt. Die von PHP vorgegebenen Standardwerte sind für den Betrieb von TYPO3 teilweise nicht ausreichend und sollten angepasst werden. Wir empfehlen, die folgenden Werte in der Datei php.ini anzupassen:

1.10 Der richtige Umgang mit Fehlermeldungen | 39 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

;;;;;;;;;;;;;;;;;;; ; Resource Limits ; ;;;;;;;;;;;;;;;;;;; memory_limit = 32M max_execution_time = 60

Links ; Maximum amount of memory a script may consume (8MB) ; Maximum execution time of each script, in seconds

Eine solche Änderung erfordert den Zugriff auf die entsprechende Datei. Dies ist in Shared-Hosting-Umgebungen in der Regel nicht möglich. In diesem Fall ist eine Änderung eventuell noch über eine .htaccess-Datei möglich: php_value memory_limit "32M" php_value max_execution_time "60"

Sollte auch diese Methode nicht zum Erfolg führen, bleibt Ihnen nur die Möglichkeit, eine entsprechende Änderung bei Ihrem Serverbetreiber zu erbitten.

Lizensiert für Markus Mueller

Grundsätzlich sollten Sie eine Website intern ausgiebig testen, bevor sie öffentlich gemacht wird. Die meisten der oben genannten Fehler lassen sich mit entsprechenden Einstellungen im TYPO3-Backend beheben bzw. von vornherein umgehen. Es kann jedoch vorkommen, dass es aus unterschiedlichen Gründen zu weiteren Fehlermeldungen kommt, die nicht so leicht zu repoduzieren sind. Falls bei Ihnen ein Fehler auftritt, der hier nicht beschrieben wurde, können Sie folgendermaßen vorgehen: Suchen Sie in der entsprechenden Newsgroup nach Hilfestellungen. In Rezept 20.6 finden Sie eine Liste der vorhandenen Newsgroups. In Rezept 20.5 erfahren Sie, wie Sie die nötigen Informationen sammeln, um den Fehler auch für andere Leser in den Newsgroups reproduzierbar zu machen und so schneller Hilfestellung zu erhalten. Wenn Sie möchten, können Sie auch eine E-Mail mit der Fehlermeldung an das Autorenteam senden ([email protected]). Wurde Ihre Fehlermeldung geklärt, können wir den Fehler dann in einer nächsten Auflage hier einbinden.

Siehe auch Auf der PHP-Seite http://de3.php.net/manual/de/ref.errorfunc.php#ini.error-log erfahren Sie, wie Sie die PHP-Fehler in einer externen Protokolldatei sichern. Falls dieses Rezept noch nicht zur Lösung des Problems beigetragen hat, haben Sie folgende weitere Möglichkeiten: Eventuell handelt es sich um eine fehlerhafte Browsereinstellung. Lesen Sie dann 3.1, um fehlerhafte Browsereinstellungen zu umgehen. Außerdem finden Sie in Rezept 20.6 Adressen von Newsgroups, in denen Sie Fragen zu tiefer gehenden Fehlern mit anderen TYPO3-Nutzern besprechen können.

Max. Linie

Max. Linie 40 | Kapitel 1: Installation und Konfiguration This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

First

Kapitel 2

KAPITEL 2

Wartung und Systempflege

2.0

Einführung

In diesem Kapitel finden Sie Lösungen zu Aufgaben, die im laufenden Betrieb von TYPO3 anfallen.

Lizensiert für Markus Mueller

Max. Linie

Wenn Ihre TYPO3-Installation erst mal läuft, wird eine der am häufigsten vorzunehmenden Aufgaben sein, ein Update auf eine nächsthöhere TYPO3-Version zu planen und durchzuführen. Die Rezepte 2.1 und 2.2 helfen Ihnen dabei, die nötigen Schritte zu überdenken und optimal zu planen. Rezept 2.3 geht darauf ein, wie Sie eine aktuelle TYPO3Installation dazu bringen, sich beim Rendern der Webseiten wie eine ältere TYPO3-Version zu verhalten. Wenn Sie technische Umstellungen oder Wartungsarbeiten an Ihrer Website vornehmen, kann dies auch die Verfügbarkeit beeinflussen. Kann oder soll Ihre Website kurzzeitig nicht mehr dargestellt werden, können Sie auf der Website eine entsprechende Meldung ausgeben. Rezept 2.4 erläutert die dafür nötigen Schritte. Weiterhin fallen im laufenden Betrieb der Website Arbeiten an, die Sie im Auge behalten sollten. Zum einen kann die Datenbank durch die Installation bzw. Deinstallation von Extensions defragmentiert werden oder Referenzen zu Datensätzen können nicht mehr aufgelöst werden. So können sich unnötige Datenbestände anhäufen, die sich zwar nicht direkt auf Ihre Website auswirken, jedoch die Verwaltung unnötig erschweren und den Blick auf die wesentlichen Daten erschweren. Sie sollten daher stets die Übersichtlichkeit fördern, indem Sie veraltete oder nicht mehr benötigte Daten entfernen. Prüfen Sie regelmäßig, ob das Datenbankschema noch konsistent ist und ob ungenutzte Daten oder Dateien vorliegen. Die dafür nötigen Tools und Vorgehensweisen werden ausführlich in den Rezepten 2.5 und 2.6 erklärt. Wie Sie die Relationen zwischen Ihren Datensätzen in Ihrer TYPO3-Datenbank darstellen und aktuell halten können, wird in den Rezepten 2.8 und 2.7 beschrieben.

| 41 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Ebenso wichtig wie die Integretät der Daten ist, dass Sie die Daten Ihrer Website regelmäßig sichern, um sie zum Beispiel nach einem Hardwarefehler schnell wiederherstellen zu können. Rezept 2.9 beleuchtet die nötigen Schritte, mit denen Sie Ihre Daten einfach und zuverlässig sichern können.

Links

Eine immer häufiger werdende Aufgabe für bestehende TYPO3-Projekte wird die Konvertierung der bestehenden Daten in den Zeichensatz UTF-8. Durch diesen Zeichensatz wird es möglich, Inhalte in unterschiedlichen Zeichensätzen in einer Datenbank zu speichern. Für die Konvertierung sollten Sie einige Vorüberlegungen treffen und ein paar wichtige Punkte beachten. Das Rezept 2.10 geht detailliert auf diese Anforderungen ein und unterstützt Sie bei der erfolgreichen Konvertierung zum UTF-8-Zeichensatz. Um Fehler im laufenden Betrieb zu ermitteln, können Sie das Syslog von TYPO3 zur Hilfe nehmen. Damit können Sie Aktivitäten und Fehlermeldungen von TYPO3 protokollieren und auswerten. Diese umfangreiche Möglichkeit, die Protokollfunktion von TYPO3 zu nutzen, wird in Rezept 2.11 beschrieben.

Lizensiert für Markus Mueller

Bei umfangreichen Datenbeständen wird es erfahrungsgemäß immer schwieriger, den Überblick zu behalten und Inhalte wiederzufinden. Rezept 2.12 zeigt Ihnen, wie Sie als Administrator sehr schnell in der TYPO3-Datenbank Inhalte finden und bearbeiten können. Auch kommt es immer häufiger vor, dass Administratoren verlorene bzw. verloren geglaubte Dateien wiederfinden müssen, weil die Verknüpfungen im TYPO3-Backend für Redakteure nicht mehr nachvollziehbar sind. In Rezept 2.13 erfahren Sie, wie Sie solche Situationen schnell meistern können.

2.1

TYPO3 auf eine neue Version aktualisieren

Problem Sie möchten eine aktuellere TYPO3-Version installieren und Ihre bestehende TYPO3Installation auf eine neue Version aktualisieren.

Lösung Laden Sie sich die aktuellsten Pakete von dieser Adresse herunter und tauschen Sie anschließend die Quelldaten Ihrer bestehenden TYPO3-Installation aus: http://typo3.org/download/packages/

Max. Linie

Wir empfehlen, Updates in einer unabhängigen Testumgebung zu testen und auf jeden Fall ein vollständiges Backup der alten TYPO3-Installation zu erstellen. Zudem beschreiben wir in der Lösung nur die grundlegenden Aktualisierungsschritte. Beachten Sie, dass Sie vorab einige Fragen klären sollten, auf die wir in der Diskussion näher eingehen. Die Diskussion gibt Ihnen die nötigen Hintergrundinformationen an die Hand, um die möglichen Risiken eines Updates besser abschätzen zu können.

42 | Kapitel 2: Wartung und Systempflege This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts Linux/Unix 1. Laden Sie sich das TAR.GZ-Paket mit dem TYPO3-Source-Paket auf Ihre Festplatte und entpacken Sie das Archiv. 2. Legen Sie die entpackten Daten in ein Verzeichnis außerhalb des Webroots. 3. Tauschen Sie den Symlink typo3_src zu Ihren TYPO3-Source-Dateien aus (falls Sie keine Symlinks verwenden oder Ihnen der Begriff neu ist, sollten Sie vor dem Update unbedingt das Rezept 1.2 lesen). Beachten Sie, dass die Rechte vom Symlink und dem Source-Paket identisch sein müssen. Der Austausch wird durch folgende Kommandos ermöglicht: rm typo3_src ln -s /pfad/zu/typo3_src typo3_src

4. Öffnen Sie im Browser das Install-Tool unter typo3/install und melden Sie sich mit Ihrem gewohnten Passwort an. 5. Prüfen Sie im Database Analyser mit der Funktion COMPARE, ob Änderungen an der Datenbank notwendig sind. Führen Sie diese wenn nötig durch. 6. Entfernen Sie – falls vorhanden – die nicht mehr benötigten Symlinks media, tslib und showpic.php. Diese werden in der aktuellsten TYPO3-Version nicht mehr benötigt. Lizensiert für Markus Mueller

Windows- und Shared Hosts-Installationen Beim Update auf Windows oder einen Shared Host per FTP-Zugang hat sich folgendes Vorgehen bewährt: 1. Laden Sie sich das ZIP-Paket mit dem TYPO3-Source-Paket auf Ihre lokale Festplatte und entpacken Sie das ZIP-Paket. 2. Fügen Sie den beiden Verzeichnisse t3lib und typo3 sowie der Datei index.php ein Präfix neu_ hinzu. Das Verzeichnis misc brauchen Sie nicht auf den Server zu legen. 3. Laden Sie diese Verzeichnisse und die Datei auf den Server. Es liegen nun die alten und neuen Dateien parallel zueinander auf dem Server. 4. Prüfen Sie die Zugriffsrechte für die neuen Verzeichnisse und die Dateien. Der Webserver sollte keine Schreibrechte darauf haben. 5. Fügen Sie den alten Verzeichnisse t3lib und typo3 sowie der Datei index.php das Präfix alt_ hinzu. 6. Entfernen Sie anschließend das Präfix neu_ bei den neuen Verzeichnissen. Ihre Website wird während dieser Umbenennungen kurz nicht erreichbar sein. 7. Öffnen Sie im Browser das Install-Tool (im neuen) TYPO3-Verzeichnis typo3/install und melden Sie sich mit Ihrem gewohnten Passwort an.

Max. Linie

8. Prüfen Sie im Database Analyser mit der Funktion COMPARE, ob Änderungen an der Datenbank notwendig sind. Führen Sie diese wenn nötig durch. 9. Passen Sie wenn gewünscht weitere Systemparameter im Abschnitt All Configuration an. Dieser Schritt ist optional.

2.1 TYPO3 auf eine neue Version aktualisieren | 43 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

10. Ebenfalls optional: Kopieren Sie die globalen Extensions aus alt_typo3/ext/ nach typo3/ext. Beachten Sie hierzu unsere Anmerkungen in der Diskussion.

Links

11. Entfernen Sie abschließend alle nicht mehr benötigten Dateien und Verzeichnisse wie zum Beispiel media, misc, tslib, showpic.php. Diese werden in der aktuellsten TYPO3Version nicht mehr benötigt. Ihre TYPO3-Installation ist nach diesen Schritten auf den neuesten Stand. Aktualisieren Sie danach Ihre Extensions. Wenn Sie Extensions aus dem TER importieren möchten, achten Sie darauf, dass Sie unter Settings die Option Enable extensions without review aktiviert haben, da die gesuchten Extensions sonst möglicherweise nicht erscheinen. Führen Sie zur schnellen Aktualisierungsüberprüfung im Erweiterungs-Manager Check for Extension Updates durch.

Diskussion

Lizensiert für Markus Mueller

Max. Linie

Auch wenn das Aktualisieren der TYPO3-Quelldateien sehr einfach ist, müssen bei jedem Update auch noch zahlreiche andere Dinge beachtet werden, damit gewährleistet werden kann, dass Ihre Website weiterhin läuft. Das Wichtigste und erfahrungsgemäß auch das Schwierigste ist es, sicherzustellen, dass alle installierten Extensions korrekt (weiter-)laufen und es durch das Update zu keinen Nebeneffekten mit installierten Extensions kommt. Die Überlegungen und Maßnahmen bei einem Update unterscheiden sich aufgrund der unterschiedlichen Versionen. Je nachdem, ob Sie auf eine Minor-, Major- oder BugfixVersion aktualisieren, müssen Sie Ihre Schritte für die Aktualisierung überdenken und mögliche Risiken berücksichtigen. Ändert sich die letzte Stelle in der Versionsnummer zum Beispiel von 4.2.1 auf 4.2.2, handelt es sich um sogenannte Patch level releases. Die TYPO3-Version enthält dann ausschließlich Bugfixes und keine funktionalen Änderungen. Sie können Ihre alte Version in diesem Fall bedenkenlos aktualisieren. Ändert sich die zweite Stelle, zum Beispiel von 4.2.0 auf 4.3.0, wurde TYPO3 um neue Funktionen erweitert. Solche Versionen enthalten – zusätzlich zu allen vorangegangenen Bugfixes – meist funktionale Änderungen, die Sie vor dem Update ausgiebig auf einem Testsystem testen sollten. Ändert sich die erste Nummer zum Beispiel von 4.2 auf 5.0, wurden völlig neue Funktionen in TYPO3 eingebaut und Änderungen an der Systemarchitektur vorgenommen. Solche Versionen unterscheiden sich im Funktionsumfang meist so deutlich von der vorherigen, dass Sie die Tragweite einer Aktualisierung langfristig und sorgfältig prüfen sollten. Der TYPO3-Kern wird von einem festen Entwicklerkreis geprüft und getestet, sodass eine sehr hohe Qualität und Abwärtskompatibilität gesichert ist. Diese Qualitätssicherung ist bei Extensions von Drittanbietern meist nur gering oder gar nicht vorhanden. Sie sollten daher bei jedem Update jede Extension prüfen, ob es zu Nebeneffekten durch das Update kommt. Meist folgt eine Inkompatibilität mit einer neuen TYPO3-Version daraus, dass

44 | Kapitel 2: Wartung und Systempflege This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

der Extension-Entwickler die TYPO3-API nicht (durchgehend) genutzt hat. Andererseits kann es sein, dass die Extension in den TYPO3-Kern aufgenommen wurde und somit nun standardmäßig zur Verfügung steht. Ebenso kann eine Extension durch eine Änderung am TYPO3-Kern obsolet werden oder im Extension-Repository nicht mehr verfügbar sein, da sie von Entwickler nicht mehr weiterentwickelt wird. Achten Sie beim Update auf inkompatible Extensions und prüfen Sie, ob eine Extension den XClass-Mechanismus nutzt, um Klassen von TYPO3 zu erweitern. Dies führt erfahrungsgemäß häufig zu Nebeneffekten bei Updates. Gegebenenfalls müssen Sie auch ein Update der Extension in Erwägung ziehen, was sich dann vor allem bei Modifikationen an der Extension als aufwendig herausstellt. Alle diese Punkte können den Aktualisierungsprozess erheblich verzögern. Planen Sie daher genügend Zeit für die Aktualisierung ein, um alle Schritte systematisch und in Ruhe durchzuführen.

Siehe auch

Lizensiert für Markus Mueller

Grundsätzlich sollten Sie sich vor dem Update über die Änderungen im Programmcode informieren. Hier geben Changelog, Release-Notes und das TYPO3-Wiki wichtige Hinweise und Hilfestellungen zu den jeweiligen Änderungen. Eine Übersicht der vorhandenen Release-Notes finden Sie unter der Adresse http://wiki.typo3.org/Category:ReleaseNotes. Dort finden Sie auch das Changelog. Wenn Sie bei neuen Releases automatisch per E-Mail benachrichtigt werden möchten, empfehlen wir Ihnen, sich an der Mailingliste TYPO3announce anzumelden: http://lists.netfielders.de/cgi-bin/mailman/listinfo/typo3-announce. Mehr über den XClass-Mechanismus und warum Sie ihn bei Extensions vorsichtig einsetzen sollten, erfahren Sie in Rezept 17.12.

2.2

Die aktuell verwendete TYPO3-Version ermitteln

Problem Sie möchten die Versionsnummer Ihrer momentanen TYPO3-Installation erfahren, beispielsweise um zu prüfen, welche Extensions Sie installieren können, ob Updates nötig sind oder ob Sie bestimmte TYPO3-Funktionen nutzen können.

Lösung Die aktuelle Versionsnummer finden Sie im Modul Über Module im Copyright-Vermerk. Zusätzlich können Sie die Versionsnummer in der Anmeldemaske anzeigen lassen. Aktivieren Sie dazu im Install-Tool die Option loginCopyrightShowVersion oder geben Sie folgende Zeile in die Datei localconf.php ein:

Max. Linie

$TYPO3_CONF_VARS['SYS']['loginCopyrightShowVersion'] = '1';

2.2 Die aktuell verwendete TYPO3-Version ermitteln | 45 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Danach erscheint die Versionsnummer mit dem Copyright-Vermerk in der Anmeldemaske. Anstatt TYPO3 CMS wird dann zum Beispiel TYPO3 CMS ver. 4.2.0 ausgegeben. Die Angabe ver. 4.2.0 steht dabei für Version 4.2.0.

Links

Diskussion Die Versionsnummer ist in drei Bereiche aufgeteilt und kann am Ende noch einen weiteren Zusatz haben, der eine besondere Entwicklerversion markiert. Je nach Wichtigkeit und Bedeutung der Änderungen wird entweder die Hauptversion oder die Unterversion erhöht. Die erste Position steht für die Hauptversion. Erscheint eine neue Hauptversion, enthält TYPO3 neue Kern-Features und grundlegende Neuerungen. Die zweite Position steht für die Unterversion. Wurde diese geändert, enthält TYPO3 neue kleinere Features und Verbesserungen. Die dritte Position steht für die aktuelle Patch-Version. Solche Veröffentlichungen enthalten wichtige Bugfixes für die aktuelle Unterversion.

Lizensiert für Markus Mueller

Hat die Versionsnummer die Endung -dev, -alpha oder -beta, handelt es sich um eine Entwicklerversion beziehungsweise um eine Alpha- oder Betaversion. RC steht für Release Candidate. Diese Versionsbezeichnungen sind optional und dienen den Entwicklern zur Unterscheidung der einzelnen Veröffentlichungsschritte. Enthält Ihre TYPO3-Version eine solche Endung, sollten Sie diese nicht in Produktionsumgebungen verwenden. Etwa zwei Monate vor einem Veröffentlichungstermin werden zunächst Betaversionen als Testversionen bereitgestellt. Nach Einarbeitung der letzten neuen Features und eines Feedbacks werden die sogenannten Release Candidates veröffentlicht. Diese RCs sind mit einem Featurefreeze verbunden. Das heißt, dass keine neuen Features mehr eingebaut werden, sondern sich die Entwickler auf das Beheben von Fehlern konzentrieren. Vor der finalen Veröffentlichung werden dann weitere Release Candidates herausgegeben, die ausschließlich der Qualitätssicherung dienen und intensiv auf Fehler geprüft werden. Sollten Fehler auftauchen, werden diese behoben, und ein neuer Release Candidate wird veröffentlicht. Mehrere Release Candidates werden von 1 bis n durchgezählt. Aus dem letzten Release Candidate wird dann eine stabile TYPO3-Version erzeugt. Danach geht der Zyklus wieder von vorne los. Bei der Entwicklung von eigenen Extensions oder TypoScript-Templates kann es sehr hilfreich sein, diese Versionsnummern zum Implementieren neuer Funktionen zu berücksichtigen. Zum Beispiel können Sie dadurch sicherstellen, dass Ihr Code mit älteren TYPO3-Versionen kompatibel bleibt und auch über größere Versionssprünge stabil läuft.

Max. Linie

Wenn Sie die TYPO3-Version bei der Entwicklung Ihrer TYPO3-Erweiterungen benötigen, sollten Sie auf die TYPO3-Konstante TYPO3_version zugreifen. In dieser Konstanten speichert TYPO3 die vollständige Versionsnummer der aktuellen Installation. Kombiniert mit der Funktion t3lib_div::int_from_ver(), generieren Sie dann aus diesem Wert eine eindeutige Zahlenfolge, mit der Sie die Versionsnummer sicher abfragen können:

46 | Kapitel 2: Wartung und Systempflege This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

$version = t3lib_div::int_from_ver(TYPO3_version); if ($version > 4002000) { // Ihr Programmcode die('Ihre TYPO3-Version ist aktuell.'); } else { die('Bitte aktualisieren Sie Ihre TYPO3-Version.'); }

Jeder Versionsabschnitt wird dabei automatisch mit Nullen auf drei Stellen erweitert, wobei führende Nullen entfernt werden. In unserem Beispiel wird daher die Versionsnummer »4.2.0« in »4002000« umgewandelt. Da es sich um einen Zahlenwert handelt, werden die führenden Nullen nicht übernommen (der eigentliche Wert wäre 004002000). Anhand dieses Zahlenwerts können Sie dann versionsgenau die gewünschten Abfragen durchführen, etwa um Funktionen oder Hooks vorauszusetzen oder entsprechende Fehlermeldungen anzuzeigen, wenn Ihre Extension auf einer veralteten TYPO3-Version installiert wird.

Siehe auch

Lizensiert für Markus Mueller

Wenn Sie in Sachen TYPO3-Versionen auf dem Laufenen bleiben möchten, erhalten Sie unter http://news.typo3.org/xml-feeds/ die Möglichkeit, Meldungen über neue TYPO3-Versionen direkt in Ihren Newsreader zu laden. Einen Überblick über die aktuellen stabilen TYPO3-Versionen finden Sie auf der offiziellen Webseite unter http://typo3.org/download/ packages/. Anhand von Rezept 1.2 erfahren Sie, welches TYPO3-Paket Sie je nach Ihren Anforderungen herunterladen sollten. Der Release-Workflow sowie die Bedeutung der Versionsnummer wird auf dieser Seite beschrieben: http://typo3.org/teams/core/resources/ release-workflow/.

2.3

Den Kompatibilitätsmodus nutzen

Problem Sie möchten Ihre TYPO3-Version aktualisieren und das Verhalten Ihrer alten TYPO3Version beim Rendern der Webseiten weitestgehend beibehalten.

Lösung

Max. Linie

Wenn Sie das gewohnte Render-Verhalten Ihrer alten TYPO3-Version beibehalten möchten, brauchen Sie nach der Aktualisierung nichts zu unternehmen. Sofern Sie von einer TYPO3-Version kleiner als 4.0 aktualisieren, wird standardmäßig die Version 3.8 simuliert. Dadurch wird sichergestellt, dass sich die aktuelle Version bei der Darstellung Ihrer Website so weit wie möglich wie die vorherige TYPO3-Version verhält. Sie erhalten dann im Backend unter Über Module lediglich einen Hinweis, dass die Compat-Version von der aktuellen TYPO3-Version abweicht.

2.3 Den Kompatibilitätsmodus nutzen | 47 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Wenn Sie nach der Aktualisierung neue Features bei der Seitengenerierung aktivieren möchten, hilft Ihnen der Update Wizard im Install-Tool, diese zu aktivieren, und gibt Ihnen gleichzeitig eine Übersicht über die geänderten Features, sodass Sie die nötigen Maßnahmen ergreifen können, um Nebeneffekte zu verhindern.

Links

Öffnen Sie hierzu das Install-Tool und setzen Sie im Update Wizard den Kompatibilitätsmodus (Compat Mode) auf die gewünschte TYPO3-Version. Klicken Sie in der Box mit der Überschrift changeCompatibilityVersion auf den Button Next. Im zweiten Schritt können Sie dann über das Auswahlfeld die gewünschte Version festlegen. Klicken Sie abschließend auf Perform updates!, damit Ihre Auswahl übernommen wird. TYPO3 schreibt Ihre Einstellung daraufhin als neuen Wert für die Variable $TYPO3_CONF_VARS['SYS']['compat_version'] in die Datei localconf.php.

Diskussion Der Kompatibilitätsmodus wurde in TYPO3-Version 4.0 eingeführt, um Aktualisierungen auf eine neue TYPO3-Version zu vereinfachen und eine Aktualisierung des Programmcodes unabhängig von Änderungen in der Darstellung der Website zu machen. Der Kompatibilitätsmodus hat dabei nur Auswirkungen auf das Frontend. Das Backend bleibt von den Änderungen am Kompatibilitätsmodus unberührt. Lizensiert für Markus Mueller

Wenn sich Änderungen im Programmcode auf die Darstellung der Website auswirken, kann eine Aktualisierung schnell länger dauern und zu einer mühsamen Suche ausarten. Oft wird ein Update dann gar nicht durchgeführt, wenn sich die Änderungen als zu umfangreich herausstellen. Genau hier setzt der Kompatibilitätsmodus an, denn durch diesen werden die Änderungen im TYPO3-Code von der Website-Darstellung entkoppelt. Das Darstellungsverhalten Ihrer Website wird so beibehalten, wie es in einer älteren TYPO3-Instanz der Fall war. Sie können dadurch TYPO3 aktualisieren, ohne Änderungen an Ihrer Website befürchten zu müssen. Gleichzeitig werden dadurch die Änderungen, die Auswirkungen auf die Darstellung der Website haben, protokolliert. Über den Update Wizard können Sie dann jede Änderung der Reihe nach einsehen und erhalten gleichzeitig nützliche Tipps dazu, wie Sie die Änderung vornehmen können. Sie brauchen also nicht sofort Ihr TypoScript zu überarbeiten, sondern können die Änderungen in Ruhe zu einem späteren Zeitpunkt durchführen und dann anschließend die Kompatibilitätsversion anpassen.

Max. Linie

Technisch gesehen, wird dieser Modus über eine if-Abfrage möglich, die an den Stellen verwendet wird, an denen neue Features implementiert werden. Diese Abfrage überprüft, welche Kompatibilitätsversion gesetzt ist, und führt daraufhin den entsprechenden Code aus oder blendet vorhandenen Code aus. Die Abfrage kann sowohl in PHP als auch in TypoScript formuliert werden.

48 | Kapitel 2: Wartung und Systempflege This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Diese Abfrage können Sie selbstverständlich auch in Ihrem Code nutzen – zum Beispiel um sicherzustellen, dass Ihre Applikation in unterschiedlichen TYPO3-Versionen funktioniert, etwa um alternative TypoScript-Bereiche zu definieren, in denen Sie die älteren Funktionsaufrufe verwenden und auf neue Funktionsaufrufe verzichten. Fügen Sie in Ihren Code Bedingungen ein, in denen Sie die Kompatibilitätsversion abfragen. Die Version setzt sich immer aus der Hauptversion und der ersten Unterversion zusammen. Das Patch-Level auf der dritten Position wird nicht benötigt. Mit den folgenden Anweisungen würde der umschlossene Code zum Beispiel nur dann ausgeführt, wenn die TYPO3-Version 4.2.0 oder höher wäre: if (t3lib_div::compat_version('4.2')) { // PHP-Code }

In TypoScript können Sie die Versionsnummer mit folgender TypoScript-Bedingung auslesen und bestimmen, welcher Code bei der Generierung der Inhalte berücksichtigt werden soll: [compatVersion >= 4.2.0] # TypoScript-Code [global] Lizensiert für Markus Mueller

Dadurch können Sie alternative Codebereiche definieren, in denen Sie die älteren Funktionsaufrufe verwenden und auf neue Funktionsaufrufe verzichten. Indem Sie mögliche Versionsunterschiede abfangen, wird Ihr Code flexibler und läuft in unterschiedlichen TYPO3-Versionen stabil.

Siehe auch Wenn Sie im Kompatibilitätsmodus den TypoScript-Object-Browser nutzen, sollten Sie darauf achten, dass Sie die jeweiligen Conditions aktivieren. Ansonsten sehen Sie nur die TypoScript-Werte der TYPO3-Version 3.8. Weitere Anwendungsmöglichkeiten mit dem TypoScript-Object-Browser finden Sie in Rezept 8.3.

2.4

Die Website temporär für Wartungsarbeiten sperren

Problem Sie möchten Wartungsarbeiten an Ihrer Website durchführen und Ihren Besuchern eine entsprechende Meldung ausgeben. Gleichzeitig soll das Backend für alle Redakteure gesperrt werden, damit nicht aus Versehen Inhalte verloren gehen.

Max. Linie

Max. Linie 2.4 Die Website temporär für Wartungsarbeiten sperren | 49 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Lösung

Links

Sperren Sie das Backend, um auszuschließen, dass während der Wartungsarbeiten Inhalte eingepflegt werden und möglicherweise Daten verloren gehen. Des Weiteren können Sie Ihren Besuchern eine Meldung im Frontend ausgeben, auf die alle Anfragen umgeleitet werden. Setzen Sie dazu im Install-Tool die Optionen adminOnly und pageUnavailable_force auf den Wert 1 oder geben Sie die beiden Werte direkt in die Datei localconf.php ein, indem Sie dort folgende Zeilen einfügen: $TYPO3_CONF_VARS['BE']['adminOnly'] = 1; $TYPO3_CONF_VARS['FE']['pageUnavailable_force'] = 1;

Leeren Sie nach dem Abspeichern den Extension-Cache. Nun gibt TYPO3 für Besucher und normale Backend-Benutzer beim Seitenaufruf im Frontend und Backend eine Fehlermeldung aus. Beachten Sie, dass Administratoren weiterhin Zugriff auf das Backend haben. Ebenso sehen Benutzer, deren IP-Adresse in $TYPO3_CONF_VARS['SYS']['devIPmask'] angegeben ist, die Website wie gewohnt. Lizensiert für Markus Mueller

Diskussion Mit den oben genannten Einstellungen weisen Sie TYPO3 an, bei schwerwiegenden Serverfehlern eine entsprechende Meldung auszugeben. Diese Meldungen erscheinen zum Beispiel dann, wenn Schwierigkeiten bei der Verbindung zum Datenbankserver auftreten. TYPO3 sendet in diesem Fall den HTTP-Status: HTTP/1.0 503 Service Temporarily Unavailable

Wenn Ihnen ein anderer Status sinnvoller erscheint, können Sie ihn mit der Option pageUnavailable_handling_statheader im Install-Tool anpassen. Auf Ihrer Webseite erscheint im Fehlerfall standardmäßig eine TYPO3-Fehlermeldung. Diese Standardmeldung können Sie an das Erscheinungsbild Ihrer Website anpassen, indem Sie zum Beispiel eine individuelle HTML-Seite ausgeben. TYPO3 bietet Ihnen mit der Option pageUnavailable_handling die Möglichkeit, vollständig Einfluss auf das Fehlerverhalten zu nehmen und den Prozess nach eigenen Wünschen zu modifizieren. Die Option erwartet dabei immer eine Zeichenkette, die je nach Einsatzgebiet nach einem bestimmten Muster aufgebaut sein muss: Auf eine andere Domain umleiten Beginnt der Wert mit dem Präfix REDIRECT:, wird TYPO3 den Besucher auf die angegebene Website umleiten.

Max. Linie

$TYPO3_CONF_VARS['FE']['pageUnavailable_handling'] = ' REDIRECT:http://www.example.com ';

50 | Kapitel 2: Wartung und Systempflege This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Eine statische HTML-Datei auslesen Beginnt der Wert mit READFILE: wird TYPO3 die Datei auslesen und deren Inhalt ausgeben. In der Datei können Sie diese Marker nutzen, um dynamische Werte im Template zu positionieren: ###CURRENT_URL### wird mit der Umgebungsvariablen REQUEST_URI ersetzt, der Marker ###REASON### mit dem Grund für die Fehlermeldung. $TYPO3_CONF_VARS['FE']['pageUnavailable_handling'] = ' READFILE:fileadmin/errors/503.html ';

Das Fehlerverhalten über eine eigene Logik implementieren Beginnt der Wert mit dem Präfix USER_FUNCTION:, wird TYPO3 die nachfolgende Dateireferenz auflösen und das angegebene Skript initiieren. Die Datei und deren Inhalt müssen bestimmte Konventionen einhalten: Sie muss eine PHP-Klasse namens user_pageUnavailable enthalten, die wiederum eine Methode pageUnavailable() benötigt, die die beiden Parameter $param und $ref erwartet. Diese Parameter werden von TYPO3 gefüllt und können dann in der Klasse verwendet werden. $params enthält ein Array mit den Werten currentUrl, reasonText und pageAccessFailureReasons. $ref enthält eine Referenz auf das Seiten-Objekt von TYPO3 (TSFE). Lizensiert für Markus Mueller

$TYPO3_CONF_VARS['FE']['pageUnavailable_handling'] = ' USER_FUNCTION:typo3conf/pageUnavailableHandling.php:user_pageUnavailable-> pageUnavailable ';

Der Text muss immer in einer Zeile stehen, da er sonst von TYPO3 nicht richtig interpretiert wird. Wir haben den Code nur der Übersichtlichkeit halber in mehrere Zeilen aufgeteilt.

Achten Sie darauf, dass die Meldung im Ernstfall nur bei schwerwiegenden Problemen erscheinen. In diesen Situationen kann es sein, dass TYPO3 auch nicht mehr wie gewohnt reagiert oder unvollständig geladen wird. Sie sollten daher auf so wenig TYPO3-Features wie nötig zurückgreifen und Fehlermeldungen auch serverseitig abfangen.

Siehe auch Rezept 9.9 geht darauf ein, wie Sie Ihren Benutzern eine individuelle Fehlerseite für den Status »404 - Seite nicht gefunden« präsentieren können. Indem Sie die beiden Fehlercodes individuell abfangen, können Sie Ihre Website auch im Fehlerfall benutzerfreundlich halten. Eine Übersicht der möglichen HTTP-Fehlercodes finden Sie auf dieser Seite in Englisch: http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.4.

Max. Linie

Max. Linie 2.4 Die Website temporär für Wartungsarbeiten sperren | 51 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

2.5

Die Datenbank prüfen und warten

Links

Problem Sie möchten Ihre TYPO3-Datenbank an die aktuelle TYPO3-Konfiguration anpassen. Das ist vor allem bei einer Aktualisierung der TYPO3-Version notwendig, weil bei einem Update oftmals einzelne Felder oder Tabellen der bestehenden Datenbank hinzugefügt oder geändert werden müssen. Demgegenüber kann es nach der Deinstallation oder Modifikation von Extensions sowie vor einem Datenbank-Backup sinnvoll sein, nicht mehr benötigte Tabellen und Daten aus der Datenbank zu entfernen.

Lösung Das Install-Tool stellt mit dem Database Analyzer ein mächtiges Werkzeug bereit, um eine laufende TYPO3-Datenbank in Schuss zu halten. Mit dem Database-Analyzer können Sie: • das Datenbankschema auf Konsistenz prüfen und gegebenenfalls anpassen, Lizensiert für Markus Mueller

• Datenbank-Dumps aus SQL-Dateien in typo3conf/ einspielen, • Daten in die Systemtabellen static_* einspielen sowie • einige weitere datenbankorientierte Operationen durchführen. Der Database-Analyzer stellt Ihnen damit ein sehr wichtiges Werkzeug zur Prüfung und Verwaltung Ihres Datenbankschemas zur Verfügung. Mindestens nach einem Update der TYPO3-Installation ist seine Verwendung wegen eines möglicherweise geänderten Datenbankschemas Pflicht. Um den Database-Analyzer aufzurufen, wechseln Sie in das Modul Installation im Bereich Admin-Werkzeuge. Bestätigen Sie den nun folgenden Hinweis zur Absicherung des Install-Tools durch einen Klick auf OK und geben Sie das Passwort für den Zugang zum Install-Tool ein. Für den Zugang zum Install-Tool benötigen Sie besondere Rechte bzw. ein separates Passwort, das sich vom Administratorpasswort unterscheiden sollte (standardmäßig ist das Passwort joh316 voreingestellt). Wählen Sie anschließend aus dem Menü den Eintrag Database Analyzer.

Das Datenbankschema prüfen

Max. Linie

Klicken Sie ganz unten neben der Bezeichnung Update required tables auf den Link COMPARE. Das Install-Tool führt daraufhin einen Abgleich zwischen den in TYPO3 und den Extensions abgelegten Metainformationen zur Datenbank und der tatsächlich in der Datenbank vorhandenen Struktur durch. Wenn Sie nach diesem Aufruf eine Meldung Table and field definitions are OK. erhalten, können Sie die Überprüfung an dieser

52 | Kapitel 2: Wartung und Systempflege This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Stelle bereits abschließen. In anderen Fällen erhalten Sie eine Liste mit allen Abweichungen, die TYPO3 ermittelt hat. In dieser Liste ist jeder Eintrag jeweils mit einem Kontrollkästchen versehen. Unter den Überschriften Add fields und Add tables werden Felder und Tabellen gelistet, die aufgrund der Konfiguration von TYPO3 erwartet werden, die sich aber nicht in der Datenbank finden lassen. Bei diesen Einträgen werden die Kontrollkästchen automatisch aktiviert. Solange Sie Einträge unter den Bezeichnungen Add Fields oder Add tables finden, können bei der Arbeit mit TYPO3 schwer wiegende Probleme auftreten.

Lizensiert für Markus Mueller

Zusätzlich enthält die Liste unter Remove unused fields (rename with prefix) und Removing tables (rename with prefix) alle Felder und Tabellen, die in der Datenbank vorhanden sind, die aber ausgehend von der aktuellen Konfiguration nicht mehr benötigt werden. Eine möglicherweise sinnvolle Löschung muss explizit manuell veranlasst werden und wird zweistufig durchgeführt. Um jedes Restrisiko bei einer Löschung auszuschließen, werden die ausgewählten Felder und Tabellen von TYPO3 im ersten Schritt lediglich umbenannt und mit einem Präfix zzz_deleted* versehen. Nur Felder und Tabellen, deren Bezeichnung bereits mit zzz_deleted* beginnt, werden tatsächlich gelöscht. Lassen Sie TYPO3 solche Tabellen und Felder zunächst umbenennen. Danach können Sie wie gewohnt mit TYPO3 arbeiten. Erst wenn Sie nach einiger Zeit keine Probleme feststellen, entfernen Sie diese endgültig.

Für alle Änderungen ist unbedingt ein abschließender Klick auf Write to database erforderlich. Erst dadurch werden Ihre Änderungen tatsächlich in der Datenbank durchgeführt.

Statische Daten importieren Einige Extensions liefern nicht nur ein bestimmtes Tabellenschema mit, sondern auch noch zusätzlich Daten, mit denen diese Tabellen gefüllt werden sollen. Hierunter fallen beispielsweise die vorgefertigten TypoScript-Templates, die in der Tabelle static_template gespeichert werden, sowie die Daten für die eingebaute TypoScript-Referenz in der Tabelle static_tsconfig_help. Neben der Bezeichnung Dump static data finden Sie den Link IMPORT. Über diesen Link rufen Sie eine Liste aller Tabellen auf, für die Daten für einen Import bereitgestellt werden. Typischerweise haben solche Tabellen das Präfix static*. Sie können nun über die Kontrollkästchen einzelne oder alle Tabellen für den Import auswählen und die Aktion durch einen Klick auf den Button Write to database ausführen.

Max. Linie

Max. Linie 2.5 Die Datenbank prüfen und warten | 53 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Links Da diese Tabellen in der Regel keine Daten von Benutzern enthalten, können Sie gefahrlos die kompletten statischen Daten auswählen und aktualisieren. So können Sie sicherstellen, dass diese Tabellen den jeweils aktuellsten Datenbestand enthalten.

Systemtabellen leeren Unter dem Link Clear tables erhalten Sie die Möglichkeit, die Inhalte aus bestimmten Systemtabellen zu entfernen. Auch hier müssen Sie die Tabellen jeweils durch Anklicken der einzelnen Kontrollkästchen auswählen und die Aktion durch Write to database bestätigen.

Lizensiert für Markus Mueller

TYPO3 erzeugt die Seiten typischerweise nicht bei jedem Aufruf, sondern speichert das Ergebnis eines einmaligen Seitenaufbaus zur späteren Verwendung in sogenannten Cache-Tabellen. Mit diesem Verfahren muss die Seite nicht jedes Mal über viele Datenbankabfragen neu aufgebaut werden, was die Serverlast reduziert. Da hierbei zum Teil komplette HTML-Ausgaben gespeichert werden, können diese Tabellen sehr groß werden. Wenn Sie die Tabellen cache_pages, cache_pagesection und cache_hash löschen, werden diese Caches gelöscht. Das Ergebnis entspricht der Funktion Alle Caches löschen in der Backend-Menüleiste. Vor einem Backup (siehe Rezept 2.9) kann dies sinnvoll sein, führt jedoch bei folgenden Seitenaufrufen zu einer erhöhten Serverlast, da die Inhalte neu aufgebaut werden müssen. Ein ausführliches Verlaufsprotokoll, mit dem Sie allerhand kontrollieren können, wird Ihnen von TYPO3 zur Verfügung gestellt. Einmal werden in der Tabelle sys_log sämtliche Benutzeraktionen aufgezeichnet, die im Backend durchgeführt werden. In der Tabelle sys_history speichert TYPO3 das Verlaufsprotokoll für jeden Datensatz ab. Dies ist beispielsweise wichtig, wenn Sie Änderungen an einem Datensatz rückgängig machen möchten oder einen Workflow eingerichtet haben. Mit der Zeit werden diese Tabellen sehr groß, wenn Sie diese Tabellen hier aber auswählen und leeren, können Sie die Größe der Datenbank verringern. Jedoch steht Ihnen diese Kontrollfunktion dann nicht mehr zur Verfügung – bedenken Sie diesen Schritt daher besonders genau, bevor Sie die Daten löschen. TYPO3 speichert für jeden Benutzer Werte in einer sogenannten Session. Damit können benutzergebundene Daten gespeichert werden (in Rezept 18.5 erfahren Sie, wie Sie das Session-Management von TYPO3 in eigenen PHP-Skripten verwenden können). Je nachdem, wie viele Besucher sich auf Ihrer Website befinden, können diese Tabellen ebenfalls sehr groß werden. Wir empfehlen, diese Tabellen nicht manuell zu löschen. Standardmäßig werden Sessions nach 24 Stunden gelöscht.

Max. Linie

Achten Sie auch darauf, dass Sie das Install-Tool nicht dauerhaft geöffnet lassen, denn hier waltet keine Session – jeder kann das Install-Tool weiterverwenden, wenn Sie das Fenster nicht schließen.

54 | Kapitel 2: Wartung und Systempflege This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Diskussion Insbesondere durch die Evaluierung und den Test von Extensions werden oftmals zusätzliche Tabellen und Felder in der Datenbank angelegt. Aus Gründen der Datensicherheit werden diese bei der Deinstallation einer Extension aber nicht wieder entfernt. Damit stehen Ihnen bereits anlegte Daten bei einer erneuten Installation wieder zur Verfügung. Sie sollten aber, je nach Grad der Entwicklungstätigkeit, regelmäßig prüfen, ob Ihre Datenbank nicht unnötigen Ballast enthält, und diesen gegebenenfalls entsorgen. Der Database Analyser greift bei der Prüfung auf die in dem Array $TCA (Table Configuration Array) gespeicherte Metakonfiguration für die Datenbanktabellen zurück und prüft diese gegen die Felder und Tabellen der verwendeten Datenbank. Die im Database Analyser zusätzlich vorhandene Funktion Compare with $TCA führt eine gegenüber COMPARE noch weiter gehende Analyse aus. Hier werden alle Felder und Tabellen mit der Metakonfiguration von TYPO3 verglichen. Dadurch werden auch bestimmte Systemfelder gelistet, die prinzipbedingt nicht in der $TCA-Konfiguration enthalten sind. Diese Funktion wird jedoch für normale Wartungsarbeiten nicht benötigt.

Datenbank-Dumps in typo3conf/ Lizensiert für Markus Mueller

Mit dem Database Analyser können auch eigene Datenbank-Dumps importiert werden. Dazu werden entsprechende SQL-Dateien im Ordner typo3conf/ erwartet. Wenn der Database Analyser dort solch eine Datei vorfindet, sind für jede dieser Dateien die Funktionen IMPORT, COMPARE und VIEW verfügbar. Dies ist nützlich, um die Installation mit einem lauffähigen Beispielprojekt zu bestücken. So können Seitenstrukturen, Inhalte, Benutzer und TypoScript-Templates übernommen werden.

Hinweise zum Namensschema von Tabellen Tabellen von Extensions sehen standardmäßig so aus: tx_extkey_name

Zusätzliche Felder von Extensions präsentieren sich standardmäßig so: tabelle.tx_extkey_feld

Die TYPO3-Standardtabellen Die folgende Aufstellung gibt Ihnen einen Überblick über alle von einer jungfräulichen TYPO3-Standardinstallation verwendeten Tabellen sowie deren Sinn und Zweck: be_groups Daten der Backend-Benutzergruppen.

Max. Linie

be_sessions Session-Informationen der angemeldeten Backend-Benutzer.

2.5 Die Datenbank prüfen und warten | 55 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

be_users Profile der Backend-Benutzer.

Links

cache_hash Referenzierungsdaten für den Cache-Mechanismus. Diese Tabelle wird vollständig geleert, wenn Sie den Button FE-Cache löschen anklicken. cache_imagesizes Daten für den Cache-Mechanismus von Vorschaubildern. cache_md5params MD5-Werte von URL-Parametern (nur in Verbindung mit der Option simulateStaticDocuments). cache_pages Daten für den Cache-Mechanismus von Seiten. Umfangreiche Datenbankabfragen zur Erstellung dieser Seiten können dadurch entfallen. Diese Tabelle wird vollständig geleert, wenn Sie den Button FE-Cache löschen anklicken. cache_pagesection Daten für den Cache-Mechanismus von Seiteninhalten. Diese Tabelle wird vollständig geleert, wenn Sie den Button FE-Cache löschen anklicken. Lizensiert für Markus Mueller

cache_typo3temp_log Referenzierungsdaten für den Cache-Mechanismus von temporären Dateien. fe_groups Daten der Frontend-Benutzergruppen. fe_sessions Session-Informationen von Frontend-Besuchern. fe_session_data Session-Daten von Frontend-Besuchern. fe_users Daten der Frontend-Benutzer. pages Die Seitenstruktur und -daten. Diese Tabelle bildet über das Seitenkonzept die Hauptstrukturierung aller Daten und Inhalte in TYPO3 ab. Hieraus werden die Navigationen und der Seitenbaum im Backend erzeugt. pages_language_overlay Übersetzungen von Seiten. Diese Felder überlagern die Seite der Standardseite aus der Tabelle pages. static_template Standard-TypoScript-Templates.

Max. Linie

static_tsconfig_help Inhalte des TSconfig-Hilfesystems.

56 | Kapitel 2: Wartung und Systempflege This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

sys_be_shortcuts Backend-Shortcuts. sys_domain Domain-Datensätze. sys_filemounts Mount-Punkte im Dateisystem. sys_history Verlaufsprotokoll für einzelne Datensätze. sys_language Aktivierte Sprachen. sys_lockedrecords Aktuell geöffnete Datensätze. sys_log Systemprotokoll. In dieser Tabelle speichert TYPO3 das Verlaufsprotokoll, in dem beispielsweise die einzelnen Bearbeitungsschritte der Backend-Benutzer aufgezeichnet werden. Dieses Verlaufsprotokoll erreichen Sie über das Modul Log im Bereich Admin-Werkzeuge.

Lizensiert für Markus Mueller

sys_note Notizen von Backend-Benutzern. Diese Notizen können über das Modul Aufgaben angelegt werden, wenn Sie die Extension sys_notepad installiert haben. sys_refindex Verknüpfungen von Inhaltselementen, Dateien oder anderen Datensätzen miteinander. sys_template TypoScript-Templates. sys_workspace Informationen und Zugriffsrechte für Workspaces. tt_address Adressen-Datensätze. tt_content Inhaltselemente der Seiten. Die PID entspricht immer der Seiten-ID, in der das jeweilige Inhaltselement liegt. tx_impexp_presets Gespeicherte Exporteinstellungen. Auf diese Exporteinstellungen können Sie dann bequem über das Modul Aufgaben zugreifen (in Rezept 5.10 erfahren Sie, wie Sie mit der Exportfunktion Inhalte aus dem TYPO3-Seitenbaum auf Ihre lokale Festplatte speichern können).

Max. Linie

tx_rtehtmlarea_acronym Informationen über Akronyme oder Abkürzungen für die Verwendung im Rich Text Editor (RTE).

2.5 Die Datenbank prüfen und warten | 57 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Siehe auch

Links

Rezept 2.8 zeigt Ihnen, wie Sie den Referenzindex nutzen können, um Ihren Datenbestand weiter zu bereinigen.

2.6

Im Dateisystem aufräumen

Problem Sie möchten Ordnung in Ihren TYPO3-Verzeichnissen schaffen und nicht mehr benötigte Dateien entfernen, um auf Ihrem Server Platz zu schaffen und Altlasten in Ihrer TYPO3-Installation zu entsorgen.

Lösung

Lizensiert für Markus Mueller

TYPO3 erzeugt beim Betrieb temporäre Dateien, die zu einem späteren Zeitpunkt teilweise nicht mehr benötigt werden. Außerdem beinhaltet der TYPO3-Quellcode einige Dateien, die für einen regulären Betrieb nicht erforderlich sind. Zusätzlich haben Sie möglicherweise einige Extensions ausprobiert, die aber gar nicht in den produktiven Betrieb übernommen wurden. Die folgenden Punkte helfen Ihnen, unnötigen Ballast zu entsorgen und Ihr TYPO3-Projekt zu entschlacken: • Löschen Sie nicht verwendete Extensions im Ordner typo3conf/ext/. • Leeren Sie regelmäßig den Ordner typo3temp/. Prinzipiell können hier alle Dateien gelöscht werden. Die Dateien werden bei Bedarf automatisch von TYPO3 neu erzeugt. Leider gibt es zum Zeitpunkt der Drucklegung dieses Buchs keine Möglichkeit herauszufinden, welche Dateien noch benötigt werden und welche nicht. Eine sinnvolle Strategie ist, sich an den Zugriffszeiten zu orientieren. Je länger auf eine Datei nicht mehr zugegriffen wurde, desto höher ist die Wahrscheinlichkeit, dass sie nicht mehr benötigt wird. Das Install-Tool bietet Ihnen mit der Funktion typo3temp/ die Möglichkeit, diese temporären Dateien selektiv zu entfernen. • Das Verzeichnis misc/ im TYPO3-Quellenpaket kann grundsätzlich gefahrlos und vollständig gelöscht werden. Hier befinden sich einige zusätzliche Skripten und Beispieldateien.

Max. Linie

• Über die Funktion Database Relations im Modul Admin-Werkzeuge/DB-Überprüfung erhalten Sie eine Liste von Dateien im Ordner uploads/, die nicht mehr benötigt werden. Sollte sich hier eine größere Anzahl von Dateien gesammelt haben, können Sie diese Liste als Ausgangspunkt nehmen, um diese Dateien zu entfernen. Eine solche Löschung muss allerdings von Hand vorgenommen werden, da das Modul derzeit keine Funktionalität zum direkten Löschen bereitstellt.

58 | Kapitel 2: Wartung und Systempflege This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Diskussion Neben dem Ordner für lokale Extensions typo3conf/ext sollten Sie auch in der Liste der globalen Extensions in typo3/ext prüfen, ob diese noch verwendet werden oder möglicherweise gelöscht werden können. Eine Übersicht der vorhandenen Extensions erhalten Sie, wenn Sie sich am TYPO3Backend der gewünschten Installation anmelden und in den Erweiterungs-Manager wechseln. Wählen Sie dann im Funktionsmenü Install extensions. Als Sortierung sollten Sie in dem Auswahlfeld group by die Option type wählen. Alle Extensions, bei denen links das kleine Icon grau unterlegt ist, werden momentan nicht verwendet und können entfernt werden. Auf die globalen Extensions wird je nach Installationsart und Betriebssystem möglicherweise von mehreren TYPO3-Installationen zurückgegriffen. Beim Löschen von globalen Extensions müssen Sie darauf achten, dass die Extensions in keiner dieser TYPO3-Installationen verwendet wird.

Das Löschen der Dateien im typo3temp/-Ordner können Sie unter Linux über den folgenden kleinen Befehl erledigen: Lizensiert für Markus Mueller

find /ABSOLUTERPFAD/typo3temp/ -atime +20 -exec rm -f "{}" \;

Hiermit werden alle Dateien, deren letztes Zugriffsdatum länger als 20 Tage zurückliegt, gelöscht. Der Wert sowie der Pfad müssen auf die Gegebenheiten angepasst werden. Diese Befehlszeile lässt sich auch gut regelmäßig, beispielsweise täglich, als Cronjob ausführen.

Siehe auch Nicht mehr verwendete Extensions hinterlassen auch in der Datenbank überflüssige Daten. Das Rezept 2.5 zeigt Ihnen, wie Sie Ihre Datenbank aufräumen. Wie Sie eine Extension mit dem Erweiterungs-Manager deinstallieren oder löschen, können Sie in Rezept 15.7 nachschlagen. Rezept 2.8 zeigt Ihnen, wie Sie mit Hilfe des Referenzindex Dateileichen aufspüren können.

2.7

Den Referenzindex aktuell halten

Problem Sie möchten den Referenzindex von TYPO3 auf dem aktuellen Stand halten.

Lösung

Max. Linie

Sie können den Referenzindex als Administrator im Backend unter Admin-Werkzeuge ➝ bB-Überprüfung ➝ Manage Reference Index aufrufen. Dort haben Sie die Möglichkeit,

2.7 Den Referenzindex aktuell halten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 59

Max. Linie

den Referenzindex zu prüfen oder zu aktualisieren. Da es sich jeweils um komplexe und umfangreiche Prüfroutinen handelt, die zudem sinnvollerweise regelmäßig ausgeführt werden sollten, ist die Verwendung der webbasierten Oberfläche nur begrenzt sinnvoll.

Links

Die Funktionalität des Referenzindex wird daher auch auf der Kommandozeile zur Verfügung gestellt. Rufen Sie dazu das TYPO3-Kommandozeilen-Interface mit dem Parameter lowlevel_refindex für den Referenzindex auf: /pfad/zu/php -f /absoluter_pfad/typo3/cli_dispatch.phpsh lowlevel_refindex

Sie erhalten dann eine kurze Übersicht über die Aufrufoptionen. Mit -c wird der Referenzindex nur auf seine Konsistenz geprüft, mit -e aktualisieren Sie den Referenzindex. Ein solcher Aufruf kann dann auch als täglicher Cronjob eingetragen werden. Für die Benutzung des Kommandozeilen-Interface ist es unbedingt erforderlich, dass ein Backend-Benutzer mit dem Benutzernamen _cli_lowlevel vorhanden ist. Vor der erstmaligen Benutzung müssen Sie diesen zunächst anlegen. Bei dem Benutzer darf das Admin-Flag nicht aktiv sein. Das Kommandozeilen-Interface gibt Ihnen bei Unstimmigkeiten bezüglich des BackendBenutzers aber auch entsprechende Hinweise.

Lizensiert für Markus Mueller

Diskussion Im Referenzindex verwaltet TYPO3 Bezüge von Datensätzen zu anderen Datensätzen (und Dateien). Über den Referenzindex kann man also schnell ermitteln, ob und welche Bezüge im System für ein Element bestehen. Das kommentarlose Löschen einer Seite oder Datei, auf die von einer anderen Seite heraus verlinkt wird, ist schließlich in der Praxis selten erwünscht. Die entsprechenden Referenzbezüge werden von TYPO3 dementsprechend in der eigenen Datenbanktabelle sys_refindex verwaltet. Die Aktualisierung dieser Bezüge geschieht bei sachgemäßem Gebrauch jeweils vollständig automatisch im Hintergrund. Dennoch gibt es Situationen, in denen der Referenzindex nicht mehr 100%ig aktuell ist. Dies kann beispielsweise passieren, wenn Datenbankeinträge ohne Verwendung der TYPO3-API gelöscht wurden. Aus diesem Grund ist es sinnvoll, den Referenzindex regelmäßig zu aktualisieren. Sie können den Referenzindex jeweils täglich um 2:30 Uhr nachts aktualisieren lassen, wenn Sie auf der Befehlszeile den Befehl crontab -e aufrufen und die folgende Zeile eintragen: 30 2 * * * /pfad/zu/php -f /pfad/zu/typo3installation/typo3/cli_dispatch.phpsh lowlevel_ refindex -e

Max. Linie

Referenzen werden nicht nur über einfache Datenbankrelationen auf Feldern erfasst. Auch entsprechende Konstrukte wie im Fließtext oder FILE.file bzw. includeCSS im TypoScript-Setup werden vom Referenzindex erfasst. Solche Referenzen werden auch als softRef bezeichnet. Der Referenzindex ist lediglich ein Verzeichnis, in dem alle Bezüge der Datensätze gelistet sind. Die Meldung Index Integrity was perfect! bedeutet lediglich, dass der Index alle 60 | Kapitel 2: Wartung und Systempflege This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

aktuellen Bezüge beinhaltet. Der Referenzindex selbst übernimmt keinerlei Prüfung, ob diese Bezüge noch intakt (d.h. erreichbar/abrufbar) sind. Für eine solche Überprüfung steht die in Rezept 2.8 besprochene Funktion lowlevel_cleaner zur Verfügung.

2.8

Den Referenzindex nutzen

Problem Sie möchten den Referenzindex nutzen, um die Datenintegrität Ihrer Installation zu prüfen und fehlerfrei zu halten.

Lösung Die Wartungsfunktionalitäten, die auf dem in Rezept 2.7 beschriebenen Referenzindex basieren, stehen ausschließlich auf der Kommandozeile zur Verfügung. Rufen Sie dazu das TYPO3-Kommandozeilen-Interface für das Analyse- und Wartungswerkzeug mit dem Parameter lowlevel_cleaner auf: /pfad/zu/php -f /absoluter_pfad/typo3/cli_dispatch.phpsh lowlevel_cleaner Lizensiert für Markus Mueller

Sie erhalten dann eine im GNU-Manual-Style verfasste Anleitung, mit der Sie die verschiedenen Funktionen nutzen können. Für die Benutzung des Kommandozeilen-Interface ist es unbedingt erforderlich, dass ein Backend-Benutzer mit dem Benutzernamen _cli_lowlevel vorhanden ist. Vor der erstmaligen Benutzung müssen Sie diesen zunächst anlegen. Bei dem Benutzer darf das Admin-Flag nicht aktiv sein. Das KommandozeilenInterface gibt Ihnen bei Unstimmigkeiten bezüglich des Backend-Benutzers aber auch entsprechende Hinweise.

Diskussion Der Cleaner hält die folgenden Funktionalitäten für Sie bereit: missing_files Hiermit werden alle Datensätze ausgegeben, die auf eine nicht mehr existierende Dateiressource verweisen. Eine automatische Reparatur ist dabei nicht in allen Fällen möglich. Gegebenenfalls müssen die Datensätze von Hand geprüft oder die Dateien wiederhergestellt werden.

Max. Linie

missing_relations Gibt alle Daten aus, die auf nicht mehr existierende Referenzen verweisen. Dies kann beispielsweise passieren, weil die Zielseite eines Links in der Zwischenzeit gelöscht wurde.

2.8 Den Referenzindex nutzen | 61 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

double_files Listet alle von TYPO3 verwaltete Dateiressourcen, die doppelt referenziert werden. Dieser Test dürfte eigentlich nie ein Ergebnis liefern, weil TYPO3 keine doppelte Referenzierung für von TYPO3 verwaltete Dateiressourcen unterstützt.

Links

rte_images Prüft die Originalreferenzen zu allen RTEmagic-Bilddateien. Diese Funktionalität ist nur in Fällen relevant, in denen innerhalb des Rich Text Editor im Fließtext Bilder eingefügt werden können. lost_files Listet die von TYPO3 verwalteten Dateiressourcen (in uploads/), die nicht mehr referenziert werden, und daher gelöscht werden können. Hier ist eine automatische Korrektur möglich. orphan_records Gibt eine Übersicht über verlorene Datensätze aus. Verlorene Datensätze sind Datensätze, die keine reguläre Verknüpfung zum Seitenbaum mehr besitzen. Diese sollten gefahrlos gelöscht werden können.

Lizensiert für Markus Mueller

deleted Gibt alle als gelöscht markierten Datensätze aus. Diese können bequem automatisch entfernt werden. versions Listet Detailinformationen zu versionierten Datensätzen und Workspaces. cleanflexform Hiermit können die XML-Strukturen von Flexform-Feldern geprüft und korrigiert werden. syslog Diese Funktion listet die aktuellsten Einträge aus der Tabelle sys_log, in der TYPO3 die Benutzeraktivitäten im Backend protokolliert. Diese Funktion ist lediglich eine Hilfsfunktion, um diese Einträge automatisch per Cronjob via E-Mail zu verteilen. tx_templavoila_unusedce Diese Funktion gibt die von TemplaVoilà nicht genutzten Content-Elemente aus. Im Gegensatz zum Referenzindex aus Rezept 2.7 sind hier deutlich mehr Operationen und Optionen verfügbar. Die grundlegende Aufrufsyntax lautet: /pfad/zu/php -f /absoluter_pfad/typo3/cli_dispatch.phpsh lowlevel_cleaner FUNKTION -r

Max. Linie

Für Funktion setzen Sie die gewünschte Aktion aus der obigen Liste ein. Der Schalter -r sorgt dafür, dass die Aktion ausgeführt wird. Ohne -r erhalten Sie zunächst noch mal einen detaillierten Hilfescreen zur Verwendung des jeweiligen Tools. Mit der Option --AUTOFIX können Sie eine automatische Reparatur veranlassen, diese ist jedoch in einigen Fällen nicht möglich. In diesem Fall müssen Sie die Ausgabe des lowlevel_cleaner als Grundlage für eine manuelle Problembeseitigung nehmen.

62 | Kapitel 2: Wartung und Systempflege This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Hier die Aufrufsyntax am Beispiel von missing_files. Für [cli_dispatch.phpsh] müssen Sie den vollständigen Aufruf wie in den obigen Beispielen einsetzen, wir haben das hier der Übersichtlichkeit wegen gekürzt: # Die Hilfefunktion aufrufen [cli_dispatch.phpsh] lowlevel_cleaner missing_files # Die Funktion mssing_files ausführen [cli_dispatch.phpsh] lowlevel_cleaner missing_files -r # Soweit möglich, eine automatische Reparatur veranlassen [cli_dispatch.phpsh] lowlevel_cleaner missing_files -r --AUTOFIX

Beachten Sie, dass der lowlevel_cleaner jeweils einen aktuellen Referenzindex erfordert. Der Referenzindex wird standardmäßig jeweils vom lowlevel_cleaner auf seine Aktualität geprüft. Mit der zusätzlichen Option --refindex update können Sie auch eine Aktualisierung veranlassen, mit der option --refindex ignore veranlassen Sie, dass der cleaner den Referenzindex nicht prüft.

Mit dem folgenden Aufruf erhalten Sie eine ausführliche Zusammenfassung über die empfohlene Nutzung des lowlevel_cleaner inklusive eines Tipps zum Einbau in einen Cronjob: Lizensiert für Markus Mueller

/pfad/zu/php -f /absoluter_pfad/typo3/cli_dispatch.phpsh lowlevel_cleaner --showhowto

Siehe auch In Rezept 2.7 finden Sie einführende Hinweise zum Referenzindex und eine Hilfestellung, wie Sie diesen aktuell halten können.

2.9

Ein Backup der TYPO3-Installation erstellen

Problem Sie möchten ein Backup Ihrer TYPO3-Installation erstellen, beispielweise um einem Datenverlust vorzubeugen oder die Daten auf ein anderes System zu überspielen.

Lösung Für ein Backup einer TYPO3-Installation sind sowohl bestimmte Ordner und Dateien als auch die Datenbank zu berücksichtigen.

Backup der Ordner und Dateien

Max. Linie

In jedem Fall sollten die beiden folgenden Ordner und diese Datei vollständig gesichert werden:

2.9 Ein Backup der TYPO3-Installation erstellen | 63 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

uploads/ fileadmin/ typo3conf/localconf.php

Links

Wenn in der Datei typo3conf/localconf.php die Konfigurationsvariable $typo_ db_extTableDef_script = 'extTables.php'; gesetzt ist, muss auch die entsprechende Datei typo3conf/extTables.php mit in das Backup einbezogen werden.

Wenn Sie Extensions beim Backup berücksichtigen wollen, sollten Sie zusätzlich folgende Ordner aufnehmen: typo3conf/ext/ typo3/ext

Dateien im Ordner typo3temp/ werden beim Aufrufen der neuen Seiten automatisch neu angelegt, daher brauchen Sie diesen Ordner nicht zu sichern. Im Ordner typo3conf/ kann insbesondere auf die Cache-Dateien, die einfach anhand des mit temp* beginnenden Dateinamens erkannt werden können, verzichtet werden. Diese temporären Dateien werden beim nächsten Aufruf automatisch von TYPO3 neu angelegt.

Backup der Datenbank Lizensiert für Markus Mueller

Für ein Backup der Datenbank verwenden Sie am sinnvollsten das entsprechende Werkzeug des eingesetzten Datenbanksystems. MySQL liefert beispielsweise zu diesem Zweck das Tool mysqldump aus. Ein Backup mit diesem Werkzeug lässt sich einfach auf der Kommandozeile mit mysqldump --opt --host=localhost --user=dbbenutzer --password=dbpasswort ihre_datenbank > /pfad/datei.sql

erstellen. Dabei müssen Sie die Werte für den Datenbankbenutzer, das Passwort, den Datenbanknamen, den Datenbank-Host und den Dateinamen auf Ihre Gegebenheiten anpassen. Ab der Version 4.0 verwendet mysqldump automatisch UTF-8 als Zeichenformat. Mit der Option --default-character-set können Sie auch eine alternative Kodierung erzwingen. Beachten Sie, dass mysqldump beim Export möglicherweise Zeichensatzkonvertierungen vornimmt. Sie sollten daher immer prüfen, ob das Ergebnis des Dumps korrekt ist. Im Rezept 2.10 finden Sie einige Hilfestellungen zur Handhabung von Zeichensätzen in Verbindung mit MySQL. Mit der Option --compatible ist es möglich, den Dump automatisch in einem zu älteren MySQL-Versionen kompatiblen Format zu erzeugen. Mit der Option --compact erzeugen Sie ein kompakteres Export-Format

Unter Unix oder Linux können Sie den Dump direkt komprimieren, was eine erheblich kleinere Dateigröße bewirkt:

Max. Linie

mysqldump --opt --host=localhost --user=dbbenutzer --password=dbpasswort ihre_datenbank | gzip -c > /pfad/datei.sql.gz

64 | Kapitel 2: Wartung und Systempflege This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Ein solcher Aufruf ist auch gut, um einen regelmäßigen Cronjob zu integrieren. Wenn Ihnen der Umgang mit der Kommandozeile nicht vertraut ist, können Sie ein Backup auch über ein beliebiges anderes Werkzeug erstellen. Weit verbreitet und oftmals bei Hostern vorinstalliert ist beispielsweise phpmyadmin, ein webbasiertes Datenbankwerkzeug, das auch als eigene TYPO3-Extension verfügbar ist. Bei webbasierten BackupWerkzeugen entstehen jedoch oftmals Probleme mit größeren Datenbanken. Um die Dateigröße des Datenbank-Dumps weiter zu verringern, können Sie vor dem Backup wie in Rezept 2.5 beschrieben einige Datenbankdaten entfernen.

Diskussion Bei einem Backup stehen Sie oft vor dem Problem, dass dieses auf einem anderen Host in den Produktivbetrieb genommen werden soll. In einem solchen Fall können Sie das Datenbank-Backup auch auf bestimmte Tabellen beschränken. Ebenso bietet es sich in diesem Fall an, in der Datei typo3conf/localconf.php

ein include-Statement einzubinden, das mithilfe von PHP eine weitere Datei in die Konfiguration einbindet: Lizensiert für Markus Mueller

include_once('host_localconf.php');

Damit können Sie hostspezifische Konfigurationen, die sich in den verschiedenen Systemen unterscheiden, wie beispielsweise Pfade zu ImageMagick oder Datenbankkennungen, getrennt halten. Bei einem Backup wird diese hostspezifische Datei dann nicht berücksichtigt.

Dieses Vorgehen erfordert natürlich etwas Umsicht bei der Änderung von Konfigurationsvariablen, damit nicht unbeabsichtigt hostspezifische Variablen über das Install-Tool in die reguläre Konfigurationsdatei typo3conf/localconf.php geschrieben werden.

Max. Linie

Hilfreich kann auch die TYPO3-Extension Full Backup (w4x_backup) sein. Diese fasst die anfangs genannten Lösungsschritte zusammen, sodass Sie das Backup bequem über das Backend steuern können. Mehr Informationen zu dieser Extension finden Sie unter http://typo3.org/extensions/repository//w4x_ backup/. Unter Windows sind für diese Extension jedoch zusätzliche Werkzeuge notwendig, und der Einsatz funktioniert aufgrund der Anforderungen nicht in jeder TYPO3-Umgebung

2.9 Ein Backup der TYPO3-Installation erstellen | 65 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Links

Siehe auch In Rezept 5.10 erfahren Sie, wie Sie Inhalte direkt aus TYPO3 heraus lokal sichern können. Im folgenden Rezept 2.10 finden Sie einige Hilfestellungen zur Handhabung von Zeichensätzen in Verbindung mit TYPO3 und MySQL, die sich auch auf den Backup-Prozess auswirken können.

2.10 Den Zeichensatz einer bestehenden TYPO3Installation prüfen und auf UTF-8 umstellen Problem Sie möchten Ihre bereits in Betrieb befindliche Website in den UTF-8-Zeichensatz konvertieren oder auch nur deren korrekte Zeichensatzkodierungen überprüfen. Die Verwendung von UTF-8 ist vor allem sinnvoll, wenn Sie Sprachen verwenden wollen, die nicht auf dem lateinischen Alphabet basieren. Aber auch ohne chinesische Inhalte ist UTF-8 ein zukunftsfähiger Standard und hilft, Probleme beim Datenaustausch zu vermeiden. Lizensiert für Markus Mueller

Lösung Eine saubere Zeichensatzkonvertierung und -handhabung ist eine komplexe Aufgabenstellung, bei der auch mit umfangreicher Erfahrung immer wieder kleinere Probleme auftreten können. Sie sollten für dieses Rezept etwas Geduld mitbringen. Wir haben auch eine entsprechende Extension zu diesem Rezept bereitgestellt, die Ihnen umfangreiche Hilfestellung bei der Konvertierung bietet.

Bevor Sie Ihre Daten sauber nach UTF-8 konvertieren können, müssen Sie zunächst einmal herausfinden, in welcher Kodierung Ihre Daten momentan vorliegen. Das klingt wesentlich trivialer, als es in der Praxis ist. Technisch bedingt gibt es keine sichere Möglichkeit, den tatsächlich verwendeten Zeichensatz einer Zeichenkette zu bestimmen. Allenfalls kann man sich den Text in verschiedenen Kodierungen ansehen und dann prüfen, ob die gewünschten Sonderzeichen korrekt dargestellt werden. Dabei spielen aber auch die Einstellungen des verwendeten Text-Editors, der Betriebssystemumgebung und auch des Datenbankservers eine Rolle. Leider kommt es leicht zu unsauber kodierten Daten, was nicht immer sofort auffällt, da sich die Fehler innerhalb einer bestimmten Umgebung (beispielsweise TYPO3) gegenseitig aufheben und alles korrekt erscheint. Um Ihre Ausgangssituation für eine erfolgreiche Konvertierung zu berücksichtigen, teilt sich die Lösung in die folgenden vier Schritte auf:

Max. Linie

1. Den in der DB hinterlegten Zeichensatz bestimmen 2. Die Zeichensatzhandhabung der MySQL-Verbindung analysieren

66 | Kapitel 2: Wartung und Systempflege This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

3. Die Zeichensatzkonfiguration von TYPO3 bestimmen 4. Einen Datenexport und -import vornehmen Wenn Ihre Daten, insbesondere die Umlaute, sowohl mit dem MySQL-Kommandozeilenwerkzeug als auch mit phpMyAdmin korrekt dargestellt werden, spricht dies für ein korrektes Datenformat. Sollten Ihre Daten innerhalb von TYPO3 vollständig korrekt verarbeitet werden, aber beispielsweise mit phpMyAdmin nicht völlig richtig angezeigt werden, ist dies ein ernst zu nehmendes Zeichen dafür, dass möglicherweise etwas mit den Kodierungen nicht stimmt. Die folgenden Ausführungen helfen Ihnen dann, die Probleme zu analysieren und zu beseitigen.

In der Datenbank hinterlegter Zeichensatz

Lizensiert für Markus Mueller

Bei aktuellen MySQL-Versionen (ab 4.1) ist der Zeichensatz einzeln für jedes (Text-)Feld einer Tabelle festgelegt. Dabei wird dieser Zeichensatz ohne weitere Vorkehrungen beim Erzeugen von Tabellen bzw. Spalten automatisch von der übergeordneten Ebene (Server, Datenbank, Tabelle) vererbt. In der Regel wird man innerhalb einer Datenbank durchgängig eine Zeichensatzkodierung verwenden, dies ist aber prinzipiell nicht zwingend erforderlich. Mit dem folgenden SQL-Befehl können Sie sich einen einfachen Überblick über alle in Ihrer TYPO3-Datenbank hinterlegten Zeichensätze verschaffen, für TYPO3_DB setzen Sie bitte den Namen Ihrer TYPO3-Datenbank ein: mysql> SELECT distinct(character_set_name) FROM INFORMATION_SCHEMA.COLUMNS WHERE table_schema = 'TYPO3_DB' AND NOT character_set_name IS NULL;

Die INFORMATION_SCHEMA-Tabellen sind erst ab MySQL-Version 5.02 verfügbar. In MySQL-Versionen ab 4.1 können Sie die Informationen zu den für die einzelnen Felder konfigurierten Zeichensätzen über den folgenden SQLBefehl erhalten: mysql> SHOW FULL COLUMNS FROM TYPO3_DB.tbl_name;

MySQL-Versionen vor 4.1 unterstützen Zeichensätze nicht auf Spaltenebene.

Mit diesen Befehlen sollten Sie ermitteln können, welche Zeichensatzkodierung im MySQL-Server für Ihre Daten hinterlegt ist. Normalerweise sollte dies entweder latin1 oder utf8 sein. Sollte der seltene Fall eintreten, dass Sie mehrere verschiedene Kodierungen verwenden, hilft Ihnen der folgende Befehl, die hinterlegte Zeichensatzkoderung für die einzelnen Felder/Spalten zu ermitteln: mysql> SELECT table_name,column_name,character_set_name,collation_name FROM INFORMATION_ SCHEMA.COLUMNS WHERE table_schema = 'TYPO3_DB' AND NOT character_set_name IS NULL ORDER BY table_name,character_set_name,column_name;

Max. Linie

Das vierspaltige Ergebnis gibt den Tabellennamen, den Feldnamen sowie den konfigurierten Zeichensatz und den konfigurierten Sortier-/Such-Algorithmus aus. Letzterer wird als collation bezeichnet und ist eng mit dem Zeichensatz verbunden.

2.10 Den Zeichensatz einer bestehenden TYPO3-Installation prüfen und auf UTF-8 umstellen | 67 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Damit haben wir den ersten Schritt für eine erfolgreiche Konvertierung und Handhabung erledigt. Wir wissen nun, welcher Zeichensatz in MySQL zur Speicherung der Daten hinterlegt ist, diesen bezeichnen wir im Folgenden mit »Zeichensatz-Datenbank«.

Links

Dieser Wert bedeutet noch nicht, dass die Daten auch wirklich korrekt in der entsprechenden Kodierung vorliegen. Erst mal ist dieser Wert nur der Wert, von dem MySQL bei der Verarbeitung ausgeht. Es ist technisch nicht möglich, herauszufinden, ob die Kodierung der angelieferten Daten auch entsprechend korrekt ist. Wie wir gleich noch sehen werden, kann es durchaus zu abweichend oder falsch kodierten Daten kommen.

Zeichensatzhandhabung der MySQL-Verbindung Neben den bei den einzelnen Feldern einer Datenbank hinterlegten Zeichensatzkodierungen nehmen einige weitere Optionen einen starken Einfluss auf die Datenhandhabung bei den SQL-Abfragen und -Ergebnissen. Um die Thematik Zeichensatzkodierung in den Griff zu bekommen, ist ein Verständnis für die grundsätzliche Handhabung der Zeichensätze in MySQL bei den Abfrage-Ergebnis-Zyklen sehr empfehlenswert, dieses werden wir im Folgenden vermitteln. Lizensiert für Markus Mueller

Zunächst sind die folgenden drei Einstellungen für den Anfrage-Ergebnis-Zyklus zwischen einer MySQL-Clientanfrage und dem MySQL-Server von zentraler Bedeutung: character_set_client Mit diesem Wert teilt der Client dem MySQL-Server mit, welche Zeichensatzkodierung er bei den Anfragen verwendet. character_set_connection Dieser Wert legt den Zeichensatz fest, den der MySQL-Server verwendet, nachdem er eine Anfrage erhalten hat. Wenn dieser Wert nicht dem Wert in character_set_client entspricht, konvertiert MySQL die eintreffenden Daten entsprechend. Die Konvertierung läuft von character_set_client zu character_set_connection. Der Wert ist nur für eingehende Anfragen und in Verbindung mit character_set_client relevant. character_set_result Mit diesem Wert wird dem MySQL-Server mitgeteilt, in welchem Zeichensatz er die Ergebnisse zurückliefern soll. Ausgehend von dem Zeichensatz, der für die Datenbank, die Tabelle oder die Spalte gesetzt wurde, werden die Daten des Ergebnisses nötigenfalls in diesen Zeichensatz konvertiert. Mit dem folgenden SQL-Befehl können Sie diese Parameter für Ihre aktuelle Session ermitteln: mysql> SHOW VARIABLES LIKE 'character_set_%';

Max. Linie

Relevant sind hier nur die oben genannten drei Parameter character_set_client, character_set_connection und character_set_result. Diese drei Werte sollten im Normalfall übereinstimmen.

68 | Kapitel 2: Wartung und Systempflege This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts Beachten Sie, dass diese Werte nur innerhalb der jeweiligen Session gültig sind. Diese Abfrage führt aus diesem Grund innerhalb der TYPO3-DB-API, dem MySQL-Konsolenclient und phpMyAdmin oft zu verschiedenen Ergebnissen. Zur Untersuchung Ihrer Ausgangslage sind jedoch nur die von TYPO3 verwendeten Werte relevant. Die Werte dieser drei Variablen sind im MySQL-Modul von PHP standardmäßig immer auf latin1 gesetzt. Um die Werte entsprechend zu beeinflussen, steht in TYPO3 die Option setDBinit im Install-Tool zur Verfügung, die dann dafür sorgt, dass die Datenbankverbindung von TYPO3 entsprechend initialisiert wird. Die Extension zu diesem Rezept zeigt Ihnen die von TYPO3 verwendeten Werte an.

Diesen Wert nennen wir im folgenden »Zeichensatz-Verbindung«.

Zeichensatz-Konfiguration TYPO3 Nun müssen Sie prüfen, welchen Zeichensatz TYPO3 bisher verwendet hat. Wenn Sie bereits die Option forceCharset im Install-Toll gesetzt haben, ist dies der Zeichensatz, den TYPO3 zum Verarbeiten und Speichern verwendet hat. Sollten Sie forceCharset bisher nicht verwendet haben, benutzt TYPO3 standardmäßig den Zeichensatz ISO 8859-1. Dies ist auch unproblematisch, weil dieser zumindest die in Westeuropa verwendeten Sprachen – bis auf wenige Sonderzeichen – vollständig unterstützt. Lizensiert für Markus Mueller

Max. Linie

Diesen Zeichensatz bezeichnen wir als »Zeichensatz-TYPO3«.

Datenexport und -import Nachdem wir nun die drei Parameter Zeichensatz-Datenbank, Zeichensatz-Verbindung und Zeichensatz-TYPO3 ermittelt haben, können wir uns mit der Datenübernahme befassen. Die folgende Tabelle gibt eine Übersicht über alle möglichen auftretenden Kombinationen: Zeichensatz-TYPO3

Zeichensatz-Verbindung

Zeichensatz-Datenbank

Ergebnis

Latin1

Latin1

Latin1

OK: Latin1

Latin1

Latin1

UTF-8

OK: UTF-8 (TYPO3 vor 4.2: Binärfelder: Latin1)

Latin1

UTF-8

Latin1

nicht möglich, sofern Umlaute verwendet werden

Latin1

UTF-8

UTF-8

nicht möglich, sofern Umlaute verwendet werden

UTF-8

Latin1

Latin1

durchgängig UTF-8-kodierte Daten in Latin1-Datenbank

UTF-8

Latin1

UTF-8

doppelt UTF-8-kodierte Daten in Datenbank (TYPO3 vor 4.2: Binärfelder: korrektes UTF-8)

UTF-8

UTF-8

Latin1

OK: Latin1 (TYPO3 vor 4.2: Binärfelder: UTF-8)

UTF-8

UTF-8

UTF-8

OK: UTF-8

2.10 Den Zeichensatz einer bestehenden TYPO3-Installation prüfen und auf UTF-8 umstellen | 69 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

mysqldump bei UTF-8-kodierten Daten in der Latin1-Datenbank

Links

Verwenden Sie das folgende mysqldump-Kommando, für USER und TYPO3_DB setzen Sie dabei die entsprechenden Werte ein: mysqldump -u USER -p --default-character-set=latin1 TYPO3_DB > t3dbdump.sql

Da es sich aus Sicht von MySQL um eine Latin1-Datenbank handelt, werden keine Konvertierungen durchgeführt, wenn Sie Latin1 als gewünschten Zeichensatz für den Dump angeben. Im Ergebnis haben Sie dann korrekt kodierte UTF-8-Daten in der Dump-Datei.

mysqldump bei doppelt UTF-8-kodierten Daten Da TYPO3 aus Sicht von MySQL Latin1-kodierte Daten angeliefert hat (ZeichensatzVerbindung Latin1), wurden diese von MySQL beim Speichern von Latin1 in UTF-8 konvertiert. Beim Auslesen der Daten hat MySQL das Ergebnis wiederum von UTF-8 in Latin1 umgewandelt. Damit kommen die Daten in TYPO3 wieder korrekt in UTF-8 an. Innerhalb von TYPO3 fällt auch dieses Problem deswegen nicht auf. Verwenden Sie das folgende mysqldump-Kommando, für USER und TYPO3_DB setzen sie dabei die entsprechenden Werte ein: Lizensiert für Markus Mueller

mysqldump -u USER -p --default-character-set=latin1 TYPO3_DB > t3dbdump.sql

Auch wenn Sie hier vermeintlich eine UTF-8-Datenbank in den Zeichensatz Latin1 konvertieren, das Ergebnis ist eine korrekte UTF-8-kodierte Datei. Mit diesem Befehl macht mysqldump lediglich die doppelt durchgeführte Konvertierung rückgängig.

mysqldump für alle anderen Fälle Verwenden Sie das folgende mysqldump-Kommando, für USER und TYPO3_DB setzen Sie dabei die entsprechenden Werte ein: mysqldump -u USER -p TYPO3_DB > t3dbdump.sql

Das weitere Vorgehen Sie haben nun in jedem Fall einen Datenbank-Dump, der korrekt UTF-8-kodierte Daten enthält.

Max. Linie

Allerdings speichert mysqldump den beim Dump verwendeten Zeichensatz, ebenso wie den Zeichensatz der Datenbank, innerhalb der Dump-Datei. Da Ihre Daten nun aber UTF-8kodiert vorliegen und auch die Zieldatenbank die UTF-8-Kodierung verwenden soll, müssen Sie nun in der erzeugten Datei mit einem beliebigen Text-Editor alle Vorkommen der Zeichenkette latin1 suchen und durch utf8 (innerhalb von SET NAMES latin1 oder DEFAULT CHARSET latin1) ersetzen. Achten Sie dabei darauf, dass alle Zeichen in Ihrem Editor korrekt dargestellt und nicht möglicherweise von diesem konvertiert werden. Unter Linux

70 | Kapitel 2: Wartung und Systempflege This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

eignen sich hier alle Editoren, unter Windows ist Notepad++ ein geeignetes Werkzeug. Nachdem Sie in t3dbdump.sql latin1 durch utf8 ersetzt haben, kann die Datei direkt in eine korrekt für UTF-8 eingerichtete TYPO3-Installation eingespielt werden. Beachten Sie dazu das Rezept 1.9 und führen Sie die dort genannten Schritte aus. Nachdem Sie die Installation korrekt eingerichtet haben, können Sie den Datenbank-Dump mit dem folgenden Befehl einspielen: mysql -u USER -p TYPO3_DB < t3dbdump.sql

Beachten Sie, dass auch die von TYPO3 verwendeten HTML-Vorlagen nun in UTF-8 kodiert sein sollten. Vorhandene Dateien können Sie leicht mit dem Werkzeug recode nach UTF-8 konvertieren: recode latin1..utf-8 latin 1datei.html

Achten Sie darauf, dass Sie zur formatierten Ausgabe von Datumsangaben auch das TypoScript-Setup config.locale_all auf einen entsprechenden Wert mit UTF-8-Unterstützung setzen sollten: config.locale_all=de_DE.UTF-8

Diskussion Lizensiert für Markus Mueller

Die folgende Liste hilft Ihnen bei der Überprüfung möglicher Fehlerquellen und gibt Ihnen einige nützliche Hintergrundinformationen: Betriebssystem unterstützt den Zeichensatz? Ihr Betriebssystem sollte grundsätzlich UTF-8 verarbeiten können. Das ist in allen modernen Betriebsystemen der Fall. Unter Linux sollten Sie ein entsprechendes Locale mit UTF-8-Unterstützung einrichten. Mit dem folgenden Befehl können Sie auf der Kommandozeile alle unterstützten Lokalisierungseinstellungen einsehen: user@rechner:~$ locale -a

Terminal/Textverarbeitungsprogramm stellt Text in UTF-8 dar? Prüfen Sie sicherheitshalber, ob Ihr Terminal und Ihre Editoren für UTF-8 eingerichtet sind. MySQL-Kommandozeile. Auf der MySQL-Kommandozeile können Sie mit den folgenden Befehlen den für die Kommunikation zu verwendenden Zeichensatz festlegen: mysql> set names utf8

Der UTF-8-Zeichensatz wird von MySQL prinzipiell unterstützt? Stellen Sie sicher, dass die Zeichenkodierung vom MySQL-Server auch unterstützt wird. Geben Sie diesen Befehl in die MySQL-Konsole ein, um die Einstellungen zu prüfen: mysql> SHOW CHARACTER SET;

Max. Linie

In der linken Spalte muss der Wert utf8 erscheinen, wie in diesem Auszug dargestellt:

2.10 Den Zeichensatz einer bestehenden TYPO3-Installation prüfen und auf UTF-8 umstellen | 71 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

+----------+--------------------+---------------------+--------+ | Charset | Description | Default collation | Maxlen | +----------+--------------------+---------------------+--------+ | utf8 | UTF-8 Unicode | utf8_general_ci | 3 | +----------+--------------------+---------------------+--------+

Links

Ebenfalls muss bei dieser Abfrage der Wert utf8_general_ci in der Liste erscheinen: mysql> SHOW COLLATION LIKE 'utf8%';

Die Tabelle sollte mindestens diese Werte zeigen: +--------------------+---------+-----+---------+----------+---------+ | Collation | Charset | Id | Default | Compiled | Sortlen | +--------------------+---------+-----+---------+----------+---------+ | utf8_general_ci | utf8 | 33 | Yes | Yes | 1 | | utf8_unicode_ci | utf8 | 192 | | Yes | 8 | +--------------------+---------+-----+---------+----------+---------+

Zeichensatzkodierung der aktuellen Datenbank-Verbindung? Nutzen Sie den folgenden SQL-Befehl zur Abfrage der Zeichensatzeinstellungen einer MySQL-Verbindung: mysql> SHOW VARIABLES LIKE 'character_set_%';

Lizensiert für Markus Mueller

Daraufhin erhalten Sie eine Liste mit den momentanen Zeichensatzeinstellungen der aktuellen Verbindung. Die Liste gibt unter anderem Auskunft über den verwendeten Zeichensatz der Datenbank und über die Kodierung der MySQL-Verbindung. Beachten Sie, dass diese Werte auf der MySQL-Kommandozeile von den Werten der TYPO3-Datenbank-API abweichen können! +--------------------------+-----------------------------------------+ | Variable_name | Value | +--------------------------+-----------------------------------------+ | character_set_client | latin1 | | character_set_connection | latin1 | | character_set_database | latin1 | | character_set_filesystem | binary | | character_set_results | latin1 | | character_set_server | latin1 | | character_set_system | latin1 | +--------------------------+-----------------------------------------+

Werden Templates in TYPO3 eingebunden? Sonderzeichen in HTML-Templates werden nicht korrekt dargestellt, wenn sie nicht in UTF-8 vorliegen. Notieren Sie sich alle Templates, die konvertiert werden müssen.

Max. Linie

Sonderzeichen in PHP? Sie sollten prüfen, ob Sonderzeichen im PHP-Code enthalten sind. Sprachwerte sollten Sie unbedingt in XML-Dokumente auslagern und über die TYPO3-API ausgeben. Alternativ können Sie die PHP-Skripten auch in UTF-8 speichern. Wir empfehlen Ihnen jedoch, die Sprachwerte vollständig über die TYPO3-API einzubinden. Die dafür nötigen Schritte werden in Rezept 17.7 erläutert. System-Extensions speichern die Sprachwerte standardmäßig in diesem Format. Prüfen Sie, ob die von Ihnen installierten Extensions es diesen gleichtun.

72 | Kapitel 2: Wartung und Systempflege This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Sperren Sie das Backend für Redakteure Sorgen Sie dafür, dass während der Umstellung keine Inhalte über das Backend eingegeben werden. In Rezept 2.4 werden die dafür nötigen Schritte beschrieben. Wenn größere Redakteurteams an der Website arbeiten, sollte die Umstellung frühzeitig kommuniziert werden. In den TYPO3-Versionen kleiner als 4.2 wird das TypoScript-Setup in einem Feld mit einem binären Datentyp gespeichert, in TYPO3-Versionen kleiner als 4.1 gilt das auch für Page- und User-TSconfig. Dies führt unter gewissen Umständen bei der Konvertierung zu Problemen mit Sonderzeichen oder Umlauten in diesen Feldern. Aktualisieren Sie Ihre Installation also erst nach dem Durcharbeiten diese Rezepts.

Die Datenbankparameter im Detail Die Parameter sind aufgeteilt in zwei Gruppen: die »Verbindungs- und Kommunikationsparameter« und die »Parameter für Datenspeicherung«. Verbindungs- und Kommunikationsparameter: character_set_client, character_set_connection und character_set_result Die Verbindungsparameter wurden bereits in der Lösung beschrieben. Lizensiert für Markus Mueller

Parameter für Datenspeicherung: character_set_server Der Standardzeichensatz für neue Datenbanken, wenn bei der Erstellung der Datenbank (CREATE DATABASE) kein Zeichensatz angegeben wurde. Der Parameter kann über die globalen Einstellungen in der my.conf-Datei, bei der Erstellung der Datenbank und während einer Datenbanksitzung [interaktiv] festgesetzt werden. character_set_database Der Standardzeichensatz für die aktuell verwendete Datenbank. Dieser wird bei der Erstellung von neuen Tabellen verwendet, wenn bei der Erstellung (CREATE TABLE) kein abweichender Zeichensatz angegeben wird. Sollte aktuell keine Datenbank verwendet werden, wird dieser Wert von character_set_server geerbt. character_set_system Die Zeichenkodierung für den Datenbanktabellen- und Spaltennamen. Dieser Wert steht standardmäßig auf utf8.

Was passiert unter der Haube?

Max. Linie

Durch die forceCharset-Einstellungen setzt TYPO3 automatisch weitere Parameter, die wichtig für eine vollständige UTF-8-Unterstützung sind. Sie brauchen diese Einstellungen nicht manuell zu ändern, es lohnt sich jedoch zu wissen, was unter der Haube von TYPO3

2.10 Den Zeichensatz einer bestehenden TYPO3-Installation prüfen und auf UTF-8 umstellen | 73 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

noch passiert, um zum Beispiel mögliche Fehlerursachen bei der Ausgabe von Sonderzeichen besser einschätzen zu können:

Links

1. Es wird explizit ein Content-Type: text/html;charset=utf-8 als Header gesendet, falls Sie das Senden dieses Headers nicht explizit per TypoScript mit der Option config.disableCharsetHeader = 1 unterbinden. 2. Die Frontend-Ausgabe erfolgt automatisch im entsprechenden Zeichensatz des TYPO3-Backends. Im Kopfbereich des HTML-Dokuments wird die Kodierung des Dokuments angegeben. Mit dem folgenden TypoScript-Wert können Sie gegebenenfalls einen abweichenden Zeichensatz für die Frontend-Ausgabe festlegen, TYPO3 konvertiert die Daten dann automatisch und passt die entsprechenden Meta-Auszeichnungen an: config.renderCharset = utf-8

3. Der Wert metaCharset legt fest, welcher Wert für den Zeichensatz in den Meta-Angaben ausgegeben wird. Eine Anpassung dieses Werts ist nicht sinnvoll, da er automatisch entsprechend der Option renderCharset übernommen wird: config.metaCharset = utf-8 => <meta http-equiv="Content-Type" content="text/html; charset=utf-8"> Lizensiert für Markus Mueller

4. Wenn Sie den Dokumenttyp mit config.doctype auf ein XHTML-Format festlegen, wird TYPO3 die Zeichenkodierung auch im XML-Prolog angegeben:

Der Zeichensatz Latin1 Der in Westeuropa meistverbreitete Zeichensatz ISO 8859-1 wird auch als Latin1 bezeichnet. Mit ISO 8859-15 und CP1252 existieren einige minimale Varianten von ISO 8859-1 beziehungsweise Latin1, die zusätzlich das €-Symbol enthalten. CP1252 findet sehr weite Verbreitung, weil es der von Microsoft in Windows verwendete Zeichensatz ist. Dementsprechend handelt es sich auch bei dem von MySQL als Latin1 bezeichneten Zeichensatz tatsächlich um den Zeichensatz CP1252. Wenn Sie mit Werkzeugen wie recode oder iconv zur Zeichensatzkonvertierung arbeiten, sollten Sie aus diesem Grund besser CP1252 statt Latin1 verwenden. Der folgende Wikipedia-Artikel geht auf die Unterschiede dieser Varianten ein: http://de.wikipedia.org/wiki/ISO_8859-1.

Siehe auch

Max. Linie

MySQL unterstützt UTF-8 ab Version 5.1. Die Sortierreihenfolge utf8_general_ci ist dann Standard. Das bedeutet, dass deutsche Umlaute korrekt sortiert werden. Zum Beispiel wird das Ö mit O gleichgestellt. Weitere Details finden Sie im MySQL-Handbuch unter http://dev.mysql.com/doc/refman/5.1/de/charset-unicode-sets.html. Einen detaillierten Einblick in die TYPO3-Funktionen zur Konvertierung zwischen unterschiedlichen Zeichensätzen finden Sie in der Datei t3lib/class.t3lib_cs.php.

74 | Kapitel 2: Wartung und Systempflege This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Die Windows-Version von recode finden Sie unter dieser Adresse: http://gnuwin32.sourceforge.net/packages/recode.htm. Ein lesenswerter Artikel zu den einzelnen Varianten von ISO 8859-1 findet sich unter http://de.wikipedia.org/wiki/ISO_8859-1.

2.11 Systemprozesse mit dem Syslog protokollieren Problem Sie möchten TYPO3 so konfigurieren, dass bestimmte Aktionen oder Prozesse protokolliert werden, beispielsweise um Informationen über Systemprozesse innerhalb von TYPO3 zu ermitteln.

Lösung Aktivieren Sie das Syslog von TYPO3. Wechseln Sie dazu in das Install-Tool und wählen Sie den Menüpunkt All Configuration. Beim Schlüssel systemLog tragen Sie einen Wert nach diesem Muster ein: Lizensiert für Markus Mueller

file,/pfad/datei.log

Alternativ können Sie diesen Wert auch direkt in die Datei localconf.php schreiben, indem Sie dort diese Codezeile hinzufügen: $TYPO3_CONF_VARS['SYS']['systemLog'] = 'file,/pfad/datei.log';

Ersetzen Sie den hervorgehobenen Text mit dem absoluten Pfad zur Logdatei und stellen Sie sicher, dass der Webserver Schreibrechte in diesem Verzeichnis hat. Zwischen dem Komma und dem Pfad darf kein Leerzeichen sein. Nachdem Sie diesen Wert gespeichert haben, schreibt TYPO3 alle Logeinträge in die angegebene Datei. Um die Protokollierung zu testen, melden Sie sich bei der Anmeldung am Backend mit ungültigen Benutzerdaten an. TYPO3 wird dann einen Protokolleintrag nach diesem Muster einfügen: 02-08-08 18:18 - Core: Login-attempt from 127.0.0.1 (), username 'admin', password not accepted!

Diese Einträge können Sie dann nutzen, um bestimmte Informationen oder Fehlerverhalten zu analysieren. Beachten Sie, dass die Logdatei je nach Loglevel und Alter an Größe zunimmt. Löschen Sie von Zeit zu Zeit Logeinträge, um den Speicherbedarf der Datei zu reduzieren.

Max. Linie

Diskussion Im Programmcode von TYPO3 sind an zahlreichen Stellen Protokollfunktionen eingebunden, die es erlauben, Aktionen und Prozesse mitzuschreiben. Standardmäßig wird

2.11 Systemprozesse mit dem Syslog protokollieren | 75 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

der Schreibvorgang dieser Protokollfunktionen jedoch unterdrückt und muss erst, wie in der Lösung gezeigt, aktiviert werden. Erst wenn Sie TYPO3 mitteilen, wo und wie die Protollierung erfolgen soll, werden die Protokolldaten sichtbar.

Links

Das Syslog protokolliert ausschließlich Systemmeldungen. Es hat damit eine gänzlich andere Zielsetzung als der Logmechanismus im TYPO3-Backend, der die verschiedenen ausgeführten Aktionen von Backend-Benutzern in der Datenbanktabelle sys_log protokolliert.

Den Umfang der Datei könenn Sie begrenzen, indem Sie die Priorität angeben, ab der TYPO3 die Protokollierung starten soll. Die einzelnen Meldungen erfolgen unter Angabe einer Priorität, die in Zahlen von 0 bis 4 angegeben wird. Über das Install-Tool können Sie über die Option systemLogLevel die minimale Priorität festlegen, ab der TYPO3 protokollieren soll. Der Standardwert ist 0, wodurch Logmeldungen jeder Priorität erfasst werden. Den Parameter systemLogLevel können Sie auch direkt in der Datei localconf.php angeben, indem Sie dort diese Codezeile einfügen: $TYPO3_CONF_VARS['SYS']['systemLogLevel'] = '0';

Den Wert können Sie aus diesen Werten wählen: Lizensiert für Markus Mueller

0 (info) Allgemeine Informationen über Prozesse; Standardwert. 1 (notice) Hinweise bzw. Informationen, die Entscheidungen in TYPO3 beeinflussen. 2 (warning) Warnungen, Meldungen, die auf mögliche Probleme hinweisen. 3 (error) Fehlermeldungen, die beim Ablauf eines Prozesses geworfen wurden. TYPO3 wird im Ablauf nicht direkt beeinflusst, es kann jedoch zu Datenverlust bzw. inkonsistenten Daten und Fehlfunktionen kommen. 4 (fatal error) Schwerwiegende Fehler, die Abläufe und Kernfunktionen von TYPO3 direkt beeinflussen und dringend behoben werden sollten. Um beispielsweise lediglich Fehlermeldungen zu protokollieren, setzen Sie den Wert auf 3.

Max. Linie

Was aber, wenn Sie unterschiedliche Protokollierungen implementieren möchen, zum Beispiel eine, die alle Meldungen in eine Datei schreibt, und eine, die Sie bei Einträgen mit höchster Priorität per E-Mail informiert? Neben der in der Lösung gezeigten Möglichkeit stehen Ihnen noch weitere Optionen zur Handhabung der Logmeldungen zur Verfügung, die genau dieses Verhalten ermöglichen. Sie können die Syslog-Meldungen auch per Mail verteilen oder an den Syslog-Dienst des Betriebssystems oder das PHP-eigene Fehlerprotokoll weiterreichen. Jede dieser Methoden verfügt über weitere Konfigurationsparameter, die durch Kommata voneinander getrennt eingetragen werden. Die folgende Liste

76 | Kapitel 2: Wartung und Systempflege This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

zeigt alle bereitgestellten Logmethoden und ihre Parameter. Optionale Parameter sind in eckige Klammern gefasst: file,/pfad/datei.log[,severity]

Die Meldungen werden in eine Datei geschrieben. mail,EmpfängerMail[/AbsenderMail] [,severity]

Die Meldungen werden per E-Mail an die Adresse EmpfängerMail versendet. syslog,Facility[,severity]

Die Meldungen werden über die PHP-Funktion syslog() an den Logservice des Betriebssystems übergeben. Als Facility sollten Sie die Zeichenkette 'USER' eintragen. Die ganzzahlige Priorität wird dabei intern automatisch in eine der PHP-Konstanten LOG_INFO, LOG_NOTICE, LOG_WARNING, LOG_ERR und LOG_CRIT übersetzt. error_log[,,severity]

Die Meldungen werden entsprechend den Einstellungen in der PHP-Konfiguration error_log verarbeitet. Tragen Sie in der Syslog-Konfiguration die gewünschte Konfiguration ein, beispielsweise syslog, um das Protokoll an den betriebssystemeigenen Syslog-Dienst zu übergeben, oder den Wert error_log, um das PHP-Fehlerprotokoll zu nutzen (diese Protokolle müssen natürlich auf Ihrem System eingerichtet sein): Lizensiert für Markus Mueller

$TYPO3_CONF_VARS['SYS']['systemLog'] = 'syslog,USER';

Derzeit können Sie maximal zwei Logmethoden kombinieren, indem Sie die Werte mit einem Semikolon voneinander trennen: $TYPO3_CONF_VARS['SYS']['systemLog'] = 'file,/pfad/datei.log;syslog,USER';

TYPO3 wird die Protokolleinträge dann in beide Dateien schreiben. Mit der folgenden Zeile werden Einträge ab Priorität 1 (message) in eine TYPO3-spezifische Logdatei geschrieben und kritische Fehler (Priorität 4) zusätzlich per E-Mail versendet: $TYPO3_CONF_VARS['SYS']['systemLogLevel'] = '0'; $TYPO3_CONF_VARS['SYS']['systemLog'] = 'file,/pfad/datei.log,1;mail,[email protected],4';

Beachten Sie, dass systemLogLevel einen Mindestschwellenwert darstellt. Bei den einzelnen Loggern können abweichend nur höhere Prioritäten vergeben werden. Wenn Sie also den Wert systemLogLevel auf 3 gesetzt haben, können Sie in keinem Ihrer Protokolle niedriger priorisierte Meldungen erfassen. Wir empfehlen Ihnen daher, systemLogLevel auf einen niedrigen Wert zu konfigurieren, und Einschränkungen nur bei den jeweiligen Protokollangaben vorzunehmen.

Max. Linie

Wenn die vorhandenen Logging-Möglichkeiten von Syslog für Ihre Zwecke nicht ausreichend sind oder Sie die Funktionalität erweitern möchten, besteht zusätzlich noch die Möglichkeit, über einen Hook individuelle Logging-Methoden zu implementieren. Die Verwendung von Hooks wird in Rezept 17.13 beschrieben.

2.11 Systemprozesse mit dem Syslog protokollieren | 77 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Neben dem bisher besprochenen Syslog gibt es noch eine weitere Logging-Schnittstelle, die als devLog bezeichnet wird. Gedacht ist dieses Logging als Hilfestellung bei der Entwicklung. Um dieses devLog zu aktivieren, sind einige weitere Schritte notwendig:

Links

• Die Installation einer zusätzlichen entsprechenden Extension, die eine solche Funktionalität bereitstellt. Im TER finden Sie hierzu die folgenden Extensions: devlog und rlmp_filedevlog. • Das Aktivieren des devLog im Install-Tool unter der Bezeichnung enable_DLOG. • Gegebenenfalls müssen in den Kernklassen noch weitere Klassenvariablen, die erweiterte Logging-Funktionalitäten aktivieren/deaktivieren, entsprechend angepasst werden. Als Beispiel sei hier $writeDevLog in der Klasse t3lib/class.t3lib_userauth.php genannt. In den folgenden Klassen des TYPO3-Kerns wird das devLog verwendet:

Lizensiert für Markus Mueller

t3lib/class.t3lib_svbase.php t3lib/class.t3lib_formmail.php t3lib/class.t3lib_div.php t3lib/class.t3lib_modsettings.php t3lib/class.t3lib_db.php t3lib/class.t3lib_userauth.php typo3/template.php typo3/sysext/sv/class.tx_sv_auth.php typo3/sysext/sv/class.tx_sv_authbase.php typo3/sysext/cms/tslib/index_ts.php typo3/sysext/cms/tslib/class.tslib_fe.php typo3/sysext/cms/tslib/class.tslib_feuserauth.php

Siehe auch Prinzipiell steht die mit TYPO3-Version 4.1 eingeführte Syslog-Funktionalität auch für Extensions offen. Leider machen bisher nur ganz wenige Extensions hiervon Gebrauch. Eine genaue Funktionsbeschreibung für die PHP-Funktionen syslog() und error_log() finden Sie unter http://php.net/syslog und http://php.net/error_log.

2.12 Inhalte im Backend schnell finden Problem

Max. Linie

Sie suchen einen bestimmten Begriff in Ihrer Website und wissen nicht mehr genau, auf welcher Seite bzw. in welchem Inhaltselement Sie diesen angegeben haben.

78 | Kapitel 2: Wartung und Systempflege This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Lösung Verwenden Sie die Volltextsuche im Modul DB-Überprüfung. Diese Suche durchsucht die gesamte TYPO3-Datenbank nach Ihrem Suchbegriff und listet alle Datensätze auf, in denen der Suchbegriff vorkommt. Anschließend können Sie jeden dieser Datensätze öffnen und dessen Inhalt kontrollieren. Klicken Sie auf das Modul DB-Überprüfung und wählen Sie anschließend die Funktion Ganze Datenbank durchsuchen bzw. in der Auswahlliste den Eintrag Full search. Anschließend erscheint ein Eingabefeld, in das Sie Ihren Suchbegriff eingeben können. Die Suchergebnisse werden dann gruppiert nach der jeweiligen Tabelle in einer Liste ausgegeben. Mit einem Klick auf das Bearbeitungssymbol öffnet sich der Datensatz, und Sie können direkt den Suchbegriff ändern. Wenn Sie die Bearbeitung abgeschlossen haben, gelangen Sie über den Schließen-Button wieder zurück auf die Ergebnisliste.

Diskussion

Lizensiert für Markus Mueller

Die Suche listet Ihnen alle Datensätze auf, in denen Ihr Suchbegriff gefunden wird. Dies kann nützlich sein, wenn Sie sich schnell orientieren möchten, jedoch kann diese Liste gerade bei feinkörnigen Suchbegriffen sehr umfangreich werden, was die Listen ziemlich unhandlich macht. Für diesen Fall können Sie Ihre Suche weiter verfeinern und auf eine Tabelle begrenzen. Wählen Sie hierzu in der Auswahlliste die Option Advanced query und verfeinern Sie Ihre Suche, indem Sie im Feld Select a table eine einzelne Tabelle auswählen. Nach der Auswahl öffnet sich eine umfangreiche Formularmaske, mit der Sie Ihre eigene Abfrage formulieren können. Ihnen stehen dabei alle im TCA der Tabelle definierten Felder zur Verfügung. In der Ergebnisliste können Sie jeden Datensatz wie gewohnt über das Bearbeitungssymbol öffnen und bearbeiten. Das Info-Icon öffnet die Datensatzübersicht in einem neuen Fenster. Besonders interessant ist diese Suchfunktion, wenn Sie gelöschte Inhalte wiederfinden möchten. Standardmäßig werden gelöschte Inhalte nicht über die Suche gefunden. Aktivieren Sie jedoch die Option Show even deleted entries (with undelete buttons), werden auch bereits gelöschte Inhalte in der Liste angezeigt. Gleichzeitig erscheinen bei dem Eintrag zwei Icons. Über das linke stellen Sie den Datensatz wieder her. Das rechte Icon stellt den Datensatz wieder her und öffnet gleichzeitig die Bearbeitungsmaske für den Datensatz, sodass Sie umgehend Änderungen vornehmen können. Dadurch wird es sehr leicht, gelöschte Inhalte zu finden und wiederherzustellen.

Max. Linie

Siehe auch Eine Alternative, um gelöschte Datensätze wiederherzustellen, finden Sie in Rezept 5.9.

2.12 Inhalte im Backend schnell finden | 79 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

2.13 Verloren geglaubte Dateien wiederfinden

Links

Problem Sie haben vergessen, wo Sie welche Datei abgelegt haben, und benötigen schnell einen Hinweis, damit Sie die Datei finden könnten.

Lösung Öffnen Sie das Modul DB-Überprüfung und wählen Sie die Funktion Alle Dateinamen nach einem Muster durchsuchen. Geben Sie in das Feld den Dateinamen oder einen Teil des Dateinamens ein (z.B. die Dateiendung) und suchen Sie nach dem Wert. TYPO3 durchsucht danach die Verzeichnisse fileadmin/, typo3temp/ und uploads/ inklusive deren Unterverzeichnisse und gibt Ihnen entsprechende Treffer in einer Liste aus.

Diskussion Lizensiert für Markus Mueller

Die Suche ist vor allem dann nützlich, wenn Sie keinen direkten Zugriff auf das Dateisystem des Servers haben und schnell eine Rückmeldung benötigen, ob eine Datei im Dateisystem vorhanden ist. Das Modul eignet sich hervorragend dazu, sich einen ersten Überblick über die vorhandenen Template-Dateien und Skripten zu verschaffen, zum Beispiel wenn Sie bestehende TYPO3-Projekte übernehmen und sich schnell einarbeiten müssen. Der Standardsuchbegriff ist mit einem regulären Ausdruck belegt, der nach allen PHPDateien in fileadmin/, typo3temp/ und uploads/ sucht: \.php[3-6]?(\..*)?$|^\.htaccess$

Die Suchergebnisse können Sie mit der DB-Suche aus Rezept 2.12 kombinieren und so zum Beispiel Pfade zu Template-Dateien nachvollziehen und auf ihre Richtigkeit hin überprüfen.

Siehe auch Mit dem Referenzindex von TYPO3 können Sie verhindern, dass Datensätze mit Relationen zu anderen Datensätzen oder Dateien gelöscht werden. In den Rezepten 2.7 und 2.8 erfahren Sie mehr über den Referenzindex. Wenn Ihnen reguläre Ausdrücke noch fremd erscheinen, empfehlen wir Ihnen das Buch Reguläre Ausdrücke von Jeffrey E.F. Friedl, O’Reilly Verlag.

Max. Linie

Max. Linie 80 | Kapitel 2: Wartung und Systempflege This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

First

Kapitel 3

KAPITEL 3

Der richtige Zugang zum Backend

3.0

Einführung

In diesem Kapitel erfahren Sie, wie Sie Zugang zum Backend, der Verwaltungsoberfläche von TYPO3, erhalten und wie Sie die Anmeldemaske an Ihre Bedürfnisse anpassen und mit weiteren Funktionen ausstatten. Lizensiert für Markus Mueller

Über das Backend haben Sie die Kontrolle über die Datenbankinhalte und Dateien, die in Ihre Website integriert werden können. Sämtliche Inhalte, Dateien und TYPO3-Einstellungen Ihrer TYPO3-Installation werden über das TYPO3-Backend gepflegt. Die Verwaltung der Inhalte findet dabei vollständig im Webbrowser statt. Zudem bietet das Backend für Administratoren einige nützliche Funktionen, um häufig anfallende Aufgaben zügig zu erledigen. Wie Sie Ihren Browser für die Verwendung des TYPO3-Backends vorbereiten, erfahren Sie in Rezept 3.1. Der Zugang zum Backend wird über ein Anmeldeformular geschützt. So ist sichergestellt, dass nur zugangsberechtigte Benutzer Inhalte pflegen oder Einstellungen vornehmen können. In Rezept 3.2 erfahren Sie, wie Sie sich am Backend anmelden. Sollten Sie einmal Ihre Zugangsdaten für das Backend verlegt haben, zeigt Ihnen Rezept 3.3, wie Sie diese wiederherstellen können. Da TYPO3 die Daten für die Anmeldung in Cookies abspeichert, ist es notwendig, dass Sie Cookies für die jeweilige Website erlauben. Zudem sollten Sie JavaScript aktivieren, denn bei der Anmeldung wird das Passwort über eine JavaScript-Funktion in ein MD5-Hash umgewandelt. So ist sichergestellt, dass alle Passwörter verschlüsselt übertragen werden – eine sehr sinnvolle Funktion, die zusätzliche Sicherheit bietet. In Rezept 3.4 erfahren Sie darüber hinaus, wie Sie die Formulardaten über HTTPS übertragen und somit abhörsicher machen können.

Max. Linie

Das Standardformular kann leicht an Ihre Gestaltungsvorgaben angepasst werden, indem Sie verschiedene Elemente ändern oder ergänzen. In Rezept 3.5 erfahren Sie, wie Sie die Beschriftung Ihrer gewünschten Sprache entsprechend ändern und sogar auf unterschiedliche Spracheinstellungen der Besucher reagieren können. Außerdem können

| 81 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Sie eigene Bilder einbinden oder auch das Formular vollständig umgestalten. Näheres zu diesen Anpassungsmöglichkeiten erfahren Sie in den Rezepten 3.6 und 3.7.

Links

Da jeder Benutzer, der im Backend arbeitet, über diese Seite in das System gelangt, kann es sinnvoll und nützlich sein, aktuelle Nachrichten oder Tipps anzeigen zu lassen, die jeden Benutzer beim Login erreichen. Wie Sie dies technisch umsetzen, wird ausführlich in den Rezepten 3.8 bis 3.9 beschrieben. Weiterhin können Backend-Benutzer nach dem Anmelden am Backend auf die Website, das TYPO3-Frontend, umgeleitet werden. Dies kann sehr hilfreich sein, wenn Sie mit dem Frontend-Editing arbeiten. Näheres zur Umleitung von Backend-Benutzern erfahren Sie in Rezept 3.10. Grundlegende Informationen zum Frontend-Editing erhalten Sie in Rezept 4.7. Die einzelnen Benutzereinstellungen zu testen, kann sehr mühsam sein. Rezept 3.11 zeigt Ihnen, wie Sie die dafür nötigen Arbeitsschritte beschleunigen können. Um sicherzustellen, dass Benutzer einheitliche Einstellungen haben, können Sie diese per BenutzerTSconfig vorbelegen oder sogar erzwingen. Hierdurch wird der administrative Aufwand erheblich reduziert. Rezept 3.12 zeigt Ihnen die dafür notwendigen Schritte.

Lizensiert für Markus Mueller

3.1

Yeah, that’s a classic – Den Browser richtig einstellen

Problem Sie möchten Probleme vermeiden, die durch falsche Browsereinstellungen verursacht werden.

Lösung Grundsätzlich können Sie das TYPO3-Backend auf jedem modernen Browser stabil und zuverlässig verwenden. Oft führen jedoch falsche Browsereinstellungen zu schwer nachvollziehbaren Fehlern. Folgende Checkliste enthält einige Optionen, die für die Arbeit im TYPO3-Backend freigeschaltet werden sollten: JavaScript aktivieren TYPO3 verwendet JavaScript für die Passwortverschlüsselung in der Anmeldemaske, das Kontextmenü, den Elementbrowser oder das automatische Logout nach einer gewissen Zeit.

Max. Linie

Pop-ups für die jeweilige Domain freischalten TYPO3 öffnet zum Bearbeiten oder Verknüpfen von Inhalten an manchen Stellen Pop-up-Fenster, die für die Verwaltung der Daten essenziell sind. Zudem öffnet TYPO3 nach einer gewissen Zeit der Inaktivität ein Fenster, in dem Sie Ihre Anmel-

82 | Kapitel 3: Der richtige Zugang zum Backend This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

dung erneuern können. Schalten Sie daher die jeweilige Domain für die Verwendung von Pop-up-Fenstern frei. Cookies akzeptieren TYPO3 speichert wichtige Daten in Cookies ab (beispielsweise die aktuelle Ansicht des Seitenbaums oder ob ein Benutzer am Backend angemeldet ist).

Diskussion Zusätzlich zu den oben genannten Einstellungen gibt es noch weitere, die das Arbeiten im Backend komfortabler machen und eng mit den Browser- bzw. Clienteinstellungen zusammenhängen. Hier wird erklärt, welche Besonderheiten für den Gebrauch des Backends zu beachten sind, wie man TYPO3 etwas weniger restriktiv einstellt, sodass es auch hinter einer Firewall gut läuft, Inhalte nicht mehr vollständig gecacht werden und Entwickler flüssig arbeiten können.

Cache-Einstellung: Seiten bei jedem Seitenaufruf neu auslesen

Lizensiert für Markus Mueller

Gerade beim Entwickeln von Extensions sollte der Browser die Webseiten stets neu vom Server anfordern. Aktivieren Sie daher auf jeden Fall die Option, die sicherstellt, dass der Browser bei jedem Zugriff auf die Seite den Cache erneuert. Zusätzlich sollten Sie den Seiten-Cache von TYPO3 bei Ihren Arbeiten am Backend stets im Hinterkopf behalten. Es kommt häufig vor, dass die gerade eingegebenen Inhalte nicht auf der Webseite erscheinen, weil TYPO3 anhand der Cache-Einstellungen den Inhalt noch aus dem Zwischenspeicher liest. Gerade beim Entwickeln einer Website ist es jedoch sehr wichtig, dass Sie Änderungen umgehend sehen. Fügen Sie diesen Code in Ihr TypoScript-Setup ein, um den Caching-Mechanismus von TYPO3 für Webseiten zu deaktivieren: config { no_cache = 1 }

Achten Sie darauf, dass Sie diesen Wert in der Produktionsumgebung wieder auf 0 setzen. Sehr nützlich beim Entwickeln von Extensions ist auch das Deaktivieren des ExtensionCaches. TYPO3 erzeugt normalerweise beim ersten Aufruf der Webseite eine Liste aller eingebundenen Extensions und deren Einstellungen. Dabei liest TYPO3 zuerst SystemExtensions, dann global installierte Extensions und abschließend die lokal installierten Extensions ein. Dies erklärt beispielsweise auch, warum lokal installierte Extensions globale Extensions überschreiben. Um den Extension-Cache zu deaktivieren, setzen Sie einfach die Option extCache im Install-Tool auf 0. Wechseln Sie in das Modul und wählen Sie den Menüeintrag All Configuration. Suchen Sie den Begriff extCache und geben Sie in das entsprechende Eingabefeld eine Null ein. Alternativ dazu können Sie auch folgenden Code direkt in die Datei localconf.php eingeben:

Max. Linie

Max. Linie

$TYPO3_CONF_VARS['EXT']['extCache'] = '0';

3.1 Yeah, that’s a classic – Den Browser richtig einstellen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 83

Dadurch werden sämtliche Extension-Einstellungen bei jedem Seitenzugriff immer wieder direkt ausgelesen und nicht wie gewöhnlich in einer Cache-Datei zwischengespeichert. Auf Entwicklungsservern sollten Sie diese Option aus Performancegründen wieder aktivieren. Setzen Sie dafür den Wert mit folgender Angabe zurück auf den Standardwert:

Links

$TYPO3_CONF_VARS['EXT']['extCache'] = '1';

doNotCheckReferer aktivieren Wenn Sie sich darüber wundern, dass Sie so oft Ihre Anmeldung am TYPO3-Backend erneuern müssen, sollten Sie überprüfen, ob Sie hinter einer Firewall oder einem Proxyserver arbeiten. TYPO3 überprüft bei jedem Seitenaufruf im Backend, ob sich der aufrufende Host vom zuvor gespeicherten Host unterscheidet. Arbeiten Sie hinter einer Firewall oder einem Proxyserver, wird diese Information möglicherweise unterdrückt oder nicht eindeutig übermittelt, sodass TYPO3 von einem Fremdzugriff ausgeht und das Backend sperrt. Diese Überprüfung können Sie deaktivieren, indem Sie in das Install-Tool wechseln und unter General Options nach dem Begriff doNotCheckReferer suchen. Aktivieren Sie das entsprechende Kontrollkästchen. Alternativ dazu können Sie auch folgenden Code in die Datei localconf.php schreiben: $TYPO3_CONF_VARS['SYS']['doNotCheckReferer'] = '1'; Lizensiert für Markus Mueller

Siehe auch In den nächsten Rezepten erfahren Sie, wie Sie sich am Backend anmelden. Lesen Sie in Rezept 3.4, wie Sie den Ordner typo3 umbenennen können und Ihr Backend über einen anderen Ordner erreichen.

3.2

Am Backend anmelden

Problem Sie möchten sich am Backend anmelden, um die Inhalte Ihrer Website zu bearbeiten oder administrative Arbeiten durchzuführen.

Lösung Um sich am Backend anzumelden, benötigen Sie die korrekte Adresse Ihrer TYPO3Installation, einen Benutzernamen und ein Passwort. Die standardmäßige URL für das TYPO3-Backend baut sich wie folgt auf: http://www.ihre_website/typo3/

Max. Linie

Der Platzhalter ihre_website entspricht dabei Ihrem Domainnamen inklusive der TopLevel-Domain, beispielsweise .de, .com oder .org.

84 | Kapitel 3: Der richtige Zugang zum Backend This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Nun benötigen Sie einen Benutzernamen und ein Passwort. Der Benutzername darf keine Sonderzeichen enthalten und sollte kleingeschrieben werden. Für den Benutzernamen können Sie maximal 20 Zeichen verwenden. Folgende Anmeldedaten sind standardmäßig vorhanden: Benutzer: admin Passwort: password

Achten Sie darauf, dass Sie diese Zugangsdaten umgehend ändern. Aus Sicherheitsgründen sollten Sie keine Website mit diesen Standardeinstellungen öffentlich zugänglich machen. Ändern Sie umgehend nach Ihrer ersten Anmeldung diese Standardwerte. Wechseln Sie dazu in das Modul Benutzerwerkzeuge ➝ Einstellungen. Im Bereich Persönliche Daten finden Sie den Abschnitt Neues Passwort. Geben Sie dort Ihr neues Passwort an und bestätigen Sie die Änderungen.

Lizensiert für Markus Mueller

Falls die Anmeldung mit den Standardwerten fehlschlägt, können Sie über das InstallTool einen neuen Administratorzugang einrichten. Melden Sie sich dazu am Install-Tool an und klicken Sie auf den zweiten Menüpunkt Database Analyzer. Am Ende der Seite finden Sie weitere Links. Wählen Sie dort den Link Create »admin« user aus. Es folgt eine Eingabemaske, mit der Sie einen neuen Benutzer mit Administratorstatus anlegen können. Wählen Sie diese neuen Zugangsdaten sorgfältig, denn nach der Bestätigung mit dem Button Write to database wird der Zugang sofort aktiv. Wechseln Sie dann mit dem Link Backend admin in new window oder über das anfangs erwähnte Adressenschema zur Backend-Anmeldemaske.

Diskussion Zusätzlich zu dem sicheren Passwort sollten Sie in Ihrem Benutzerprofil auch Ihren Namen und die E-Mail-Adresse angeben. TYPO3 verwendet diese Angaben für Benachrichtigungsfunktionen, die vor allem für Administratoren sehr nützlich sind. Beispielsweise aktivieren Sie mit der Option Unterrichte mich per Email wenn jemand sich mit meinem Account anmeldet eine Überwachungsfunktion, die Sie informiert, wenn sich jemand am Backend mit Ihren Benutzerdaten anmeldet. So werden Sie umgehend darüber informiert. Diese Option können Sie standardmäßig aktivieren, indem Sie in Ihrem Benutzer-TSconfig den folgenden Code eingeben: setup { default.emailMeAtLogin = 1 }

Um sicherzugehen, dass diese Option aktiviert ist, können Sie den Wert auch fest vorgeben:

Max. Linie

setup { override.emailMeAtLogin = 1 }

Der Wert ist dann standardmäßig aktiviert und kann über die Benutzereinstellungen nicht mehr abgewählt werden.

3.2 Am Backend anmelden | 85 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Zusätzlich bietet TYPO3 Administratoren noch zwei weitere Kontrollmöglichkeiten. Zum einen können Sie im Installtool eine E-Mail-Adresse angeben, an die eine E-Mail gesendet wird, wenn sich ein Backend-Benutzer viermal mit falschen Zugangsdaten anmeldet. Wechseln Sie dazu in das Install-Tool und wählen Sie den Eintrag All Configuration. Suchen Sie dann nach warning_email_addr. Geben Sie in das dazugehörige Feld die gewünschte E-Mail-Adresse ein. Alternativ können Sie diese Option auch direkt aktivieren, indem Sie folgenden Code in die Datei localconf.php eingeben:

Links

$TYPO3_CONF_VARS['BE']['warning_email_addr'] = 'email_adresse';

Diese Funktion können Sie noch verschärfen, wenn Sie die Warnstufe mit dem Wert warning_mode erhöhen. Setzen Sie die Option auf 1 Bit, wird bei jeder Anmeldung eines Backend-Besuchers eine Meldung versendet. Aktivieren Sie das zweite Bit, wird die Meldung nur versandt, wenn sich Administratoren anmelden. Im Installtool befindet sich die Einstellung unter warning_mode. Setzen Sie im dazugehörigen Feld die gewünschten Werte. Auch hier können Sie die Anpassung direkt über die Datei localconf.php vornehmen, indem Sie folgenden Wert hinzufügen: $TYPO3_CONF_VARS['BE']['warning_mode'] = '1';

Beachten Sie, dass diese Einstellung nur Auswirkungen hat, wenn Sie zuvor eine gültige E-Mail-Adresse angegeben haben. Lizensiert für Markus Mueller

Siehe auch Um zusätzliche Sicherheit für Ihre TYPO3-Installation zu gewährleisten, sollten Sie Rezept 3.4 lesen. Dort erfahren Sie, wie Sie das Backend zusätzlich gegen unbefugten Zugriff sichern können. Rezept 3.1 erläutert, welche grundlegenden Optionen aktiviert sein müssen, um im Backend optimal arbeiten zu können.

3.3

Ein verlorenes Passwort für das Backend wiederherstellen

Problem Sie haben Ihr Passwort für den Zugang zum Backend vergessen oder verlegt und möchten es wiederherstellen.

Lösung

Max. Linie

Wählen Sie das Modul Liste und wechseln Sie in das Wurzelverzeichnis der Website. Dort finden Sie sämtliche Backend-Benutzer-Accounts. Öffnen Sie nun den gewünschten Benutzerdatensatz und vergeben Sie über das Feld Passwort ein neues Passwort. Nach der Eingabe wird es automatisch MD5-verschlüsselt und beim Speichervorgang entspre-

86 | Kapitel 3: Der richtige Zugang zum Backend This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

chend in der Datenbank gespeichert. Sollten Sie keinen Zugriff auf die Benutzerdatensätze haben, können Sie auch mit der Funktion Switch User in die Rolle des jeweiligen Benutzers schlüpfen und die Anmeldedaten über dessen Benutzereinstellungen ändern. Wechseln Sie dazu in das Modul Verwaltung unterhalb von Admin-Werkzeuge und klicken Sie, wie in Abbildung 3-1 gezeigt, auf das rechte Icon.

Abbildung 3-1: Mit diesem Button wechseln Sie temporär in die Rolle des jeweiligen Benutzers

Aus Sicherheitsgründen speichert TYPO3 die Passwörter für Backend-Benutzer standardmäßig MD5-verschlüsselt in der Datenbank ab. Durch den MD5-Algorithmus werden die Passwörter in eine zufällige Zeichenkette umgewandelt, die keine Rückschlüsse auf den ursprünglichen Wert zulässt. Als Administrator können Sie daher die Passwörter der Backend-Benutzer nur erneuern und nicht direkt auslesen. Lizensiert für Markus Mueller

Diskussion Wenn Sie Ihr Administratorpasswort zum Backend verlegt haben, gibt es mehrere Möglichkeiten, dies wiederherzustellen. Haben Sie noch Zugang zum Install-Tool, können Sie dort einen neuen Administratorzugang anlegen. Geben Sie dazu die Adresse zum InstallTool in die Adresszeile Ihres Browsers ein. Diese Adresse ist standardmäßig folgendermaßen aufgebaut: http://www.ihre-website.tld/typo3/install/

Max. Linie

Sollten Sie das Install-Tool über diese Adresse nicht erreichen, überprüfen Sie, ob im Ordner typo3/install/ in der Datei index.php die Bedingung in Zeile 50 erfüllt und die Datei ENABLE_INSTALL_TOOL im Verzeichnis typo3conf vorhanden ist. Erst dann können Sie das Install-Tool verwenden. Ansonsten wird das Skript an dieser Stelle automatisch beendet, sodass Sie keinen Zugang zum Install-Tool herstellen können. Wenn Sie das Anmeldeformular im Install-Tool sehen, geben Sie dort Ihr neues Passwort in das Eingabeformular ein und bestätigen die Eingabe mit dem Button Log in. Die Anmeldung wird fehlschlagen. Jedoch zeigt Ihnen TYPO3 unterhalb des Formulars den MD5-Wert des eingegebenen Passworts an. Kopieren Sie diesen Wert in die Zwischenablage und öffnen Sie anschließend die Datei localconf.php im Verzeichnis typo3conf. Suchen Sie dort nach der Variablen $TYPO3_CONF_VARS['BE']['installToolPassword']. Diese Variable enthält das alte Passwort für das Installtool als MD5-verschlüsselte Zeichenkette. Ersetzen Sie diesen Wert nun mit Ihrem neuen MD5-Wert aus der Zwischenablage.

3.3 Ein verlorenes Passwort für das Backend wiederherstellen | 87 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Beachten Sie dabei, dass TYPO3 die Werte vorheriger Install-Tool-Passwörter nicht direkt ersetzt, sondern den neuen Wert unterhalb des alten Werts einfügt, sodass er dadurch überschrieben wird. Passen Sie daher unbedingt die unterste Variablenzuweisung an, da Ihre Passwortänderung ansonsten nicht übernommen wird.

Links

Nachdem Sie Zugang zum Install-Tool erhalten haben, wechseln Sie zum Punkt Database Analyzer. Dort finden Sie am Seitenende den Menüeintrag Create »admin« user. Klicken Sie auf diesen Punkt und geben Sie abschließend die nötigen Benutzerdaten ein. Achten Sie darauf, dass der neue Benutzername von Ihrem alten Administrator-Account abweicht, denn TYPO3 überprüft, ob der Benutzername schon in der Datenbank existiert. Nachdem Sie einen neuen Administrator-Account angelegt haben, können Sie sich damit wie gewohnt am Backend anmelden und die Passwortänderung bei Ihrem alten Account durchführen. Anschließend wechseln Sie über die Benutzerverwaltung in Ihren alten Account und entfernen den soeben erstellten Account wieder.

Lizensiert für Markus Mueller

Wenn Sie keinerlei Zugang mehr zum TYPO3-Backend haben, jedoch noch über einen Datenbankzugriff verfügen, gehen Sie wie folgt vor: Erstellen Sie mit der MySQL-Funktion MD5() anhand eines neuen Passworts eine MD5-Prüfsumme und aktualisieren Sie damit Ihren Backend-Benutzer. Wichtig ist hierbei, dass Sie den Benutzernamen exakt so eingeben, wie Sie ihn auch bei der Anmeldung am TYPO3-Backend verwenden. Verbinden Sie sich mit der TYPO3-Datenbank und führen Sie folgenden SQL-Befehl aus: UPDATE be_users SET password = MD5('neues_passwort') WHERE username = 'Benutzername';

Ihr neues Passwort ist danach sofort aktiv, sodass Sie sich wieder wie gewohnt am TYPO3-Backend anmelden können.

3.4

Das Backend absichern

Problem Sie möchten das Backend mit weiteren Sicherheitsvorkehrungen ausstatten, zum Beispiel indem Sie die Datenübertragung über eine HTTPS-Verbindung verschlüsseln.

Lösung

Max. Linie

Um für die Datenübertragung bei der Anmeldung am Backend eine HTTPS-Verbindung zu nutzen, bietet TYPO3 die Möglichkeit, das Anmeldeformular automatisch auf eine HTTPS-Verbindung umzuleiten. Wechseln Sie dazu in das Install-Tool und melden Sie sich an. Wählen Sie anschließend den Menüpunkt All Configuration, suchen Sie dort nach dem Begriff lockSSL und geben Sie in das entsprechende Feld den Wert 2 ein. Alternativ dazu können Sie auch den folgenden Code direkt in die Datei localconf.php eintragen: $TYPO3_CONF_VARS['BE']['lockSSL'] = '2';

88 | Kapitel 3: Der richtige Zugang zum Backend This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Wenn Sie den Wert auf 3 setzen, wird ausschließlich die Anmeldung verschlüsselt übertragen. Nach der Anmeldung leitet TYPO3 die Adresse wieder auf das HTTP-Protokoll um. $TYPO3_CONF_VARS['BE']['lockSSL'] = '3';

Mit dem Wert 1 ermöglichen Sie eine HTTPS-Verbindung – eine Anmeldung über HTTP ist jedoch noch möglich und bietet daher keine effektive Absicherung. Um eine HTTPS-Verbindung zum Server aufzubauen, benötigen Sie ein gültiges SSL-Zertifikat für den Server. Ein solches Zertifikat erhalten Sie beispielsweise über die Website von http://www.cacert.org/. Beachten Sie, dass jeder IP-Adresse nur ein SSL-Zertifikat zugewiesen werden kann. Wenn Sie mehrere Domains auf einem Server betreiben, beispielsweise bei mehreren virtuellen Hosts, sollten Sie sich zu Beginn der Registrierung entscheiden, für welche Domain das Zertifikat erstellt werden soll. Erfolgt zu einer nicht registrierten Domain ein Aufruf über die HTTPS-Verbindung, erhält der Besucher eine entsprechende Warnung, die ihn darauf hinweist, dass ein ungültiges Zertifikat für die aktuelle Domain vorliegt. Diese Meldung kann viele Benutzer davon abhalten, die Seite weiter zu verwenden. Wenn Ihr SSL-Port von dem Standardport 443 abweicht, können Sie mit dieser Einstellung die Portnummer eintragen: Lizensiert für Markus Mueller

$TYPO3_CONF_VARS['BE']['lockSSLPort'] = '443';

TYPO3 verwendet dann diesen Port für SSL.

Um die Sicherheit Ihrer TYPO3-Installation zusätzlich zu erhöhen, können Sie das Backend auch in einen anderen Ordner verschieben. Weicht der Ordner vom Standardwert typo3 ab, wird es für potienzielle Angreifer schwerer, die Adresse für das BackendAnmeldeformular zu erraten. Um die Änderungen vorzunehmen, gehen Sie wie folgt vor: Ändern Sie das Verzeichnis typo3 auf den von Ihnen gewünschten Namen. Achten Sie darauf, dass Sie keine Leerzeichen oder Sonderzeichen im Ordnernamen verwenden. Suchen Sie danach die Konstante TYPO3_mainDir in den folgenden Dateien und ersetzen Sie sie mit dem neuen Ordnernamen: /neues_verzeichnis/init.php /neues_verzeichnis/thumbs.php /neues_verzeichnis/sysext/cms/tslib/index_ts.php /neues_verzeichnis/sysext/cms/tslib/showpic.php /neues_verzeichnis/t3lib/class.t3lib_superadmin.php /neues_verzeichnis/t3lib/thumbs.php

Ändern Sie dort den Inhalt dieser Konstanten von typo3/ auf Ihren neuen Ordnernamen.

Max. Linie

Zusätzlich müssen Sie in der Datei index.php noch den Pfad zur Extension cms anpassen, da TYPO3 ansonsten die nötigen Skripte für die TypoScript-Bibliothek nicht einbinden kann. Die Datei index.php finden Sie im Wurzelverzeichnis Ihrer TYPO3-Installation. Ersetzen Sie dort die hervorgehobenen Werte mit Ihren Angaben:

3.4 Das Backend absichern This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 89

Max. Linie

... if (@is_dir(PATH_site.'typo3/sysext/cms/tslib/')) { define('PATH_tslib', PATH_site.'typo3/sysext/cms/tslib/'); } elseif (@is_dir(PATH_site.'tslib/')) { define('PATH_tslib', PATH_site.'tslib/'); ...

Links

Es kann vorkommen, dass die Konstante zum TYPO3-Verzeichnis in Extension-Dateien neu definiert wird. Suchen Sie daher sicherheitshalber in Ihrer TYPO3-Installation nach dem Funktionsaufruf define('TYPO3_mainDir', 'typo3/');, um sämtliche Stellen zu finden, an denen das Verzeichnis typo3/ definiert wird, und ändern Sie die Zuweisung entsprechend. Zudem sollten Sie in Ihren Skripten keine absoluten Pfade zum typo3-Verzeichnis angeben, sondern stets die Konstante TYPO3_mainDir verwenden, um entsprechend flexibel auf Änderungen der Ordnerstruktur eingehen zu können.

Lizensiert für Markus Mueller

Außerdem müssen Sie noch bei jedem lokal installierten Backend-Modul die Variable $BACK_PATH anpassen. Dieser Variablen wird während des Installationsvorgangs standardmäßig der Ordner typo3/ hinzugefügt, damit beim Aufruf des Backend-Moduls der TYPO3-Ordner ermittelt werden kann. Diese Angabe müssen Sie nun bei den bereits installierten Modulen ändern. Wechseln Sie dazu in das Verzeichnis typo3conf/ext und kontrollieren Sie bei den vorhandenen Extensions, ob Unterordner mit dem Namen mod1 vorhanden sind. (Die 1 steht hier für das erste Modul. Wenn mehrere Module vorhanden sind, wird dieser Zähler entsprechend erhöht.) Öffnen Sie dort die Datei conf.php und passen Sie die Variable $BACK_PATH entsprechend an. Aus dem Wert $BACK_PATH='../../../../typo3/';

wird dann $BACK_PATH='../../../../neues_verzeichnis/';

Aktualisieren Sie abschließend den Extension-Cache, um auch eventuell zwischengespeicherte Pfadangaben neu zu laden und Fehler zu vermeiden. Wenn Sie Backend-Module installieren, nachdem Sie die Anpassungen vorgenommen haben, erkennt der Erweiterungs-Manager den neuen TYPO3-Ordner automatisch und passt die Pfadangaben bei der Installation neuer Extensions entsprechend an. Wenn Sie die Werte zu dem TYPO3-Verzeichnis nicht korrekt ersetzen, erhalten Sie diese Fehlermeldung: Error in init.php: Path to TYPO3 main dir could not be resolved correctly.

Die hier beschriebenen Maßnahmen sind natürlich nutzlos, wenn Sie die grundlegenden Sicherheitsvorkehrungen nicht berücksichtigen: Ändern Sie umgehend die Standardpasswörter für den Backend-Zugang sowie für das Install-Tool und achten Sie auf die Sicherheitshinweise im Modul Über Module.

Max. Linie

Max. Linie 90 | Kapitel 3: Der richtige Zugang zum Backend This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Rechts

Diskussion Auch wenn Sie keine HTTPS-Verbindung einrichten können, stellt TYPO3 sicher, dass Ihr Passwort verschlüsselt übertragen wird. Sobald Sie das Anmeldeformular absenden, wird das Passwort über eine JavaScript-Funktion mit dem MD5-Algorithmus verschlüsselt. Diese MD5-Verschlüsselung lässt keinerlei Rückschlüsse über Ihr ursprüngliches Passwort zu, sodass dies zu keinem Zeitpunkt im Klartext übertragen wird. Ebenso verhält es sich, wenn Sie das Passwort im Backend in Ihren Benutzereinstellungen ändern. Zusätzlich können Sie auch noch weitere Vorkehrungen treffen, um das Backend gegen unbefugten Gebrauch zu sichern (in der Diskussion von Rezept 3.2 werden weitere nützliche Funktionen vorgestellt, etwa wie Sie fehlerhafte Anmeldeversuche frühzeitig erkennen können). Um beispielsweise nur Benutzer aus einem bestimmten IP-Bereich zu erlauben, sollten Sie im Install-Tool über das Feld IPmaskList einen IP-Adressbereich oder eine konkrete IP-Adresse angeben, über die sich die Benutzer ausschließlich anmelden dürfen. Dies ist beispielsweise für Intranet-Applikationen sehr interessant. Das Eingabefeld für diese IPNummer finden Sie unter All Configuration. Suchen Sie dort nach dem Begriff IPmaskList. Geben Sie dann in das entsprechende Feld die IP-Adresse ein. Alternativ können Sie folgenden Code direkt in die Datei localconf.php eingeben: $TYPO3_CONF_VARS['BE']['IPmaskList'] = 'ip_adresse';

Lizensiert für Markus Mueller

Wenn Sie einen konkreten IP-Adressbereich erlauben möchten, können Sie auch Platzhalterzeichen in Form eines Sternchens für den jeweiligen Zahlenwert einsetzen. TYPO3 erkennt dann automatisch die IP-Adressen unterhalb des erlaubten Bereichs. Geben Sie etwa folgenden Code ein, erlauben Sie den Zugriff über alle IP-Adressen, die mit 192.168 beginnen – das Anmelden aus einem anderen IP-Bereich wird hingegen vollständig unterbunden: $TYPO3_CONF_VARS['BE']['IPmaskList'] = '192.168.*.*';

Möchten Sie die Anmeldung nur für einzelne Benutzer oder Benutzergruppen auf einen bestimmten IP-Bereich festlegen, ist die oben genannte Möglichkeit etwas zu unflexibel. Für diesen Fall stellt Ihnen TYPO3 die Option enabledBeUserIPLock zur Verfügung. Diese Option finden Sie ebenfalls im Install-Tool unter All Configuration. Suchen Sie dort nach dem Begriff enabledBeUserIPLock. Falls die Option nicht standardmäßig voreingestellt ist, aktivieren Sie nur das entsprechende Kontrollkästchen, um die Funktion freizuschalten. Auch hier können Sie wieder den Code direkt in die Datei localconf.php eingeben: $TYPO3_CONF_VARS['BE']['enabledBeUserIPLock'] = 1;

Mit dieser Funktion ermöglichen Sie die Überprüfung der IP-Nummer jedes einzelnen Benutzers, der sich am Backend anmeldet. In den Benutzereinstellungen können Sie dann über das Feld TSconfig mit folgendem Code die IP-Adressen festlegen, über die sich der Benutzer anmelden darf:

Max. Linie

option { lockToIP = ip_adresse }

3.4 Das Backend absichern This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie | 91

Folgendes Beispiel würde die Anmeldung ausschließlich über eine IP-Adresse mit dem Muster 192.168.*.* zulassen:

Links

option { lockToIP = 192.168.*.* }

Auch hier können Sie Adressbereiche definieren, indem Sie die Zahlen durch das Platzhalterzeichen * ersetzen. TYPO3 erkennt dann automatisch die IP-Adressen innerhalb dieses Bereichs. Diese Funktion ist sehr ähnlich der Option IPmaskList, hat jedoch den feinen Unterschied, dass Sie hier für jeden Benutzer oder jede Benutzergruppe eine eigene IP-Adresse vergeben und daher sehr flexibel auf die jeweiligen IP-Adressen Ihrer Benutzer eingehen können. Falls Sie den Zugang zum Backend einmal komplett sperren möchten, beispielsweise um die TYPO3-Version zu aktualisieren, bietet Ihnen TYPO3 die Möglichkeit, mit der Option adminOnly das Backend für reguläre Benutzer zu sperren: $TYPO3_CONF_VARS['BE']['adminOnly'] = 1;

Der Zugang zum Backend ist damit nur noch für Administratoren möglich. Wenn sich reguläre Benutzer anmelden möchten, erhalten diese eine Meldung, die darüber informiert, dass das Backend zurzeit gesperrt ist. Lizensiert für Markus Mueller

Wenn Sie das gesamte TYPO3-Backend sperren möchten – beispielsweise um umfangreiche Änderungen an der Datenbank vorzunehmen –, geben Sie folgenden Code in die Datei localconf.php ein: $TYPO3_CONF_VARS['BE']['adminOnly'] = -1;

Beachten Sie, dass Sie mit dieser Option wirklich das gesamte Backend vollständig deaktivieren. Eine Anmeldung und der Zugriff auf das Install-Tool sind dann selbst für Administratoren nicht mehr möglich – auch wenn diese bereits am Backend angemeldet waren. Um diese Sperre aufzuheben, müssen Sie den Wert direkt in der Datei localconf.php ändern und ihn beispielsweise wieder auf den Standardwert 0 zurücksetzen: $TYPO3_CONF_VARS['BE']['adminOnly'] = 0;

Siehe auch Achten Sie darauf, dass Sie alle nötigen Browsereinstellungen vorgenommen haben, da Sie sich sonst womöglich nicht am Backend anmelden können. In Rezept 3.1 wird erläutert, welche grundlegenden Optionen aktiviert sein müssen. In der Diskussion von Rezept 3.2 finden Sie grundsätzliche Hinweise darauf, wie Sie sich am Backend anmelden. In Rezept 1.4 erfahren Sie mehr über die Ordnerstruktur von TYPO3.

Max. Linie

Max. Linie 92 | Kapitel 3: Der richtige Zugang zum Backend This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Rechts

3.5

Die Beschriftung im Anmeldeformular ändern

Problem Sie möchten das Anmeldeformular mit eigenen Feldbezeichnungen darstellen.

Lösung Ändern Sie die Beschriftungen des Anmeldeformulars über die Variable $TYPO3_CONF_ VARS['BE']['loginLabels']. Diese Variable können Sie über das Installtool ändern. Wechseln Sie dazu in das Modul Installation (falls Sie keinen Zugang zum Install-Tool haben, lesen Sie die Diskussion von Rezept 3.3). Wählen Sie anschließend den Abschnitt All Configuration und suchen Sie nach der Überschrift [loginLabels]. Ändern Sie in dem entsprechenden Eingabefeld die gewünschten Textpassagen. Speichern Sie abschließend die neuen Werte über den Button Write to localconf.php in der Datei localconf.php. Alternativ dazu können Sie die Beschriftungen auch direkt in der Datei localconf.php vornehmen. Für ein deutsches Anmeldeformular geben Sie zum Beispiel folgende Werte ein:

Lizensiert für Markus Mueller

$TYPO3_CONF_VARS['BE']['loginLabels'] = ' Benutzername|Passwort|Interfacemodus|Anmelden|Abmelden|Backend,Frontend| Verwaltungsbereich der Seite Seitenname| (Hinweis: Cookies müssen aktiviert sein!)| Wichtige Nachrichten:| Ihre Anmeldung ist fehlgeschlagen. Stellen Sie sicher, dass Sie Ihre Zugangsdaten korrekt eingegeben haben und Sie nicht aus Versehen die Groß- und Kleinschreibung vertauscht haben. ';

Als Seitentitel können Sie ab Version 4.2 auch den Marker ###SITENAME### nutzen. Dieser Marker wird dann automatisch mit dem Wert ersetzt, den Sie während der Installation als Sitenamen angegeben haben. Um diesen langen Wert nicht vollständig eingeben zu müssen, hat sich folgender Weg als Arbeitserleichterung bewährt: Wechseln Sie dazu wie anfangs beschrieben über das Install-Tool zu dem Eingabefeld unterhalb von der Überschrift [loginLabels]. Fügen Sie in das Eingabefeld ein Leerzeichen vor dem Wert Username ein und speichern Sie dann den neuen Wert über den Button Write to localconf.php. TYPO3 erkennt die Änderung und schreibt den gesamten Variableninhalt in die Datei localconf.php. Danach können Sie dort den Wert bequem über Ihren Texteditor ändern.

Max. Linie

Ihre neuen Angaben werden nach dem Speichern der Datei direkt im Anmeldeformular angezeigt. Beachten Sie, dass Sie mit den Werten nur die Beschriftungen der Felder ändern können und keinen Einfluss auf die Feldanordnung haben. Das bedeutet, dass Sie auch nicht benötigte Feldbezeichnungen angeben müssen, um die Reihenfolge der Werte zu erhalten. Der Grund hierfür: In der Funktion, die das Anmeldeformular darstellt, wird der String mithilfe der Pipes (|) in ein Array umgewandelt. Anhand der Schlüsselwerte

3.5 Die Beschriftung im Anmeldeformular ändern | 93 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

dieses Arrays wird daraufhin der entsprechende Text ermittelt. Achten Sie deshalb besonders darauf, dass Sie kein |-Zeichen löschen und so aus Versehen die Reihenfolge ändern. Außerdem sollten Sie keine HTML-Tags verwenden, da diese aus Sicherheitsgründen nicht unterstützt werden.

Links

Stellen Sie vor dem Speichern auch unbedingt sicher, dass keine Fehler vorhanden sind, denn sonst wird das gesamte Formular nicht mehr angezeigt. Eine Anmeldung wäre dann nicht mehr möglich.

Diskussion

Lizensiert für Markus Mueller

Max. Linie

Durch die oben dargestellten Methoden können Sie das Anmeldeformular in der von Ihnen gewünschten Sprache darstellen. Was aber, wenn an Ihrer Website Benutzer arbeiten, die nochmals eine andere Sprachen sprechen? Besser wäre hier, die Benutzer in ihrer jeweiligen Landessprache anzusprechen. Fragen Sie hierfür in der Datei localconf.php die Spracheinstellungen über die Browsereigenschaften des aktuellen Benutzers ab. Diese Information wird in der Variablen HTTP_ACCEPT_LANGUAGE gespeichert. TYPO3 bietet Ihnen dafür mit getIndpEnv() eine entsprechende Funktion, mit der Sie diesen Wert unabhängig von Betriebsystem und Servertyp abfragen können. Somit stellen Sie sicher, dass der Wert plattformunabhängig ermittelt wird. Analysieren Sie dann das Ergebnis mit einer CaseAbfrage, um die jeweiligen Sprachwerte entsprechend zuzuweisen: $lang = t3lib_div::getIndpEnv('HTTP_ACCEPT_LANGUAGE'); $lang = substr($lang, 0, 2); switch ($lang) { case 'de': $TYPO3_CONF_VARS['BE']['loginLabels'] = ' Benutzername|Passwort|Interfacemodus|Anmelden|Abmelden|Backend,Frontend| Verwaltungsbereich der Seite Seitenname| (Hinweis: Cookies müssen aktiviert sein!)| Wichtige Nachrichten:| Ihre Anmeldung ist fehlgeschlagen. Stellen Sie sicher, dass Sie Ihre Zugangsdaten korrekt eingegeben haben und Sie nicht aus Versehen die Groß- und Kleinschreibung vertauscht haben. '; break; case 'en': $TYPO3_CONF_VARS['BE']['loginLabels'] = ' Username|Password|Interface|Log In|Log Out|Backend,Frontend| Administration Login on Sitenname| (Note: Cookies and JavaScript must be enabled!)| Important Messages:| Your login attempt did not succeed. Make sure to spell your username and password correctly, including upper/lowercase characters. '; break; default: $TYPO3_CONF_VARS['BE']['loginLabels'] = ' Benutzername|Passwort|Interfacemodus|Anmelden|Abmelden|Backend,Frontend|

94 | Kapitel 3: Der richtige Zugang zum Backend This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Verwaltungsbereich der Seite Seitenname| (Hinweis: Cookies müssen aktiviert sein!)| Wichtige Nachrichten:| Ihre Anmeldung ist fehlgeschlagen. Stellen Sie sicher, dass Sie Ihre Zugangsdaten korrekt eingegeben haben und Sie nicht aus Versehen die Groß- und Kleinschreibung vertauscht haben. '; break; }

Zusätzlich zur Anmeldemaske können Sie auch das gesamte Backend an die jeweilige Sprache des Benutzers anpassen, sodass alle Sprachfelder in der entsprechenden Sprache ausgegeben werden. Wählen Sie dazu in dem jeweiligen Benutzerprofil für die BackendSprache den gewünschten Eintrag aus der Liste der möglichen Sprachen aus. Achten Sie dabei darauf, dass das Sprachpaket für die gewünschte Sprache vorhanden ist. Standardmäßig ist nur das englische Sprachpaket installiert. Weitere Sprachpakete installieren Sie über den Erweiterungs-Manager. Das Rezept 15.10 geht näher auf die Installation und Verwaltung dieser Sprachpakete ein. Beachten Sie auch, dass einige Sprachpakete möglicherweise noch nicht vollständig übersetzt sind. Falls Ihnen ein bestimmtes Sprachpaket fehlt, erfahren Sie in Rezept 20.4, wie Sie TYPO3 selbst in die exotischsten Sprachen übersetzen können. Lizensiert für Markus Mueller

Vielleicht fragen Sie sich, warum Sie für diese Funktionalität nicht die Sprachoptionen von TYPO3 verwenden können. Der Grund dafür ist folgender: Diese Informationen stehen TYPO3 zum Zeitpunkt der Anmeldung noch nicht zur Verfügung, denn TYPO3 erzeugt das Backend-Benutzerobjekt BE_USER erst, wenn der Benutzer vollständig authentifiziert werden konnte.

Siehe auch In Rezept 3.8 erfahren Sie, wie Sie das Anmeldeformular mit weiteren Funktionen ausstatten. Die Ausgabe mehrsprachiger Inhalte erläutert Rezept 9.4. In Rezept 20.4 erfahren Sie, wie Sie dabei helfen können, TYPO3 zu übersetzen.

3.6

Eigene Bilder im Anmeldeformular anzeigen

Problem Sie möchten im Anmeldeformular eigene Bilder anzeigen.

Lösung

Max. Linie

Erstellen Sie eine neue, leere Extension und installieren Sie diese über den ErweiterungsManager. In Rezept 16.2 erfahren Sie mehr über die nötigen Schritte. Anschließend legen Sie in dem Extension-Ordner einen Unterordner res/ sowie die Datei ext_tables.php an.

3.6 Eigene Bilder im Anmeldeformular anzeigen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 95

Max. Linie

Der Ordner res/ enthält später sämtliche Bilddateien, die im Anmeldeformular erscheinen sollen. Die Datei ext_tables.php enthält den PHP-Code, um TYPO3 so einzustellen, dass diese Bilder im Anmeldeformular angezeigt werden.

Links

Für eine bessere Übersicht sollten Sie nun im Ordner res einen weiteren Unterordner mit dem Namen login_bilder erzeugen. Speichern Sie dort die Bilder im PNG-, JPG- oder GIFFormat. Wenn Sie nur ein Bild einfügen, wird immer dieses Bild angezeigt. Liegen mehrere Bilder vor, erscheinen diese in zufälliger Reihenfolge. Geben Sie abschließend folgenden Code in die Datei ext_tables.php ein: $ext_pfad = t3lib_extMgm::extRelPath($_EXTKEY); $ext_pfad_bilder = $ext_pfad . 'res/login_bilder/'; $GLOBALS['TBE_STYLES']['loginBoxImage_rotationFolder'] = $ext_pfad;

Zuerst ermitteln Sie mit der Funktion t3lib_extMgm::extRelPath($_EXTKEY) den Pfad zur Extension. Danach weisen Sie diesem Pfad den Wert des Unterordners zu. Je nachdem, ob dort gültige Bilddateien vorliegen, wird nun die Standardgrafik automatisch mit einem Bild aus diesem Ordner ersetzt. Wenn keine Bilder geladen werden können, erscheint kein Bild. Achten Sie auch darauf, dass die Bilder einheitlich groß sind, denn sie werden nicht an eine bestimmte Größe angepasst. Die Größe der Standardbilder beträgt 500 x 100 Pixel. Lizensiert für Markus Mueller

Diskussion Zusätzlich können Sie noch das TYPO3-Logo gegen eine eigene Grafik austauschen. Ergänzen Sie den Code um die zwei hervorgehobenen Zeilen: $ext_pfad = t3lib_extMgm::extRelPath($_EXTKEY); $ext_pfad_bilder = $ext_pfad . 'res/login_bilder/'; $ext_pfad_logo = $ext_pfad . 'logo/'; $GLOBALS['TBE_STYLES']['loginBoxImage_rotationFolder'] = $ext_pfad_bilder; $GLOBALS['TBE_STYLES']['logo_login'] = $ext_pfad_logo .'logo_grafik';

Fügen Sie das Logo in den Unterordner logo ein und passen Sie den Platzhalter logo_grafik entsprechend dem Dateinamen an. Das Standardlogo hat eine Größe von 128 x 59 Pixeln. Beachten Sie, dass Sie das TYPO3-Logo unter der Anmeldemaske unter keinen Umständen ändern oder entfernen dürfen.

3.7

Das Layout der Anmeldemaske ändern

Problem Sie möchten das Anmeldeformular an Ihr eigenes Layout anpassen.

Max. Linie

Max. Linie 96 | Kapitel 3: Der richtige Zugang zum Backend This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Rechts

Lösung Erweitern Sie die Datei index.php per XClass-Verfahren. Legen Sie dafür die Datei class. ux_SC_index.php in den Extension-Ordner. In dieser Datei überschreiben Sie die Funktion wrapLoginForm aus der ursprünglichen Datei index.php. Geben Sie abschließend folgenden Code in die Datei ext_localconf.php ein: $ext_pfad = t3lib_extMgm::extPath('ext_key'); $TYPO3_CONF_VARS[TYPO3_MODE]['XCLASS']['typo3/index.php'] = $ext_pfad .'class.ux_SC_index.php';

Mit dieser Zuweisung überlagern Sie die Datei index.php mit der Datei class.ux_SC_ index.php. Dadurch können Sie sämtliche Funktionen dieser Datei ändern und erweitern. Für die Darstellung des Anmeldeformulars ist die Funktion wrapLoginForm zuständig. Dort können Sie das Logo, die Bilder sowie das Anmeldeformular völlig frei positionieren und wie folgt anpassen:

Lizensiert für Markus Mueller

' : ''; // Login box image: $loginboxImage = $this->makeLoginBoxImage(); $content='

'.$logo.'

'.$loginboxImage.'

'.$content.'

Max. Linie

'.$this->makeLoginNews().'

3.7 Das Layout der Anmeldemaske ändern | 97 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

'.$this->makeCopyrightNotice().'

';

Links

return $content; } } ?>

Diskussion

Lizensiert für Markus Mueller

Beachten Sie, dass sich diese Änderungen auch auf das Anmeldeformular auswirken, das erscheint, wenn Sie Ihre Anmeldung am TYPO3-Backend erneuern müssen. Da dieses Anmeldeformular in einem Pop-up-Fenster mit fester Größe erscheint, sollten Sie Ihre Darstellung darauf abstimmen oder die Login-Box vielleicht wieder im ursprünglichen Zustand anzeigen lassen. Um diesen Zustand zu unterscheiden, können Sie den GETParameter loginRefresh abfragen: if (t3lib_div::_GET('loginRefresh')) { ... }

Über diesen Parameter können Sie ermitteln, ob die Anmeldemaske im Pop-up-Fenster angezeigt wird, und etwaige Änderungen am Code bzw. am Layout vornehmen. Begrenzen Sie Ihre Änderungen an der Klasse auf die Methode wrapLoginForm(), da Sie ansonsten womöglich Abläufe im Anmeldeprozess ändern, die Auswirkungen auf die Sicherheit Ihrer TYPO3-Installation haben können. Wenn Sie in der Datei class.ux_SC_ index.php eine Methode nicht überschreiben, bleibt die ursprüngliche Funktionalität der Originaldatei index.php erhalten. Sie müssen also nicht zwingend alle Methoden überschreiben. Achten Sie besonders darauf, dass Sie die Funktion makeCopyrightNotice() nicht ändern oder ausblenden. Diese Funktion ist verantwortlich für die Copyright-Hinweise und darf auf keinen Fall geändert werden.

Siehe auch

Max. Linie

In Rezept 3.6 erfahren Sie, wie Sie komfortabel die Bilder der Anmeldemaske anpassen können. Zusätzlich können Sie unterhalb der Anmeldemaske aktuelle Meldungen anzeigen; die dafür nötigen Schritte werden in Rezept 3.8 beschrieben. Mehr über den XClassMechanismus erfahren Sie in Rezept 17.12.

98 | Kapitel 3: Der richtige Zugang zum Backend This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

3.8

Aktuelle Meldungen unter dem Anmeldeformular anzeigen

Problem Sie möchten unter dem Anmeldeformular aktuelle Meldungen ausgeben, beispielsweise um Redakteure über neue Optionen im Backend zu informieren.

Lösung Geben Sie in der Datei ext_tables.php folgenden Code ein: $GLOBALS['TYPO3_CONF_VARS']['BE']['loginNews'][] = array( 'date' => '11.10.2008', 'header' => 'Überschrift', 'content' => 'Ein Meldungstext' );

Lizensiert für Markus Mueller

Mit diesem Array können Sie unter dem Formular Texte nach dem Muster Datum, Überschrift, Text anzeigen lassen. Möchten Sie mehrere Texte zeigen, erweitern Sie das Array entsprechend: $GLOBALS['TYPO3_CONF_VARS']['BE']['loginNews'][] = array( 'date' => '11.10.2008', 'header' => 'Überschrift 1', 'content' => 'Ein Meldungstext' ); $GLOBALS['TYPO3_CONF_VARS']['BE']['loginNews'][] = array( 'date' => '11.11.2008', 'header' => 'Überschrift 2', 'content' => 'Ein zweiter Meldungstext' );

Die Meldungen werden dann in der angegebenen Reihenfolge untereinander aufgelistet. Jedoch werden sie unter jedem Anmeldeformular angezeigt – auch unter dem, das erscheint, wenn Sie Ihre Anmeldung erneuern müssen. Die Größe des Pop-up-Fensters ist für eine vollständige Darstellung der Meldungen allerdings nicht ausreichend. Um die Meldungen dort auszublenden, setzen Sie den Code in folgende Abfrage: if (!t3lib_div::_GET('loginRefresh')) { $GLOBALS['TYPO3_CONF_VARS']['BE']['loginNews'][] = array( 'date' => '11.10.2008', 'header' => 'Überschrift', 'content' => 'Ein Meldungstext' ); }

Max. Linie

Max. Linie 3.8 Aktuelle Meldungen unter dem Anmeldeformular anzeigen | 99 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Damit erscheinen die Meldungen nur auf der Seite mit der Hauptanmeldung. Wenn Ihnen die Datei ext_tables.php noch fremd ist, erfahren Sie in Rezept 16.2 mehr über den grundlegenden Aufbau einer Extension.

Links

Diskussion Mit der oben beschriebenen Methode können Sie Meldungen wie gewünscht unter dem Anmeldeformular anzeigen lassen. Jedoch müssen Sie für jede Änderung die Datei öffnen und das Array entsprechend anpassen. Einfacher wäre es, die Aktualisierung – wie bei regulären Seiteninhalten – über das Backend vorzunehmen. Verwenden Sie zur Pflege der Meldungen die Extension tt_news. Nachdem Sie sie über den Erweiterungs-Manager installiert haben, legen Sie im Backend einen neuen SysOrdner an. In diesem SysOrdner speichern Sie später alle Meldungen, die unter dem Anmeldeformular erscheinen sollen. Geben Sie dann folgenden Code in die Datei ext_tables.php ein: if (!t3lib_div::_GET('loginRefresh')) { if (t3lib_extMgm::isloaded('tt_news')) { require_once(PATH_t3lib.'class.t3lib_befunc.php');

Lizensiert für Markus Mueller

$table = 'tt_news'; $enableFields = t3lib_BEfunc::BEenableFields($table) . t3lib_BEfunc::deleteClause($table); $pid = ihre_seiten_id; $limit = maximale_meldungen; $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery( '*', $table, 'pid='. $pid .' '. $enableFields, '', 'crdate DESC', $limit ); if ($GLOBALS['TYPO3_DB']->sql_num_rows($res)) { while ($row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res)) { $GLOBALS['TYPO3_CONF_VARS']['BE']['loginNews'][] = Array( 'date' => strftime('%e. %B %Y', $row['datetime']), 'header' => $row['title'], 'content' => nl2br($row['bodytext']) ); } } } }

Max. Linie

Passen Sie den Platzhalter ihre_seiten_id an die Seiten-ID des SysOrdners an, in dem die Meldungen gespeichert werden. Diese Angabe bewirkt, dass die Abfrage nur noch Meldungen in dem dafür vorgesehenen SysOrdner berücksichtigt (in Rezept 7.3 erfahren Sie, wie Sie die Seiten-ID schnell herausfinden).

100 | Kapitel 3: Der richtige Zugang zum Backend This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Nach der Überprüfung, ob die Extension tt_news installiert ist, bereiten Sie die Abfrage an die Datenbank vor, um die aktuellen Meldungen aus der Tabelle tt_news auszulesen. Der Wert $pid beschränkt die Abfrage auf Datensätze, die in dem gewünschten SysOrdner liegen. Um sicherzustellen, dass nur sichtbare Datensätze angezeigt werden, binden Sie die Funktionen BEenableFields und deleteClause ein. Diese Funktionen erzeugen für die angegebeneTabelle eine passende WHERE-Klausel, mit der die Felder hidden, deleted, starttime und endtime automatisch berücksichtigt werden. So ist sichergestellt, dass alle Sichtbarkeitseinstellungen korrekt übernommen werden. Die gesamte WHERE-Klausel speichern Sie abschließend in der Variablen $enableFields. require_once(PATH_t3lib.'class.t3lib_befunc.php'); $enableFields = t3lib_BEfunc::BEenableFields($table) . t3lib_BEfunc::deleteClause($table);

Danach führen Sie die Datenbankabfrage durch. Diese sollten Sie ausschließlich über das TYPO3-Datenbankobjekt $GLOBALS['TYPO3_DB'] vornehmen. Dadurch stellen Sie sicher, dass Ihre Abfragen auch mit anderen Datenbanksystemen funktionieren (in Rezept 17.5 erfahren Sie mehr über die Verwendung der TYPO3-API und wie diese Ihre Programmierarbeit erleichtern kann). Abschließend füllen Sie das Array $GLOBALS['TYPO3_CONF_ VARS']['BE']['loginNews'] mit den Ergebnissen aus der Datenbank, die dann auch unter dem Anmeldeformular angezeigt werden. Lizensiert für Markus Mueller

Wenn Sie diese Funktionalität auch in anderen TYPO3-Projekten einsetzen möchten, wäre es hilfreich, wenn Sie die Seiten-ID und die Anzahl der Meldungen ohne Eingriff in den Code anpassen könnten. Legen Sie dazu im Extension-Ordner eine neue Datei mit dem Namen ext_conf_template.txt an. Auf diese Weise erzeugen Sie automatisch eine Eingabemaske im Abschnitt Information Ihrer Extension. Diese Eingabemaske erreichen Sie, wenn Sie im Erweiterungs-Manager auf den Titel der Extension klicken. Dort können Sie dann die Extension-Variablen direkt editieren und über den Button Update aktivieren. Alle Werte, die Sie in dieser Datei vorgeben, dienen als Standardwerte, wenn das Eingabefeld leer bleibt. Legen Sie nun mit folgendem Code die Standardwerte für die gewünschten Abfrageparameter an: # cat=basic/enable; type=int+; label=Seiten-ID der aktuellen Meldungen: Geben Sie hier die Seiten-ID des Ordners an, der die Meldungen für das Anmeldeformular enthält. login_news_pid = id_der_seite # cat=basic/enable; type=int+; label=Maximale Anzahl der aktuellen Meldungen: Geben Sie hier die maximale Anzahl der Meldungen an. login_news_limit = 5

Max. Linie

Diese Werte speichert TYPO3 in einer serialisierten Zeichenkette in der Datei localconf. php. Beachten Sie, dass die Kommentare in einer Zeile stehen müssen und hier nur als Platzgründen in eine neue Zeile gerutscht sind (weitere Einstellungsmöglichkeiten und Verwendungsbeispiele für die Datei ext_conf_template.txt erhalten Sie in Rezept 17.14). Um die Werte in dem PHP-Code wieder auszulesen, verwenden Sie folgenden Code: $lConf = unserialize($TYPO3_CONF_VARS['EXT']['extConf'][$_EXTKEY]);

3.8 Aktuelle Meldungen unter dem Anmeldeformular anzeigen | 101 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Wandeln Sie zuerst den serialisierten String wieder in ein reguläres Array um. Anschließend greifen Sie mit dieser Zuweisung auf die Werte zu:

Links

$pid = intval($lConf['login_news_pid']); $limit = intval($lConf['login_news_limit']);

In der Datenbankabfrage werden diese Werte nun wie folgt eingesetzt: $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery( '*', $table, 'pid='. $pid .' '. $enableFields, '', 'crdate DESC', $limit );

Die Meldungen erscheinen nun wie gewünscht unter dem Anmeldeformular. Einstellungen an der Datenbankabfrage können Sie über die Extension-Einstellungen vornehmen. Im nächsten Schritt aktivieren Sie die Unterstützung für mehrsprachige Meldungen und nehmen Feineinstellungen an der Darstellung vor.

Lizensiert für Markus Mueller

Zuerst ermitteln Sie anhand der Browsereinstellungen die Sprache des Besuchers. Anschließend übersetzen Sie diesen Wert über eine CASE-Abfrage in die ID der jeweiligen Systemsprache und erweitern die WHERE-Klausel der Datenbankabfrage. Ergänzen Sie dazu den zuvor genannten Code um die hervorgehobenen Zeilen (zur Verdeutlichung der Position sehen Sie schon den Funktionsaufruf der Datenbankabfrage): ... $lang = t3lib_div::getIndpEnv('HTTP_ACCEPT_LANGUAGE'); $lang = substr($lang, 0, 2); switch ($lang) { case 'de': $lang_id = 0; break; case 'en': $lang_id = 1; break; default: $lang_id = 0; break; } $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery( ...

Max. Linie

Bei dieser Abfrage ist es wichtig, den Zusammenhang zwischen der gewünschten Sprache und der Sprach-ID zu verstehen: Sobald Sie dem TYPO3-Backend eine neue Sprache hinzufügen, erhält diese eine eindeutige Identifizierungsnummer (die Sprach-ID). Wenn Sie Datensätze übersetzen, speichert TYPO3 die jeweilige Sprach-ID automatisch im Feld sys_ language_uid. Indem Sie nun diese Sprach-ID über die Variable $lang_id in Ihrer Abfrage berücksichtigen, können Sie die Meldungen auf die gewünschte Sprache reduzieren:

102 | Kapitel 3: Der richtige Zugang zum Backend This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

$res = $GLOBALS['TYPO3_DB']->exec_SELECTquery( '*', $table, 'pid='. $pid .'AND sys_language_uid = '. $lang_id .' '. $enableFields, '', 'crdate DESC', $limit ); ...

Die hervorgehobene Codezeile muss in dem weiter oben gezeigten Code ersetzt werden, da ansonsten die Spracheinstellungen nicht von der Datenbankabfrage berücksichtigt werden. Um dem Formular jetzt noch optisch den letzten Schliff zu geben, können Sie zusätzliche CSS-Angaben im Seitenkopf der Anmeldeseite einfügen. Über diese CSS-Stile können Sie die Darstellung der Meldungen visuell sehr genau an Ihre Bedürfnisse anpassen. Fügen Sie dazu unter der Datenbankabfrage noch folgenden Code ein:

Lizensiert für Markus Mueller

... $TBE_STYLES['inDocStyles_TBEstyle'] = ' DIV#loginNews { width: 70%; margin-top: 30px; } DIV#loginNews H2 { background: #666; color: #fff; font-size: 12px; } DIV#loginNews DL DD { padding-right: 10px; padding-left: 10px; } DIV#loginNews DL DT { font-weight: bold; } DIV#loginNews DL DT SPAN { color: #333; } DIV#loginNews DL DT { background: #fff; color: #333; } DIV#loginNews DL DD { color: #666; } '; ...

Hier eine Zusammenfassung des besprochenen Codes: if (!t3lib_div::_GET('loginRefresh')) { if (t3lib_extMgm::isloaded('tt_news')) { require_once(PATH_t3lib.'class.t3lib_befunc.php'); // Konfiguration einlesen $lConf = unserialize($TYPO3_CONF_VARS['EXT']['extConf'][$_EXTKEY]); // Tabelleneinstellungen $table = 'tt_news'; $enableFields = t3lib_BEfunc::BEenableFields($table) . t3lib_BEfunc::deleteClause($table); $pid = intval($lConf['login_news_pid']); $limit = intval($lConf['login_news_limit']);

Max. Linie

// Mehrsprachigkeit $lang = t3lib_div::getIndpEnv('HTTP_ACCEPT_LANGUAGE'); $lang = substr($lang, 0, 2); switch ($lang) { case 'de': $lang_id = 0; break;

3.8 Aktuelle Meldungen unter dem Anmeldeformular anzeigen | 103 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

case 'en': $lang_id = 1; break; default: $lang_id = 0; break;

Links

} // Datenbank abfragen $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery( '*', $table, 'pid='. $pid .' AND sys_language_uid = '. $lang_id .' '. $enableFields, '', 'crdate DESC', $limit );

Lizensiert für Markus Mueller

// Werte zuweisen if ($GLOBALS['TYPO3_DB']->sql_num_rows($res)) { while ($row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res)) { $GLOBALS['TYPO3_CONF_VARS']['BE']['loginNews'][] = Array( 'date' => strftime('%e. %B %Y', $row['datetime']), 'header' => $row['title'], 'content' => nl2br($row['bodytext']) ); } } // CSS anpassen $TBE_STYLES['inDocStyles_TBEstyle'] = ' DIV#loginNews { width: 70%; margin-top: 30px; } DIV#loginNews H2 { background: #666; color: #fff; font-size: 12px; } DIV#loginNews DL DD { padding-right: 10px; padding-left: 10px; } DIV#loginNews DL DT { font-weight: bold; } DIV#loginNews DL DT SPAN { color: #333; } DIV#loginNews DL DT { background: #fff; color: #333; } DIV#loginNews DL DD { color: #666; } '; } }

Siehe auch

Max. Linie

Im nächsten Rezept 3.9 wird erklärt, wie Sie auf ähnliche Weise zufällige Texte unter der Anmeldung anzeigen lassen. In Rezept 3.5 erfahren Sie, wie Sie die Beschriftungen im Anmeldeformular in mehreren Sprachen darstellen können. In Rezept 3.7 erfahren Sie, wie Sie das gesamte Layout der Anmeldemaske anpassen können. Rezept 17.1 verrät mehr über die verwendeten TYPO3-Funktionen. In Rezept 4.9 erfahren Sie Genaueres zum Zusammenhang zwischen der ID und der gewünschten Sprache. Mehr über die PHP-Funktion unserialize erfahren Sie auf der PHP-Website unter http://de3.php.net/ unserialize.

104 | Kapitel 3: Der richtige Zugang zum Backend This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

3.9

Tipp des Tages auf der Anmeldeseite anzeigen

Problem Sie möchten unter dem Anmeldeformular bei jedem Seitenaufruf wechselnde Tipps anzeigen lassen.

Lösung Geben Sie dazu folgenden Code in die Datei ext_tables.php ein:

Lizensiert für Markus Mueller

if (!t3lib_div::_GET('loginRefresh')) { $tipps = array( array( 'date' => 'Tipp Nr. 1', 'header' => 'Überschrift', 'content' => 'Beschreibung des ersten Tipps' ), array( 'date' => 'Tipp Nr. 2', 'header' => 'Überschrift', 'content' => 'Beschreibung des zweiten Tipps' ), array( 'date' => 'Tipp Nr. 3', 'header' => 'Überschrift', 'content' => 'Beschreibung des dritten Tipps' ) ); srand((float) microtime() * 10000000); $tipp_id = array_rand($tipps, 1); $GLOBALS['TYPO3_CONF_VARS']['BE']['loginNews'][] = $tipps[$tipp_id]; }

Legen Sie zuerst eine Sammlung nützlicher Tipps in einem Array an. Dann erzeugen Sie mit der PHP-Funktion array_rand einen zufälligen Zeiger, um bei jedem Seitenaufruf einen neuen Wert aus dem Array auszulesen. Später weisen Sie das Ergebnis dem Array $GLOBALS['TYPO3_CONF_VARS']['BE']['loginNews'] zu. Dieses Array speichert die Texte, die später unter dem Formular als Tipps nach dem Muster Tipp-ID, Überschrift, Erklärung angezeigt werden. Um die Tipps nur auf der Hauptanmeldeseite anzuzeigen, umschließen Sie den gesamten Code mit folgender Abfrage (ansonsten würden die Tipps auch in dem kleinen Fenster erscheinen, das beim Aktualisieren des Passworts erscheint):

Max. Linie

if (!t3lib_div::_GET('loginRefresh')) { ... }

3.9 Tipp des Tages auf der Anmeldeseite anzeigen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie | 105

Diskussion

Links

Mit der oben beschriebenen Methode können Sie Ihre Tipps wie gewünscht unter dem Anmeldeformular anzeigen lassen. Jedoch müssen Sie für jede Änderung die Datei öffnen und das Array entsprechend anpassen. Wenn Sie die Eingabe über das Backend vornehmen würden, wäre es einfacher, die Tipps zu verwalten. Installieren Sie dazu die Extension tt_news über den Erweiterungs-Manager und legen Sie im Backend einen neuen SysOrdner an. In diesem SysOrdner speichern Sie alle Tipps, die Sie auf der Anmeldeseite anzeigen möchten. Geben Sie dann folgenden Code in die Datei ext_tables.php ein: // Tipp des Tages if (t3lib_extMgm::isloaded('tt_news')) { require_once(PATH_t3lib.'class.t3lib_befunc.php'); $table = 'tt_news'; $enableFields = t3lib_BEfunc::BEenableFields($table) . t3lib_BEfunc::deleteClause($table); $pid = ihre_seiten_id;

Lizensiert für Markus Mueller

$res = $GLOBALS['TYPO3_DB']->exec_SELECTquery( '*', $table, 'pid = '. $pid .' '. $enableFields, '', 'RAND()', 1 ); $count = $GLOBALS['TYPO3_DB']->sql_num_rows($res); if ($count) { while ($row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res)) { $GLOBALS['TYPO3_CONF_VARS']['BE']['loginNews'][] = Array( 'date' => 'Tipp Nr. '. $row['uid'], 'header' => $row['title'], 'content' => nl2br($row['bodytext']) ); } } }

Passen Sie den Platzhalter ihre_seiten_id abschließend an die Seiten-ID des SysOrdners an, in dem die Tipps gespeichert werden. Die Tipps erscheinen nun wie gewünscht in zufälliger Reihenfolge unter dem Anmeldeformular. Im nächsten Schritt nehmen Sie noch Feineinstellungen an der Datenbankabfrage sowie der Darstellung vor, indem Sie über CSS die Darstellung anpassen.

Max. Linie

Wenn Sie diese Funktionalität in anderen TYPO3-Projekten einsetzen möchten, wäre es hilfreich, wenn Sie diese Seiten-ID ohne Eingriff in den Code anpassen könnten. Legen

106 | Kapitel 3: Der richtige Zugang zum Backend This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Sie dazu im Extension-Ordner eine neue Datei mit dem Namen ext_conf_template.txt an und speichern Sie darin folgenden Code: # cat=basic/enable; type=int+; label=Seiten-ID der aktuellen Tipps: Geben Sie hier die Seiten-ID des Ordners an, der die Tipps für das Anmeldeformular enthält. login_news_pid = id_der_seite

Dadurch erzeugen Sie automatisch eine Eingabemaske im Abschnitt Information Ihrer Extension. Diese Eingabemaske erreichen Sie, wenn Sie im Erweiterungs-Manager auf den Titel der Extension klicken. Dort können Sie dann die Extension-Variablen direkt editieren und über den Button Update aktivieren. Alle Werte, die Sie in der Datei vorgeben, dienen als Standardwerte, wenn das Eingabefeld leer bleibt. Weitere Einstellungsmöglichkeiten und Verwendungsbeispiele für die Datei ext_conf_template.txt erhalten Sie in Rezept 17.14. Die Darstellung der Tipps können Sie über CSS an Ihre Gestaltungsvorgaben anpassen. Geben Sie dazu folgenden Code unterhalb Ihrer Datenbankabfrage ein:

Lizensiert für Markus Mueller

... $TBE_STYLES['inDocStyles_TBEstyle'] = ' DIV#loginNews { width: 70%; margin-top: 30px; } DIV#loginNews H2 { background: #666; color: #fff; font-size: 12px; } DIV#loginNews DL DD { padding-right: 10px; padding-left: 10px; } DIV#loginNews DL DT { font-weight: bold; } DIV#loginNews DL DT SPAN { color: #333; } DIV#loginNews DL DT { background: #fff; color: #333; } DIV#loginNews DL DD { color: #666; } '; ...

Ändern Sie abschließend noch die Werte der Überschrift Important Messages: in Tipp des Tages. Geben Sie dazu folgenden Code ein: $TYPO3_CONF_VARS['BE']['loginLabels'] = ' Benutzername|Passwort|Interfacemodus|Anmelden|Abmelden|Backend,Frontend| Verwaltungsbereich der Seite ###SITENAME###| (Hinweis: Cookies müssen aktiviert sein!)| Tipp des Tages| Ihre Anmeldung ist fehlgeschlagen. Stellen Sie sicher, dass Sie Ihre Zugangsdaten korrekt eingegeben haben und Sie nicht aus Versehen die Groß- und Kleinschreibung vertauscht haben. ';

Hier noch mal zusammenfassend der gesamte Code dieses Beispiels: // Tipp des Tages if (!t3lib_div::_GET('loginRefresh')) { if (t3lib_extMgm::isloaded('tt_news')) { require_once(PATH_t3lib.'class.t3lib_befunc.php');

Max. Linie

// Konfiguration auslesen $lConf = unserialize($TYPO3_CONF_VARS['EXT']['extConf'][$_EXTKEY]);

3.9 Tipp des Tages auf der Anmeldeseite anzeigen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie | 107

// Tabelleneinstellungen $table = 'tt_news'; $enableFields = t3lib_BEfunc::BEenableFields($table) . t3lib_BEfunc::deleteClause($table); $pid = intval($lConf['login_news_pid']);

Links

// Datenbank abfragen $res = $GLOBALS['TYPO3_DB']->exec_SELECTquery( '*', $table, 'pid = '. $pid .' '. $enableFields, '', 'RAND()', 1 ); $count = $GLOBALS['TYPO3_DB']->sql_num_rows($res);

Lizensiert für Markus Mueller

// Werte zuweisen if ($count) { while ($row = $GLOBALS['TYPO3_DB']->sql_fetch_assoc($res)) { $GLOBALS['TYPO3_CONF_VARS']['BE']['loginNews'][] = Array( 'date' => 'Tipp Nr. '. $row['uid'], 'header' => $row['title'], 'content' => nl2br($row['bodytext']) ); } } // CSS anpassen $TBE_STYLES['inDocStyles_TBEstyle'] = ' DIV#loginNews { width: 70%; margin-top: 30px; } DIV#loginNews H2 { background: #666; color: #fff; font-size: 12px; } DIV#loginNews DL DD { padding-right: 10px; padding-left: 10px; } DIV#loginNews DL DT { font-weight: bold; } DIV#loginNews DL DT SPAN { color: #333; } DIV#loginNews DL DT { background: #fff; color: #333; } DIV#loginNews DL DD { color: #666; } '; } }

Siehe auch In Rezept 3.5 finden Sie weitere Hinweise für die Umbenennung der Formularbeschriftung. Rezept 17.10 erläutert die Konfiguration von Extensions über die Datei ext_conf_ template.txt.

Max. Linie

Max. Linie 108 | Kapitel 3: Der richtige Zugang zum Backend This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Rechts

3.10 Backend-Benutzer auf das Frontend umleiten Problem Sie möchten nach der Anmeldung am Backend direkt im Frontend arbeiten, beispielsweise um dort die Inhalte Ihrer Website über Frontend-Editing-Mechanismen zu pflegen.

Lösung Wechseln Sie in das Modul Installation. Nach der Authentifizierung wählen Sie den vierten Punkt All Configuration und suchen nach dem Wort interfaces im Bereich BE. Geben Sie dort den Wert frontend ein. Alternativ dazu können Sie auch folgenden Code direkt in die Datei localconf.php eintragen: $TYPO3_CONF_VARS['BE']['interfaces'] = 'frontend';

Nach dem Speichern wird die neue Einstellung direkt aktiv. TYPO3 leitet nun jede Anmeldung am TYPO3-Backend automatisch auf das Frontend um.

Diskussion Lizensiert für Markus Mueller

Aus dem Frontend heraus erreichen Sie das Backend, indem Sie die URL direkt in der Adressleiste des Browsers ändern und so in das Backend wechseln. Diese URL baut sich nach folgendem Muster auf: www.example.com/typo3/

Beachten Sie, dass der Ordner je nach Installation vom Standard abweichen kann. In Rezept 3.4 erfahren Sie, wie Sie den Ordner umbenennen. Eine andere Möglichkeit besteht darin, das Backend über das Admin-Panel zu öffnen. Um diese Einstellung vorzunehmen, benötigen Sie unbedingt Administratorrechte. Wechseln Sie dazu in den Modus Liste und wählen Sie die Wurzelseite mit der ID 0 aus. Dort speichert TYPO3 die Benutzerprofile sämtlicher Backend-Benutzer sowie die Benutzergruppen. Öffnen Sie nun den entsprechenden Backend-Benutzer und geben Sie anschließend folgenden Code in das Feld TSconfig ein: admPanel { hide = 0 enable.edit = 1 }

Max. Linie

Wenn Sie die Option für eine Benutzergruppe freischalten möchten, geben Sie den Code in das TSconfig-Feld der Benutzergruppe ein. Sie wird dann automatisch für alle Benutzer dieser Gruppe aktiviert, sofern sie im Benutzerprofil nicht wieder überschrieben wird. Wechseln Sie nach dem Speichern wieder ins Frontend. Wie in Abbildung 3-2 gezeigt, finden Sie nun im Bereich Eingabe des Admin-Panels den Link TYPO3 Backend öffnen.

3.10 Backend-Benutzer auf das Frontend umleiten | 109 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Links

Abbildung 3-2: Mit diesem Link öffnen Sie das Backend in einem neuen Fenster

Mit einem Klick auf diesen Link öffnet sich das Backend in einem neuen Fenster. Da Sie bereits als Backend-Benutzer angemeldet sind, können Sie umgehend im Backend weiterarbeiten. Wenn Sie bei jeder Anmeldung selbst bestimmen möchten, in welche Ansicht Sie nach der Anmeldung gelangen, erweitern Sie den Code von $TYPO3_CONF_VARS['BE']['interfaces'] = 'frontend';

auf $TYPO3_CONF_VARS['BE']['interfaces'] = 'frontend,backend';

Lizensiert für Markus Mueller

Damit erzeugen Sie ein Auswahlfeld, mit dem Sie die gewünschte Ansicht selbst wählen können. Mit der Reihenfolge der Werte bestimmen Sie die Anordnung der Optionen in der Auswahlliste. Folgende Angabe zeigt die Option Backend an oberster Stelle: $TYPO3_CONF_VARS['BE']['interfaces'] = 'backend,frontend';

Mit einem Komma fügen Sie der Liste ein leeres Feld hinzu: $TYPO3_CONF_VARS['BE']['interfaces'] = ',frontend,backend';

Achten Sie darauf, dass Sie die Werte korrekt eingeben. Bleibt das Feld leer oder ist der Wert ungültig, verwendet TYPO3 standardmäßig die Backend-Ansicht. Zusätzlich können Sie über das Benutzer-TSconfig festlegen, dass Sie nach dem Login auf eine spezielle Adresse umgeleitet werden. Das ist vor allem dann nützlich, wenn nur Teilbereiche der Seite bearbeitet werden können. Um diese Weiterleitung einzurichten, geben Sie folgenden Code in das Feld TSconfig ein: auth.BE { redirectToURL = http://www.example.com/index.php?id=seiten_id }

Als Wert können Sie jede URL eingeben, die Sie als sinnvoll erachten. Wichtig ist vor allem, dass sie korrekt aufgebaut und erreichbar ist. Um Seiten innerhalb von TYPO3 anzuspringen, können Sie die URL auch folgendermaßen angeben: auth.BE { redirectToURL = ../index.php?id=seiten_id }

Max. Linie

Beachten Sie, dass Sie das Backend danach nicht mehr wie gewohnt über die URL www. example.com/typo3/ erreichen können, da TYPO3 bei jedem Zugriff über die Datei index.

110 | Kapitel 3: Der richtige Zugang zum Backend This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

php den im Benutzerprofil gespeicherten Wert ausliest und eine entsprechende Weiterleitung durchführt. Um in das Backend zu gelangen, geben Sie die URL dann nach folgendem Muster ein: www.example.com/typo3/backend.php

Ergänzend dazu können Sie auch in Ihren Seiteninhalten Links angeben, mit denen der Benutzer nach der Anmeldung umgeleitet wird. Dazu müssen Sie dem Link lediglich den Parameter redirect_url anhängen. Dieser Parameter speichert die Adresse, auf die der Benutzer nach erfolgter Anmeldung weitergeleitet wird. Das folgende Beispiel verdeutlicht den Aufbau: Frontend-Editing aktivieren

Selbstverständlich können solche Links auch über TypoScript erstellt und damit beispielsweise fest in der Seitennavigation verankert werden. Binden Sie folgendes Codefragment in ein Menüobjekt in Ihrem TypoScript-Template ein:

Lizensiert für Markus Mueller

... 10 = TEXT 10 { value = Frontend-Editing aktivieren typolink.parameter = typo3/index.php typolink.parameter.dataWrap = |?redirect_url=../index.php?id={page:uid} } ...

Mit diesem TypoScript-Code wandeln Sie den Text Frontend-Editing aktivieren in einen Hyperlink um. Diesem Hyperlink übergeben Sie zusätzlich den Parameter redirect_url mit der Adresse zur aktuellen Seite im Frontend. Um vom Backend-Formular wieder auf diese Seite umgeleitet zu werden, müssen Sie diese relativ zum Backend angeben. Achten Sie darauf, dass Sie den Wert {page:uid} nicht anpassen, da er vom TypoScript-Parser automatisch in die aktuelle Seiten-ID umgewandelt wird. In Kapitel 12 erfahren Sie mehr über die Menütypen und deren Anwendungsmöglichkeiten. Beachten Sie, dass Sie eine mögliche Sicherheitslücke öffnen, wenn Sie einen Link zum Backend öffentlich anzeigen. Überprüfen Sie, ob es genügt, wenn Sie den Link nur für registrierte Benutzer sichtbar schalten. Ergänzen Sie den Code dann bei Bedarf um die hervorgehobene Zeile:

Max. Linie

... 10 = TEXT 10 { if.isTrue.data = TSFE:loginUser value = Frontend-Editing aktivieren typolink.parameter = typo3/index.php typolink.parameter.dataWrap = |?redirect_url=../index.php?id={page:uid} } ...

3.10 Backend-Benutzer auf das Frontend umleiten | 111 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Wenn Sie – wie in Rezept 3.4 gezeigt – Änderungen am TYPO3-Verzeichnis vorgenommen haben, sollten Sie die Pfadangabe entsprechend anpassen. Als registrierter Backend-Benutzer haben Sie die Möglichkeit, Seiteninhalte direkt über das Frontend zu bearbeiten. Lesen Sie hierzu in Rezept 4.7 mehr über die Einstellungsmöglichkeiten dieser Bearbeitungsform.

Links

Siehe auch In Rezept 4.7 erfahren Sie, wie Sie Inhalte über das Frontend pflegen.

3.11 Einen bestimmten Backend-Benutzer simulieren Problem Sie möchten als Administrator die Zugriffsrechte eines bestimmten Backend-Benutzers prüfen und möchten (temporär) in die jeweilige Benutzerrolle schlüpfen.

Lösung Lizensiert für Markus Mueller

Wechseln Sie in das Modul Verwaltung unterhalb von Admin-Werkzeuge, aktivieren Sie in der Auswahlliste die Option Compare User Settings und suchen Sie in der Liste nach dem Namen des Benutzers, in dessen Rolle Sie wechseln möchten. Nach dem Klick auf das rot hervorgehobene Icon wechseln Sie temporär in die Ansicht des gewählten Benutzers (siehe Abbildung 3-3). Mit dem Button Verlassen rechts oben wechseln Sie wieder zurück in Ihre ursprüngliche Rolle.

Abbildung 3-3: Über dieses Icon wechseln Sie in die Ansicht des Benutzers

Diskussion Diese Funktion eignet sich hervorragend, wenn Sie Zugriffsrechte, Benutzer-TSconfigEinstellungen oder bestimmte Einstellungen des Benutzers prüfen oder nachvollziehen möchten. Etwaige Fehlermeldungen lassen sich so sehr direkt und verlässlich nachvollziehen, sodass die Unklarheiten meist schnell gefunden sind.

Max. Linie

Wenn Sie lediglich die Benutzereinstellungen prüfen oder das Passwort zurücksetzen möchten, können Sie dies auch über einen anderen, schnelleren Weg durchführen.

112 | Kapitel 3: Der richtige Zugang zum Backend This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Zum einen können Sie die Benutzerprofile über das Modul Verwaltung bearbeiten, indem Sie auf den Bearbeitungsstift neben dem Benutzernamen klicken. Hierauf öffnet sich direkt der gewählte Datensatz des Backend-Benutzers. Nach dem Schließen des Datensatzes befinden Sie sich wieder in der Benutzerübersicht. Zum andern können Sie auch direkt in die Benutzereinstellungen des Benutzers wechseln. Dies ist vor allem dann sehr hilfreich, wenn Sie das Benutzer-TSconfig testen möchten, um bestimmte Benutzereinstellungen vorzubelegen, wie in Rezept 3.12 beschrieben. Ebenso können Sie auch hier das Benutzerpasswort zurücksetzen oder den Namen anpassen. Um diese Einstellungen vorzunehmen, wechseln Sie in Ihre Benutzereinstellungen und wählen den Reiter Admin-Funktionen. Dort erscheint nun eine Auswahlliste, mit der Sie den gewünschten Benutzernamen auswählen können. Durch die Auswahl werden automatisch die Benutzereinstellungen des gewählten Benutzers geladen. Nun können Sie zum Beispiel das Passwort zurücksetzen oder den Benutzernamen korrigieren. Durch das TSconfig fest vorgegebene Werte werden in den Einstellungen visuell abgeblendet und können nicht überschrieben werden. Indem Sie wieder auf das Modul Verwaltung klicken, gelangen Sie zurück in Ihr ursprüngliches Benutzerprofil. So können Sie schnell Einstellungen von Benutzern anpassen, ohne das gesamte Backend neu zu laden.

Lizensiert für Markus Mueller

Die Benutzereinstellungen können Sie so noch schneller einsehen und anpassen als über den in der Lösung genannten Weg. Jedoch beschränkt sich der Einblick hier auf die Benutzereinstellungen. Um die Zugriffsrechte im Seitenbaum oder tiefer gehende SeitenTSconfig-Einstellungen zu prüfen, müssen Sie den ersten Lösungsweg gehen.

3.12 Benutzereinstellungen vorgeben Problem Sie möchten standardmäßig bestimmte Benutzereinstellungen aktivieren.

Lösung Nutzen Sie das Benutzer-TSconfig, um die Einstellungen für den gewählten Benutzer fest vorzugeben. Wenn Sie den TSconfig-Code in die Benutzergruppe einfügen, erhalten automatisch alle Benutzer dieser Gruppe die jeweiligen Standardeinstellungen. Um den TSconfig-Code einzugeben, wechseln Sie in das Modul Verwaltung und klicken dort rechts neben dem Benutzernamen auf das Stiftsymbol. Aktivieren Sie im Datensatzdetail den Reiter Optionen und setzen Sie den Cursor in das Feld TSconfig.

Max. Linie

Klicken Sie nun rechts vom Eingabefeld auf das Icon TS (siehe Abbildung 3-4). Hierauf öffnet sich die TSconfig-Kurzreferenz in einem neuen Pop-up-Fenster. Dort können Sie über

3.12 Benutzereinstellungen vorgeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 113

Max. Linie

einen Codeassistenten schnell nach TSconfig-Parametern suchen und erhalten gleichzeitig zu jedem Wert eine nähere Funktionsbeschreibung. Zudem hilft Ihnen der Assistent, den TSconfig-Code richtig zu schreiben und einzurücken. So sparen Sie viel Tipparbeit und vermeiden Fehlerquellen.

Links

Abbildung 3-4: Über diese Schaltfläche aktivieren Sie die TSconfig-Kurzreferenz

Die möglichen TSconfig-Parameter werden in einer Baumstruktur dargestellt, durch die Sie sich mit der Maus klicken können. Über die rot hervorgehobenen Links GO gehen Sie eine Ebene tiefer in den TSconfig-Einstellungen und erhalten mehr Details über den gewünschten Bereich. Mit dem Link am linken oberen Rand gelangen Sie zurück in die Parameterübersicht.

Lizensiert für Markus Mueller

Wenn Sie eine passende Einstellung gefunden haben, klicken Sie auf das kleine Plussymbol am linken Rand. Hierdurch wird der Wert in den Codeassistenten eingefügt. Wenn Sie mehrere Werte einfügen möchten, wiederholen Sie diesen Schritt bei jeder Option. Anschließend wandeln Sie Ihre Auswahl über den Link Umbruch in wohlgeformten TSconfig-Code um und übertragen ihn anschließend in das TSconfig-Feld des Backend-Benutzers. Um Ihre Auswahl zu starten, klicken Sie nun auf das rot hervorgehobene GO bei setup. [default] (Abbildung 3-5).

Abbildung 3-5: Die TSconfig-Kurzreferenz, mit der Sie alle TSconfig-Einstellungen formulieren können

Max. Linie

Wählen Sie abschließend in der Liste mit dem Plussymbol die gewünschten Optionen aus, die Sie festlegen möchten. TYPO3 fügt diese Werte dann nacheinander in das Texteingabefeld ein, das sich am unteren Seitenrand befindet. Wenn Sie mit der Auswahl fertig sind, scrollen Sie zu diesem Feld, setzen die gewünschten Werte und klicken auf den

114 | Kapitel 3: Der richtige Zugang zum Backend This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Link Umbruch. TYPO3 wird die gewählten Werte dann den richtigen TSconfig-TopLevel-Objekten zuweisen (siehe Abbildung 3-6). Das ist wichtig, um die Werte in den richtigen Kontext zu setzen, damit sie von TYPO3 interpretiert werden können. Wenn Sie diese Einrückung nicht vornehmen, werden die Einstellungen von TYPO3 ignoriert.

Abbildung 3-6: Der Code vor und nach der Einrückung

Klicken Sie abschließend auf Übertragen & schließen. Der Assistent überträgt danach die Werte in das TSconfig-Feld des Backend-Benutzers und schließt das Pop-up-Fenster. Lizensiert für Markus Mueller

Zum Beispiel können Sie in der Liste die beiden Optionen recursiveDelete und allSaveFunctions aktivieren. Nach dem Klick auf die Option Umbruch sollte der Code dann so aussehen: setup.default { recursiveDelete = 0 allSaveFunctions = 1 }

Wenn Sie im Pop-up-Fenster direkt auf den Wert geklickt haben, fügt der Assistent lediglich den Wert ein und schließt das Fenster. Sie müssen den Code dann noch entsprechend dem oben gezeigten Code anpassen, damit Ihre TSconfig-Einstellungen von TYPO3 korrekt interpretiert werden können. Nachdem Sie den Benutzer gespeichert haben, sind die gewählten Eigenschaften auch standardmäßig in seinen Einstellungen aktiv.

Diskussion

Max. Linie

Hiermit stehen Ihnen zahlreiche Optionen zur Verfügung, mit denen Sie die Benutzereinstellungen beeinflussen können. Sie werden feststellen, dass nicht alle angebotenen Optionen im Benutzerprofil erscheinen und daher vom Benutzer nicht geändert werden können. Diese Werte haben eher administrativen Charakter und können dazu genutzt werden, grundlegende Einstellungen wie zum Beispiel die Breite für den Seitenbaumbereich zentral festzulegen (ein solches Anwendungsbeispiel finden Sie in Rezept 7.4).

3.12 Benutzereinstellungen vorgeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 115

Max. Linie

Der Benutzer kann seine Einstellungen nach seinen eigenen Wünschen über das Modul Einstellungen anpassen. Was aber, wenn Sie bestimmte Werte erzwingen möchten? Beispielsweise soll der Benutzer die Option Rekursives Löschen niemals aktivieren können, um potenzielle Fehlerquellen auszuschließen.

Links

Um Werte fest vorzubelegen, geben Sie anstatt des Werts default den Wert override an. Die Optionen werden dann nach dem Speichern immer wieder von TYPO3 auf diese festgelegten Werte zurückgesetzt, sodass der Benutzer keine Änderungen vornehmen kann: setup.override { recursiveDelete = 0 allSaveFunctions = 1 }

Somit stellen Sie sicher, dass alle Optionen nach Ihren Wünschen übernommen werden und sich auch nachträglich nicht ändern lassen.

Siehe auch

Lizensiert für Markus Mueller

Falls Ihnen der Begriff TSconfig noch neu ist, sollten Sie die Einleitung von Kapitel 6 lesen. Dort gehen wir auf den Begriff näher ein. Zudem finden Sie in Kapitel 6 weitere Anwendungsbeispiele für die Einsatzmöglichkeiten von TSconfig. Eine Übersicht über alle TSconfig-Parameter und Top-Level-Objekte finden Sie im Dokument TSconfig unter http://typo3.org/documentation/document-library/core-documentation/doc_core_tsconfig/ current/.

Max. Linie

Max. Linie 116 | Kapitel 3: Der richtige Zugang zum Backend This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

First

Kapitel 4

KAPITEL 4

Inhalte eingeben

4.0

Einführung

In diesem Kapitel erfahren Sie, wie Sie Seiten komfortabel erstellen und mit Inhalt füllen. Die Rezepte 4.1 und 4.2 bieten Ihnen Lösungen und Tipps, wie Sie redaktionelle Änderungen an Ihrer Website in kürzester Zeit vornehmen können. Selbst aufwendigere Anpassungen an der Seitenstruktur lassen sich dadurch in der Regel schnell und bequem erledigen. Lizensiert für Markus Mueller

Rezept 4.3 zeigt Ihnen, wie Sie Eingabefelder mit häufig benötigten Werten vorbelegen und so viel Zeit bei der Eingabe der Inhalte sparen. Zusätzlich können Sie auch festlegen, welche Felder beim Kopieren von Datensätzen automatisch übernommen werden. In Rezept 4.4 erfahren Sie, wie Sie diese Möglichkeit effektiv einsetzen können. Wenn Sie Änderungen an den Inhalten vornehmen, ist es auch hilfreich, die jeweiligen Datensätze während der Bearbeitung zu verstecken, sodass Besucher Ihrer Website davon nichts mitbekommen. Sie können zum Beispiel sämtliche Inhalte in Ruhe eingeben und erst dann freischalten, wenn Sie mit dem Ergebnis zufrieden sind. In Rezept 4.5 erfahren Sie, wie Sie Datensätze standardmäßig verstecken. Vor allem wenn Sie mit mehreren Benutzern innerhalb einer TYPO3-Installation arbeiten, möchten Sie vielleicht die Erzeugung bestimmter Datensätze auf manchen Seiten unterbinden, etwa um sicherzustellen, dass Seiteninhalte ausschließlich auf regulären Seiten erstellt werden dürfen. In Rezept 4.6 finden Sie dazu die passende Lösung.

Max. Linie

Wenn sich Ihre Website mit der Zeit mit Inhalten füllt und umfangreicher wird, kann die Verwaltung über das TYPO3-Backend zunehmend abstrakt und unübersichtlich werden, und Sie verlieren dadurch möglicherweise den Blick für die Zusammenhänge auf der jeweiligen Webseite. TYPO3 bietet Ihnen die Möglichkeit, die Seiteninhalte auch direkt im Frontend zu ändern. Dadurch können Sie unmittelbar in der Website arbeiten und gelangen erfahrungsgemäß schneller an die gewünschte Stelle, an der Sie dann über die gewohnten Bearbeitungssymbole die Eingabemaske öffnen und die Inhalte anpassen können. Rezept 4.7 beschreibt die nötigen Schritte, um diese intuitive Eingabemöglichkeit zu aktivieren.

| 117 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Um Inhalte einzugeben, bietet Ihnen TYPO3 standardmäßig ein interaktives Textbearbeitungsmodul, mit dem Sie sehr intuitiv Seiteninhalte formatieren können. Dieser Editor ist hochgradig anpassbar und äußerst flexibel einzustellen. In Rezept 4.8 erfahren Sie, wie Sie die Einstellungen an Ihre Bedürfnisse anpassen.

Links

Sämtliche Inhalte Ihrer Website können Sie in mehreren Sprachen anlegen und auf Ihrer Website entsprechend den Einstellungen Ihrer Besucher präsentieren. Wenn Sie die Inhalte Ihrer Website in mehreren Sprachen anbieten möchten, sollten Sie Rezept 4.9 lesen. Dort erfahren Sie, welche Einstellungen Sie vornehmen müssen, um mehrsprachige Inhalte einzugeben und zu verwalten. Wenn Sie die Inhaltseingabe der Benutzer kontrollieren möchten oder müssen, stellt Ihnen TYPO3 sogenannte Workspaces zur Verfügung. Über Workspaces können mehrere Benutzer an Inhalten arbeiten, wobei alle Änderungen automatisch von TYPO3 protokolliert werden. Rezept 4.10 erläutert anhand eines beispielhaften Workflows die grundlegenden Einstellungsmöglichkeiten der Workspaces.

Lizensiert für Markus Mueller

Wenn Sie sensible Inhalte auf Ihren Webseiten ausgeben, können Sie mit einem Workflow erheblich zur Qualitätssicherung beitragen. Die Inhalte werden dann durch das VierAugen-Prinzip von mehreren Personen gegengelesen, sodass mögliche Fehler frühzeitig erkannt werden können. Wie Sie einen solchen Workflow mit TYPO3-Bordmitteln einrichten, erfahren Sie in Rezept 4.11.

4.1

Seiten schnell erzeugen

Problem Sie möchten schnell eine oder mehrere Seiten erstellen.

Lösung Falls noch keine Seite in Ihrem Seitenbaum existiert, aktivieren Sie zuerst das Modul Seite und klicken auf die Weltkugel im Seitenbaum. Wählen Sie dann im Kontextmenü den Eintrag Neu und klicken Sie anschließend auf den Eintrag Seite (in). Es erscheint eine Eingabemaske, über die Sie die Seiteneigenschaften festlegen können. Nach dem Speichern klicken Sie auf das Modul Funktionen.

Max. Linie

Im Modul Funktionen finden Sie den Assistenten Erzeuge mehrere Seiten. In den Eingabefeldern geben Sie die Titel der neuen Seiten an. Die restlichen Eigenschaften der Seite ändern Sie, nachdem die Seiten erzeugt wurden. Nach einem Klick auf den Button Seiten anlegen erzeugen Sie die neuen Seiten oberhalb der bestehenden. Mit der Option Neue Seiten nach existierenden Unterseiten anlegen fügen Sie die Seiten danach ein. Arbeiten Sie in einer Produktionsumgebung, sollten Sie die Option Neue Seiten verbergen aktivieren. Dadurch haben Sie die Möglichkeit, die Seiten vor dem Freischalten mit Inhalt zu füllen.

118 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Diskussion Möchten Sie nur einzelne Seite erzeugen, ist der oben erwähnte Weg auf Dauer etwas umständlich. TYPO3 bietet Ihnen die Möglichkeit, neue Seiten direkt aus einer bestehenden Seite heraus zu erstellen. Aktivieren Sie dazu mit folgendem Benutzer-TSconfig die Funktion Dokument sichern und neues anlegen in der Aktionspalette (allgemeine Informationen zu TSconfig-Anweisungen finden Sie in der Einleitung zu Kapitel 6): options { saveDocNew.pages = 1 }

Nach dem Speichern der TSconfig-Angaben wird, wie in Abbildung 4-1 gezeigt, die Aktionspalette im Bearbeitungsformular der Seiteneigenschaften um einen neuen Button mit der gewünschten Funktion erweitert.

Abbildung 4-1: Die Aktionspalette vor und nach der Aktivierung des Buttons »Speichern und neuen Datensatz anlegen« Lizensiert für Markus Mueller

Die neuen Seiten werden standardmäßig unterhalb der bestehenden Seiten angelegt. Wenn Sie jedoch möchten, dass die neuen Seiten darüber angelegt werden, geben Sie folgenden Code in Ihr Benutzer-TSconfig-Feld: options { saveDocNew.pages = top }

Zusätzlich können Sie die Inhalte über die Listenansicht anlegen. Aktivieren Sie dazu im Listenmodul die Option Erweiterte Ansicht. Daraufhin erscheint in der Optionspalette das Symbol Neue Seite nach dieser Seite anlegen. Abbildung 4-2 zeigt dieses Icon, mit dem Sie individuell bestimmen können, nach welchem Datensatz der neue Inhalt angelegt wird.

Abbildung 4-2: Die Listenansicht in der erweiterten Ansicht; neue Datensätze können so sehr intuitiv an der gewünschten Position erstellt werden

Mit dem in Abbildung 4-3 gezeigten Symbol erstellen Sie einen neuen Datensatz direkt am Anfang der Seite.

Max. Linie

Abbildung 4-3: Mit diesem Symbol erstellen Sie einen neuen Datensatz am Seitenanfang 4.1 Seiten schnell erzeugen | 119 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Siehe auch

Links

Erfahren Sie in Rezept 4.2, wie Sie neue Seiten schnell mit Inhalt füllen. Rezept 5.4 erläutert, wie Sie bestehende Inhalte im Handumdrehen in die neuen Seiten einfügen. In Rezept 5.6 erfahren Sie, wie Sie mehrere Inhalte gleichzeitig bearbeiten.

4.2

Die Inhaltseingabe beschleunigen

Problem Sie möchten Ihre Inhalte schneller und effizienter eingeben.

Lösung Verwenden Sie den Bearbeitungsmodus Schnelleingabe im Modul Seite. Mit der Schnelleingabe steht Ihnen ein Eingabemodus zur Verfügung, mit dem Sie Inhaltselemente schnell bearbeiten und neu erzeugen können.

Lizensiert für Markus Mueller

Wechseln Sie also in das Modul Seite und klicken Sie auf die Seite, deren Inhalt Sie bearbeiten möchten. Der Seiteninhalt wird dann dem aktuellen Darstellungsmodus entsprechend entweder nach Spalten, Sprachen oder im Schnelleingabe-Modus angezeigt. Falls die Schnelleingabemaske nicht gleich erscheint, finden Sie rechts oben ein Auswahlfeld, mit dem Sie den Bearbeitungsmodus einstellen können. Wählen Sie dort die Option Schnelleingabe. Danach ändert sich die Eingabemaske, und Sie können über das Schnelleingabeformular Inhalte direkt anwählen und editieren. Unterhalb der Eingabemaske für den Datensatz werden alle anderen Seiteninhalte aufgelistet, die sich in der Seite befinden. Der aktuelle Datensatz wird in der Liste mit einem roten Pfeil gekennzeichnet. Klicken Sie auf einen der Titel, öffnet sich umgehend die Eingabemaske für das entsprechende Inhaltselement. Beachten Sie dabei, dass Ihre Änderungen unwiderruflich verloren gehen, wenn Sie vor dem Wechsel die Inhalte nicht abspeichern. Innerhalb der Liste können Sie auch neue Seitenelemente hinzufügen. Klicken Sie dazu auf den Pfeil an der gewünschten Position. Nach dem Speichern erzeugt TYPO3 den Datensatz an der gewünschten Stelle. Beachten Sie, dass der Bearbeitungsmodus Schnelleingabe in SysOrdnern ausgeblendet wird.

Diskussion Um die Eingabe noch effektiver zu gestalten, können Sie in der Schnelleingabe die Feldanordnung über das Benutzer- oder Seiten-TSconfig anpassen. Mit dem folgenden Code verschieben Sie das Feld Text vor das Feld Überschrift:

Max. Linie

mod.web_layout.tt_content { fieldOrder = bodytext, header }

120 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Dies ist dann hilfreich, wenn Sie bestimmte Felder hintereinander bearbeiten möchten, etwa um Inhalte in einer festen Reihenfolge zu kopieren. Beispielsweise können Sie damit die Tabulator-Reihenfolge so optimieren, dass Sie mit jeweils einem Tabulator-Schritt ins nächste Feld springen. Alle übrigen Felder werden nach den Standardangaben angeordnet. Beachten Sie, dass die Angaben im Benutzer-TSconfig die Angaben im Seiten-TSconfig überschreiben. Eine vollständige Liste der möglichen Feldnamen erhalten Sie über das Modul Konfiguration. Wählen Sie dort den Eintrag $TCA (tables.php) in der Auswahlliste. Danach klappen Sie beim Eintrag tt_content den Wert columns auf. Damit erhalten Sie eine Liste der möglichen Feldnamen, die Sie umstellen können (in Rezept 1.5 erfahren Sie mehr über das Modul Konfiguration). Um die Inhaltseingabe zusätzlich zu beschleunigen, geben Sie folgenden Code in das Benutzer-TSconfig-Feld ein: options.saveDocNew = 1

Damit erweitern Sie die Optionspalette zum Speichern um die Funktion Dokument sichern und neues anlegen für alle Datensätze. In Abbildung 4-4 sehen Sie die Palette vor und nach der Aktivierung dieser Funktion. Lizensiert für Markus Mueller

Abbildung 4-4: Die neue Option »Dokument sichern und neues anlegen« ist unten nun aktiv

Neue Datensätze können Sie so direkt aus der aktuellen Eingabemaske heraus anlegen. Möchten Sie diese Speicherfunktion nur auf spezielle Tabellen anwenden, verwenden Sie folgenden Code: options.saveDocNew = 0 options.saveDocNew.[tabellen_name] = 1

Die Option Speichern und neu wird so nur bei der angegebenen Tabelle sichtbar. Umgekehrt können Sie diese Option in der Form auch für spezielle Tabellen deaktivieren: options.saveDocNew = 1 options.saveDocNew.[tabellen_name] = 0

Standardmäßig werden die so erzeugten Datensätze immer unterhalb des bestehenden Datensatzes geschrieben. Möchten Sie die Datensätze oberhalb der bestehenden anlegen, geben Sie folgenden Code ein: options.saveDocNew = top

Analog zu den oben beschriebenen Einstellungen können Sie diese Option auch nur auf spezielle Tabellen anwenden:

Max. Linie

options.saveDocNew.[tabellen_name] = top

4.2 Die Inhaltseingabe beschleunigen | 121 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Beachten Sie, dass im Seitenmodus Schnelleingabe die Option Speichern und neu nicht vorhanden ist. Sie können jedoch unter jedem Element automatisch einen neuen Datensatz anlegen, wenn Sie auf einen der grauen Pfeile zwischen den vorhandenen Seitenelementen klicken. Daraufhin öffnet sich gleich die Eingabemaske des neuen Elements. Indem Sie auf den Titel eines bestehenden Datensatzes klicken, öffnen Sie den entsprechenden Datensatz für die Bearbeitung.

Links

Siehe auch In Rezept 4.3 erfahren Sie, wie Sie Felder mit einem bestimmten Wert vorbelegen können. Rezept 4.4 zeigt Wege, wie Sie Ihre Dateneingabe weiter optimieren können, indem Sie Werte vorangegangener Elemente beim Erstellen oder Kopieren übernehmen. Rezept 5.4 erläutert, wie Sie lange Seiten komfortabel aufteilen und so Ihre Inhalte für Ihre Besucher aufbereiten können.

4.3

Standardwerte für Felder vorgeben

Problem Lizensiert für Markus Mueller

Sie möchten bestimmte Felder mit Standardwerten vorbelegen, um die Eingabe wiederkehrender Inhalte zu beschleunigen.

Lösung Setzen Sie die Standardwerte mit TCAdefaults über das Benutzer- oder Seiten-TSconfig. Die Angaben von TCAdefaults sind immer nach diesem Muster aufgebaut: TCAdefaults.[tabellen_name].[spalten_name] = Wert

Geben Sie zum Beispiel folgenden Code in das TSconfig-Feld einer Backend-Benutzergruppe ein, um zu erreichen, dass alle von den Benutzern dieser Gruppe neu angelegten Inhaltselemente standardmäßig versteckt sind: TCAdefaults.tt_content { hidden = 1 }

Geben Sie den Code in das TSconfig-Feld einer Seite ein, gelten die Standardwerte für alle Unterseiten.

Diskussion

Max. Linie

Jedes Feld im TYPO3-Backend lässt sich über TCAdefaults mit Werten vorbelegen. Dafür ist es entscheidend, dass Sie wissen, welches Feld welche Datenbankspalte abbildet. Um dies herauszufinden, können Sie entweder im HTML-Quelltext der jeweiligen Eingabemaske nach dem Feldnamen suchen oder den Wert über die Datenbankstruktur herleiten.

122 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

So erhalten Sie den Wert aus dem HTML-Code: Öffnen Sie die Eingabemaske und lassen Sie sich den Quelltext des Frames anzeigen, in dem das Formular angezeigt wird. Suchen Sie im Code nach dem Eingabefeld. Im HTML-Code finden Sie für jedes Feld einen eindeutigen Namen. Über diesen Namen wird jedes Feld eindeutig einem Wert in der Datenbank zugewiesen. Der Feldname ist immer nach diesem Muster aufgebaut: data[tabellen_name][uid][spalten_name]

[tabellen_name] kennzeichnet die Tabelle, in der dieser Datensatz liegt. [uid] steht für

die UID des aktuellen Datensatzes. Die Abkürzung UID steht für Unique ID und repräsentiert einen eindeutigen Zahlenwert, anhand dessen TYPO3 Datensätze eindeutig abfragen und zuordnen kann. Jedoch spielt sie bei der Verwendung in TCAdefaults keine Rolle und kann ignoriert werden. Mit dem Wert [spalten_name] setzen Sie den Namen derjenigen Tabellenspalte fest, in der der Wert gespeichert wird. Über die Datenbankstruktur finden Sie die passende Struktur folgendermaßen heraus: Schauen Sie, in welchem Datensatz Sie welches Feld ausblenden möchten. Seiten finden Sie in der Tabelle pages. Seiteninhalt wird standardmäßig in der Tabelle tt_content gespeichert. Lesen Sie die Diskussion in Rezept 2.5, um einen Überblick über die vorhandenen Datenbanktabellen zu erhalten. Außerdem finden Sie in Rezept 16.4 eine Übersicht über die Tabellenfelder der Tabelle tt_content und deren Bedeutung. Lizensiert für Markus Mueller

Siehe auch Rezept 4.4 beschreibt, wie Sie bestimmte Werte von bestehenden Datensätzen automatisch beim Kopieren oder Erstellen neuer Datensätze übernehmen.

4.4

Werte anderer Datensätze übernehmen

Problem Sie möchten Werte vorangegangener Datensätze automatisch übernehmen, wenn Sie neue Datensätze anlegen, beispielsweise um schnell eine Serie ähnlicher Inhaltstypen zu erstellen.

Lösung Passen Sie den ctrl-Bereich im TCA der jeweiligen Tabelle an und fügen Sie dort die Eigenschaft useColumnsForDefaultValues ein. In useColumnsForDefaultValues geben Sie die Feldnamen an, die vom vorangehenden Datensatz übernommen werden sollen. Falls Ihnen der Begriff ctrl-Bereich noch neu ist, sollten Sie zuerst das Rezept 16.3 lesen, bevor Sie weiterlesen.

Max. Linie

Max. Linie 4.4 Werte anderer Datensätze übernehmen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 123

In eigenen Extensions genügt es dazu, die folgende Zeile in den ctrl-Abschnitt des TCA der Tabelle einzufügen:

Links

$TCA['tabellen_name'] = Array ( 'ctrl' => Array ( 'useColumnsForDefaultValues' => 'feld_namen', ), );

Den ctrl-Bereich bestehender Tabellen ändern Sie über eine Extension, in der Sie über die Datei ext_tables.php die bestehenden TCA-Einstellungen an Ihre Bedürfnisse anpassen (wenn Ihnen der Umgang mit Extensions noch neu ist, erfahren Sie in Kapitel 16 die nötigen Hintergründe). Zuerst laden Sie das TCA der gewünschten Tabelle. Danach können Sie dort die Änderungen vornehmen. Ersetzen Sie feld_namen durch den entsprechenden Feldnamen aus der Tabelle. Die Feldnamen werden mit Kommata voneinander getrennt: t3lib_div::loadTCA('tabellen_name'); $TCA['tabellen_name']['ctrl']['useColumnsForDefaultValues'] = 'feld1, feld2, feldn';

Mit dem folgenden Code legen Sie beispielsweise fest, dass der Inhaltstyp eines Datensatzes beim Anlegen neuer Datensätze übernommen wird: t3lib_div::loadTCA('tt_content'); $TCA['tt_content']['ctrl']['useColumnsForDefaultValues'].= ',CType'; Lizensiert für Markus Mueller

Beachten Sie, dass Sie mit dem Code die bestehenden Einstellungen der Tabelle mit der Zuweisung .= erweitern. Dadurch bleiben die ursprünglichen Standardwerte colPos und sys_language_uid erhalten. Möchten Sie jedoch nur den Wert des Inhaltstyps übernehmen, ändern Sie die Wertzuweisung, indem Sie den Punkt und das Komma entfernen.

Diskussion Möchten Sie bestimmte Werte auch beim Kopieren von Datensätzen übernehmen, fügen Sie die Eigenschaft copyAfterDuplFields in den ctrl-Bereich der gewünschten Tabelle ein: t3lib_div::loadTCA('tabellen_name'); $TCA['tabellen_name']['ctrl']['copyAfterDuplFields'] = 'feld1, feld2, feldn';

Wenn Sie Datensätze aus der Zwischenablage hinter einen anderen Datensatz kopieren, werden mit dieser Einstellung alle leeren Felder mit den Werten des vorangehenden Datensatzes übernommen. Beispielsweise wird mit folgendem Code das Layout der Überschrift des vorangegangenen Datensatzes übernommen: t3lib_div::loadTCA('tt_content'); $TCA['tt_content']['ctrl']['copyAfterDuplFields'].= 'header_layout';

Siehe auch

Max. Linie

In Rezept 1.5 erfahren Sie, wie Sie die aktuellen Konfigurationseinstellungen analysieren können und so eine bessere Übersicht erhalten.

124 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

4.5

Seiten und Inhalte standardmäßig verstecken

Problem Sie möchten Datensätze standardmäßig ausblenden, um deren Inhalt beispielsweise vor dem Veröffentlichen nochmals gegenzulesen.

Lösung Setzen Sie per TCAdefaults den Standardwert des Felds hidden auf 1. Geben Sie dazu folgenden Code in das TSconfig-Feld in Ihrem Benutzerprofil, der Benutzergruppe oder der Seite ein und passen Sie den Tabellennamen an die gewünschte Tabelle an: TCAdefaults { tabellen_name.hidden = 1 }

Mit folgendem Code verstecken Sie beispielsweise neue Seiten und Seiteninhalte:

Lizensiert für Markus Mueller

TCAdefaults { pages.hidden = 1 tt_content.hidden = 1 }

Wenn Sie den Code in das TSconfig-Feld einer Benutzergruppe schreiben, wird das Feld automatisch bei allen Benutzern dieser Gruppe aktiviert.

Diskussion Mit diesen Einstellungsmöglichkeiten lässt sich auch leicht ein einfacher WorkflowMechanismus einrichten. Mit diesem Workflow stellen Sie beispielsweise sicher, dass Inhalte nur dann freigegeben werden, nachdem sie von einem anderen Benutzer authentifiziert wurden. Um diesen Mechanismus in TYPO3 einzurichten, gehen Sie wie folgt vor: Legen Sie zwei Benutzer und zwei Benutzergruppen an. Die eine Benutzergruppe darf das Feld Verstecken sehen und ändern. Die andere Benutzergruppe darf dieses Feld nicht sehen und dadurch auch nicht ändern. Der Wert für das Feld Verstecken wird in der Datenbank standardmäßig über das Feld hidden gespeichert. Um dieses Feld nun im Backend vorzubelegen, setzen Sie bei der ersten Benutzergruppe den Standardwert für dieses Feld auf 0. Bei der zweiten Benutzergruppe wird das Feld mit dem Wert 1 belegt, sodass es standardmäßig aktiviert ist. Für die erste Gruppe wählen Sie jetzt in der Auswahlliste Allowed excludefields die Option Seiteninhalt: Verstecken. Im Feld TSconfig geben Sie diesen Code ein:

Max. Linie

TCAdefaults.tt_content { hidden = 0 }

4.5 Seiten und Inhalte standardmäßig verstecken | 125 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Speichern Sie dann den Datensatz und wechseln Sie in die zweite Gruppe. Stellen Sie die Auswahlliste in Allowed excludefields wie bei der ersten Benutzergruppe ein, achten Sie jedoch unbedingt darauf, dass in der Auswahlliste die Option Seiteninhalt: Verstecken nicht aktiv ist. Im Feld TSconfig geben Sie folgenden Code ein:

Links

TCAdefaults.tt_content { hidden = 1 }

Dadurch aktivieren Sie das Feld Versteckt für diese Gruppe. Da das Feld selbst jedoch ausgeblendet ist, können Benutzer dieser Gruppe keine Seiteninhalte freischalten. Die Freischaltung muss von einem Benutzer der ersten Gruppe vorgenommen werden. Um diesen Workflow bei eigenen Tabellen zu verwenden, müssen Sie lediglich den Namen der Tabelle anpassen. Am schnellsten finden Sie diese Tabellennamen über den Erweiterungs-Manager heraus. Wählen Sie dort in der Auswahlliste die Option Geladene Extensions anzeigen und sehen Sie sich die Extension-Details der gewünschten Extension an. Unter dem Punkt Database requirements finden Sie die Namen der Tabellen, die von dieser Extension verwendet werden. Sollten Tabellen mit der Endung _mm angezeigt werden, können Sie diese ignorieren. Diese Tabellen dienen der Verknüpfung von Datensätzen zweier Tabellen und können nicht mit TCAdefaults-Werten belegt werden (in Rezept 16.3 erfahren Sie, wie Sie eigene Tabellen in TYPO3 integrieren). Lizensiert für Markus Mueller

Um sicherzustellen, dass Datensätze nicht durch versehentliches Kopieren veröffentlicht oder doppelt angezeigt werden, sollten Sie die Option hideAtCopy im ctrl-Bereich der jeweiligen Tabelle aktivieren. ctrl-Bereich bedeutet so viel wie control-Bereich. Dort speichert TYPO3 die grundlegenden Tabelleneigenschaften und damit auch, wie sich die Datensätze beim Kopieren verhalten. Um die Datensätze nun stets versteckt zu halten, geben Sie folgenden Code in die Datei ext_tables.php ein: t3lib_div::loadTCA('tt_content'); $TCA['tt_content']['ctrl']['hideAtCopy'] = 1;

Wenn Sie diese Eigenschaft bei eigenen Tabellen aktivieren möchten, müssen Sie folgenden Code in den TCA-Abschnitt ctrl einfügen: $TCA['tabellen_name'] = Array ( 'ctrl' => Array ( 'hideAtCopy' => 1, ), );

Diese Eigenschaft können Sie wiederum – beispielsweise für administrative Aufgaben – mit folgendem Code über TSconfig für bestimmte Benutzer oder Benutzergruppen überschreiben:

Max. Linie

TCEMAIN.table.tt_content { disableHideAtCopy = 1 }

126 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Achten Sie darauf, dass Sie das Kontrollkästchen für die Eigenschaft Versteckt nicht über TCEFORMS-Angaben ausblenden, da sonst die Bearbeitung der Felder für beide Gruppen nicht möglich ist (wenn Sie mit dem Begriff TCEFORMS noch nichts anfangen können, sollten Rezept 6.6 lesen. Dort erfahren Sie mehr über die Möglichkeit, Eingabeformulare im Backend zu reduzieren).

Siehe auch Eine Übersicht der möglichen Tabellennamen erhalten Sie in der Diskussion von Rezept 2.5. Wenn Sie mehr zum Thema Workflow wissen möchten, sollten Sie auch einen Blick auf das Workflow-Projekt von TYPO3 werfen: http://typo3.org/development/projects/ workflow-engine/. In Rezept 16.3 erfahren Sie mehr über die Einstellungsoptionen für Tabellen in TYPO3.

4.6

Datensätze nur in bestimmten Seiten erlauben

Problem Lizensiert für Markus Mueller

Sie möchten die Verwendung von Datensätzen eingrenzen, beispielsweise um in SysOrdnern reguläre Seiteninhalte auszuschließen.

Lösung Wählen Sie die Seite, in der Sie die Inhalte einschränken möchten, und bearbeiten Sie die Seiteneigenschaften. Geben Sie nun in das Feld TSconfig folgenden Code ein: mod.web_list { allowedNewTables = tabellen_name }

Ersetzen Sie den Platzhalter tabellen_name mit dem Namen der gewünschten Tabelle, deren Inhalte Sie auf der Seite nicht erlauben möchten. Um beispielsweise in einem SysOrdner nur TypoScript-Templates zu ermöglichen, geben Sie in das Feld TSconfig dieses SysOrdners folgenden Code ein: mod.web_list { allowedNewTables = sys_template }

Die folgende Auflistung zeigt die häufigsten Tabellennamen, die Sie als Wert verwenden können:

Max. Linie

Max. Linie 4.6 Datensätze nur in bestimmten Seiten erlauben | 127 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Tabelle 4-1: Tabellennamen und ihre Verwendung Tabellenname

Verwendung

be_groups

Backend-Benutzergruppen

be_users

Backend-Benutzer

fe_groups

Frontend-Benutzergruppen

fe_users

Frontend-Benutzer

pages

Seiten

pages_language_overlay

Übersetzungen von Seiten

sys_dmail

Newsletter bzw. Direct-Mail-Datensätze

sys_domain

Domains

sys_filemounts

Datei-Mounts für Backend-Gruppen oder -Benutzer

sys_note

Textnotizen im Backend

sys_template

TypoScript-Templates

tt_address

Adressendatensätze

tt_content

Seiteninhalte

tt_news

Aktuelle Meldungen

Links

Lizensiert für Markus Mueller

Natürlich können Sie auch mehrere Tabellen angeben, indem Sie deren Namen durch Kommata voneinander trennen.

Diskussion Beachten Sie, dass Sie trotz der TSconfig-Einstellungen prinzipiell noch Datensätze anderer Tabellen in die Seite einfügen können – dann etwa, wenn diese über die Zwischenablage eingefügt werden. Möchten Sie unerwünschte Datensätze wirklich unterbinden, müssen Sie die Seiteneigenschaften anpassen. Dort definieren Sie dann die Tabellen, die innerhalb der Seite vorkommen dürfen. TYPO3 speichert sämtliche Seiteneigenschaften im Array $PAGES_TYPES. In diesem Array werden, wie der Name schon vermuten lässt, sämtliche Seitentypen verwaltet, die Sie im Backend über die Seiteneigenschaften auswählen können. Jeder Seitentyp kann über eine eindeutige Identifizierungsnummer (ID) angesprochen werden. TYPO3 speichert diesen Seitentyp standardmäßig im Feld doktype der Tabelle pages ab. Die folgende Tabelle zeigt die vorhandenen Seitentypen mit deren IDs und verdeutlicht diesen Zusammenhang: Tabelle 4-2: Diese Seitentypen sind vorgegeben

Max. Linie

ID

Seitentypen

1

Standard

3

Link zu externer URL

4

Verweis

6

Backend-Benutzerbereich

128 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Tabelle 4-2: Diese Seitentypen sind vorgegeben (Fortsetzung) ID

Seitentypen

7

Einstiegspunkt

199

Visuelles Trennzeichen für Menü

254

SysOrdner

255

Papierkorb

Die Seitentypen oberhalb von 200 sind standardmäßig nicht über das Frontend erreichbar und werden in Navigationselementen ausgeblendet. Mit den Seitentypen unterhalb von 199 erzeugen Sie die Seiten, die für die Verwendung im Frontend vorgesehen sind. Eine Sonderrolle nimmt dabei der Seitentyp 199, Abstand, ein. Dieser kann zwar im Frontend als Trennelement in Navigationselementen eingebunden werden, ist jedoch nicht direkt über einen Seitenaufruf erreichbar. Um dieses Array um Ihren eigenen Seitentyp zu erweitern, sollten Sie – wie in Rezept 16.2 beschrieben – eine eigene Extension verwenden. Dadurch, dass Sie Ihre Änderungen in Extensions kapseln, trennen Sie Ihre eigenen Einstellungen sauber vom TYPO3-Kern und behalten so leichter den Überblick. Über die Extension erweitern Sie anschließend das Array $PAGES_TYPES um den neuen Seitentyp mit dem Wert 253. Lizensiert für Markus Mueller

Öffnen Sie nun in dem Extension-Ordner die Datei ext_tables.php und erweitern Sie mit folgendem Code das Array $PAGE_TYPES: $PAGES_TYPES['253'] = array( 'allowedTables' => 'tabellen_name' );

Sie haben Ihren Seitentyp damit registriert, und TYPO3 weiß nun, welche Tabellen in den Seiten dieses Typs gespeichert werden dürfen. Mit der Eigenschaft onlyAllowedTables können Sie die Einschränkung nochmals dahingehend verschärfen, dass der Seitentyp nicht geändert werden kann, wenn sich bereits Datensätze von unerwünschten Tabellen in der Seite befinden. Sie müssten dann sicherstellen, dass keine unerlaubten Datensätze vorhanden sind, bevor Sie den Seitentyp ändern. Erst wenn keine Datensätze anderer Tabellen mehr vorhanden sind, können Sie den Seitentyp umstellen. Ergänzen Sie für diese Einstellung den PHP-Code um die folgende hervorgehobene Zeile: $PAGES_TYPES['253'] = array( 'allowedTables' => 'tabellen_name', 'onlyAllowedTables' => '0' );

Fügen Sie nun unerlaubte Datensätze in eine Seite dieses Typs ein, würde TYPO3 Ihnen mit einer entsprechenden Meldung mitteilen, dass dieser Vorgang nicht durchgeführt werden kann.

Max. Linie

Wenn Sie die Datei ext_tables.php nun speichern und die Auswahlliste der Seitentypen kontrollieren, werden Sie feststellen, dass Ihr neuer Seitentyp dort noch nicht auftaucht.

4.6 Datensätze nur in bestimmten Seiten erlauben | 129 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Das liegt daran, dass der Seitentyp nun zwar konfiguriert ist, das Auswahlfeld in der Eingabemaske jedoch noch nicht erweitert wurde. Dies holen Sie nun im nächsten Schritt nach.

Links

Die Auswahlliste für die Seitentypen wird über die Feldeigenschaften im TCA der Tabelle pages erzeugt. Dort wird festgelegt, dass das Datenbankfeld doktype in einem BackendFormular als Auswahlliste dargestellt wird. Über eine weitere Feldeigenschaft werden die Einträge dieser Auswahlliste definiert. Diese Auswahlliste erweitern Sie nun um Ihren eigenen Seitentyp. Dazu müssen Sie lediglich die vorhandene Listeneinstellung im TCA der Tabelle korrekt ansprechen und erweitern. Öffnen Sie dazu wiederum die Datei ext_tables.php. Um die TCA-Einstellungen für die Tabelle pages zu erweitern, müssen Sie die jeweiligen TCA-Informationen zuerst einlesen. Erst danach werden die Änderungen am TCA wirksam. t3lib_div::loadTCA('pages');

Dann erweitern Sie über die PHP-Funktion array_push das TCA für die Tabelle pages, sodass Ihr Eintrag am Ende der Auswahlliste eingetragen wird. $pageItems = &$TCA['pages']['columns']['doktype']['config']['items']; array_push($pageItems, array('Eigener Seitentyp', '253'));

Lizensiert für Markus Mueller

Max. Linie

Um Ihren Eintrag stärker von den anderen Seitentypen abzuheben, können Sie mit dem Wert --div-- noch ein zusätzliches Trennelement vor den Eintrag setzen, sodass er deutlicher von den restlichen Einträgen separiert wird: array_push($pageItems, array('-----', '--div--')); $pageItems = &$TCA['pages']['columns']['doktype']['config']['items']; array_push($pageItems, array('Eigener Seitentyp', '253'));

Der neue Seitentyp kann nun wie gewünscht über die Seiteneigenschaften gewählt werden. Zusammenfassend hier der vollständige Code zur Erstellung des neuen Seitentyps: $PAGES_TYPES['253'] = array( 'allowedTables' => 'tabellen_name', 'onlyAllowedTables' => '0' ); t3lib_div::loadTCA('pages'); $pageItems = &$TCA['pages']['columns']['doktype']['config']['items']; array_push($pageItems, array('-----', '--div--')); array_push($pageItems, array('Eigener Seitentyp', '253'));

Eine häufige Fehlerquelle bei Anpassungen dieser Art ist, dass sie von anderen Extensions überschrieben werden, sofern diese nach Ihrer Extension installiert werden. Daher sollte vor dem Installieren einer neuen Version genau darauf geachtet werden, welche Änderungen diese vornimmt. Installieren Sie prinzipiell nur Extensions, die keine Ihrer Einstellungen überschreiben. In Rezept 1.5 finden Sie nützliche Tipps, wie Sie diese Einstellungen verlässlich überprüfen und sicherstellen, dass Ihre Änderungen korrekt übernommen werden.

130 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Siehe auch In Rezept 6.5 erfahren Sie, wie Sie das Auswahlfeld für Seitentypen auch ohne PHP-Code erweitern können. In Rezept 7.8 wird erläutert, wie Sie Ihre Seiten mit eigenen Icons ausstatten können und diesen so ein eigenes Erscheinungsbild im Seitenbaum verpassen. In Rezept 1.5 erfahren Sie mehr über den Aufbau des TCA und die Möglichkeit, die gewünschten TCA-Werte schnell zu ermitteln.

4.7

Inhaltseingabe über das Frontend ermöglichen

Problem Sie möchten die Inhalte Ihrer Website direkt auf der Webseite pflegen.

Lösung

Lizensiert für Markus Mueller

Aktivieren Sie über die TSconfig-Einstellungen das Frontend-Editing für den jeweiligen Benutzer, indem Sie das Admin-Panel aktivieren und dort die Bearbeitungsmöglichkeiten für das Frontend freischalten. Fügen Sie dazu folgenden Code in das Benutzer-TSconfig ein: admPanel { enable.edit = 1 override.edit.displayFieldIcons = 1 hide = 1 }

Mit enable.edit = 1 schalten Sie die Bearbeitungsmöglichkeiten zuerst einmal frei. Die Option override.edit.displayFieldIcons = 1 blendet daraufhin die Bearbeitungssymbole ein. Mit hide = 1 verstecken Sie das Admin-Panel, sodass nur die Bearbeitungssymbole auf der Website angezeigt werden. Wenn Sie nun auf ein solches Bearbeitungssymbol klicken, öffnet sich im Frontend die entsprechende Bearbeitungsmaske.

Diskussion Um weitere Arbeiten im Frontend zu erledigen, bietet Ihnen TYPO3 das sogenannte Admin-Panel. Mit dem Admin-Panel können Sie unterschiedliche Arbeiten direkt im Frontend durchführen, ohne ins Backend wechseln zu müssen.

Max. Linie

Dadurch können Sie auch umfangreiche Aufgaben schnell und flexibel im Frontend erledigen und direkter in der Seite arbeiten. Über das Admin-Panel können Sie beispielsweise Datensätze intuitiv auf der Seite verschieben, ausblenden oder löschen. Zudem lässt sich das Admin-Panel sehr fein konfigurieren und bietet – wie der Name schon vermuten lässt – vor allem für Administratoren viele nützliche Funktionen, die im Folgenden beschrieben werden.

4.7 Inhaltseingabe über das Frontend ermöglichen | 131 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Bevor Sie das Admin-Panel einsetzen können, sollten Sie überprüfen, ob es für die gewünschte Seite im TypoScript-Setup freigeschaltet ist. Für die Überprüfung empfehlen wir Ihnen den TypoScript Object Browser. Falls Ihnen die Verwendung mit dem ObjectBrowser noch fremd ist, sollten Sie unbedingt das Rezept 8.3 lesen, um die Grundlagen für die weiteren Schritte zu legen.

Links

Die Aktivierung des Admin-Panels erfolgt über mehrere Stufen. Zuerst muss es generell aktiviert sein. Diese Aktivierung wird über die Seitenkonfiguration vorgenommen. Geben Sie dazu folgende Zeilen in Ihr TypoScript-Setup ein oder stellen Sie sicher, dass die Option über den Object Browser entsprechend aktiviert wurde. Der Wert config.admPanel muss auf 1 stehen, damit Sie mit dem Admin-Panel arbeiten können. Alternativ können Sie auch folgenden Code direkt in das TypoScript-Setup einfügen: config { admPanel = 1 }

Im zweiten Schritt blenden Sie das Admin-Panel über die TSconfig-Einstellungen der jeweiligen Benutzergruppe oder des einzelnen Benutzers ein, indem Sie in das Feld TSconfig folgenden Code eingeben:

Lizensiert für Markus Mueller

admPanel { hide = 0 }

Die Einstellungsmöglichkeiten des Admin-Panels sind dann wiederum in einzelne Funktionsbereiche aufgeteilt. Nach folgendem Muster können Sie jeden dieser Bereiche aktivieren: admPanel { enable.bereich = 1 }

Sie können auch mehrere Bereiche gleichzeitig freischalten, indem Sie pro Zeile eine neue Einstellung vornehmen. Als Administrator haben Sie standardmäßig Zugriff auf alle Bereiche. Sie können jedoch auch einzelne Bereiche ausblenden, wenn Sie die entsprechenden Befehle in das Feld TSconfig eingeben: admPanel { enable.bereich = 0 }

Für jeden Bereich gibt es mehrere Optionen, die Sie nach folgendem Muster aktivieren können: override.bereich.funktion = 1

Max. Linie

Ersetzen Sie nun den Platzhalter mit einem der folgenden Werte. Die Überschriften stellen den jeweiligen Namen des Bereichs dar, den Sie in das zuvor genannte Beispiel einsetzen können. Die untergeordneten Funktionsaufrufe werden immer in eine eigene Zeile geschrieben. Manche Funktionen werden nicht aktiv, wenn der entsprechende Bereich im

132 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Admin-Panel geschlossen ist. Öffnen Sie dann mit dem Plussymbol den entsprechenden Bereich im Admin-Panel.

preview = 1 Schaltet den Bereich Vorschau ein. Damit können Sie versteckte Seiten und deren Inhalte sichtbar schalten und ein Datum oder eine bestimmte Benutzergruppe simulieren. Mit folgenden Optionen lässt sich das Vorschauverhalten weiter anpassen: override.preview.showHiddenPages = 1 Versteckte Seiten werden standardmäßig angezeigt. So ist es beispielsweise möglich, neue Seitenbäume zu erstellen oder Navigationsstrukturen intutiv über das Frontend zu testen. Sie erhalten dadurch einen direkten Eindruck davon, wie sich die neuen Seiten in die bisherige Seitenstruktur einfügen. Beispielsweise können Sie so auch Testbenutzern Zugang zu neuen Bereichen Ihrer Seite geben, die dann vor dem Launch auf Benutzbarkeit getestet werden können.

Lizensiert für Markus Mueller

override.preview.showHiddenRecords = 1 Versteckte Inhalte werden standardmäßig angezeigt und können wie reguläre Inhalte über das Frontend bearbeitet werden. Dies ist vor allem dann sehr nützlich, wenn Sie vor der Veröffentlichung die Formatierungen der Inhalte begutachten und eventuelle Anpassungen im Seitenkontext vornehmen möchten. Beide Funktionen ermöglichen Arbeiten an der Website, ohne dass reguläre Besucher davon Notiz nehmen. Sobald Sie die Datensätze sichtbar schalten, werden die Anpassungen auf der Website für alle Besucher sichtbar. Lesen Sie in Rezept 4.5, wie Sie Inhalte standardmäßig verstecken und so mit diesen Optionen optimal verknüpfen können. override.preview.simulateDate = (zeitstempel) Ein Veröffentlichungsdatum wird fest vorgegeben. Das Format entspricht dem UnixZeitstempel. Ein gültiger Wert wäre beispielsweise 1223676000. Dies würde das Erscheinungsdatum für den 11.10.2008 simulieren. override.preview.simulateUserGroup = 1 Mit dieser Einstellung können Sie eine Benutzergruppe fest vorgeben, indem Sie als Wert eine Benutzergruppen-ID angeben, die Sie eingerichtet haben.

cache = 1 Schaltet den Bereich Cache frei. Hiermit kann der Seitencache individuell für jede Seite gelöscht werden. override.cache.noCache = 1 Mit der Option Kein Caching deaktivieren Sie das Caching der Inhalte dauerhaft.

Max. Linie

override.cache.clearCacheLevels = 1 Über das Auswahlfeld Löschebenen können Sie festlegen, ob der Seitencache auch für die aktuellen Unterseiten gelöscht werden soll. Diese Cache-Optionen sollten nur Administratoren zugänglich sein.

4.7 Inhaltseingabe über das Frontend ermöglichen | 133 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

publish = 1

Links

Schaltet den Bereich Veröffentlichen frei. Hiermit können Sie Seiten als statische HTMLDatei rendern. Die Seiten werden dann in ihrem aktuellen Zustand als HTML-Seite im Dateisystem abgelegt. Dadurch können Sie die Systemperformance erheblich erhöhen, da die mitunter sehr aufwendigen Datenbankabfragen entfallen. Jedoch sind die Seiten dann nicht mehr direkt über TYPO3 editierbar. Ändern Sie beispielsweise einen Navigationspunkt, müssen Sie sämtliche Seiten neu publizieren, die den alten Navigationspunkt beinhalten. override.publish.publish_levels = 1 Um Ihnen diese Arbeit zu erleichtern, stellt Ihnen das Admin-Panel dafür die Option Veröffentlichungsebenen zur Verfügung, mit denen Sie mehrere Seiten gleichzeitig rendern oder aktualisieren können.

edit = 1 Schaltet den Bereich Eingabe frei. Dieser ermöglicht die Bearbeitung der Inhalte über das Frontend. Zusätzlich können Sie diesen Bereich noch mit folgenden Optionen anpassen:

Lizensiert für Markus Mueller

override.edit.displayFieldIcons = 1 Die Bearbeitungssymbole werden für jedes Feld des Datensatzes angezeigt. Beispielsweise erhalten bei einem Datensatz Text das Feld Überschrift und das Feld Fließtext jeweils ein Icon, mit dem das jeweilige Bearbeitungsfenster geöffnet werden kann. override.edit.displayIcons = 1 Eine umfangreiche Bearbeitungsleiste wird angezeigt. Damit stehen Ihnen vielfältige Bearbeitungsfunktionen zur Verfügung. Beispielsweise können Sie Datensätze über die Webseite bearbeiten, ausblenden oder innerhalb der aktuellen Seite bzw. im gesamten Seitenbaum verschieben. override.edit.editFormsOnPage = 1 Wenn Sie zusätzlich die Option Eingabeformular auf Webseite aktivieren, erscheint die Eingabemaske für den gesamten Datensatz direkt auf der Webseite, wenn Sie die Datensätze über die Bearbeitungsleiste öffnen. override.edit.editNoPopup = 1 Das Bearbeitungsformular für den gesamten Datensatz erscheint direkt in der Seite, wenn Sie die Felder über die Bearbeitungs-Icons öffnen. Zusätzlich enthält der Bereich Eingabe einen Link zum TYPO3-Backend. Wenn Sie auf den Link TYPO3 Backend öffnen klicken, öffnet sich ein neues Browserfenster, in dem das Backend geladen wird.

Max. Linie

Max. Linie 134 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Rechts Frontend-Editing vor TYPO3-Version 4.0 In TYPO3-Versionen vor 4.0 stehen Ihnen die zuvor gezeigten Optionen für den Bereich Eingabe noch nicht zur Verfügung. Verwenden Sie dann folgende Angaben, um das Frontend-Editing zu beeinflussen: module.edit.forceDisplayIcons = 1 Eine umfangreiche Bearbeitungsleiste wird angezeigt. Damit stehen Ihnen vielfältige Bearbeitungsfunktionen zur Verfügung. Beispielsweise können Sie Datensätze über die Webseite bearbeiten, ausblenden oder innerhalb der aktuellen Seite bzw. im gesamten Seitenbaum verschieben. module.edit.forceDisplayFieldIcons = 1 Die Bearbeitungssymbole werden für jedes Feld des Datensatzes angezeigt. Beispielsweise erhalten bei einem Datensatz Text das Feld Überschrift und das Feld Fließtext jeweils ein Icon, mit dem das jeweilige Bearbeitungsfenster geöffnet werden kann. module.edit.forceNoPopup = 1 Das Bearbeitungsformular für den gesamten Datensatz erscheint direkt in der Seite, wenn Sie die Felder über die Bearbeitungs-Icons öffnen. Das Beispiel aus der anfangs genannten Lösung würde mit diesen Befehlen folgendermaßen lauten: Lizensiert für Markus Mueller

admPanel { enable.edit = 1 module.edit.forceDisplayFieldIcons = 1 hide = 1 }

tsdebug = 1 Schaltet den Bereich TypoScript frei. Hier können Sie Werte in der TypoScript-Engine nachverfolgen und sehen, wie Ihre Seite von TYPO3 verarbeitet wird. Dieser Bereich dient ausschließlich zum Entwickeln und sollte nur Administratoren zugänglich sein. In Rezept 8.4 erfahren Sie mehr über die Debug-Funktionen von TYPO3 und wie diese Ihnen beim Entwickeln von TYPO3-Seiten helfen können. override.tsdebug.tsdebug_tree = 1 Aktiviert die Baumdarstellung der TypoScript-Parameter. override.tsdebug.displayTimes = 1 Die Rendering-Zeiten werden in weiteren Spalten angezeigt. override.tsdebug.displayMessages = 1 Zeigt Nachrichten vom TypoScript-Parser an.

Max. Linie

override.tsdebug.LR = 1 Verfolgt das Rendering der Inhalte.

4.7 Inhaltseingabe über das Frontend ermöglichen | 135 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

override.tsdebug.displayContent = 1 Zeigt die generierten Inhalte.

Links

override.tsdebug.displayQueries = 1 Erklärt die SELECT-Anweisung der Datenbankabfragen.

info = 1 Schaltet den Bereich Info frei. Dieser zeigt zahlreiche Parameter der aktuellen Seite, wie etwa die Seiten-ID, den Seitentyp und die IDs der Benutzergruppen, die Zugriff auf diese Seite haben. Außerdem wird sichtbar, ob der Seitencache aktiviert ist und welche ID der aktuelle Besucher der Seite hat. Wenn Sie im Bereich Cache die Option Kein Caching aktiviert haben, zeigt Ihnen TYPO3 auch eine Liste der verwendeten Grafiken inklusive Dateigröße sowie die Gesamtgröße der endgültigen Webseite an. Abschließend erfahren Sie über Total parsetime, wie lange TYPO3 für die Erstellung der Seite gebraucht hat. Der Bereich Info liefert Ihnen detaillierte Seiteninformationen und Hinweise zur Performance der Website, die vor allem für administrative Aufgaben äußerst nützlich sind.

Beispiel Lizensiert für Markus Mueller

Hier sehen Sie die vollständigen Einstellungsmöglichkeiten des Admin-Panels mit möglichen Beispielwerten: admPanel { hide = 0 enable.all = 0 enable.preview = 1 override.preview.showHiddenRecords = 0 override.preview.showHiddenPages = 0 override.preview.simulateDate = 0 override.preview.simulateUserGroup = 0 enable.cache = 0 override.cache.noCache = 0 override.cache.clearCacheLevels = 2 enable.publish = 0 override.publish.publish_levels = 0 enable.edit = 1 override.edit.displayFieldIcons = 0 override.edit.displayIcons = 0 override.edit.editNoPopup = 0 override.edit.editFormsOnPage = 0

Max. Linie

enable.tsdebug = 0 override.tsdebug.tsdebug_tree = 0 override.tsdebug.displayTimes = 0 override.tsdebug.displayMessages = 0

136 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

override.tsdebug.LR = 0 override.tsdebug.displayContent = 0 override.tsdebug.displayQueries = 0 override.tsdebug.forceTemplateParsing = 0 enable.info = 0 }

Die Bereiche Vorschau und Bearbeiten sind hierbei aktiviert. Versteckte Datensätze und Seiten werden angezeigt. Das Bearbeiten von Seiteninhalten ist dadurch über das Frontend möglich, das Admin-Panel wird jedoch auf der Webseite ausgeblendet, sodass nur die jeweiligen Bearbeitungssymbole sichtbar sind. Alle übrigen Bereiche sind ausgeblendet.

Siehe auch Das Rezept 9.5 beschäftigt sich damit, wie Sie die Frontend-Editing-Optionen weiter ausbauen und auf Ihre Bedürfnisse abstimmen können. In Rezept 4.2 erfahren Sie, wie Sie Inhalte über das Backend schnell eingeben.

4.8

Den interaktiven Texteditor RTE konfigurieren

Lizensiert für Markus Mueller

Problem Sie möchten die interaktive Texteingabemaske, den sogenannten Rich Text Editor (RTE), auf Ihre Bedürfnisse anpassen.

Lösung Zur Anpassung des Texteditors stehen Ihnen für die am häufigsten auftretenden Bedürfnisse bereits entsprechende Optionen bei der Installation der Extension zur Verfügung. Seit der TYPO3-Version 4.0 wird rtehtmlarea in TYPO3 als Standard-WYSIWYG-Editor verwendet. Die Integration dieses RTE ist sehr weit fortgeschritten, es gibt jedoch noch verschiedene andere RTEs zum Gebrauch mit TYPO3. Dieses Rezept ist auf die mit der TYPO3-Version 4.0 gelieferte System-Extension rtehtmlarea ausgerichtet. Die Diskussion liefert aber auch einige nützliche Hinweise, die in Verbindung mit anderen RTE-Extensions ebenfalls gültig sind.

Auswahloptionen in der Installationsmaske

Max. Linie

Die Konfigurationsmaske der Extension rtehtmlarea wird direkt bei der Installation aufgerufen. Sie können sie aber zu jedem späteren Zeitpunkt erneut verwenden, indem Sie im Erweiterungs-Manager die Funktion Loaded extensions aufrufen und auf den entsprechenden Extension-Titel klicken.

4.8 Den interaktiven Texteditor RTE konfigurieren | 137 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Die ersten Optionen in der Konfiguration sind nur für die optionale Rechtschreibprüfung relevant, darauf werden wir noch in der Diskussion eingehen. Dies sind die zunächst zentral wichtigsten Einstellungen bei der Installation:

Links

List of htmlArea RTE plugins Innerhalb von htmlArea gibt es mehrere optionale Features, die auch als plugins bezeichnet werden. In der Konfiguration legen Sie unter List of htmlArea RTE plugins zunächst fest, welche der Plugins generell aktiviert werden können. Eine Übersicht über die Plugins und ihre Bedeutung finden Sie in der Diskussion. Default configuration settings Da htmlArea eine Unzahl von Optionen und Konfigurationsmöglichkeiten bereitstellt, deren Beherrschung nicht ganz trivial ist, bietet die Extension drei verschiedene Grundkonfigurationen an. Dadurch ist eine sinnvolle Grundkonfiguration auch für unbedarfte Anwender leicht möglich. Für diese Grundkonfiguration stehen Ihnen die folgenden Auswahloptionen zur Verfügung. • Minimal

Lizensiert für Markus Mueller

Diese Option stellt im RTE nur sehr rudimentäre Möglichkeiten zur Verfügung. Der RTE stellt dann als einzige Formatierungsoptionen Buttons zur fetten und kursiven Auszeichnung zur Verfügung. Weitere Optionen müssen entsprechend manuell hinzugefügt werden. • Typical Durch die Auswahl dieser Option werden im RTE die wichtigsten und am häufigsten verwendeten Optionen und Features zur Verfügung gestellt. Diese Einstellung wird insbesondere für unerfahrene Administratoren unbedingt empfohlen, da sie gleichzeitig noch versucht zu verhindern, dass die Datenbank unnötig mit einem unübersichtlichen Ballast von HTML-Auszeichnungen überschwemmt wird. Doch dazu später mehr. • Demo Mit der Einstellung Demo werden alle verfügbaren Optionen und Features freigeschaltet. Dabei wird das erzeugte (oder per Copy-and-Paste übernommene) HTML auch beim Speichern nur in sehr geringem Umfang geprüft. Diese Option sollte nur gewählt werden, um den Funktionsumfang des RTE zu testen. Enable images in the RTE Eine heiß diskutierte Frage ist, ob es über den RTE möglich sein soll, Bilder innerhalb des Textfelds zu verwenden. Eigentlich sieht TYPO3 für die Verwendung von Bildern die beiden Inhaltselemente Bild und Text m/Bild vor. Da deren Layoutoptionen für manche Anwendungsfälle nicht ausreichend sind, ist es möglich, auch in einem Textfeld Bilder einzubinden. Durch Aktivierung dieser Option können Sie die Standardkonfiguration Typical so gegebenenfalls einfach erweitern, um den Redakteuren

Max. Linie

Max. Linie 138 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Rechts

entsprechende Buttons zur Verwendung von Bildern im Fließtext zur Verfügung zu stellen. Enable Mozilla/Firefox extension Eine häufige Nutzung im RTE ist auch das berühmte Copy-and-Paste aus Office-Programmen oder anderen Webseiten. Standardmäßig verhindert das Sicherheitskonzept der Mozilla- bzw.- Firefox-Browser teilweise die Benutzung von Copy-and-Paste. Statt umständlich in den Konfigurationsprofilen von Mozilla/Firefox manuell Änderungen vornehmen zu müssen, kann htmlArea in einem solchen Fall anbieten, eine entsprechende Erweiterung für den Browser zu installieren. Wenn Sie sich das Anpassen der Profildateien von Mozilla/Firefox ersparen wollen, sollten Sie die Option aktivieren. Die Installation der Extension muss allerdings auch dann im Bedarfsfall noch explizit vom Anwender erlaubt werden. Durch einen Klick auf den Button Update speichern Sie diese Extension-Konfiguration ab. Wenn Sie bei Default Configuration settings den Eintrag Typical gewählt haben, verfügen Sie damit bereits über eine sehr sinnvolle und in sich stimmige Grundkonfiguration, die sich an den häufigsten Anforderungen und etablierten TYPO3-Standards orientiert. Wenn Sie den RTE detailliert an Ihre Bedürfnisse anpassen wollen, helfen Ihnen die Ausführungen in der Diskussion.

Lizensiert für Markus Mueller

Diskussion Die Konfiguration des RTE erfolgt grundsätzlich über Page- und/oder User-TSconfig. Abhängig von den im Erweiterungs-Manager gewählten Einstellungen, werden dazu entsprechende unterschiedliche Standardwerte für Page- bzw. User-TSconfig eingebunden. Eine individuelle Detailanpassung ist darauf aufbauend durch zusätzliche Einträge in die Felder für Page- bzw. User-TSconfig möglich. Das eingebundene Page-TSconfig können Sie über die Funktion Seiten TSconfig im Modul Web/Info komfortabel einsehen oder bearbeiten. Die Unterfunktion Inhalt des TSconfig-Felds anzeigen zeigt Ihnen dabei unter der Überschrift Standard-Konfiguration aus TYPO3_CONF_VARS das eingebunden Page-TSconfig mit zusätzlichen Kommentaren versehen an, über die Bleistifte am unteren Ende der Ausgabe können Sie bequem eigene Page-TSconfig-Einträge bearbeiten. Über die Unterfunktion RTE. erhalten Sie eine Baumansicht der entsprechenden RTE-Einstellungen. Das User-TSconfig lässt sich am komfortabelsten im Modul Admin-Werkzeuge/ Verwaltung bei aktivierten Kontrollkästchen TSconfig bzw. TSconfig HL einsehen und bearbeiten.

Die RTE-Konfiguration mit Page-TSconfig TYPO3 bietet im Kern eine API, um die Einbindung verschiedener RTEs zu unterstützen.

Max. Linie

Max. Linie 4.8 Den interaktiven Texteditor RTE konfigurieren | 139 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Links Zur Konfiguration des Rich Text Editors reserviert TYPO3 im Kern den PageTSconfig-Schlüssel RTE. Unterhalb des Schlüssels RTE. legt die Eigenschaft RTE.default das Standardverhalten des RTE fest. Allerdings kann diese Konfiguration über RTE.config.[tabelle].[feld] für einzelne Felder überschrieben werden. Beachten Sie, dass Letzteres insbesondere im Zusammenspiel mit der Nutzung des RTE für Felder aus Extensions teilweise notwendig ist. Zur Prüfung des Page-TSconfig sollten Sie, wie bereits weiter oben angesprochen, die Funktion Seiten TSconfig im Modul Web/Info verwenden.

Das folgende Codebeispiel zeigt das Prinzip der Page-TSconfig-Hierarchie für die RTEKonfiguration, [tabelle] und [feld] sind dabei jeweils Platzhalter für konkrete Tabellenund Feldbezeichnungen:

Lizensiert für Markus Mueller

RTE { default { # RTE-spezifische Config # ... proc { # individuelle Transformationskonfiguration # RTE-unabhängiges TYPO3-Kernfeature } } config { [tabelle] { [feld] { # RTE-spezifische Config # ... proc { # individuelle Transformationskonfiguration # RTE-unabhängiges TYPO3-Kernfeature } } } } # RTE-spezifische Optionen # ... }

Der Schlüssel proc hat eine Sonderstellung, da der TYPO3-Kern hier die Optionen für die Konvertierung (die sogenannte Transformation) des Inhalts zwischen Datenbank und RTE ausliest. Darauf wird detailliert im Abschnitt »Das Parsen des vom Rich Text Editor erzeugten Inhalts beeinflussen« weiter unten eingegangen.

Max. Linie

Individualisierung der Symbolleiste und Auswahloptionen des Rich Text Editors htmlArea Mit dem folgenden Codebeispiel für Page-TSconfig entfernen Sie die beiden Symbole zur Auszeichnung als hoch- bzw. tiefgestellter Text. Dabei nutzen wir ein neues Feature der Version 4.0 von TYPO3, um Werte aus einer Liste zu entfernen, statt den modifizierten

140 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Wert zuzuweisen. Bitte lesen Sie dazu auch das Rezept 8.11, in dem dieses Prinzip detailliert erläutert wird. Die Eigenschaft showButtons legt allgemein die zur Verfügung stehenden Buttons fest. RTE { default { showButtons:=removeFromList(subscript,superscript) # Alternativ, falls Sie mit der als advanced bezeichneten # eingeschränkten Grundkonfiguration arbeiten # Achtung: eine lange Zeile # # # #

showButtons:=addToList(blockstylelabel, blockstyle, textstylelabel, textstyle, bold, italic, underline, formatblock, orderedlist, unorderedlist, copy, cut, paste, undo, redo )

} }

Sie können auch die Eigenschaft hideButtons verwenden, um bestimmte Symbole aus der Anzeige zu entfernen. Beachten Sie, dass bei Konflikten die Einstellungen in hideButtons Vorrang vor denen in showButtons haben.

Lizensiert für Markus Mueller

Wenn Sie die angezeigten Buttons für bestimmte Benutzer abweichend festlegen möchten, können Sie die Eigenschaft options.RTEkeyList im User-TSconfig nutzen. options { RTEkeyList ( bold, italic, underline, formatblock, orderedlist, unorderedlist, copy, cut, paste, undo, redo ) }

Beachten Sie, dass diese Eigenschaft per Default mit dem Wert »*« festgelegt wird. Es werden für die einzelnen Redakteure also alle mit showButtons festgelegten Buttons angezeigt. Sie müssen in options.RTEkeyList gegebenenfalls explizit eine entsprechende Liste der anzuzeigenden Buttons zuweisen.

htmlArea stellt Ihnen über die mit formatblock bezeichnete Option ein Auswahlfeld zur HTML-Auszeichnung eines Absatzes zur Verfügung. Standardmäßig können Sie über das Auswahlfeld die Blockauszeichnungen Normal (Absatz), Überschrift x, Vorformatiert und Adresse zuweisen. Über die Eigenschaft hidePStyleItems können Sie diese Liste reduzieren. Das folgende Beispiel für Page-TSconfig verdeutlicht dies:

Max. Linie

RTE { default { hidePStyleItems = h1,h2,h4,h5,h6 } }

4.8 Den interaktiven Texteditor RTE konfigurieren | 141 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Sie können in dem Auswahlfeld nun zwischen Normal (Absatz), Überschrift 3, Vorformatiert und Adresse wählen. Diese Einstellung ist nur wirksam, wenn der Button formatblock in showButtons respektive RTEkeyList freigeschaltet ist.

Links

Beachten Sie, dass die Auszeichnung

im Standard-Template css_ styled_content bei der Ausgabe mit dem TypoScript-Setup nicht zu den erlaubten Tags gehört. Mit folgendem TypoScript-Setup können Sie dies ändern, in Rezept 10.5 finden Sie eine Beschreibung zu diesen beiden TypoScript-Objektpfaden: lib.parseFunc.allowTags:=addToList(address) lib.parseFunc_RTE.allowTags:=addToList(address)

Die beiden Plugins DynamicCSS und InlineCSS in htmlArea stellen Ihnen über die Optionen blockstyle und textstyle darüber hinaus in einem Auswahlfeld Möglichkeiten zur Verfügung, einem Absatz oder Textbereich CSS-Klassen zuzuweisen. Die einfachste Möglichkeit, um die Optionen in diesen Auswahlfeldern anzupassen, ist, über contentCSS ein eigenes Stylesheet zuzuweisen. Standardmäßig wird die Datei EXT:rtehtmlarea/htmlarea/ plugins/DynamicCSS/dynamiccss.css verwendet, mit folgendem Page-TSconfig können Sie eine alternative, selbst erstellte Datei verwenden: Lizensiert für Markus Mueller

Max. Linie

RTE { default { contentCSS = fileadmin/styles/rte.css # showTagFreeClasses = 1 } }

Hier ein Beispiel für eine solche via contentCSS in htmlArea eingebundene Stylesheet-Datei: p.layout-1 { border: 1px solid red; } h3.layout-3 { margin: 20px; } span.important { font-weight: bold; }

Die CSS-Selektoren in einem solchen Stylesheet werden dynamisch ausgewertet und in htmlArea kontextabhängig in den beiden Auswahlfeldern Absatz: und Text: zur Verfügung gestellt. Es werden nur jeweils die CSS-Klassen zur Auswahl angeboten, die im Stylesheet für den Kontext definiert sind, in dem sich der Mauszeiger gerade befindet. Die CSS-Klasse layout-1 steht somit über den CSS-Selektor p.layout-1 {} nur innerhalb eines regulären Absatzes

zur Verfügung und eine CSS-Klasse layout-3 über den CSS-Selektor h3.layout-3 {} nur innerhalb einer Überschrift

. Um einen Textbereich mit einer CSS-Klasse auszeichnen zu können, muss zunächst ein Textbereich markiert werden, anschließend stehen alle CSS-Klassen zur Auswahl, die im eingebundenen Stylesheet mit

142 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

dem -Tag verbunden sind, z.B. span.important {}. Sie können diese CSS-Datei ganz nach eigenen Bedürfnissen gestalten, die entsprechenden Styles werden bei Auswahl eines Eintrags auch automatisch innerhalb des htmlArea-Bearbeitungsfelds angewendet. Wenn Sie auch reine, klassenbasierte CSS-Selektoren ohne Tags wie beispielsweise .layout-1 {} verwenden wollen, können Sie die Eigenschaft showTagFreeClasses = 1 aktivieren. Eine mögliche Stolperfalle ist dabei, dass es zusätzlich Page-TSconfig-Optionen (default. classes) gibt, mit denen bestimmte CSS-Klassen an bestimmte Tags gebunden werden können und diese in der Typical und Demo-Konfiguration auch verwendet werden. Im Folgenden sehen Sie ein Beispiel für ein modifiziertes Setup für dynamische CSS-Auszeichnungen. Das Page-TSconfig ist dabei zur Benutzung mit dem Typical-Setup optimiert:

Lizensiert für Markus Mueller

Max. Linie

# Optionales Anlegen von Klassen # zur Bezeichnung und Auszeichnung in den # Dynamic- und Inline-CSS-Selekt-Feldern RTE { classes { layout-1 { name = rechtsbündig/Rahmen value = text-align: right; border: 1px solid red; } layout-2 { name = Aussenabstand value = margin: 3px; } important { name = wichtig value = font-weight: bold; } } # Optionales Anlegen von Klassen # zur Benutzung im Link-Dialog classesAnchor { externalLink { class = external-link type = url titleText = externer Link altText = Link öffnen image > # image = fileadmin/images/external_link.png } internalLink { class = internal-link type = page titleText = interner Link altText = Link öffnen image > # image = fileadmin/images/external_link.png } }

4.8 Den interaktiven Texteditor RTE konfigurieren | 143 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

default { #Einbinden der CSS-Datei contentCSS = fileadmin/styles/rte.css

Links

Lizensiert für Markus Mueller

# Zuweisen von bestimmten CSS-Klassen an bestimmte Tags. # Wenn hier Werte vorhanden sind, werden nicht automatisch # alle kontextabhängigen Selektoren aus der CSS-Datei verwendet, # sondern nur die jeweils hier angegebenen. classesParagraph > classesCharacter > classesImage > classesTable > classesTD > classesTD > classesAnchor = external-link, internal-link classesAnchor { default { page = internal-link url = external-link #file = class #mail = class } } # für Erklärung zu .proc, siehe Abschnitt: # 'Das Parsen des vom Rich Text Editor erzeugten Inhalts beeinflussen' proc { # Liste von erlaubten CSS-Klassen allowedClasses = layout-1, layout-2, important } } }

Über die Hauptschlüssel classes und classesAnchor werden Klassen zur Benutzung angelegt. Der Vorteil ist dabei, dass dadurch im Auswahlfeld über die Eigenschaft name ein vom CSS-Klassennamen abweichendes Label verwendet werden kann, das auch sprachabhängig sein kann. Im Fall von classesAnchor können außerdem einige besondere Möglichkeiten im Link-Dialog genutzt werden wie das zusätzliche Einfügen eines und Klassen abhängig von der Art des Links. Der Nachteil ist, dass man die Config wieder an zwei Stellen (in der eingebundenden CSS-Datei und im Page-TSconfig) pflegen muss. Die angelegten CSS-Klassen können über die default.classes-Optionen an bestimmte Tags gebunden werden. Sollte eine solche Bindung vorhanden sein, werden nur diese Klassen angezeigt. Daher ist es einfacher, die entsprechenden default.classes-Config gegebenenfalls zu löschen, dann werden nämlich automatisch alle passenden Selektoren aus der CSS-Datei verwendet.

Max. Linie

Max. Linie 144 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Rechts Beachten Sie, dass es einige weitere Optionen und Möglichkeiten zur Konfiguration bzw. Einbindung von CSS-Auszeichnungen gibt, die teilweise nur aus historischen Gründen bzw. zur Kompatibilität mit dem in früheren Versionen verwendeten RTE vorhanden sind. Außerdem müssen Sie beachten, dass die Inhalte beim Speichern noch mal geparst werden, dabei werden möglicherweise bestimmte Tags oder CSS-Klassen ausgefiltert, die nicht in der Konfiguration erlaubt sind. Vgl. dazu die Ausführungen im folgenden Abschnitt. Außerdem müssen Sie beachten, dass diese CSS-Datei nicht automatisch im Frontend eingebunden wird. Bei Änderungen an der Datei müssen Sie gegebenenfalls Ihren Browser-Cache (!) leeren, um die Änderungen wirksam werden zu lassen.

Lizensiert für Markus Mueller

Das Parsen des vom Rich Text Editor erzeugten Inhalts beeinflussen Von sehr zentraler Bedeutung ist ein Verständnis für die Handhabung der Inhalte durch TYPO3, wenn diese mit einem RTE bearbeitet werden. Der Rich Text Editor ist prinzipiell ein vollwertiger HTML-Editor, mit dem der gesamte Umfang an HTML-Auszeichnungen genutzt werden kann. Insbesondere im Zusammenhang mit Copy-and-Paste aus anderen Anwendungen entsteht dabei sehr oft ein qualitativ minderwertiges (verschmutztes) HTML. Eine Kernaufgabe eines CMS wie TYPO3 ist es, dafür Sorge zu tragen, dass die Inhalte in einem sauberen und konsistenten Format gespeichert werden, damit diese langfristig nutzbar bleiben. Hierbei spielen auch weitere Tatsachen, wie beispielsweise die korrekte Verlinkung der einzelnen Inhalte miteinander und der historische Hintergrund, dass die gespeicherten Inhalte möglichst einfach von Menschen lesbar sein sollten, eine Rolle. Aus diesem Grund werden die Inhalte bei der Bearbeitung mit dem RTE sowohl vor der Bearbeitung mit dem RTE als auch vor der Speicherung in der Datenbank in jeweils optimierte Formate konvertiert (geparst). Bei Bedarf können Sie auf diesen Prozess Einfluss nehmen, um beispielsweise zu vermeiden, dass bestimmte Auszeichnungen oder Attribute ausgefiltert werden, oder aber um die bereits erlaubten weiter einzuschränken. Für all diese Optionen stehen Ihnen im Page-TSconfig mehrere verschiedene Optionen im Schlüssel proc zur Verfügung. Dabei müssen Sie auch darauf achten, dass die dem Redakteur zur Verfügung gestellten Optionen sinnvoll dazu passen. Es macht beispielsweise wenig Sinn, das -Tag innerhalb des Textfelds nicht zur Speicherung zuzulassen, aber dem Redakteur das Bildauswahlsymbol anzubieten. Die Optionen zum Parsen, die unterhalb des Schlüssels proc festgelegt werden, sind ein Kern-Feature und prinzipiell unabhängig vom jeweils genutzten RTE.

Max. Linie

RTE { default { proc { # den Transformationsmodus überschreiben overruleMode = ts_css # Liste von erlaubten HTML-Tags # eingeschränktes Beispiel!

4.8 Den interaktiven Texteditor RTE konfigurieren | 145 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Lizensiert für Markus Mueller

allowTags = p, h3, adress, blockquote, ul, ol, li # Liste von erlaubten CSS-Klassen # eingeschränktes Beispiel! allowedClasses = layout-1, layout-2, layout-3, important # weitere Optionen ... # insbesondere mehrere zusätzliche HTMLparser exitHTMLparser_rte = 1 exitHTMLparser_rte { # ... } exitHTMLparser_db = 1 exitHTMLparser_db { # ... } entryHTMLparser_rte = 1 entryHTMLparser_rte { # ... } entryHTMLparser_db = 1 entryHTMLparser_db { # ... } } } }

Links

Wenn Inhalte mit einem RTE bearbeitet werden, werden diese jeweils beim Bearbeiten und Speichern durch eine sogenannte Transformation verarbeitet. Dabei wird beispielsweise aus einem ein , aus einem
ein Zeilenumbruch usw. Diese Transformation wird zunächst über den Hauptschlüssel proc gesteuert. Über einen sogenannten Modus werden dabei gleich eine ganze Reihe von Optionen gesteuert. Dieser Modus wird bereits im $TCA vorgegeben und lässt sich über die Eigenschaft overruleMode übersteuern. Wenn Sie nicht genau wissen, was diese Einstellung bewirkt, sollten Sie sicherstellen, dass der Transformationsmodus css_transform in $TCA bzw. overruleMode verwendet wird.

Über proc.allowedTags legen Sie eine Liste von HTML-Tags fest, die in einem Feld zur Verwendung zugelassen sind. Über proc.allowedClasses legen Sie eine Liste von CSSKlassen fest, die in einem Feld zur Verwendung zugelassen sind. Neben einigen weiteren Optionen zum Feintuning dieser Transformation können Sie den Inhalt jeweils noch mal durch eine von vier verschiedenen, individuell konfigurierten HTMLparser-Konfigurationen verarbeiten lassen. Abbildung 4-5 veranschaulicht diese Abläufe noch einmal.

Max. Linie

entryHTMLparser_db Dieser HTMLparser wird optional zusätzlich auf dem Weg vom RTE in die Datenbank (Speichern) vor der Standardtransformation aufgerufen.

146 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Abbildung 4-5: Die vier optionalen, RTE-unabhängigen HTMLparser-Konfigurationen Lizensiert für Markus Mueller

exitHTMLparser_db Dieser HTMLparser wird optional zusätzlich auf dem Weg vom RTE in die Datenbank (Speichern) nach der Standardtransformation aufgerufen. entryHTMLparser_rte Dieser HTMLparser wird optional zusätzlich auf dem Weg von der Datenbank zum RTE (Bearbeiten) vor der Standardtransformation aufgerufen. exitHTMLparser_rte Dieser HTMLparser wird optional zusätzlich auf dem Weg von der Datenbank zum RTE (Bearbeiten) nach der Standardtransformation aufgerufen. Ein sehr nützliches zusätzliches Feature von htmlArea ist die Option RTE. default.enableWordClean = 1. Mit dieser Einstellung wird Inhalt beim Copyand-Paste direkt von unnötigem Ballast aus Fremdanwendungen befreit. Auch hierbei handelt es sich um ein HTMLparser-Objekt, das auf Wunsch entsprechend detailliert konfiguriert werden kann.

Max. Linie

Das Frontend-Rendering Sie dürfen nicht vergessen, dass die Ausgabe der Inhalte im Frontend durch Ihr TypoScript-Setup gesteuert wird. Auch hierbei werden die Daten aus der Datenbank zum Teil nochmals aufbereitet. So verwendet TYPO3 typischerweise datenbankseitig die Auszeichnung zur Auszeichnung von Links, die im Frontend (der Website) in ein entsprechendes HTML-konformes -Tag umgewandelt wird (siehe dazu auch die Rezepte 9.6, 9.7, 10.5 und 10.7). Teilweise liegt die Lösung eines vermeintlichen RTE-Problems auch in der Anpassung des TypoScript-Setups.

4.8 Den interaktiven Texteditor RTE konfigurieren | 147 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Liste der htmlArea-RTE-Plugins

Links

Zur Übersicht hier noch mal eine Liste der in htmlArea zur Verfügung stehenden Plugins und deren Einsatzgebiet. TableOperations Über das TableOperations-Plugin erhalten Sie eine Symbolleiste bzw. ein Kontextmenü innerhalb von Tabellen, mit denen das Bearbeiten von Tabellen innerhalb eines Fließtextfelds sehr komfortabel möglich ist. Hier die Liste der damit in Zusammenhang stehenden Optionen für showButtons: table, toggleborders, tableproperties, rowproperties, rowinsertabove, rowinsertunder, rowdelete, rowsplit, columninsertbefore, columninsertafter, columndelete, columnsplit, cellproperties, cellinsertbefore, cellinsertafter, celldelete, cellsplit, cellmerge. Achtung, einige zusätzliche Optionen in den jeweiligen Dialogen werden möglicherweise über eine der folgenden Eigenschaften deaktiviert: disableAlignmentFieldsetInTableOperations, disableSpacingFieldsetInTableOperations, disableColorFieldsetInTableOperations, disableLayoutFieldsetInTableOperations, disableBordersFieldsetInTableOperations.

Lizensiert für Markus Mueller

SpellChecker Hiermit können Sie eine Rechtschreibprüfung für die Inhalte durchführen. Hier die damit in Zusammenhang stehende Option für showButtons: spellcheck. ContextMenu Stellt bei einem rechten Mausklick innerhalb des Texts ein Kontextmenü zur Verfügung. SelectColor Stellt ein Pop-up zur Auswahl einer Farbe aus einer Farbpalette in den entsprechenden Dialogen bereit. Hier die Liste der damit in Zusammenhang stehenden Optionen für showButtons: textcolor, bgcolor. TYPO3Browsers Dieses Plugin bindet im Dateiauswahl- und im Link-Dialogfeld die TYPO3-spezifischen Elementbrowser ein. Hier die Liste der damit in Zusammenhang stehenden Optionen für showButtons: link, image. InsertSmiley Stellt ein Symbol zum Einfügen eines Smileys bereit. Hier die damit in Zusammenhang stehende Option für showButtons: emoticon. FindReplace Ein einfaches Suchen/Ersetzen-Werkzeug für den RTE. Hier die damit in Zusammenhang stehende Option für showButtons: findreplace.

Max. Linie

RemoveFormat Über dieses Plugin können die Formatierungen im Text manuell gesäubert werden. Hier die damit in Zusammenhang stehende Option für showButtons: removeformat.

148 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

CharacterMap Von diesem Plugin wird ein Symbol zum Einfügen von Sonderzeichen zur Verfügung gestellt. Hier die damit in Zusammenhang stehende Option für showButtons: insertcharacter. QuickTag Mit dem QuickTag-Plugin ist es möglich einen Text zu markieren und anschließend eine HTML-Auszeichnung auf diese Markierung aus einer Auswahlliste anzuwenden. Hier die damit in Zusammenhang stehende Option für showButtons: inserttag. DynamicCSS Das DynamicCSS-Plugin stellt die in der Lösung detailliert beschriebene Möglichkeit zur Auszeichnung mit CSS-Klassen für Absatz-(Block-)Auszeichnungen zur Verfügung. Hier die Liste der damit in Zusammenhang stehenden Optionen für showButtons: blockstylelabel, blockstyle. InlineCSS Das InlineCSS-Plugin stellt die in der Lösung detailliert beschriebene Möglichkeit zur Auszeichnung mit CSS-Klassen für Textbereiche zur Verfügung. Hier die Liste der damit in Zusammenhang stehenden Optionen für showButtons: textstylelabel, textstyle.

Lizensiert für Markus Mueller

UserElements Dieses Plugin ermöglicht es, über das entsprechende Symbol einen Dialog zum Einfügen von benutzerdefinierten Elementen aufzurufen. Nützlich für häufig verwendete Textbausteine oder individuelle Tags. Hier die damit in Zusammenhang stehende Option für showButtons: user. Acronym Dieses Plugin hilft Ihnen bei der Auszeichnung von Akronymen. Hier die damit in Zusammenhang stehende Option für showButtons: acronym.

Rechtschreibprüfung Ab Version 0.7.6 unterstützt der Editor auch eine integrierte Rechtschreibprüfung. Wenn Sie diese nutzen möchten, benötigen Sie die sogenannten Aspell-Bibliotheken auf dem Server. Außerdem muss die Extension sr_static_info installiert sein, und PHP darf nicht im sogenannten safe_mode laufen. Wenn diese Voraussetzungen erfüllt sind, das Plugin aktiviert und spellcheck in showButtons bzw. RTEkeyList gesetzt ist, können Sie die Texte einer Rechtschreibprüfung unterziehen. Dabei ist es zunächst nicht möglich, unbekannte Wörter in den Wortschatz aufzunehmen. Mit den zwei folgenden TSconfig-Angaben aktivieren Sie Wörterbücher, in die Sie dann auch eigene Einträge aufnehmen können. Schalten Sie dazu zuerst diese Funktion per Seiten-TSconfig frei: RTE.default.enablePersonalDicts = 1

Max. Linie

Max. Linie 4.8 Den interaktiven Texteditor RTE konfigurieren | 149 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Dann können Sie per Benutzer-TSconfig den Zugriff auf die Wörterbücher pro Benutzer oder Benutzergruppe freischalten:

Links

options.enablePersonalDicts = 1

Siehe auch Der Editor wird ständig weiterentwickelt und verfügt noch über einige weitere Optionen. Sie sollten daher auch die vollständige Dokumentation von htmlArea zu Rate ziehen, die Sie unter http://typo3.org/documentation/document-library/extension-manuals/rtehtmlarea/ current/ finden. Für alle Belange rund um die verschiedenen RTEs steht eine eigene Mailingliste/Newsgroup typo3.projects.rte zur Verfügung. Wie Sie darauf zugreifen können, wird in Rezept 20.6 beschrieben. Schauen Sie auch in den Abschnitt »RTE API« des Dokuments TYPO3 Core APIs unter http://typo3.org/documentation/document-library/core-documentation/doc_core_api/current/. Informationen rund um das GNU-Projekt Aspell, eine Open Source-Rechtschreibprüfung, finden Sie unter http://aspell.sourceforge.net/. In Rezept 15.2 erfahren Sie, wie Sie die Grundeigenschaften der Extension über den Erweiterungs-Manager anpassen. Rezept 17.14 zeigt Ihnen, wie Sie Ihre eigenen Extensions mit solchen Optionen ausrüsten. Lizensiert für Markus Mueller

4.9

Mehrsprachige Inhalte mit TYPO3 einpflegen

Problem Sie möchten mehrsprachige Inhalte auf Ihrer Website ausgeben und entsprechend im Backend einpflegen und bearbeiten oder den bestehenden Inhalt nach und nach übersetzen.

Lösung Aktivieren Sie die gewünschten Sprachen, in denen Sie Ihre Inhalte verwalten möchten, im TYPO3-Backend und legen Sie anschließend mit dem Datensatz Alternative Seiten Sprache Übersetzungen Ihrer vorhandenen Seiten an. Danach können Sie den Inhalt dieser Seiten in die jeweilige Sprache übersetzen.

Max. Linie

Um zusätzliche Sprachen zu aktivieren, wechseln Sie in das Modul Liste und wählen die Wurzelseite mit der ID 0 (dazu benötigen Sie administrative Rechte). Legen Sie dort einen neuen Datensatz vom Typ Website Sprache an. Diesen Datensatz füllen Sie mit den entsprechenden Sprachinformationen. Geben Sie unter Sprache die Bezeichnung der Sprache ein (etwa Englisch, wenn Sie Ihre Inhalte ins Englische übersetzen möchten). Dieser Wert erscheint dann später im Backend in den Auswahlfeldern, mit denen Sie die Sprache für die Übersetzung festlegen. Die beiden anderen Felder dienen dazu, den

150 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Sprachwert mit technischen Hintergrundinformationen zu verknüpfen, auf die Sie später bei Bedarf zurückgreifen können. Für den eigentlichen Übersetzungsablauf spielen diese Angaben jedoch keine Rolle. Um die Backend-Oberfläche mehrsprachig anzuzeigen, müssen Sie das entsprechende Sprachpaket installieren und die jeweilige Sprache im Benutzerprofil aktivieren. Die dazu nötigen Schritte werden ausführlich in Rezept 15.10 behandelt.

Lizensiert für Markus Mueller

Nachdem Sie den Datensatz für die Sprache gespeichert haben, legen Sie im ersten Schritt für jede Seite, deren Inhalt Sie übersetzen möchten, eine Übersetzung an. Erst danach können Sie auch den Seiteninhalt übersetzen. Aktivieren Sie dazu das Modul Seite und wechseln Sie auf eine Seite, deren Inhalt Sie übersetzen möchten. Wählen Sie dann über die Auswahlliste in der rechten oberen Ecke den Eintrag Sprachen. Daraufhin wird der aktuelle Seiteninhalt in einer angepassten Spaltenansicht dargestellt. Außerdem erscheint ein weiteres Auswahlmenü Neue Übersetzung dieser Seite anlegen, in dem Sie die Sprache auswählen können. Danach initiiert TYPO3 den Übersetzungsprozess, in dem automatisch die entsprechende Eingabemaske geöffnet wird, mit der Sie eine Übersetzung der aktuellen Seite anlegen können. Geben Sie in diese Eingabemaske die Seiteneigenschaften für die jeweilige Sprache ein. Sämtliche Felder, die Sie in dieser Eingabemaske nicht sehen, werden von der ursprünglichen Seite automatisch übernommen. TYPO3 überlagert dann später beim Auslesen der Seiteninformation je nach Sprache die Angaben der ursprünglichen Seite mit den übersetzten Inhalten. Um Ihnen die Übersetzung der Seiteninformationen zu erleichtern, zeigt Ihnen TYPO3 unterhalb der Eingabefelder standardmäßig die Werte der ursprünglichen Seiteneigenschaften an. Nachdem Sie Ihre Änderungen kontrolliert und gespeichert haben, können Sie den Datensatz schließen. Danach leitet TYPO3 Sie automatisch zurück zur Spaltenansicht, die sich durch den Übersetzungsprozess wie folgt geändert hat: Zum einen werden die Inhalte nun in zwei Spalten dargestellt. Dabei enthält jede Spalte den Inhalt der jeweiligen Sprache. In der Spalte Standard sehen Sie den ursprünglichen Seiteninhalt. In der rechten Spalte erscheint der übersetzte Inhalt. Unter dem Spaltentitel finden Sie den Seitentitel der übersetzten Seite. Zum anderen sehen Sie in der rechten oberen Ecke ein neues Auswahlmenü, mit dem Sie zwischen den einzelnen Sprachen hinund herschalten können. Damit wechseln Sie in die Ansicht, die Sie vom regulären Seitenmodul her kennen – nur dass der Inhalt dann ausschließlich in der gewählten Sprache erscheint. Liegen in der gewählten Sprache noch keine übersetzten Inhalte vor, hat die Auswahl auch noch keine Auswirkung.

Max. Linie

Um den Übersetzungsprozess weiter zu erleichtern, können Sie über den Button StandardInhalte kopieren sämtliche Inhalte aus der Originalsprache übernehmen und für die Übersetzung markieren. In Klammern steht die Anzahl der Datensätze, die davon betroffen sein werden. So können Sie Inhalte sehr schnell von einer Sprache zur anderen übernehmen

4.9 Mehrsprachige Inhalte mit TYPO3 einpflegen | 151 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

und mit dem Übersetzen beginnen. Ähnlich wie bei den Seiteneigenschaften werden Ihnen auch hier die Inhalte des ursprünglichen Datensatzes angezeigt. Diese Übersetzungshilfe wird nur angezeigt, wenn Sie in der Auswahlliste Originalübersetzung den Originaldatensatz gewählt haben. Dieses Feld wird automatisch mit dem entsprechenden Wert vorbelegt, wenn Sie Inhalte von einer anderen Sprache übernehmen. Lassen Sie diese Angabe leer, werden die Übersetzungsinformationen ausgeblendet.

Links

Um diese übersetzten Inhalte nun auf der Website anzuzeigen, müssen Sie noch weitere Schritte unternehmen: Zum einen müssen Sie Ihr TypoScript-Template so einstellen, dass die Sprache von TYPO3 bei der Inhaltsausgabe überhaupt berücksichtigt wird. Das Rezept 9.4 beschäftigt sich ausführlich mit diesen Einstellungen. Außerdem sollten Sie auf Ihrer Website eine Funktion bereitstellen, mit der Ihre Website-Besucher in die gewünschte Sprache wechseln können. Dazu erhalten Sie in Rezept 12.8 Beispiele und nützliche Anregungen.

Diskussion

Lizensiert für Markus Mueller

Alternativ zu dem Modul Seite können Sie die Inhalte auch über das Modul Liste verwalten. Das ist vor allem dann sehr hilfreich, wenn Sie zahlreiche Inhalte bearbeiten oder sich schnell einen Überblick über die vorhandenen Übersetzungen verschaffen möchten. Aber auch zum Anlegen von neuen Übersetzungen bietet dieses Modul sehr effektive Bearbeitungsmöglichkeiten. Wenn Sie im Listenmodul mit Übersetzungen arbeiten möchten, müssen Sie die Option Lokalisierungsansicht aktivieren. Diese finden Sie am Ende der Liste. Nachdem TYPO3 die Listenansicht aktualisiert hat, stehen Ihnen über die zwei zusätzlichen Spalten Lokalisierung und Lokalisieren weitere Bearbeitungsmöglichkeiten zur Verfügung. Die Spalte Lokalisierung zeigt die Sprache des Datensatzes anhand der entsprechenden Flaggengrafik und der Sprachbezeichnung, wohingegen in der Spalte Lokalisieren die Datensätze mit einem Klick auf die Flaggengrafik direkt übersetzt werden können. TYPO3 öffnet danach die entsprechende Eingabemaske für die Übersetzung. Im Feld Sprache ist die gewünschte Sprache automatisch vorausgewählt. Außerdem stellt TYPO3 über das Feld Originalübersetzung eine Verknüpfung zum ursprünglichen Datensatz her. Beachten Sie, dass diese Spalten auch nur dann mit den Übersetzungsdaten angezeigt werden, wenn die jeweilige Seite bereits übersetzt wurde. Sollte das noch nicht der Fall sein, können Sie dies nachholen, indem Sie einen neuen Datensatz vom Typ Alternative Seiten Sprache erstellen und entsprechend ausfüllen. Zusätzlich können Sie über das Modul Info die vorhandenen Übersetzungen im Seitenbaum kontrollieren, ändern, oder Sie können neue anlegen. Wechseln Sie dazu in das Infomodul und wählen Sie dort in der Auswahlliste den Eintrag Lokalisierungs-Übersicht aus.

Max. Linie

In dieser Übersicht werden alle Seiten, die schon übersetzt wurden, farbig markiert. Die Farbe spielt dabei eine wichtige Rolle: Wird der Hintergrund grün eingefärbt, ist die Seite

152 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

ordnungsgemäß übersetzt und auf der Webseite sichtbar. Ein roter Hintergrund signalisiert, dass die Seite in der jeweiligen Sprache nicht vorhanden ist und der Besucher eine Fehlermeldung erhalten würde, sobald er die Seite in der entsprechenden Sprache aufruft. Grau hinterlegte Zellen signalisieren, dass es für diese Seite noch keine Übersetzung gibt. Der Besucher bekommt in diesem Fall standardmäßig immer den Inhalt der Standardsprache angezeigt. Zusätzlich können Sie in der Übersetzungsübersicht auch komfortabel mehrere Seiten gleichzeitig übersetzen. Wählen Sie dazu in der Spalte der gewünschten Sprache mithilfe der Kontrollkästchen die Seiten aus, die Sie übersetzen möchten. Klicken Sie anschließend im Tabellenkopf auf das Symbol Erstelle neue Übersetzungen. Daraufhin erscheint eine Eingabemaske, mit der Sie die Seitentitel und die entsprechende Sprache festlegen können. Detailanpassungen können Sie anschließend über die Bearbeitungssymbole vornehmen. Diese Bearbeitungssymbole haben folgende Bedeutung: Bearbeite Seiteninformationen der Standardsprache Öffnet die Seiteneigenschaften der gewünschten Seite. Bei der Standardseite öffnen Sie die Basisinformationen der Seite, bei der Übersetzung den jeweiligen Datensatz Alternative Seiten Sprache.

Lizensiert für Markus Mueller

Bearbeite Seite Öffnet die jeweilige Seite im Modul Seite. Dadurch können Sie die einzelnen Inhaltselemente direkt bearbeiten, verschieben und übersetzen. Seite anzeigen Mit dem Lupensymbol öffnen Sie die Seite in der jeweiligen Sprache. Der Sprachparameter wird dabei automatisch übermittelt. Wenn Sie TYPO3 wie in Rezept 9.4 beschrieben vorbereitet haben, werden die Inhalte in der entsprechenden Sprache ausgegeben. Die Zahl am rechten Rand verdeutlicht die übersetzten Inhaltselemente, die in dieser Sprache vorliegen.

Siehe auch Die Ausgabe mehrsprachiger Inhalte können Sie über zusätzliche Optionen in den Seiteneigenschaften und Systemeinstellungen gezielt steuern. In Rezept 9.4 werden diese Optionen ausführlich erklärt. Es gibt auch die Möglichkeit, für jede Sprache einen eigenen Seitenbaum zu erstellen. Das ist vor allem dann sinnvoll, wenn die andere Sprache eine völlig andere Seitenstruktur hat als die Originalsprache. Mehr über dieses Konzept finden Sie auf der Website http://typo3.org/documentation/tips-tricks/multi-language-sites-in-typo3/.

Max. Linie

Max. Linie 4.9 Mehrsprachige Inhalte mit TYPO3 einpflegen | 153 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

4.10 Sich in einem Workspace zurechtfinden

Links

Problem Ihnen ist der Begriff Workspace bzw. Arbeitsumgebung noch unklar, und Sie möchten sich über die grundlegenden Funktionen und möglichen Unterschiede zum normalen TYPO3-Backend informieren.

Lösung Arbeiten Sie wie gewohnt im TYPO3-Backend. Den Unterschied zur normalen (Live-)Umgebung werden Sie sehen, sobald Sie Inhalte bearbeitet haben und Ihre Überarbeitung speichern. TYPO3 ändert dann zum einen den Hintergrund der Seite im Seitenbaum, auf der Sie gerade arbeiten, zum Anderen wird das Inhaltselement in der Liste und der Seitenansicht ebenfalls farbig hinterlegt. Durch diese Kennzeichnung können Sie geänderte Inhalte sehr schnell erkennen (die Änderung im Seitenbaum wird erst dann deutlich, wenn Sie im Seitenbaum eine andere Seite auswählen oder den Seitenbaum neu laden). Lizensiert für Markus Mueller

Wenn Sie die Seite mit der Änderung im Frontend betrachten, erhalten Sie eine Gegenüberstellung der Inhalte mit der Live-Seite. So können Sie Ihre Inhalte prüfen und die Änderungen begutachten. Um eine Übersicht all Ihrer Änderungen zu sehen, wechseln in das Modul Workspace. Dort erhalten Sie eine ausführliche Übersicht Ihrer Änderungen sowie die Möglichkeit, diese zur Veröffentlichung vorzuschlagen. Je nachdem, wie der Workspace eingerichtet ist, können Sie die Inhalte nun über die Pfeile nach oben in der Spalte Stufe zur Veröffentlichung vorschlagen. Nach einem Klick werden Sie um eine kurze Nachricht gebeten. Geben Sie eine knappe Zusammenfassung Ihrer Änderungen an. Die nächsthöhere Prüfinstanz erhält nach dem Bestätigen dieser Aktion eine Benachrichtigung und kann die Veröffentlichung dann abschließen oder ablehnen.

Diskussion Sinn und Zweck eines Workspace ist es, dass mehrere Benutzer bei der Inhaltserstellung zusammen an den Entwürfen arbeiten können. Sobald das finale Ergebnis abgestimmt wurde, kann der Inhalt dann auf der Webseite veröffentlicht werden. Der Workflow ist in dem Moment abgeschlossen. Besonders wichtig ist dieser Prozess bei Inhalten, die durch ein sogenanntes Vier-Augen-Prinzip vor der Veröffentlichung auf mögliche Fehler geprüft werden oder bestimmte Qualitätsmerkmale aufweisen müssen.

Max. Linie

Workspaces erlauben ein Arbeiten in einer Umgebung, die jede Änderung an den Inhalten automatisch protokolliert und als Versionierungsschritt markiert. Bereits nach der Instal-

154 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

lation von TYPO3 sind standardmäßig zwei Workspaces eingerichtet: der Live-Workspace und der Entwurfs-Workspace. Der Live-Workspace entspricht immer dem aktuellsten Stand der Website. Alle Inhalte im Live-Workspace können direkt auf den Webseiten ausgegeben werden, die auch Ihre Besucher sehen. Im Entwurfs-Workspace hingegen können Sie vor dem Veröffentlichen der Inhalte eine Kontrollinstanz einfügen. Jedoch können die Eigenschaften des Entwurfs-Workspace nicht angepasst werden, daher empfehlen wir, einen eigenen Workspace anzulegen. Der Funktionsumfang eines Workspace hängt dabei stark davon ab, wie der Administrator diesen eingerichtet hat und welche Rechte Sie in diesem Workspace haben (Rezept 3.11 geht näher auf die Rechtevergabe ein). So finden Sie, je nachdem, ob mehrere Workspaces für Sie freigeschaltet sind, in der rechten oberen Ecke eine Auswahlliste mit den verfügbaren Workspaces. Der aktive Eintrag ist immer der aktuell ausgewählten Workspace. Workspaces wird in der Liste immer eine Zahl vorangestellt. Nachdem Sie den Workspace gewählt haben, lädt sich das Backend neu, und Sie befinden sich im Workspace. Wenn Sie nur auf einen Workspace Zugriff haben, ist dieser sofort nach Ihrer Anmeldung im Backend aktiv, und es erscheint keine Auswahlliste.

Lizensiert für Markus Mueller

Sobald Sie in einem Workspace das Modul Seite aktivieren, sehen Sie oberhalb des Seitenbaums den Workspace-Titel. Beim Betrachten der Inhalte im Frontend erscheint ein Hinweis, der Ihnen sagt, dass Sie sich in einem Workspace befinden. Die dargestellten Inhalte sind also noch nicht öffentlich. Je mehr Sie in einem Workspace arbeiten, desto mehr Veröffentlichungen müssen Sie auch durchführen. Sie können Ihre Änderungen direkt über die Vorschauansicht im Frontend oder über das Modul Arbeitsumgebung zum Review einreichen. Hierfür stehen Ihnen je nach Zugriffsrechten folgende Schaltflächen zur Verfügung: Mit dem Pfeil nach unten können Sie Änderungen zurücknehmen. TYPO3 fordert Sie nach dem Klick zu einer Begründung auf, damit Ihre Änderung auch für andere nachvollziehbar bleibt. Über diese Schaltfläche geben Sie das Element zum Reviewer weiter und leiten den nächsten Schritt im Workflow ein. Über diese Schaltfläche gibt der Reviewer das Element zum Veröffentlichen weiter und leitet den nächsten und letzten Schritt im Workflow ein. Hiermit wird Ihre Änderung aus dem Workspace entfernt.

Max. Linie

Max. Linie 4.10 Sich in einem Workspace zurechtfinden | 155 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Über den Bearbeitungsstift können Sie direkt weitere Änderungen an dem Datensatz vornehmen

Links

Protokoll zeigen ermöglicht Ihnen einen Einblick in die bisherigen Änderungen des Datensatzes. Die Funktion Veröffentlichen stellt den Datensatz direkt im Live-Workspace zur Verfügung. Nach dem Klick sind die überarbeiteten Inhalte auf der Webseite sichtbar. Die Funktion Austauschen wechselt den bestehenden Datensatz im Live-Workspace mit dem überarbeiteten Datensatz aus. Nach dem Klick sind die überarbeiteten Inhalte auf der Webseite sichtbar. Ein erneuter Klick stellt wieder den ursprünglichen Zustand her. In der rechten Spalte Lebenszyklus sehen Sie, wie oft der Datensatz schon veröffentlicht wurde. Lizensiert für Markus Mueller

Mit der Zeit wird es jedoch lästig, die immer wiederkehrenden Arbeitsschritte für jeden Datensatz zu wiederholen. TYPO3 unterstützt Sie bei der Durchführung mehrerer Aktionen im Workspace-Modul. Dort können Sie mehrere Einträge auswählen und für die gewählten Einträge Aktionen durchführen. Wechseln Sie dazu in das Modul Arbeitsumgebung und wählen Sie mit den Kontrollkästchen am rechten Tabellenrand die Einträge aus, die Sie verarbeiten möchten. Legen Sie anschließend über die Auswahlliste am Tabellenkopf die Aktion fest, die TYPO3 durchführen soll. Mit den markierten Elementen können Sie diese Aktionen durchführen: Publish/Veröffentlichen Veröffentlicht die Datensätze. Über diese Funktion wird die Seite inklusive aller Inhalte im Live-Workspace veröffentlicht. Swap/Austauschen Wechselt die Datensätze aus. Im Prinzip stellt die Swap-Funktion eine erweiterte Publish-Funktion dar. Durch die Swap-Funktion werden die bestehenden Inhalte ausgetauscht. Nach einem erneuten Aufruf der Swap-Funktion werden die ursprünglichen Inhalte wieder dargestellt. Besonders nützlich ist diese Funktion daher bei temporären Änderungen der Website, die zu einem bestimmten Zeitpunkt wieder rückgängig gemacht werden sollen. Stage: x Ausgewählte Elemente auf die gewünschte Ebene heben.

Max. Linie

Flush (Delete) Ausgewählte Elemente löschen. Inhalte werden tatsächlich in der Datenbank gelöscht und nicht nur aus der Liste entfernt.

156 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Noch schneller können Sie Inhalte freischalten oder austauschen, indem Sie auf die jeweilige Schaltfläche über der Übersicht klicken. Nach der Bestätigung der Sicherheitsabfrage werden alle Änderungen veröffentlicht. Prüfen Sie vor dem Klicken auf diese Schaltflächen, ob die Inhalte auch wirklich veröffentlicht werden dürfen. Somit stehen Ihnen umfangreiche Möglichkeiten zur Verfügung, Ihre Änderungen im Workspace vorzunehmen und zu verwalten.

Siehe auch Rezept 4.11 geht näher auf die Rechtevergabe und die Einstellungen eines Workspace ein. Weitere Informationen über Workspaces finden Sie im Dokument Inside TYPO3 (http://typo3.org/documentation/document-library/core-documentation/doc_core_inside/).

4.11 Die Veröffentlichung von Inhalten über einen Workflow kontrollieren Problem Lizensiert für Markus Mueller

Sie möchten kontrollieren, welche Inhalte auf der Website erscheinen. Hierzu möchten Sie zwischen der Inhaltseingabe zum Beispiel durch Redakteure und der Veröffentlichung eine Kontrolle einbauen, die vor der Veröffentlichung die Inhalte prüft und anschließend freigibt.

Lösung Nutzen Sie die Workspace-Funktionen von TYPO3 und richten Sie für die Redakteure bzw. Redaktionsgruppen eine eigene Arbeitsumgebung ein, um die dortigen Änderungen zu verfolgen. Diese Checkliste soll Ihnen helfen, die dafür nötigen Schritte zu meistern: 1. Stellen Sie sicher, dass Sie als Administrator am Backend angemeldet sind: Sie können die hier beschriebenen Schritte nur durchführen, wenn Sie dafür die nötigen Rechte haben. 2. Eine Benutzergruppe erstellen:

Max. Linie

Nennen Sie die Gruppe Redaktion. Benutzer dieser Gruppe müssen Seiten und Seiteninhalte bearbeiten dürfen sowie mindestens Zugriff auf die Module Web, Web > Seite, Benutzerwerkzeuge und Benutzerwerkzeuge>Arbeitsumgebungen haben. Wählen Sie daher unter dem Reiter Zugriffsliste die entsprechenden Werte in den Auswahllisten unter Module und Tabellen (ändern). Schalten Sie außerdem im Feld Seitentypen mindestens den Seitentyp Standard frei, damit neue Seiten angelegt werden können.

4.11 Die Veröffentlichung von Inhalten über einen Workflow kontrollieren This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 157

Max. Linie

3. Rechte für Benutzergruppen auf Seitenbaum definieren:

Links

Setzen Sie über das Modul Zugriff die korrekten Zugriffsrechte. Die Benutzergruppe muss mindestens Seiten sehen und Inhalte bearbeiten dürfen. 4. Mindestens zwei Nutzer erstellen, wenn noch nicht vorhanden: Anhand dieser Benutzer werden Sie den Workflow testen. Hierbei haben sich Benutzernamen bewährt, die eine Hierarchie erkennen lassen, zum Beispiel Redakteur und Chefredakteur. Dadurch können Sie später die einzelnen Schritte leichter nachvollziehen und komfortabler testen. 5. Benutzergruppe zuweisen: Weisen Sie den Benutzern die Gruppe Redaktion zu. Achten Sie darauf, dass Sie die beiden Kontrollkästchen unterhalb von Freigaben aus Gruppen aktivieren. Nur so können alle Datenbankfreigaben und damit die Zugriffsmöglichkeiten auf die Seiten von der Benutzergruppe übernommen werden. 6. Zugriff auf andere Arbeitsumgebungen einschränken:

Lizensiert für Markus Mueller

Bei jedem Nutzer unter Freigaben und Arbeitsumgebungen müssen die Optionen Live bearbeiten (Online) und Entwurf bearbeiten (Offline) deaktiviert werden. Dieser Schritt ist wichtig, um die Arbeitsschritte der Benutzer auf den neuen Workspace zu beschränken. Wenn Sie diese Optionen aktiviert lassen, können die Benutzer die Inhalte auch direkt – ohne den Workflow-Prozess – bearbeiten. Die Benutzer erhalten später dann eine Auswahlliste, in der sie die gewünschte Arbeitsumgebung aktivieren können. Falls Sie mehrere Arbeitsumgebungen zur Verfügung stellen, sollten Sie dann beim Testen darauf achten, dass die richtige ausgewählt ist. 7. Workspace über das Modul Liste anlegen und bearbeiten: Wechseln Sie dazu in das Wurzelverzeichnis und legen Sie einen neuen Datensatz vom Typ Arbeitsumgebung an. 8. Workspace einrichten: In den nächsten Schritten werden die Zugriffsrechte der einzelnen Benutzer über die Workspace-Einstellungen vorgenommen. Die Zugriffsrechte auf Workspaces lassen sich nicht über Benutzergruppen definieren. Vergeben Sie einen Titel sowie eine Beschreibung für den Workspace. Diese Angaben erscheinen dann in der Listenansicht und helfen Ihnen, bei mehreren Workspaces den Überblick zu bewahren. Zusätzlich erscheint der Titel inklusive ID oberhalb des Seitenbaums im jeweiligen Workspace. 9. Benutzerrechte im Workspace zuweisen:

Max. Linie

Im Bereich Users können Sie einzelne Benutzer sowie Benutzergruppen angeben, die Zugriff auf den Workspace haben. Wenn Sie Benutzergruppen angeben, erhalten alle Benutzer dieser Gruppe automatisch Zugriff auf den Workspace. In unserem Beispiel fügen Sie den Benutzer Redakteur – mit weniger Rechten – in das Feld Mitglieder ein. Diese Benutzer dürfen keine Inhalte veröffentlichen. Fügen Sie in das Feld Redakteure die Benutzer ein, die Inhalte veröffentlichen dürfen, in unserem Beispiel den Benutzer Chefredakteur.

158 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

10. Datenbank-Mount im Workspace festlegen: Hiermit bestimmen Sie, welche Seiten die Benutzer der Arbeitsumgebung sehen dürfen. Die Zugriffsrechte auf den Seitenbaum müssen mit den zuvor festgelegten Zugriffsrechten im Live-Seitenbaum übereinstimmen. Es ist über diese Auswahl nicht möglich, Seiten freizuschalten, die vom Benutzer nicht bearbeitet werden dürfen. Stellen Sie daher sicher, dass die Rechte passen, denn hier lauert die größte Fehlerquelle. 11. Optional: Verzeichnisfreigaben einbinden: Wenn Sie möchten, dass Dateien mit Datensätzen verknüpft werden können, aktivieren Sie unter Verzeichnisfreigaben den gewünschten Eintrag. Auch hier müssen die Verzeichnisfreigaben mit den Einstellungen in der Benutzergruppe übereinstimmen. Der Benutzer kann im Modul Dateiliste keine Aktionen durchführen. 12. Speichern und testen Sie die Einstellungen mit den ausgewählten Benutzern:

Lizensiert für Markus Mueller

Wechseln Sie anschließend über die Benutzerverwaltung in die jeweilige Benutzerrolle, um den Workflow zu testen. Klicken Sie hierzu im Modul Benutzerverwaltung auf das rot hinterlegte Symbol SU. Sie wechseln damit temporär in die gewünschte Benutzeransicht, können diese aber über den Button Verlassen wieder schließen und in Ihre vorherige Administratoransicht zurückkehren. So können Sie die Benutzerrechte schnell testen, ohne sich jedes Mal neu anmelden zu müssen (Rezept 3.11 geht detaillierter auf diese Schritte ein). Hier hat es sich bewährt, drei unabhängige Browser zu verwenden und sich in jedem mit einem unabhängigen Backend-Benutzer anzumelden. So können Sie intuitiv die einzelnen Arbeitsschritte im Backend nachvollziehen. Wichtig ist hierbei, dass Sie weder Tabs noch neue Fenster verwenden, sondern voneinander unabhängige Browserinstanzen. Die Browser müssen unabhängig voneinander laufen, da TYPO3 die Benutzer-Sessions ansonsten nicht auseinanderhält. Melden Sie sich in jedem Browser mit einem unterschiedlichen Benutzer an und spielen Sie die Inhaltsverwaltung wie in Rezept 4.10 beschrieben durch.

Wenn Sie die Einstellungen erfolgreich getestet haben, können Sie weitere Benutzer hinzufügen oder anstelle einzelner Benutzer auch Benutzergruppen verwenden, was die Verwaltung vieler Benutzer erleichtert. Die beiden Benutzer können nun abhängig voneinander Inhalte veröffentlichen. Gleichzeitig haben Sie durch die automatische Versionierung der Inhalte die größtmögliche Transparenz, was die Aktivitäten und Änderungen der Redakteure betrifft. Die Benutzer können den neu angelegten Workspace umgehend nutzen und die Inhalte in dem festgelegten Seitenbaum anpassen. Die Veröffentlichung der Inhalte liegt jedoch ganz in der Hand der festgelegten Workspace-Redakteure.

Max. Linie

Max. Linie 4.11 Die Veröffentlichung von Inhalten über einen Workflow kontrollieren This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 159

Diskussion

Links

Eine Arbeitsumgebung erlaubt es unterschiedlichen Benutzern, im Prozess der Inhaltserstellung zusammen an Entwürfen arbeiten zu können. Jedoch kann dieser Prozess durch einen Workflow auch unnötig behindert werden. Bevor Sie Workspaces einsetzen, sollten Sie daher genau prüfen, ob Ihre Umgebung durch einen Workflow entlastet werden kann und ob ein Workflow überhaupt sinnvoll ist. Um einen Workflow zu nutzen, benötigen Sie mindestens zwei Backend-Benutzer, die unabhängig voneinander Inhalte eingeben sollen, bzw. zwei Benutzergruppen, deren Benutzer unabhängig voneinander Inhalte eingeben können. Nur wenn Sie mehrere Benutzergruppen haben, die unterschiedliche Hierarchien und daher auch Bearbeitungsrechte besitzen, ist die Implementierung eines Workflows sinnvoll. Ebenso ist ein Workflow nur bei größeren, (örtlich) verteilten Gruppen sinnvoll, deren Kommunikation zeitversetzt und nicht direkt erfolgen kann. Es ist zum Beispiel sinnlos, ein kompliziertes Workflow-Konstrukt zu errichten, wenn die Redakteure in einem Raum sitzen und sich auch direkt absprechen können. Erfahrungsgemäß lohnt sich der Aufwand, der mit dem gezeigten Workflow-Modell einhergeht, nicht, der Workspace wird von den Benutzern meist nicht genutzt. Lizensiert für Markus Mueller

Die Bereiche Benutzerverwaltung und Rechtevergabe sind sehr vielschichtig. Wir zeigen die Verwendung des Workflows an einem rudimentären Beispiel, wie es in der Praxis häufig vorkommt. Eventuell müssen Sie die hier gezeigten Einstellungen über mehrere Benutzergruppen verteilen. Es ist durchaus möglich, dass Sie die Benutzerrechte feiner gliedern möchten. Das Rezept gibt Ihnen das nötige Grundwissen an die Hand. Wenn Sie eine weitere Freigabeebene benötigen, können Sie den oben skizzierten Prozess auch um eine Hierarchiestufe erweitern. Richten Sie hierzu einen weiteren Benutzer der Gruppe Redaktion ein und legen Sie diesen Benutzer als Besitzer der Arbeitsumgebung fest, indem Sie ihn in das entsprechende Feld im Bereich Users einfügen. Wechseln Sie anschließend in den Bereich Other und aktivieren Sie dort die Option Only workspace owner can publish. Dadurch werden die Veröffentlichungsrechte von Redakteuren deaktiviert, sodass diese Benutzer nur noch Inhalte für die Veröffentlichung vorschlagen können. Die Veröffentlichung obliegt dann dem Besitzer der Arbeitsumgebung. Wenn ein Workflow eingerichtet ist und der Prozess im Redaktionsteam nahtlos integriert ist, können Änderungen verfolgt werden, indem man sich zum Beispiel per E-Mail über Änderungen informieren lässt. Sie haben dadurch eine größtmögliche Transparenz bei den Aktivitäten im Workspace und halten die Änderungen im Blick.

Max. Linie

Wählen Sie dazu in den Benachrichtigungseinstellungen aus, wie Sie bzw. die Redakteure des Workspace benachrichtigt werden möchten. Standardmäßig werden die Benutzer bei Änderungen nicht benachrichtigt. Stellen Sie die Option E-Mail-Benachrichtigung bei Phasenänderung auf Notify all users on any change, um eine Benachrichtigung bei jeder Änderung zu aktivieren. Wenn Sie nur bei wesentlichen Änderungen benachrichtigen möchten, wählen Sie die Option Notify users on next stage only.

160 | Kapitel 4: Inhalte eingeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Sie können die Menge an Benachrichtigungs-E-Mails mit der Option Stage change notification by email bestimmen. Wir empfehlen Ihnen, die Option auf Notify users on next stage only zu stellen. Sie erhalten nur dann Meldungen, wenn ein Redakteur Inhalte veröffentlichen will (oder die Veröffentlichung abgelehnt wurde und so weiter). Die Option Notify all users on any change sendet die Benachrichtigungen bei jeder Änderung, also auch, wenn der Benutzer ein Inhaltselement ändert. Möchten Sie als Workspace-Besitzer die Bearbeitung der Inhalte im Workspace verbieten, können Sie den Workspace mit der Option Bearbeitung einfrieren sperren. Dies ist dann sinnvoll, wenn Sie den aktuellen Stand der Inhalte im Workspace so festhalten möchten, ohne den Workspace ganz zu löschen bzw. für die Benutzer auszublenden. Beachten Sie, dass eine Versionierung der Seite nicht mehr möglich ist, wenn Inhaltselemente auf dieser Seite bearbeitet wurden.

Siehe auch Eine weitere Dokumentation zu Workspaces und den einzelnen Funktionen des Moduls finden Sie auf der TYPO3-Website, wenn Sie nach dem Begriff doc_v4_workspace suchen. Lizensiert für Markus Mueller

Max. Linie

Max. Linie 4.11 Die Veröffentlichung von Inhalten über einen Workflow kontrollieren This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 161

Lizensiert für Markus Mueller

First

Kapitel 5

KAPITEL 5

Inhalte verwalten

5.0

Einführung

Lizensiert für Markus Mueller

Erfahrungsgemäß wächst mit zunehmendem Umfang der Website auch der Aufwand, die unterschiedlichen Datensätze zu verwalten. Die Hauptaufgabe im Backend wird dabei in der Regel darin bestehen, Inhalte auf den Webseiten zu bearbeiten, aufzuteilen und sinnvoll zu strukturieren. TYPO3 bietet Ihnen über das Backend komfortable Möglichkeiten, diese Arbeitsvorgänge zu optimieren. In den Rezepten 5.1 und 5.2 erfahren Sie, wie Sie wiederkehrende Aufgaben – vor allem im administrativen Bereich – schnell erledigen und sogar weitestgehend automatisieren können. Für Arbeiten an der Seitenstruktur oder an den Inhalten finden Sie in den Rezepten 5.3, 5.4 und 5.5 Lösungen für die anfallenden Arbeitsschritte. Dabei spielt das Modul Liste – kombiniert mit der sogenannten Zwischenablage – eine entscheidende Rolle. Über das Modul Liste erhalten Sie schnell einen Überblick über die vorhandenen Datensätze, und mit der Zwischenablage können Sie Daten bequem in der Seitenstruktur transportieren. Die Zwischenablage fungiert dabei wie ein TYPO3-eigener Zwischenspeicher, mit dem Inhalte über die Modulgrenze hinweg verschoben oder kopiert werden können. Zu bearbeitende Inhaltselemente können Sie über die Bearbeitungssymbole öffnen. In Rezept 5.6 erfahren Sie, wie Sie diese Bearbeitungsschritte auf mehrere Datensätze anwenden, um möglichst effektiv und Zeit sparend vorzugehen. Ähnlich gehen Sie vor, wenn Sie Datensätze aus Ihrer Website ganz entfernen möchten. Dazu finden Sie in Rezept 5.7 tiefer gehende Hintergrundinformationen. Wenn Sie Dateien oder Ordner über das Modul Dateiliste löschen möchten, finden Sie in Rezept 5.8 die nötigen Hinweise dazu.

Max. Linie

Sollten Sie versehentlich Inhalte gelöscht haben, erfahren Sie in Rezept 5.9, wie Sie diese wiederherstellen können. Zudem können Sie die Inhalte auch lokal sichern oder in andere

| 163 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

TYPO3-Instanzen übertragen, indem Sie die Import- und Exportfunktionen von TYPO3 verwenden. Die Rezepte 5.10 und 5.11 erläutern die grundlegenden Funktionen dieses Moduls.

Links

Bei umfangreichen Inhalten besteht die Möglichkeit, für Frontend-Benutzer eine Suche auf der Website einzurichten. Standardmäßig unterstüzt TYPO3 zwei Suchmethoden. Die Rezepte 5. 12 und 5.13 beleuchten diese beiden Funktionen im Detail. Seit TYPO3-Version 4.1 gibt es mit IRRE ein neuartiges Konzept, verknüpfte Datensätze im Backend anzuzeigen und zu bearbeiten. Einen kurzen Überblick über dieses Konzept des Inline Relational Record Editing gibt Ihnen Rezept 5.14.

5.1

Datensätze effektiv verwalten

Problem Sie möchten Ihre Datensätze effektiver handhaben und wünschen sich einen schnelleren Zugriff auf häufig verwendete Funktionen.

Lösung Lizensiert für Markus Mueller

Aktivieren Sie in der Listenansicht die Option Erweiterte Ansicht. Nun werden die wichtigsten Funktionen des Kontextmenüs in einer erweiterten Optionspalette direkt neben dem jeweiligen Datensatz angezeigt.

Diskussion Mit der Option Erweiterte Ansicht können Sie die am häufigsten gebrauchten Bearbeitungsfunktionen wie Bewegen, Ausblenden und Löschen direkt auswählen. Der Umfang der Bearbeitungsfunktionen orientiert sich dabei stets am jeweiligen Datensatztyp. Beispielsweise beinhaltet die Optionspalette von Seiten zusätzlich die Möglichkeit, Zugriffsrechte für Backend-Benutzer zu vergeben, was bei Inhaltselementen nicht möglich ist. Im Folgenden erhalten Sie eine Auflistung der Funktionen, die bei allen Inhaltselementen vorhanden sind. Dabei werden die Icons der Reihe nach von links nach rechts erläutert. Der kursiv gesetzte Text entspricht dem Titel des Icons: Informationen anzeigen Das Info-Icon erlaubt Ihnen einen schnellen Einblick in den Datensatz, ohne ihn öffnen zu müssen. Wenn Sie auf das Icon klicken, öffnet sich ein Fenster, das die wichtigsten Feldinhalte des Datensatzes übersichtlich auflistet. Das Layout der Infoansicht wird vom TCA der Tabelle bestimmt.

Max. Linie

Änderungsverlauf anzeigen/Rückgängig Mit diesem Icon erhalten Sie eine tabellarische Gegenüberstellung der Änderungen, die seit dem Erstellen des Datensatzes vollzogen wurden, sowie Informationen über

164 | Kapitel 5: Inhalte verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Autor und den Zeitpunkt der Änderung. In Rezept 5.9 erfahren Sie, wie Sie mit dieser Funktion gelöschte Inhalte wiederherstellen oder Änderungen, die ab einem bestimmten Zeitpunkt gemacht wurden, aufsummieren. Versionierung Das Icon V steht für Versionierung. Über dieses Icon haben Sie Zugriff auf die Versionkontrolle des Datensatzes, über die Sie zum Beispiel Unterschiede zwischen zwei Versionen eines Datensatzes sichtbar machen können. Neuer Datensatz nach diesem einfügen bzw. Neue Seite nach dieser Seite anlegen Mit diesem Icon erzeugen Sie einen neuen Datensatz direkt unter dem vorhandenen. In Rezept 4.4 erfahren Sie, wie Sie Werte von vorhergehenden Datensätzen übernehmen und so mitunter viel Zeit sparen. Nach oben verschieben bzw. Nach unten verschieben Mit diesen Icons können Sie einzelne Inhaltselemente direkt verschieben. Diese Funktion ist so nicht im Kontextmenü verfügbar und steht Ihnen nur in der erweiterten Ansicht zur Verfügung. In Kapitel 5 erfahren Sie, wie Sie mehrere Inhaltselemente gleichzeitig verschieben oder sortieren können.

Lizensiert für Markus Mueller

Datensatz verbergen und Datensatz löschen Diese Icons nehmen direkt Einfluss auf die Darstellung der Datensätze im Frontend. Sie können damit den Datensatz direkt aus- oder einblenden oder auch löschen, sodass er im Frontend nicht mehr angezeigt wird. Das Icon Datensatz verbergen zeigt immer den Zustand, den der Datensatz haben wird, wenn Sie auf das Icon klicken. Ein rot durchstrichenes Icon bedeutet, dass der Datensatz ausgeblendet wird, nachdem Sie die Grafik angeklickt haben. Ist das Symbol nicht durchgestrichen, bedeutet dies: Der Datensatz ist momentan ausgeblendet. Mit einem Klick wäre er wieder sichtbar. Zusätzlich zu den allgemeinen Optionen, die bei jedem Datensatz angezeigt werden, bietet die Funktionsleiste bei Seiten folgende zusätzliche Möglichkeiten: Zugriffsrechte für Seite einstellen Mit diesem Icon wechseln Sie in das Modul Zugriff. Dort legen Sie fest, welche Backend-Benutzer und -Benutzergruppen auf die Seite zugreifen dürfen. Bewege diese Seite hinter die derzeit übergeordnete Seite (einwärts) Bewege diese Seite als Unterseite in die derzeit vorhergehende Seite (auswärts) Mit diesen Icons kann eine Seite direkt in der Seitenhierarchie ein- oder ausgerückt werden. Ganze Seitenbäume können so neu erzeugt, verschoben oder eingerückt werden.

Siehe auch

Max. Linie

In Rezept 4.2 erfahren Sie, wie Sie Seiteninhalte schnell eingeben. In den Rezepten 4.2, 5.6 und 5.7 finden Sie Tipps dazu, wie Sie mehrere Datensätze gleichzeitig bearbeiten, verschieben oder löschen können.

5.1 Datensätze effektiv verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 165

Max. Linie

5.2

Wiederkehrende Arbeiten beschleunigen

Links

Problem Sie möchten oft benötigte Aktionen im Backend weitestgehend automatisieren oder vereinfachen.

Lösung Verwenden Sie sogenannte Befehle, mit denen Sie Arbeitsschritte zusammenfassen und Routineaufgaben leichter abarbeiten können. Installieren Sie dazu die Extension User> Task Center, Actions (sys_action). Diese Extension legt eine neue Datenbanktabelle an, in der die Befehle gespeichert werden, und bindet die entsprechenden Eingabemasken in das Backend ein. Neue Befehle erstellen Sie dann über das Modul Liste in der Wurzelseite Ihrer TYPO3-Installation. Legen Sie dort ein neues Inhaltselement vom Typ Befehl an. Sämtliche Befehle finden Sie nach dem Speichern im Modul Aufgaben im Bereich Befehle. Von dort aus können Sie diese dann direkt per Mausklick aufrufen.

Lizensiert für Markus Mueller

Beachten Sie, dass ausschließlich Benutzer vom Status Administrator Befehle anlegen können – diese können jedoch Befehle auch für andere Backend-Gruppen freischalten, sodass diese Befehle von jedem Benutzer dieser Gruppe auch über das Modul Aufgaben verwendet werden können. Wenn Sie selbst keine Befehle anlegen dürfen und einen Befehl vermissen, sollten Sie sich mit dem Administrator in Verbindung setzen.

Diskussion Die Befehle können ganz unterschiedliche Einsatzgebiete haben. Beispielsweise können Sie mit wenigen Mausklicks Backend-Benutzer erzeugen oder eine bestimmte Seite mit Inhalt füllen. Dabei sind die Befehle stets identisch aufgebaut. In der Wurzelseite legen Sie einen Datensatz Befehl an, der über die Eingabefelder konfiguriert wird. Dieser Datensatz wird dann in der Datenbank gespeichert und in das Modul Aufgaben integriert. Wird der Befehl aufgerufen, analysiert TYPO3 dessen Einstellungen und ruft intern die entsprechenden Module auf, die dann wiederum die erforderlichen weiteren Funktionalitäten bereitstellen. Wenn Sie Befehle erstellen, sollten Sie stets einen aussagekräftigen Titel und eine Beschreibung vergeben. Diese Angaben erscheinen später im Modul Aufgaben und sind erfahrungsgemäß sehr hilfreich, um Befehle eindeutig zu unterscheiden. Zusätzlich können Sie mit dem Auswahlfeld Assign action to groups die Backend-Benutzergruppen bestimmen, die später Zugriff auf diesen Befehl haben. Wenn Sie die Auswahlliste leer lassen, haben nur Administratoren Zugriff auf den Befehl.

Max. Linie

Über die Auswahlliste Typ können Sie aus folgenden Befehlstypen wählen:

166 | Kapitel 5: Inhalte verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Create Backend User Legen Sie mit einem Mausklick einen neuen Backend-Benutzer an. Als Vorlage für den neuen Benutzer dient ein bereits angelegter Benutzer (der sogenannte TemplateBenutzer). Sämtliche Einstellungen (außer den Werten für Name, Benutzername, Passwort und E-Mail-Adresse) werden beim Anlegen eines neuen Benutzers automatisch von diesem Benutzer übernommen. Verwenden Sie diesen Befehlstyp, wenn Sie häufig Backend-Benutzer anlegen möchten oder sich diese Aufgabe mit einem anderen Backend-Benutzer teilen möchten, der selbst über keine administrativen Rechte verfügt. Wir empfehlen Ihnen, diesen Template-Benutzer ganz zu deaktivieren, um eine mögliche Anmeldung mit dessen Zugangsdaten auszuschließen. Die neu generierten Backend-Benutzer werden selbstverständlich umgehend aktiviert, wenn Sie diese über den Template-Benutzer anlegen. SQL-query Definieren Sie eigene Datenbankabfragen, die Sie dann über das Modul Aufgaben per Mausklick aufrufen können. Verwenden Sie diesen Befehlstyp, um eigene Listenansichten zu erzeugen (in Rezept 7.2 erfahren Sie mehr über diese Anwendungsmöglichkeiten).

Lizensiert für Markus Mueller

Record list Listen Sie die Inhaltselemente innerhalb einer bestimmten Seite auf. Sie gelangen dadurch automatisch in die Listenansicht dieser Seite. Mit der Auswahlliste List only table begrenzen Sie die Anzeige der Datensätze auf bestimmte Tabellen. Verwenden Sie diesen Typ, wenn Sie sich schnell einen Überblick über die vorhandenen Datensätze in einer Seite verschaffen möchten. Edit records Legen Sie über die Auswahlliste Records to edit bestimmte Datensätze fest, die über diesen Befehl aufgelistet und per Mausklick geöffnet werden können. Verwenden Sie diesen Typ, wenn Sie häufig an bestimmten Datensätzen arbeiten müssen (in Rezept 7.1 finden Sie weitere Anregungen dazu, wie Sie häufig verwendete Datensätze schnell erreichen). New Record Erzeugen Sie einen neuen Datensatz innerhalb einer vordefinierten Seite. Sie können festlegen, in welcher Seite der Datensatz erstellt wird und welchen Typ er hat. Verwenden Sie diesen Befehl, wenn Sie die Erzeugung von bestimmten Datensätzen vereinfachen möchten. Achten Sie darauf, dass Sie in der Auswahlliste Create records in table einen Datensatztyp angegeben haben, da der Befehl sonst nicht durchgeführt werden kann.

Max. Linie

Wenn Sie über den Befehl Datensätze auflisten, bearbeiten oder neu anlegen möchten und diesen für andere Benutzergruppen freischalten, müssen Sie auch sicherstellen, dass die gewählte Benutzergruppe die nötigen Rechte hat, diese Datensätze aufzulisten oder zu bearbeiten. Kontrollieren Sie hierfür die aktivierten Tabellen in der Auswahlliste Tables

5.2 Wiederkehrende Arbeiten beschleunigen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 167

Max. Linie

(modify) (bzw. Tables (list), wenn Sie Datensätze nur auflisten möchten). Diese Auswahlliste finden Sie in den Einstellungen der Backend-Benutzergruppe. Achten Sie darauf, dass dort das Kontrollkästchen Include Access Lists aktiv ist.

Links

Siehe auch In Rezept 7.2 erfahren Sie mehr über den Befehlstyp SQL-query, mit dem Sie – ähnlich dem Modul Dokumente – die aktuellsten Datensätze in der Datenbank ermitteln.

5.3

Datensätze verschieben oder kopieren

Problem Sie möchten bestimmte Seiteninhalte auf mehr als einer Seite anzeigen lassen, etwa um wiederkehrende Seitenelemente in bestimmte Seiten einfügen.

Lösung Lizensiert für Markus Mueller

Wählen Sie das Modul Liste und wechseln Sie in die Seite, in der das gewünschte Inhaltselement liegt, das Sie kopieren möchten. Aktivieren Sie am Seitenende der Listenansicht die Option Zwischenablage anzeigen und wählen Sie dort Zwischenablage Nr.1. Legen Sie nun die gewünschten Datensätze in die Zwischenablage, indem Sie über die Kontrollkästchen die Datensätze auswählen und in der Bearbeitungsspalte auf das Symbol Ausgewählte Datensätze auf die Zwischenablage transferieren klicken. Aktivieren Sie abschließend die Option Objekte kopieren statt zu verschieben, sodass das Icon, das Sie in Abbildung 5-1 sehen, in der linken Ecke orange gefärbt erscheint.

Abbildung 5-1: Wird diese Grafik orange hervorgehoben, werden die Inhalte kopiert

Max. Linie

Die Inhalte liegen nun in der Zwischenablage und können bequem an eine andere Stelle im Seitenbaum kopiert werden. Wechseln Sie dazu über den Seitenbaum in die gewünschte Seite, in der Sie den Inhalt aus der Zwischenablage einfügen möchten. Dort erscheint jetzt ein Icon . Ist auf der Seite schon Inhalt vorhanden, können Sie den Inhalt auch mit diesem Icon gezielt hinter diese Datensätze setzen. Sind Unterseiten vorhanden, ist es mit diesem Icon möglich, den Inhalt auch direkt in diese Seiten zu legen. Die Inhalte werden dadurch direkt in die jeweilige Seite eingefügt und angezeigt.

168 | Kapitel 5: Inhalte verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Diskussion Wenn Sie lediglich ein einzelnes Inhaltselement oder eine Seite kopieren möchten, können Sie alternativ dazu auch den Kopieren-Befehl aus dem Kontextmenü oder den Verschiebe-Assistenten verwenden. Sie sparen sich dadurch die oben genannten Schritte und sind womöglich schneller am Ziel als mit der Zwischenablage. Jedoch können Sie damit nur jeweils einen Datensatz verarbeiten. Um Inhalte mit dem einfachen Kopieren-Befehl zu verarbeiten, klicken Sie auf das Symbol des Inhaltselements und wählen die Option Kopieren. Der Datensatz wird dadurch automatisch in die Zwischenablage Normal gelegt und kann dann umgehend wieder an der gewünschten Stelle eingefügt werden, wenn Sie auf das Icon einer Seite klicken und die Option Einfügen in auswählen. Möchten Sie Inhalte mit dem Verschiebe-Assistenten kopieren, wechseln Sie dazu in den Listenmodus und wählen anschließend die Seite, von der Sie das Inhaltselement kopieren möchten. Den Verschiebe-Assistenten erreichen Sie über mehrere Wege: Klicken Sie auf das Icon des gewünschten Datensatzes und wählen Sie die Option Weitere Einstellungen im Kontextmenü. In der nun folgenden Auswahl klicken Sie dann auf die Option Element verschieben. Alternativ dazu erreichen Sie diese Funktion auch direkt über die sogenannte Erweiterte Ansicht. Bitte lesen Sie dazu mehr in Rezept 5.1.

Lizensiert für Markus Mueller

Nachdem Sie die Option Element verschieben gewählt haben, erscheint der VerschiebeAssistent. Aktivieren Sie dort die Option Objekte kopieren statt zu verschieben und wählen Sie mit den grauen Pfeilen eine neue Position im Seitenbaum. Sollten Sie die richtige Position nicht sehen, klicken Sie auf den gewünschten Seitentitel. Sie setzen damit den neuen Ausgangspunkt für den Verschiebe-Assistenten. Beachten Sie, dass der Verschiebe-Assistent nicht funktioniert, wenn Sie bei einer Seite die Option Seitenbaum stoppen aktiviert haben. Die gewünschten Seiten erscheinen dann nicht wie zuvor beschrieben in der Auswahl. Um Inhaltselemente unterhalb eines gestoppten Seitenbaums zu kopieren, können Sie die eingangs beschriebene Methode verwenden. Klicken Sie dann auf das rote Pluszeichen. Damit wählen Sie die Ausgangsseite als temporären Startpunkt und können die Zwischenablage wie gewohnt verwenden.

Beachten Sie außerdem, dass der Verschiebe-Assistent nicht für alle Datensätze zur Verfügung steht. Nutzen Sie dann die anfangs beschriebene Methode über die Zwischenablage.

Max. Linie

Zahlreiche Kopien eines Datensatzes können Flexibilität bedeuten, aber auch schnell unübersichtlich werden. TYPO3 bietet Ihnen mehrere Möglichkeiten, wiederkehrende Inhalte bequem zu verwalten, ohne dass Sie jedes Mal die Inhalte kopieren müssten. Besonders bei umfangreichen Websites kann der Verwaltungsaufwand dadurch stark reduziert werden, denn die Änderungen am ursprünglichen Inhalt werden umgehend an allen verknüpften Stellen sichtbar.

5.3 Datensätze verschieben oder kopieren This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 169

Max. Linie

Sie können dabei punktuell auf Ihren Seiten Stellen definieren, die Inhalte anderer Bereiche anzeigen sollen oder gar den ganzen Inhalt einer Seite mit dem Inhalt einer anderen Seite austauschen.

Links

Mit dem Inhaltselement Datensatz einfügen können Sie für einen bestimmten Inhaltsbereich festlegen, welcher Inhalt an der gewünschten Stelle angezeigt werden soll. Mit diesem Inhaltselement legen Sie eine Referenz eines Datensatzes an, in denen dann TYPO3 den Originalinhalt anzeigt. So können Sie zum Beispiel bestimmte Inhalte zentral verwalten und Änderungen am ursprünglichen Datensatz umgehend an unterschiedlichen Stellen durchführen. Legen Sie dazu ein neues Inhaltselement vom Typ Datensatz einfügen an und wählen Sie über das Feld Objekte die gewünschten Seiteninhalte. Diese werden nach dem Speichern an der gewünschten Stelle ausgegeben. Über das Feld Name können Sie einen Namen für das Inhaltselement vergeben. Dieser Name wird nicht im Frontend ausgegeben und dient nur der Übersichtlichkeit im Backend.

Lizensiert für Markus Mueller

Eine andere Möglichkeit, Inhalte zentral zu verwalten, besteht mit der Option Inhalt dieser Seiten anzeigen, die Sie in den Seiteneigenschaften finden. Mit dieser Option können Sie den gesamten Inhalt einer bestimmten Seite auf einer anderen Seite auslesen. Legen Sie dazu eine neue Seite an oder wählen Sie eine bestehende Seite in Ihrem Seitenbaum aus und bearbeiten Sie die Seiteneigenschaften. Wählen Sie dort den Reiter Optionen. Im unteren Bereich des Formulars finden Sie das Auswahlfeld Inhalt dieser Seite anzeigen. Mit diesem Auswahlfeld können Sie nun eine Seite festlegen, die den Inhalt für die aktuelle Seite liefert. Sämtlicher Inhalt der aktuellen Seite wird dadurch von der ausgewählten Seite überschrieben. Wenn Sie in Ihrer TYPO3-Installation mehrere Domains verwalten und Inhalte zwischen diesen Domains austauschen möchten, müssen Sie dies explizit freischalten. Standardmäßig können Inhalte von anderen Domains nicht mit den oben genannten Funktionen ausgetauscht werden. Fügen Sie folgenden TypoScript-Code in das Setup-Feld Ihres TypoScript-Templates ein, um diese Option freizuschalten: config { content_from_pid_allowOutsideDomain = 1 }

Beachten Sie, dass die Einstellung Inhalt dieser Seite anzeigen mitunter sehr verwirrend sein kann. Falls Ihre Änderungen auf der Seite nicht direkt sichtbar werden oder Sie sich wundern, warum die Inhalte auch nach dem Leeren des Seitencaches nicht erscheinen, kann es daran liegen, dass die Inhalte der Seite von einer ganz anderen Seite geholt werden.

Siehe auch

Max. Linie

In Rezept 13.1 erfahren Sie, wie Sie mit TypoScript Inhalte fest in Ihrer Seite verankern und Änderungen zentral steuern können. Mehr Informationen zu den unterschiedlichen Seitentypen finden Sie in Rezept 7.8.

170 | Kapitel 5: Inhalte verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

5.4

Seiteninhalt auf mehrere Seiten verteilen

Problem Sie möchten mehrere Datensätze gleichzeitig verschieben, beispielsweise um Inhalte von einer Seite auf mehrere Seiten zu verteilen.

Lösung Aktivieren Sie am Seitenende der Listenansicht die Option Zwischenablage anzeigen und wählen Sie dort Zwischenablage Nr.1. Daraufhin ändert sich erneut die Listenansicht, und es erscheint in jeder Zeile zusätzlich zu den Ansichts-, Bearbeitungs- und Verschiebesymbolen ein Kontrollkästchen. Wählen Sie nun über diese Kontrollkästchen die gewünschten Datensätze aus, die Sie in die Zwischenablage verschieben möchten. Abschließend klicken Sie in der Bearbeitungsspalte auf das Symbol Ausgewählte Datensätze in die Zwischenablage transferieren . Beachten Sie dabei, dass Sie immer nur Datensätze einer Tabelle gleichzeitig auf die Zwischenablage verschieben können. Um mehrere Datensätze unterschiedlicher Tabellen in der Zwischenablage abzulegen, wiederholen Sie diesen Vorgang für jede Tabelle. Lizensiert für Markus Mueller

Wählen Sie danach eine weitere Zwischenablage und wiederholen Sie den Vorgang, bis Sie alle Inhalte in die Zwischenablagen verteilt haben. Achten Sie abschließend darauf, dass Sie die Option Elemente verschieben deaktiviert haben. Nachdem Sie alle gewünschten Datensätze in die Zwischenablage übertragen haben, wechseln Sie auf die Seite, in der Sie Ihre Datensätze platzieren möchten. Auf der neuen Seite erscheint nun dieses Icon . Ist auf der Seite schon Inhalt gleichen Typs vorhanden, können Sie den Inhalt auch mit diesem Icon gezielt hinter diese Datensätze setzen. Sind Unterseiten vorhanden, legen Sie den Inhalt direkt in diese Seiten . Wiederholen Sie auch hier den Schritt für jede Zwischenablage, bis Ihre Inhalte wie gewünscht verteilt sind. Sollten Ihnen die Zwischenablagen für Ihr Vorhaben ausgehen, lesen Sie in Rezept 5.5 nach, wie Sie die Anzahl der Zwischenablagen erhöhen.

Diskussion Wenn Sie alle Datensätze einer Tabelle gleichzeitig verschieben möchten, verwenden Sie die Option Alles/nichts markieren. Dadurch markieren Sie automatisch alle Datensätze einer Tabelle. Sollten Sie einmal vergessen haben, an welcher Stelle Sie den Datensatz in die Zwischenablage gelegt haben, genügt ein Klick auf den Titel oder das Icon des Datensatzes. Sie gelangen damit automatisch an die ursprüngliche Position des Datensatzes. TYPO3

Max. Linie

Max. Linie 5.4 Seiteninhalt auf mehrere Seiten verteilen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 171

merkt sich, welcher der Datensätze sich momentan in der Zwischenablage befindet, und markiert sie entsprechend in der Listenansicht. Gerade wenn Sie zahlreiche Datensätze aus unterschiedlichen Seiten in der Zwischenablage gespeichert haben, hilft diese Funktion sehr, die Übersicht zu bewahren. Um Inhalte aus der Zwischenablage zu entfernen, deaktivieren Sie das entsprechende Kontrollkästchen in der Liste und klicken erneut auf den Befehl Ausgewählte Datensätze auf die Zwischenablage transferieren oder auf das kleine x-Symbol in der Liste neben dem Datensatz. Um alle Einträge auf der aktuellen Zwischenablage gleichzeitig zu löschen, klicken Sie auf Löschen rechts oben in der Zwischenablage.

Links

Beachten Sie, dass die Optionen Ausschneiden, Kopieren und Einfügen im Kontextmenü als Zwischenspeicher immer die Ebene Normal verwenden. Wenn Sie also Inhalte von einer der Ebenen einfügen möchten, müssen Sie die Seite auswählen, in die Sie die Inhalte legen möchten, und dort die zuvor beschriebenen Schritte ausführen. Sollten Sie die Zwischenablage einmal aus Versehen deaktivieren, achten Sie beim erneuten Aktivieren darauf, dass sie automatisch auf die Ebene Normal zurückgesetzt wird und Sie Ihre gewünschte Ebene sowie den Kopiermodus womöglich erneut auswählen müssen. Lizensiert für Markus Mueller

Siehe auch Rezept 5.7 beschreibt, wie Sie mehrere Datensätze gleichzeitig löschen. Benötigen Sie mehr als fünf Ebenen, erklärt Ihnen Rezept 5.5, wie Sie weitere hinzufügen können.

5.5

Die Zwischenablage erweitern

Problem Sie möchten zusätzliche Ebenen in der Zwischenablage aktivieren, um so noch mehr Inhalte übersichtlich in der Zwischenablage zu gruppieren und auch umfangreiche Inhalte komfortabler zu verwalten.

Lösung Erweitern Sie die Ebenen in der Zwischenablage. Geben Sie dazu folgenden Code in Ihr Benutzer-TSconfig ein: options { clipboardNumberPads = 5 }

Max. Linie

Sie können so bis zu 20 Ebenen in der Zwischenablage anlegen.

172 | Kapitel 5: Inhalte verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Diskussion Der Inhalt der Zwischenablage wird in der aktuellen Session gespeichert. Diese Session wird standardmäßig beim Abmelden gelöscht, sodass mit der Abmeldung auch der Inhalt aus der Zwischenablage entfernt wird. Mit folgender TSconfig-Einstellung halten Sie die Inhalte in der Zwischenablage, auch wenn die Session durch den Abmeldevorgang gelöscht wurde: options { saveClipboard = 1 }

Siehe auch In Rezept 5.4 erfahren Sie, wie Sie mit der Zwischenablage komfortabel lange Seiten aufteilen.

5.6

Mehrere Datensätze gleichzeitig bearbeiten

Problem Lizensiert für Markus Mueller

Sie möchten an mehreren Datensätzen gleichzeitig arbeiten, beispielsweise um Inhalte von einem Datensatz in den anderen zu kopieren, Werte zu vergleichen oder Änderungen in mehreren Datensätzen gleichzeitig zu speichern.

Lösung Wählen Sie im Modul Seite die Option Spalten im Auswahlmenü und klicken Sie auf das Bearbeitungssymbol Diese Spalte bearbeiten in der Spaltenüberschrift. Daraufhin öffnen sich, wie in Abbildung 5-2 zu sehen, alle Datensätze der gewählten Spalte.

Abbildung 5-2: Über dieses Icon öffnen Sie sämtliche Datensätze der jeweiligen Spalte

Max. Linie

Wenn der gewünschte Datensatz nicht angezeigt wird, wechseln Sie in das Modul Liste und klicken anschließend auf den Tabellentitel, um die Tabelle in der Einzelansicht zu öffnen. Aktivieren Sie anschließend die Option Zwischenablage anzeigen am Seitenfuß. Wählen Sie dann in der Zwischenablage die Ebene Zwischenablage Nr.1 und klicken Sie, wie in Abbildung 5-3 gezeigt, auf das Bearbeitungssymbol im Kopf der Spalte mit den Kontrollkästchen. Sämtliche aufgelisteten Datensätze der jeweiligen Tabelle öffnen sich dann in der Bearbeitungsansicht.

5.6 Mehrere Datensätze gleichzeitig bearbeiten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 173

Max. Linie

Links Abbildung 5-3: Dieses Icon öffnet die aufgelisteten Datensätze

Diskussion Mit den oben genannten Bearbeitungsmöglichkeiten öffnen Sie alle Datensätze, die in der jeweiligen Ansicht sichtbar sind. Gerade bei umfangreichen Inhalten kann dies zu langen Ladezeiten und unübersichtlichen Eingabeformularen führen. Sie können TYPO3 auch so einrichten, dass nur eine bestimmte Anzahl von Datensätzen geöffnet wird, wenn Sie das Bearbeitungssymbol eines Datensatzes anklicken. Damit legen Sie fest, wie viele Datensätze sich öffnen, wenn Sie in der jeweiligen Spalte auf das Bearbeitungssymbol eines Datensatzes klicken. Standardmäßig wird nur ein Datensatz geöffnet, mit dieser Einstellung können Sie aber bis zu zehn aufeinander folgende Datensätze gleichzeitig bearbeiten. Geben Sie dazu folgenden TSconfig-Code in das Feld TSconfig der übergeordneten Seite ein:

Lizensiert für Markus Mueller

mod.web_layout { editFieldsAtATime = 5 }

Achten Sie darauf, dass Sie hierbei auf das Bearbeitungssymbol eines Datensatzes klicken und nicht – wie anfangs beschrieben – auf das Bearbeitungssymbol für die gesamte Spalte. Der Unterschied zur Option Diese Spalte bearbeiten liegt darin, dass Sie mit der oben genannten Einstellung Einfluss darauf haben, wie viele Datensätze sich ab dem gewählten Datensatz öffnen. Gerade bei zahlreichen Datensätzen ist dies von großem Vorteil.

Wenn Sie nur bestimmte Datensätze bearbeiten möchten, wechseln Sie in das Modul Liste. Klicken Sie anschließend auf den Tabellentitel, um die Einzelansicht der Tabelle zu öffnen. Aktivieren Sie nun die Option Zwischenablage anzeigen am Seitenfuß und dann in der Zwischenablage die Ebene Zwischenablage Nr.1. Daraufhin ändert sich die Listenansicht, und es erscheinen in jeder Zeile eines Datensatzes am rechten Rand Kontrollkästchen. Zusätzlich werden nun auch Ansichts-, Bearbeitungsund Verschiebesymbole angezeigt, mit denen Sie die einzelnen Datensätze bearbeiten könnten. Die Zwischenablage dient in diesem Fall nur dazu, die Kontrollkästchen zu aktivieren, und wird nicht weiter benötigt. In Rezept 5.4 erfahren Sie mehr über die Zwischenablage. Wählen Sie über die Kontrollkästchen die Datensätze aus, die Sie bearbeiten möchten. Klicken Sie dann auf das Bearbeitungssymbol im Kopf der Spalte mit den Kontrollkästchen. Dadurch öffenen sich die gewählten Datensätze in der Bearbeitungsansicht.

Max. Linie

Beachten Sie, dass Sie so nur die Datensätze aus einer Tabelle gleichzeitig bearbeiten können. Beispielsweise ist eine gleichzeitige Bearbeitung von Seiten und Seiteninhalten

174 | Kapitel 5: Inhalte verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

nicht möglich. In dem Fall müssen Sie den oben beschriebenen Weg für jede Tabelle einzeln durchführen. Wenn Sie Datensätze unterschiedlicher Tabellen oder Seiten bearbeiten möchten, gehen Sie wie folgt vor: Bearbeiten Sie den ersten Datensatz. Scrollen Sie an das Seitenende und klicken Sie dort auf das Symbol In neuem Fenster öffnen . Die Eingabemaske des aktuellen Datensatzes öffnet sich dann in einem neuen Pop-up-Fenster. Achten Sie darauf, dass Sie Ihren Browser wie in Rezept 3.1 eingerichtet haben und kein Pop-up-Blocker aktiv ist bzw. Pop-ups von der aktuellen Domain erlaubt sind. Wechseln Sie dann wieder zurück in das Hauptfenster. Wählen Sie dort den anderen Datensatz aus und klicken Sie auch hier auf das Icon, sodass die Bearbeitungsmaske dieses Datensatzes ebenso in einem neuen Fenster geöffnet wird. Bringen Sie nun die beiden Fenster in den Vordergrund und platzieren Sie sie nebeneinander. So können Sie die Inhalte direkt vergleichen und bearbeiten. Um die Bearbeitung abzuschließen, klicken Sie auf das Icon Speichern und schließen. Die neuen Inhalte werden nun in die Datenbank übernommen, und das Fenster wird geschlossen.

Siehe auch Lizensiert für Markus Mueller

In Rezept 5.7 erfahren Sie, wie Sie mit der Zwischenablage mehrere Datensätze gleichzeitig löschen.

5.7

Einen oder mehrere Datensätze löschen

Problem Sie möchten nicht benötigte Inhalte von der Seite löschen oder veraltete Datensätze entfernen, um die Übersichtlichkeit zu erhöhen.

Lösung TYPO3 bietet Ihnen über die beiden Module Seite und Liste mehrere Möglichkeiten zum Löschen von Inhalten. Über das Modul Seite können Sie Inhalte sehr intuitiv löschen, da der Seiteninhalt je nach Inhaltsspalte und Position angezeigt wird. Im Modul Liste können Sie hingegen sehr effektiv löschen, da die Inhalte übersichtlich untereinander aufgelistet werden.

Max. Linie

Um Inhalte über das Modul Seite zu löschen, wählen Sie zuerst das entsprechende Modul und danach die Seite aus, aus der Sie Inhalte löschen möchten. Klicken Sie dann in der Kopfzeile des jeweiligen Inhaltselements auf das Papierkorbsymbol und bestätigen Sie die anschließende Sicherheitsfrage (alternativ dazu erreichen Sie den Befehl zum Löschen auch über das Kontextmenü, indem Sie auf das Symbol des Inhaltselements klicken).

5.7 Einen oder mehrere Datensätze löschen | 175 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Oft werden nicht mehr benötigte Inhaltselemente ausgeblendet, um sie bei Bedarf wieder anzuzeigen. Standardmäßig sind diese versteckten Inhalte im Modul Seite jedoch ausgeblendet. Achten Sie beim Arbeiten im Modul Seite darauf, dass Sie am Ende der Seite die Option Zeige verborgene Inhalte an aktiviert haben. Eine weitere Besonderheit des Seitenmoduls ist es, dass Datensätze von eigenen Extensions dort standardmäßig nicht angezeigt werden. Um eigene Datensätze zu löschen, müssen Sie daher in das Listenmodul wechseln.

Links

Über das Modul Liste löschen Sie Datensätze über das Kontextmenü, das Sie mit einem Mausklick auf das Symbol des jeweiligen Datensatzes aufrufen. Zusätzlich können Sie diese Löschfunktion noch schneller aufrufen, indem Sie die Bearbeitungsleiste einblenden. Aktivieren Sie dazu die Option Erweiterte Ansicht, die Sie am Seitenende finden. Daraufhin erscheint das Papierkorb-Icon in jeder Zeile, und Sie können den Löschbefehl direkt aufrufen.

Lizensiert für Markus Mueller

Um mehrere Datensätze gleichzeitig zu löschen, richten Sie sich die Zwischenablage wie in Rezept 5.4 beschrieben ein. Wählen Sie die erste Zwischenablage unterhalb der Ebene Normal. Daraufhin wird die Listenansicht neu geladen. Wählen Sie dann über die Kontrollkästchen die gewünschten Datensätze aus. Mit dem Schalter Alles/nichts markieren wählen Sie mit einem Klick sämtliche Kontrollkästchen der jeweiligen Tabelle aus, was vor allem bei umfangreichen Datenbeständen sehr vorteilhaft ist. Klicken Sie dann das in Abbildung 5-4 gezeigte Löschen-Symbol in der rechten Bearbeitungsspalte an und bestätigen Sie abschließend den Löschvorgang.

Abbildung 5-4: Mit diesem Icon löschen Sie mehrere ausgewählte Datensätze

Standardmäßig werden in der Übersicht nur 30 Datensätze angezeigt. Um die Auswahlmöglichkeit zu erweitern, bietet sich die Detailansicht der Tabelle an. Dort können Sie 50 Datensätze gleichzeitig auswählen (in Rezept 7.6 erfahren Sie, wie Sie die Anzahl der Elemente im Listenmodul erhöhen können). Beachten Sie, dass Sie über diese Option nur Datensätze einer Tabelle gleichzeitig löschen können, sodass Sie den Löschvorgang für jede Tabelle entsprechend oft wiederholen müssen. Wenn Sie Seiten löschen, werden auch sämtliche Seiteninhalte gelöscht. Seiten mit Unterseiten können Sie aus Sicherheitsgründen nur dann löschen, wenn Sie die Option Rekursives Löschen(!) in den Benutzereinstellungen aktivieren. Wechseln Sie dazu in das Modul Einstellungen. Dort finden Sie in dem Bereich Erweiterte Funktionen die Option Rekursives Löschen(!). Aktivieren Sie dieses Feld und speichern Sie die Daten über den Button Konfiguration sichern.

Max. Linie

Max. Linie 176 | Kapitel 5: Inhalte verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Rechts

Das Ausrufezeichen im Titel der Option symbolisiert, dass Sie diese Option nicht leichtfertig aktivieren sollten. Wir empfehlen Ihnen sogar ausdrücklich, diese standardmäßig per Benutzer-TSconfig-Anweisung für alle Benutzer zu deaktivieren. Um diese Einstellung vorzunehmen, benötigen Sie Administratorrechte. Wechseln Sie dazu in das Modul Liste und wählen Sie die Wurzelseite des Seitenbaums aus. Dort finden Sie unterhalb von Backend Benutzer sämtliche Backend-Benutzer. Bearbeiten Sie die gewünschten Benutzer und geben Sie folgenden TSconfig-Code in das Feld TSconfig ein: setup.override { recursiveDelete = 0 }

Alternativ dazu können Sie diesen Code auch in das Feld TSconfig einer Backend Benutzergruppe schreiben. Die Option wird dann für alle Mitglieder dieser Gruppe standardmäßig deaktiviert. Es sei nochmals betont, dass Sie diese Option nur mit äußerster Vorsicht aktivieren sollten. Eine weitere Möglichkeit zum Entfernen von Inhalten besteht darin, in den Seitenbaum eine Seite vom Typ Papierkorb zu integrieren. Wenn Sie nun Datensätze aus dem regulären Seitenbaum entfernen möchten, brauchen Sie diese Inhalte lediglich in den Papierkorb zu verschieben. Sie sind dann nicht mehr von außen erreichbar, können jedoch jederzeit wieder verwendet oder hergestellt werden. Lizensiert für Markus Mueller

Diskussion Wenn Sie im TYPO3-Backend Daten löschen, werden diese vorerst nicht direkt aus der Datenbank entfernt, sondern lediglich als gelöscht markiert, sodass sie im Backend nicht mehr auftauchen. Damit ist sichergestellt, dass die Daten zu jedem Zeitpunkt wiederhergestellt werden können. Diese Einstellung dient der Sicherheit Ihrer Daten, denn wenn diese direkt aus der Datenbank entfernt werden, lassen sie sich nicht mehr herstellen. Manchmal ist es jedoch sinnvoll, Inhalte über die Lösch-Funktion direkt aus der Datenbank zu entfernen, beispielsweise wenn Sie sensible Daten verwalten, die nach dem Löschen auch umgehend aus der Datenbank entfernt werden müssen, um sie vor möglichen Zugriffen zu schützen. Ändern Sie dazu das TCA der jeweiligen Tabelle, indem Sie im ctrl-Bereich der Eigenschaft delete einen leeren Wert zuweisen. Anhand des Werts delete ermittelt TYPO3 das Feld, mit dem der Datensatz als gelöscht markiert wird. Wenn Sie diesen Wert leer lassen, nimmt TYPO3 an, dass es kein Feld gibt, mit dem der Datensatz als gelöscht markiert wird, und führt den Löschvorgang direkt aus. Um beispielsweise Seiteninhalte sofort zu löschen, geben Sie folgenden Code in die Datei ext_tables.php ein: $TCA['tt_content']['ctrl']['delete'] = '';

Max. Linie

Vermeiden Sie es unter allen Umständen, Datensätze direkt über eigene SQL-Befehle in der Datenbank zu löschen. TYPO3 erzeugt beispielsweise für Übersetzungen und zur Versionierung – besonders in Verwendung mit Workspaces – Relationen, die über das Backend nicht direkt nachzuvollziehen sind und ein sehr tiefes Verständnis für die internen Abläufe

5.7 Einen oder mehrere Datensätze löschen | 177 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

von TYPO3 erfordern. Sie müssten dann in Ihren SQL-Befehlen darauf achten, dass Sie Datensätze auch löschen, und laufen dadurch Gefahr, Ihre Datenbank mit inkonsistenten Daten zu füllen, die unnötig Speicherplatz kosten und nachhaltig Ihre Datenarchitektur zerstören können. Löschen Sie Ihre Inhalte daher immer über die Löschfunktionen im TYPO3-Backend. Dort werden Ihre Daten über die sogenannte TYPO3 Core Engine (TCE) verwaltet, die beispielsweise alle Datenbankinteraktionen überwacht und die notwendigen Querverknüpfungen und Tabelleneigenschaften berücksichtigt. Dadurch stellen Sie sicher, dass Ihre Daten stets konsistent bleiben.

Links

Siehe auch Rezept 5.9 beschreibt, wie Sie gelöschte Daten wiederherstellen können, wenn diese versehentlich über die TYPO3-Oberfläche gelöscht wurden. In Rezept 5.10 erfahren Sie, wie Sie Sicherheitskopien Ihrer Inhalte anlegen.

5.8

Dateien oder Ordner verschieben oder löschen

Problem Lizensiert für Markus Mueller

Sie möchten Dateien oder Ordner umstrukturieren oder aus dem Dateisystem entfernen.

Lösung Im Modul Dateiliste verschieben Sie Dateien, indem Sie auf das jeweilige Symbol der Datei klicken und dort den Eintrag Ausschneiden auswählen. Klicken Sie danach auf den gewünschten Zielordner und wählen Sie im Kontextmenü des Ordners den Eintrag Einfügen in. Nachdem Sie die Aktion im darauf folgenden Dialog bestätigt haben, wird die Datei in den gewünschten Ordner verschoben. Möchten Sie die Datei löschen, wählen Sie anstatt Ausschneiden die Option Löschen. Falls Sie eine Fehlermeldung erhalten, die Ihnen sagt, dass diese Aktion nicht erlaubt ist, sollten Sie überprüfen, ob in Ihrem Backend-Benutzerprofil unterhalb von Fileoperation permissions die Option Files: Upload,Copy,Move,Delete,Rename,New,Edit aktiv ist. Um Backend-Benutzerprofile zu bearbeiten, benötigen Sie administrative Rechte. Mit folgenden Schritten kontrollieren Sie die Einstellung: Wechseln Sie in das Modul Liste und wählen Sie die Wurzelseite Ihrer TYPO3-Installation aus. Öffnen Sie dann in der Tabelle Backend Benutzer das Benutzerprofil und überprüfen Sie im Bereich Fileoperation permissions die Auswahl (beachten Sie, dass Sie diese Änderung über das Eingabeformular des Backend-Benutzers tätigen und die Optionen nicht in den Benutzereinstellungen suchen).

Max. Linie

Ganze Ordner verschieben Sie folgendermaßen: Klicken Sie auf das jeweilige Symbol des Ordners und halten Sie die Maustaste gedrückt. Ziehen Sie es dann auf das Symbol eines

178 | Kapitel 5: Inhalte verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

anderen Ordners. Lassen Sie die Maustaste los. Daraufhin erscheint ein Kontextmenü, in dem Sie wählen können, wohin Sie den Ordner verschieben möchten. Nachdem Sie diese Auswahl getroffen haben, wird der Ordner verschoben. Wenn Sie ganze Ordner verschieben oder entfernen möchten, sollten Sie darauf achten, dass Sie in Ihrem Benutzerprofil auch die Option Directory: Move, Delete,Rename,New aktivieren, da diese Option standardmäßig deaktiviert ist.

Diskussion Die anfangs beschriebenen Methoden erlauben das schnelle Verschieben von ganzen Ordnern und den darin enthaltenen Dateien. Im Folgenden erfahren Sie, wie Sie die Ordner und Dateien auf eine bestimmte Auswahl begrenzen und schnell verschieben können. Um diese Bearbeitungsaktionen auf mehreren Dateien und Ordner anzuwenden, aktivieren Sie, wie in Abbildung 5-5 gezeigt, die Option Zwischenablage anzeigen.

Lizensiert für Markus Mueller

Abbildung 5-5: Mit dieser Option aktivieren Sie die Zwischenablage im Dateimodul

Wählen Sie anschließend eine freie Zwischenablage unterhalb der Ebene Normal, etwa Zwischenablage Nr.1. Dort können Sie nun die gewünschten Dateien und Ordner ablegen. In jeder Zeile der Dateiliste erscheinen nun Kontrollkästchen, mit denen Sie Dateien auswählen können. Mit dem Icon Alles/nichts markieren aktivieren Sie alle sichtbaren Kontrollkästchen. Mit dem Button Ausgewählte Dateien auf die Zwischenablage transferieren legen Sie diese Auswahl dann in die ausgewählte Zwischenablage. Danach erscheint hinter den Kontrollkästchen eine weitere Grafik. Indem Sie diese anklicken, verschieben Sie den Inhalt der aktiven Zwischenablage direkt in einen Unterordner. Wenn Sie den Inhalt der Zwischenablage in einen übergeordneten Ordner legen möchten, gehen Sie wie folgt vor: Wechseln Sie über den Ordnerbaum in den gewünschten Ordner und klicken Sie auf das in Abbildung 5-6 gezeigte Icon.

Abbildung 5-6: Über dieses Symbol fügen Sie den Inhalt einer Zwischenablage in den aktuellen Ordner ein

Max. Linie

Um mehrere Dateien gleichzeitig zu löschen, wählen Sie die jeweiligen Elemente über die Kontrollkästchen aus und klicken anschließend, wie in Abbildung 5-7 gezeigt, auf das

5.8 Dateien oder Ordner verschieben oder löschen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 179

Max. Linie

Symbol Markierte löschen. Nachdem Sie diese Aktion bestätigt haben, werden die Elemente gelöscht.

Links

Abbildung 5-7: Mit diesem Symbol löschen Sie die ausgewählten Elemente

Möchten Sie in den Löschaktionen auch Unterordner berücksichtigen, sollten Sie die Option Directory: Delete recursively (rm -Rf) in Ihrem Benutzerprofil aktivieren. Die Anmerkung rm -Rf verdeutlicht die Auswirkung dieser Option anhand des entsprechenden Unix-Befehls. Ist diese Option aktiviert, können ganze Ordnerstrukturen auf einmal entfernt und Daten unwiederbringlich gelöscht werden. Sie sollten diese Option daher nur mit äußerster Vorsicht aktivieren und sich darüber bewusst sein, welche Auswirkungen diese haben kann.

Lizensiert für Markus Mueller

Als Schutz vor ungewolltem Löschen sollten Sie einen Ordner vom Typ Recycler anlegen. In diesem Ordner sammelt TYPO3 automatisch alle gelöschten Dateien und Ordner, sodass diese – etwa nach einem versehentlichen Löschvorgang – leicht wiederhergestellt werden können. Gerade bei umfangreichen Datenbeständen kann sich dieser Ordner jedoch schnell mit Daten füllen und muss daher in regelmäßigen Abständen geleert werden. Um diesen Ordner anzulegen, erstellen Sie über das Kontextmenü einen neuen Ordner und geben diesem den Namen _recycler_. Anhand dieses Titels wandelt TYPO3 den Ordner automatisch in den gewünschten Recycler um, der sich durch ein spezielles Icon von den anderen Ordnern unterscheidet.

Siehe auch In Rezept 5.5 erfahren Sie, wie Sie die Anzahl der Zwischenablagen für jeden Benutzer individuell erweitern können. Details zum Befehl rm finden Sie auf http://de.wikipedia.org/ wiki/Rm_(Unix).

5.9

Gelöschte Inhalte wiederherstellen

Problem Sie haben beim Arbeiten im Backend versehentlich Seiten oder deren Inhalte gelöscht, die Sie wiederherstellen möchten.

Max. Linie

Lösung Machen Sie die Aktion über das Verlaufsprotokoll rückgängig.

180 | Kapitel 5: Inhalte verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Wenn Sie beim Bearbeiten eines Datensatzes versehentlich gespeichert haben und dadurch Inhalte gelöscht oder überschrieben wurden, können Sie den letzten Bearbeitungsschritt über das Symbol Letzte Änderung zurücknehmen in der Funktionspalette rückgängig machen. Dieses Symbol finden Sie ganz rechts in der Bearbeitungsmaske eines Datensatzes. Beachten Sie, dass TYPO3 nur Änderungen speichert, wenn Sie das Inhaltselement abspeichern. Die Änderungen werden also nur durch Speichern übernommen. Bemerken Sie also während Ihrer Arbeit an dem Datensatz, dass Sie Inhalte aus Versehen gelöscht haben, schließen Sie den Datensatz und öffnen ihn erneut. Ihre vorherigen Änderungen werden dadurch wieder zurückgesetzt. Zusätzlich dazu zeichnet TYPO3 ein ausführliches Verlaufsprotokoll auf, in dem TYPO3 standardmäßig die Änderungen der letzten 20 Arbeitsschritte innerhalb des letzten Monats speichert. Dieses ausführliche Verlaufsprotokoll erreichen Sie am schnellsten über das Kontextmenü der Seite, in der Sie den Löschvorgang durchgeführt haben. Wählen Sie dort die Option Erstellungsverlauf/Rückgängig machen.

Lizensiert für Markus Mueller

Wenn Ihnen das Kontextmenü nicht zur Verfügung steht, wechseln Sie in das Modul Liste und wählen die Seite aus, in der Sie die Inhalte oder Unterseiten gelöscht haben. Aktivieren Sie am Seitenende die Option Erweiterte Ansicht und klicken Sie anschließend auf das Icon Änderungsverlauf anzeigen/ Rückgängig (in Rezept 5.1 erfahren Sie mehr über die restlichen Icons und deren Funktionen).

Daraufhin sehen Sie in einer tabellarischen Gegenüberstellung die Änderungen, die seit dem Erstellen des Datensatzes vollzogen wurden, sowie Informationen über den Autor und den Zeitpunkt der Änderung. So gehen Sie dann weiter vor: • Stellen Sie zunächst sicher, dass Sie für die Option Einträge anzeigen eine ausreichende Anzahl angegeben haben. • Stellen Sie außerdem sicher, dass die Optionen Zeige Unterelemente und Zeige eingefügte/gelöschte Datensätze aktiv sind. • Suchen Sie in der Spalte Unterschiede den Wert löschen und kontrollieren Sie über die Spalte Tabelle:Uid, ob dies der gewünschte Datensatz ist. • Klicken Sie nun auf das linke Icon Rückgängig machen (Vorschau), um das Verlaufsprotokoll dieses Datensatzes aufzurufen. Danach widerrufen Sie mit einem Klick auf das Icon Alle gezeigten Änderungen rückgängig machen die Löschaktion. Der Datensatz wird danach wieder in der ursprünglichen Version angezeigt.

Diskussion

Max. Linie

Wenn Sie im TYPO3-Backend Daten löschen, werden diese standardmäßig nicht direkt aus der Datenbank entfernt, sondern lediglich als gelöscht markiert und dadurch im Backend ausgeblendet. Vermeintlich gelöschte Daten können daher zu jedem Zeitpunkt

5.9 Gelöschte Inhalte wiederherstellen | 181 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

wiederhergestellt werden. Im Backend tauchen diese Datensätze jedoch nicht mehr auf. Zudem speichert TYPO3 standardmäßig für Seiten und Seiteninhalte ein Änderungsprotokoll, anhand dessen Sie Änderungen auch für einzelne Felder verfolgen können.

Links

TYPO3 speichert die letzten 20 Arbeitsschritte in dem Verlaufsprotokoll. Der älteste Eintrag ist dabei maximal einen Monat alt. Diese Standardeinstellungen können Sie über TSconfig-Angaben für jede Seite individuell anpassen. Da diese Einstellungen in den Seiteneigenschaften gespeichert werden, wirken sie sich automatisch auf alle Unterseiten und deren Inhalte aus. Um das Verlaufsprotokoll beispielsweise für einen Seitenbaum auf 30 Einträge zu erhöhen, öffnen Sie die Seiteneigenschaften der ersten Seite und geben in das Feld TSconfig folgenden Code ein: TCEMAIN { default.history.keepEntries = 30 }

Zusätzlich können Sie das Verlaufsprotokoll auch für einzelne Tabellen einstellen, indem Sie den Code nach folgendem Muster erweitern: TCEMAIN { default.history.keepEntries = 30 table.tabellen_name.history.keepEntries = 20 } Lizensiert für Markus Mueller

Um beispielsweise das Verlaufsprotokoll für Seiten und Seiteninhalte anzupassen, ändern Sie den Tabellennamen einmal für Seiten in pages und für Seiteninhalte in tt_content. Der entsprechende TSconfig-Code sieht dann folgendermaßen aus: TCEMAIN { default.history.keepEntries = 10 table.pages.history.keepEntries = 20 table.tt_content.history.keepEntries = 30 }

Eine Übersicht der gebräuchlichsten Tabellennamen finden Sie in Rezept 4.6 (beachten Sie, dass nicht alle Tabellen ein Verlaufsprotokoll besitzen). Achten Sie auch darauf, dass die zuvor genannten Einstellungen immer abhängig davon sind, wie alt die Protokolldaten sein dürfen. Standardmäßig dürfen die Einträge höchstens 30 Tage alt sein. Diese Einstellung können Sie über folgenden TSconfig-Code anpassen: TCEMAIN { history.maxAgeDays = 7 }

Max. Linie

Geben Sie hier eine 0 an, werden die Protokolldaten für ein Jahr bereitgestellt. Beachten Sie, dass die Protokolldaten zusätzlich zu den vorhandenen Datensätzen in der Datenbank gespeichert werden und dadurch natürlich auch deren Größe entsprechend stark zunimmt. Kalkulieren Sie diesen Zuwachs daher in Ihren Speicherplatz mit ein, bevor Sie diese Einstellungen ändern. Gerade bei umfangreichen Inhalten können dadurch sehr große Datenmengen entstehen, daher sollten Sie die Einstellungen nicht leichtfertig erhöhen.

182 | Kapitel 5: Inhalte verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Trotz der Möglichkeit, die Daten über das Verlaufsprotokoll wiederherstellen zu können, ist dieser Vorgang auf Dauer doch recht mühsam und zeitaufwendig. Eine ganz andere Art, Inhalte zurückzuholen, ist, das Löschen von Datensätzen erst gar nicht zu erlauben und diese stattdessen auszublenden. Zusätzlich gibt es die Möglichkeit, die Löschoptionen in der Aktionsleiste über folgendes Benutzer-TSconfig auszublenden: options { disableDelete = 1 }

Damit blenden Sie die Funktion Datensatz löschen in der Aktionspalette aus. Abbildung 5-8 verdeutlicht die Auswirkungen dieser TSconfig-Einstellungen: Zu sehen ist die Aktionspalette vor und nach dem Ausblenden der Funktion.

Abbildung 5-8: Die Löschoption können Sie über das Benutzer-TSconfig ausblenden

Möchten Sie das Löschen nur bei bestimmten Tabellen erlauben, erreichen Sie das mit folgendem Code: Lizensiert für Markus Mueller

options { disableDelete = 1 disableDelete.tabellen_name = 0 }

Um die Option Löschen aus dem Kontextmenü zu entfernen, fügen Sie unterhalb des oben genannten Codes noch folgende Zeilen ein: options.contextMenu { pageTree.disableItems = delete pageList.disableItems = delete }

Eine andere Möglichkeit, das Löschen von Datensätzen zu unterbinden, steht Ihnen auch über die Seitenrechte zur Verfügung. Wechseln Sie dazu in das Modul Zugriff und wählen Sie in der Auswahlliste in der rechten oberen Ecke die Option Rechte. Wählen Sie nun über den Seitenbaum die Seite aus, deren Rechte Sie bearbeiten möchten. Wollen Sie die Zugriffsrechte der Unterseiten ebenfalls ändern, können Sie über die Auswahlliste Tiefe die Ebenen einstellen, auf die Ihre Aktion angewendet wird. Der Seitenbaum zeigt Ihnen stets die Seiten, deren Rechte Sie nun im Folgenden einstellen können.

Max. Linie

Klicken Sie jetzt auf das Bearbeitungssymbol Bearbeite Rechte der obersten Seite, um die Rechte anzupassen. Wählen Sie über die Auswahllisten Besitzer und Gruppe die jeweiligen Backend-Benutzer bzw. -Benutzergruppen, die Zugriff auf diese Seite haben dürfen. Mit den einzelnen Kontrollkästchen unterhalb von Rechte geben Sie dann die jeweiligen Zugriffsrechte an. Mit den Kontrollkästchen im Bereich Alle können Sie getrennt von der oberen Auswahl die Zugriffsrechte für sämtliche Backend-Benutzer einstellen.

5.9 Gelöschte Inhalte wiederherstellen | 183 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

In der Praxis hat sich auch eine Seite vom Seitentyp Papierkorb bewährt. Diese Seite wird allgemein sichtbar in den Seitenbaum integriert, sodass sämtliche Datensätze hierhin verschoben werden können, die im regulären Seitenbaum nicht mehr benötigt werden. Datensätze, die in diesem Papierkorb liegen, sind von außen für Website-Besucher nicht mehr erreichbar, können jedoch jederzeit problemlos wiederhergestellt werden, indem sie zurück in den Seitenbaum geschoben werden.

Links

Beachten Sie, dass TYPO3 in dem Fall nicht zwischen verschieben und löschen unterscheidet, da das Verschieben in den Papierkorb einem Löschen in der ursprünglichen Seite gleichkommt. Das bedeutet, dass ein Backend-Benutzer für die jeweilige Seite das Recht Bearbeite Inhalt benötigt, um Seiteninhalte in den Papierkorb zu legen, und Lösche Seite, damit er Seiten in den Papierkorb verschieben kann. Wenn mehrere BackendBenutzer in Ihrer TYPO3-Installation arbeiten, sollten Sie die Verwendung des Papierkorbs entsprechend deutlich kommunizieren und die vorhandenen Löschoptionen über die oben genannten Einstellungen weitestgehend ausblenden.

5.10 Inhalte lokal sichern Lizensiert für Markus Mueller

Problem Sie möchten die Inhalte in Ihrer TYPO3-Installation sichern, beispielsweise um regelmäßig eine Sicherheitskopie des Seitenbaums zu erstellen, die Sie bei Bedarf wieder in Ihre TYPO3-Installation einspielen können.

Lösung Verwenden Sie die Import-/Exportfunktion von TYPO3. Damit können Sie ganze Seitenbäume exportieren und als spezielle TYPO3-Datenpakete auf Ihrer Festplatte speichern. Bei Bedarf können Sie diese Dateien dann wieder über die Importfunktion einspielen (die Importfunktion wird in Rezept 5.11 beschrieben) und Inhalte wiederherstellen oder aktualisieren. Um die Exportfunktion aufzurufen, wechseln Sie in das Modul Seite und wählen die Seite bzw. den Startpunkt des Seitenbaums, den Sie exportieren möchten. Klicken Sie dazu auf das Icon der Seite und wählen Sie im Kontextmenü die Option Weitere Einstellungen. Dort finden Sie die Option Exportieren in .t3d. Nach einem Klick darauf öffnet sich im rechten Bearbeitungsbereich die Konfigurationsoberfläche der Exportfunktion. Die Oberfläche des Exportmoduls ist in mehrere Bereiche aufgeteilt. Wichtig für den Export sind vor allem die Bereiche Konfiguration sowie Datei & Voreinstellungen.

Max. Linie

Im Bereich Konfiguration legen Sie allgemeine Einstellungen zum Umfang des Exports fest und bestimmen, aus welchen Datensätzen sich die spätere Exportdatei zusammensetzt, wie tief TYPO3 im Seitenbaum nach welchen Datensätzen sucht und welche Querverbindungen dabei berücksichtigt werden sollen. Wichtig ist hier, dass Sie die Einstellung Ebe-

184 | Kapitel 5: Inhalte verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

nen anpassen. Standardmäßig exportieren Sie nur die gewählte Seite. Mit dieser Option können Sie ganze Seitenbäume exportieren. Wir empfehlen Ihnen, die Option Unendlich zu wählen. Nachdem Sie die Auswahl mit Aktualisieren bestätigt haben, wird TYPO3 den gesamten Seitenbaum unterhalb der gewählten Seite beim Export berücksichtigen. Wechseln Sie jetzt in den Bereich Datei & Voreinstellungen und klicken Sie auf Exportdatei herunterladen. TYPO3 packt die Daten nun in ein spezielles, komprimiertes Format und liefert die fertige Datei an den Browser aus. Speichern Sie diese Datei auf Ihrer lokalen Festplatte.

Diskussion Der Export von Seiten und deren Inhalten ist einer der am häufigsten vorkommenden Anwendungsfälle. Standardmäßig werden sämtliche Datensätze in dem Seitenbaum exportiert. Inhalte mehrerer TYPO3-Instanzen können dadurch einfach und schnell ausgetauscht und aktualisiert werden. Jedoch ist es bei häufigen Exportvorgängen recht mühsam, immer wieder die gleichen Einstellungen vorzunehmen.

Lizensiert für Markus Mueller

Wenn Sie regelmäßig Inhalte sichern möchten, können Sie Ihre Exporteinstellungen als Voreinstellung speichern. Diese Einstellungen laden Sie dann zu einem späteren Zeitpunkt über den Button Laden wieder in das Exportmodul ein (zusätzlich können Sie die Voreinstellung über das Modul Aufgaben aufrufen und dort den Import direkt durchführen). Um die Voreinstellungen abzuspeichern, wechseln Sie in den Bereich Datei & Voreinstellungen und geben unter Ausgabeoptionen einen aussagekräftigen Titel und eine Beschreibung ein. Außerdem können Sie eine Anmerkung anbringen, die zum Beispiel für interne Notizen genutzt werden kann. Geben Sie nun einen Namen für die Voreinstellung ein. Der Name sollte möglichst sprechend sein. In der Praxis hat sich bewährt, hier auch wieder den Titel zu verwenden, den Sie bereits für die Exportvoreinstellungen angegeben haben. Klicken Sie abschließend auf den Button Speichern und bestätigen Sie den Speichervorgang. In der Auswahlliste erscheint nun Ihre neue Voreinstellung. Wenn Sie diese Einstellung nun wählen und laden, werden alle Ihre vorherigen Angaben wiederhergestellt. Diese Daten werden dann auch beim Import in der Vorschau angezeigt. Die Inhalte können dadurch noch einfacher und bequemer ausgetauscht werden. Was aber, wenn Sie nur bestimmte Datensätze austauschen, aktualisieren oder exportieren möchten?

Max. Linie

Hierfür gibt es im Bereich Konfiguration die Auswahlliste Einzuschließende Tabellen, mit der Sie den Export auf einzelne Tabellen begrenzen können. Möchten Sie zum Beispiel nur Seiteninhalte exportieren, wählen Sie den Eintrag tt_content und bestätigen die Auswahl mit dem Button Aktualisieren. In der Vorschau des Seitenbaums sind nun nur noch Seiteninhalte zu finden.

5.10 Inhalte lokal sichern | 185 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Eine weitere – etwas versteckte – Möglichkeit, nur bestimmte Datensätze zu exportieren, bietet die Zwischenablage. Der Export funktioniert standardmäßig über die Relationen zur Seite. Es kann jedoch auch vorkommen, dass Sie nur einzelne Inhaltselemente oder andere Datensätze exportieren möchten. Gehen Sie hierzu folgendermaßen vor: Wechseln Sie in das Modul Liste und fügen Sie ein oder mehrere Datensätze in die Zwischenablage ein (diese Schritte werden ausführlich in Rezept 5.4 beschrieben). Wählen Sie anschließend aus der Auswahlliste die Option Export. Danach öffnet sich die gewohnte Exportoberfläche, auf der Sie wie immer Ihre Einstellungen vornehmen können.

Links

Weiterhin können Sie beeinflussen, wie TYPO3 auf Verknüpfungen zu Dateien oder Extensions eingeht. Standardmäßig werden alle Datensätze, die in dem gewählten Seitenbaum liegen, beim Export berücksichtigt. Wenn Sie jedoch innerhalb dieses Seitenbaums auf Datensätze außerhalb des Seitenbaums verweisen, zum Beispiel indem Sie Links auf Seiten oder TypoScript-Templates außerhalb des Seitenbaums verwenden, werden diese Verknüpfungen beim Export ignoriert und gehen verloren. Sie erhalten dann lediglich den Hinweis, dass die Relationen nicht aufgelöst werden konnten.

Lizensiert für Markus Mueller

Bei einem Import in eine neue, leere TYPO3-Installation könnten die Relationen dann nicht wiederhergestellt werden, oder TYPO3 findet eine andere Seite mit der gleichen ID und stellt dann »falsche« Relationen her, die nicht sinngemäß sind. Wenn Sie jedoch die Querverlinkungen zu anderen Datensätzen berücksichtigen möchten, müssen Sie in der Liste Relationen zu Tabellen einschließen die jeweiligen Tabellen auswählen. TYPO3 löst daraufhin die Relation auf und berücksichtigt auch diese Datensätze beim Export, obwohl Sie sie nicht direkt ausgewählt haben. Dadurch ist sichergestellt, dass beim Import die Relationen aufrechterhalten werden können. Wenn Sie die Struktur in eine neue Struktur importieren möchten, können Sie die Relationen zu den alten Seiten auch ignorieren und den Export so gestalten, dass beim Import eine neue Seite ausgewählt werden kann. Wählen Sie dazu in dem dargestellten Seitenbaum aus der Auswahlliste den Wert Editierbar. Beim Import erscheint dann für diese Relation ein Eingabefeld, in das Sie die neue ID bzw. einen neuen Wert für die Relation eingeben können. Im Bereich Erweiterte Einstellungen können Sie zusätzlich angeben, inwiefern TYPO3 auf Abhängigkeiten zu bestimmten Extensions reagieren soll. Diesen Bereich müssen Sie nur beachten, sofern Sie auf dem Zielsystem bzw. beim Wiedereinspielen der Daten bestimmte Extensions voraussetzen müssen. Wenn Sie hier Extensions festlegen und diese beim Import nicht vorhanden sind, wird TYPO3 Sie auffordern, diese vor dem Import zu installieren. Dadurch wird sichergestellt, dass alle importierten Daten ordnungsgemäß dargestellt werden können.

Max. Linie

Bevor Sie den Export abschließen, sollten Sie einen letzten kontrollierenden Blick auf den Bereich Meldungen werfen. Wenn Sie dort vom Exportmodul Meldungen erhalten, sollten Sie nochmals die Exporteinstellungen kontrollieren. Sind keine Meldungen zu sehen, können Sie nun in den Abschnitt Datei & Voreinstellungen wechseln. Klicken Sie abschließend

186 | Kapitel 5: Inhalte verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

auf den Button Exportdatei downloaden. Der gewünschte Seitenbaum wird dann samt Inhalt in einer komprimierten Datei zum Download angeboten, die Sie auf Ihrer lokalen Festplatte speichern können. Alternativ können Sie die Datei auch auf dem Webserver im Verzeichnis fileadmin speichern. Klicken Sie dazu auf den Button Speichern als. Darauf erfolgt die Meldung Datei gespeichert am oberen linken Seitenrand. Die Datei wird dann mit Ihren Einstellungen und den Informationen über die enthaltenen Datensätze auf Ihrer Festplatte abgelegt.

Siehe auch In Rezept 2.9 erfahren Sie, wie Sie eine vollständige Sicherungskopie der gesamten TYPO3-Installation erstellen und welche Schritte dazu nötig sind. Um diese Funktion nutzen zu können, benötigen Sie die Extension extra_page_cm_options für die zweite Optionspalette sowie die Extension imexp für die eigentliche Importfunktion. Beide Extensions sind standardmäßig in jeder TYPO3-Installation enthalten. Falls eine dieser Extensions noch nicht vorhanden ist, können Sie die Installation über den ErweiterungsManager nachholen – stellen Sie dabei sicher, dass Sie die Option Display shy extensions aktiviert haben. Lizensiert für Markus Mueller

5.11 Inhalte zwischen unterschiedlichen TYPO3Instanzen austauschen Problem Sie möchten Inhalte von einer TYPO3-Installation schnell in eine andere kopieren.

Lösung Verwenden Sie die Import-/Exportfunktion von TYPO3 wie in Rezept 5.10 beschrieben. Die so erzeugte Datei können Sie über dasselbe Modul wieder einspielen. Um die exportierten Inhalte wieder in Ihre TYPO3-Installation zurückzuschreiben, klicken Sie auf die Seite, in die Sie die Daten importieren möchten, und wählen im Kontextmenü die Option Weitere Einstellungen. Klicken Sie dort auf die Option Importieren aus .t3d. Daraufhin öffnet sich im rechten Bearbeitungsbereich die Konfigurationsoberfläche der Importfunktion.

Max. Linie

Wenn Sie die Exportdatei auf Ihrer lokalen Festplatte gespeichert haben, müssen Sie diese nun im ersten Schritt im Bereich Upload auf den Webserver laden. TYPO3 speichert diese Datei dann im Ordner fileadmin. Ansonsten muss sich die Datei schon im Verzeichnis fileadmin befinden. Danach erscheint sie in der Auswahlliste Importdatei aus-

5.11 Inhalte zwischen unterschiedlichen TYPO3-Instanzen austauschen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 187

Max. Linie

wählen. Wählen Sie diese Datei nun aus dieser Auswahlliste aus und klicken Sie anschließend auf Vorschau. Kontrollieren Sie im Abschnitt Meldungen, ob TYPO3 eventuell Fehler gefunden hat. Erst danach sollten Sie den Import durchführen, da die Daten ansonsten möglicherweise unvollständig importiert werden. Wenn Sie zufrieden mit der Vorschau sind, können Sie den Schreibvorgang mit dem Button Import bestätigen. Die importierten Datensätze finden Sie dann unterhalb der anfangs gewählten Seite.

Links

Diskussion Im Gegensatz zum Export gestaltet sich der Import sehr viel einfacher. Jedoch lauern hier auch Stolperfallen, die sich häufig durch Unachtsamkeiten einschleichen. Besonders wichtig ist es, dass Sie den richtigen Startpunkt wählen und die Datei die Inhalte enthält, die Sie wünschen. Gerade wenn Sie häufig Importe durchführen, kann die Übersicht verloren gehen. Wir empfehlen daher, die Dateien eindeutig zu benennen und zu entfernen, wenn sie nicht mehr benötigt werden. Standardmäßig ist das Modul so eingestellt, dass keine bestehenden Datensätze beschädigt werden oder verloren gehen können. Im schlimmsten Fall werden die Relationen zwischen den Datensätzen anhand der vorliegenden IDs neu berechnet, was zu unbrauchbaren Verlinkungen führt. Lizensiert für Markus Mueller

Wesentlich mehr Einfluss auf die bestehenden Inhalte können Sie im Bereich Import mit den Importeinstellungen ausüben. Wenn Sie zum Beispiel die bestehenden Datensätze aktualisieren möchten, aktivieren Sie die Option Datensätze aktualisieren und bestätigen Ihre Auswahl mit dem Button Vorschau. Bevor Sie den Import abschließen, wird Ihnen TYPO3 eine Übersicht der Datensätze ausgeben, die aktualisiert werden können. Somit haben Sie die Möglichkeit, alle Daten vorab zu kontrollieren und die Aktualisierung abzubrechen, falls etwas nicht Ihren Wünschen entspricht. Ähnlich verhält sich die Option ALLE UID-Werte erzwingen. Diese Option führt den Importbefehl ohne Vorschau durch und ersetzt alle bestehenden Datensätze mit dem gleichen ID-Wert durch die neuen Daten. Dies kann auch zu einer Aktualisierung der Datensätze führen, jedoch sollten Sie dann ganz sicher sein, dass auch alle ID-Werte übereinstimmen. Ansonsten würden Sie einen Datenverlust riskieren.

5.12 Eine Suche auf der Website integrieren Problem Sie möchten eine einfache Suche auf Ihrer Webseite integrieren, mit der Ihre Besucher schnell nach Seiteninhalten suchen können.

Max. Linie

Max. Linie 188 | Kapitel 5: Inhalte verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Rechts

Lösung Legen Sie ein Inhaltselement vom Typ Suche auf Ihre Seite. Ihre Besucher können danach standardmäßig die Seiteneigenschaften Ihrer Website durchsuchen. Die Suche unterstützt die Auswertung mehrerer Suchbegriffe, logische Verknüpfungen mit OR und Ausschlüsse mit dem Begriff NOT. Wenn Sie Ihren Suchbegriff in Anführungszeichen setzen, wird der gesamte Suchbegriff gesucht. Groß- und Kleinschreibung wird ignoriert. Der Suchbegriff TYPO3 OR Kochbuch findet zum Beispiel Seiten mit TYPO3 oder Kochbuch. Der Suchbegriff "TYPO3 Kochbuch" (inklusive Anführungszeichen) würde nur Seiten mit dem Begriff "TYPO3 Kochbuch" finden.

Diskussion Bei der Suche werden standardmäßig die Felder Titel, Untertitel, Schlüsselwörter und Beschreibung aus den Seiteneigenschaften sowie Überschriften aus allen Seiteninhalten berücksichtigt. Wenn der Besucher die Auswahl Suchen in auf Seiteninhalt ändert, werden nur Seiteninhalte, deren Überschrift und die Bildbeschreibung durchsucht. Beachten Sie, dass nur Seiten gefunden werden, auf denen auch Inhaltselemente liegen. Dadurch wird verhindert, dass Suchergebnisse zu leeren Seiten gefunden werden. Lizensiert für Markus Mueller

Um weitere Felder bei der Suche zu berücksichtigen, müssen Sie das TypoScript des Inhaltselements anpassen. Das TypoScript für die Suche ist in zwei Bereiche aufgeteilt. Der erste Teil definiert die Darstellung der Suchergebnisse und die erlaubten Suchfelder. So ist sicherstellt, dass nur freigeschaltete Felder gefunden werden können. Der zweite Teil legt den Umfang des Suchformulars fest und übergibt die zu durchsuchenden Felder an das PHP-Skript, das dann die Suche in der Datenbank durchführt. Durch folgende Angaben im TypoScript-Setup fügen Sie das Feld Inhaltsbeschreibung den erlaubten Feldern hinzu (alle Werte müssen in einer Zeile stehen): tt_content.search.20 { allowedCols = pages.title-subtitle-keywords-description-abstract : tt_content.header-bodytext-imagecaption }

Die Syntax ist dabei an die Tabellenstruktur angelehnt: Der erste Teil gibt den Namen der Tabellen an, zum Beispiel pages. Nach dem Punkt geben Sie die Felder der jeweiligen Tabelle an, die Sie mit einem Bindestrich voneinander trennen. Die anderen Angaben legen die oben erwähnten Felder fest. Um den Suchparameter im Formular zu erweitern, geben Sie folgenden Code in Ihr TypoScript-Setup ein:

Max. Linie

tt_content.search.30 { dataArray { 20.valueArray { 10.value = pages.title-subtitle-keywords-description-abstract: tt_content.header } } }

5.12 Eine Suche auf der Website integrieren | 189 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Selbstverständlich können Sie auch eigene Datenbanktabellen in die Suche integrieren. Geben Sie die nötigen Angaben an den beiden genannten Stellen im TypoScript an, damit diese von der Standardsuche berücksichtigt werden. Nachdem Sie die Änderungen gespeichert haben, werden die Inhalte bei der Suche gefunden.

Links

Lizensiert für Markus Mueller

TYPO3 unterstützt von Hause aus zwei Suchmechanismen. Einmal können Sie über das Inhaltselement Suche eine einfache Suche einbinden. Hier werden mit TYPO3-Bordmitteln die Datenbankinhalte durchsucht und auf der Webseite ausgegeben. Als Alternative können Sie eine Suche integrieren, die zwischen den Inhalten Ihrer Website Relationen herstellt und damit Suchergebnisse auch gegeneinander gewichten kann. Die Suche wird dann meist präziser. Wenn Sie eine solche Suche wünschen, sollten Sie die Indexsuche genauer anschauen. Diese wird in Rezept 5.13 näher erläutert. Die hier gezeigte Suche hat den entscheidenden Vorteil, dass die Inhalte ohne großen Aufwand auf Ihrer Website direkt gefunden werden. Um ein ähnliches Ergebnis bei der Indexsuche zu erzielen, müssen Sie eine weitere Extension aktivieren und konfigurieren. Zudem muss die Seite gecacht sein und zuvor von einem Indexmechanismus in den Suchindex aufgenommen werden, bevor die Inhalte in der Suche gefunden werden können. Im Vergleich zur Indexsuche hat die Standardsuche jedoch auch nur einen sehr begrenzten Funktionsumfang, der bei größeren Websites mit gesteigerten Anforderungen schnell an seine Grenzen stößt. Es werden zum Beispiel keine Gewichtigungen bei den Suchergebnissen vorgenommen, und die Suche ist auf eine Textsuche in den angegebenen Feldern begrenzt. Auch bei der Darstellung der Suchergebnisse ist die Standardsuche umständlich zu erweitern. Prüfen Sie daher vorab, welche Suchmöglichkeit Sie Ihren Besuchern anbieten möchten.

Siehe auch Die Alternative zu der hier gezeigten einfachen Suche wird in Rezept 5.13 näher erläutert.

5.13 Inhalte mit der Indexsuche von TYPO3 suchen und finden Problem Sie möchten Ihren Website-Besuchern die Möglichkeit bieten, die Inhalte Ihrer Website mit einer Suchmaschine zu durchsuchen. Die Suchergebnisse sollen nach Relevanz gewichtet werden und repräsentative Ergebnisse widerspiegeln.

Lösung

Max. Linie

Fügen Sie diese Zeilen in Ihr TypoScript-Setup ein: config { index_enable = 1 }

190 | Kapitel 5: Inhalte verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Wechseln Sie anschließend in den Erweiterungs-Manager und aktivieren Sie dort die Extension mit dem Key indexed_search. Den Hinweis auf die Extension doc_indexed_ search können Sie ignorieren. Die Extension beinhaltet lediglich das Handbuch für die Extension, das Sie auch nachträglich noch installieren können. Nachdem Sie die Extension mit einem Klick auf den Button Update aktiviert haben, ist die Suchmaschine auch schon grundlegend eingerichtet. Besucht ein Benutzer eine gecachte Webseite, speichert TYPO3 im Hintergrund automatisch den Inhalt im Suchindex. Im nächsten Schritt binden Sie eine Suchmaske in Ihre Webseite ein, damit der Suchindex auch von Ihren Besuchern durchsucht werden kann. Wählen Sie dazu eine Seite, auf der Sie die Suche sowie die Suchergebnisse anzeigen lassen möchten, und legen Sie dort ein neues Inhaltselement vom Typ Plugin an. Als Plugin wählen Sie den Eintrag Indexsuche. Nach dem Speichern erscheint ein Suchformular auf der Webseite mit dessen Hilfe der Inhalt Ihrer Website komfortabel nach Suchbegriffen durchsucht werden kann. Achten Sie darauf, dass Sie das Plugin Indexsuche verwenden und nicht das Inhaltselement Suchen. Mit dem Inhaltselement Suchen kann die Indexsuche nicht durchgeführt werden (das Inhaltselement Suchen wird in Rezept 5.12 ausführlich erläutert).

Lizensiert für Markus Mueller

Diskussion Durch die Indexsuche werden zwischen den Inhalten Ihrer Website Relationen herstellt, und es wird ein sogenannter Suchindex erstellt. Anhand dieses Index können dann zum Beispiel bestimmte Suchbegriffe mit vorhandenen Indexeinträgen gegeneinander gewichten werden. Dadurch können die Suchergebnisse präziser auf den Suchbegriff abgestimmt werden, als es mit einer normalen SQL-Suche möglich wäre. Wenn Sie die neu installierte Suche über das Suchformular testen, werden Sie feststellen, dass noch keine Ergebnisse zurückgegeben werden. Dies hat den Hintergrund, dass nur Inhalte in den Suchindex aufgenommen werden, die im TYPO3-Cache liegen. So speichert TYPO3 beispielsweise keine Seiten im Cache, sobald Sie am Backend angemeldet sind. Um die Suche zu testen, müssen Sie sich also entweder am Backend abmelden oder die Seite in einem anderen Browser öffnen, in dem keine Session für einen BackendBenutzer vorliegt. Stoßen Sie die Suche erneut an, sobald Sie mit einem normalen Besucher eine Webseite besucht haben, und verwenden Sie als Suchbegriff ein Wort, dass auf der besuchten Webseite vorkommt. Danach sollten Sie ein Suchergebnis erhalten. Der Suchindex wird nur gefüllt, wenn die jeweilige Seite im TYPO3-Cache abgelegt wird. Möchten Sie also die Indexsuche aktivieren, sollten Sie diese Fehlerquellen vorab ausschließen: 1. Prüfen Sie in den Seiteneigenschaften, ob die gesamte Seite gecacht wird.

Max. Linie

Max. Linie

Stellen Sie sicher, dass das Kontrollkästchen Nicht cachen inaktiv ist.

5.13 Inhalte mit der Indexsuche von TYPO3 suchen und finden This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 191

2. Eine weitere häufige Fehlerquelle ist, dass die Seiteneigenschaft Nicht suchen aktiv ist. Diese Option verhindert, dass die Seite in den Suchindex aufgenommen wird. Die Seite wird also nicht gefunden, wenn diese Option aktiv ist.

Links

3. Prüfen Sie dazu über den TypoScript-Object-Browser, ob der Wert config.no_cache auf 1 gesetzt ist. Setzen Sie den Wert auf den Standardwert 0 oder entfernen Sie die Zeile aus dem TypoScript-Code. 4. Durchsuchen Sie danach die Extension-Verzeichnisse fileadmin und typo3conf/ext/ nach dem Begriff no_cache. An den Fundstellen sollten Sie prüfen, ob diese Funktion aufgerufen wird: $GLOBALS['TSFE']->set_no_cache();

Lizensiert für Markus Mueller

Prüfen Sie, weshalb diese Funktion aufgerufen wird, und entfernen Sie diesen Funktionsaufruf. Die Funktion deaktiviert das TYPO3-Caching, bremst dadurch einerseits die allgemeine Performance der Website und verhindert andererseits, dass Seiteninhalte in den Suchindex übernommen werden. Sie sollten daher auf diese Funktion unbedingt verzichten. Nutzen Sie das Syslog bei der Suche nach Stellen, an denen der no_cache-Parameter aufgerufen wird. TYPO3 protokolliert jeden Aufruf des no_cache-Parameters im Syslog (in Rezept 2.11 erfahren Sie, wie Sie das Syslog aktivieren und hierfür nutzen können). Alternativ können Sie auch die Option disableNoCacheParameter im Install-Tool aktivieren oder diese Zeile in die Datei localconf.php einfügen: $TYPO3_CONF_VARS['FE']['disableNoCacheParameter'] = 1;

TYPO3 unterbindet dadurch die Verwendung des no_cache-Parameters, was jedoch auch zu Nebeneffekten bei bereits installierten Extensions führen kann. Sie sollten diese Einstellung daher nur dann aktivieren, wenn Sie Nebeneffekte ausschließen können. Finden Sie solche Stellen im Code, sollten Sie die Ursache dafür unbedingt prüfen. TYPO3 stellt ausgereifte Caching-Lösungen bereit, die bei der Extension-Entwicklung genutzt werden können. Lesen Sie hierzu zuerst die relevanten Rezepte zum Thema Caching in Rezept 11.2, bevor Sie die Suche weiter einrichten. Die Suche wird nur dann verlässlich laufen und repräsentative Ergebnisse zurückgeben, wenn Ihre Webseiten sinnvoll gecacht werden. 5. Zum anderen werden Inhalte, die über ein _INT-Objekt ausgegeben werden, nicht im Cache abgelegt (wenn Ihnen der Begriff _INT-Objekt noch fremd ist, sollten Sie das Reztept 11.12 lesen). Nachdem Sie diese Anpassungen vorgenommen haben, sind die Voraussetzungen geschaffen, dass die Inhalte über die Suche durchsucht werden können.

Siehe auch

Max. Linie

Die Suche ist eher auf Komfort und Features ausgelegt und glänzt durch die Integration in TYPO3. Bei Websites mit über 1.000 Seiten zeigen sich jedoch auch die Grenzen der

192 | Kapitel 5: Inhalte verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Indexsuche, vor allem bei der Auswertung der Relationen von Schlüsselwörtern. Die Indexsuche ist nicht auf größere Datenmengen ausgelegt. Es kann dann zu Speicherüberläufen und auch zu Abstürzen des Datenbankservers kommen. Es gibt Ansätze, weitere Suchmaschinen wie Lucene (http://lucene.apache.org/java/docs/) oder Mnogosearch (http:// www.mnogosearch.org/) in TYPO3 zu integrieren. Wenn Sie nach Alternativen Ausschau halten, lohnt sich eine Suche nach diesen beiden Begriffen auf http://typo3.org/extensions/.

5.14 Mit IRRE verknüpfte Datensätze bearbeiten Problem Sie arbeiten mit einem TYPO3-System, auf dem eine Extension installiert ist, die das seit TYPO3-Version 4.1 verfügbare Prinzip des Inline Relational Record Editing – genannt IRRE – verwendet. Dabei erscheinen die Elemente in den Backend-Formularen teilweise in einem völlig neuartigen Layout, und es sind Icons zu sehen, die Ihnen bisher unbekannt waren.

Lizensiert für Markus Mueller

Nun wollen Sie wissen, was diese Icons bedeuten, welche zusätzlichen Möglichkeiten der Bearbeitung im Backend durch IRRE angeboten werden und wie Sie diese komfortabel nutzen können.

Lösung Öffnen Sie eines der neuen Elemente so, wie Sie es gewohnt sind, um es zu bearbeiten. Es erscheint ein auf den ersten Blick vertraut anmutendes Backend-Formular, das bei näherem Hinsehen jedoch einige kleinere Unterschiede aufweist. In Abbildung 5-9 sehen Sie ein solches Formular, bei dem sich die verknüpften Elemente noch im Urzustand der Ansicht, also im zusammengeklappten Zustand, befinden. Je nachdem, wie die Extension vom Autor angelegt wurde, müssen Sie allerdings zunächst in den Listenmodus wechseln, um die einzelnen Einträge in den Tabellen der Hauptelemente, Unterelemente und Verknüpfungen bearbeiten zu können, denn oftmals sind sie in der normalen Seitenansicht nicht sichtbar. Wenn Sie nun auf einen der beiden Titel der Unterelemente klicken, öffnet sich das dazugehörige Formular des verknüpften Elements, und Sie können es bearbeiten. Eine entsprechende aufgeklappte Ansicht des betroffenen Felds Unterelemente finden Sie in Abbildung 5-10. Wenn Sie danach erneut auf den Titel klicken, wird das dazugehörige Formular wieder zusammengefaltet, und Sie können ein anderes Unterelement bearbeiten. Je nach Einstellung der Extension können Sie dabei gleichzeitig mehrere Unterelemente oder nur genau eines im aufgeklappten Zustand betrachten.

Max. Linie

Max. Linie 5.14 Mit IRRE verknüpfte Datensätze bearbeiten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 193

Links

Abbildung 5-9: Ein Hauptelement mit verknüpften Unterelementen im zusammengeklappten Zustand

Lizensiert für Markus Mueller

Abbildung 5-10: Ein Hauptelement mit verknüpften Unterelementen im aufgeklappten Zustand Beachten Sie dabei jedoch, dass sämtliche Änderungen, die Sie in den Unterelementen vornehmen, erst dann gespeichert werden, wenn Sie das dazugehörige Hauptelement speichern.

Max. Linie

Max. Linie 194 | Kapitel 5: Inhalte verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Rechts

Wenn Sie ein neues Unterelement anlegen wollen, können Sie dies je nach Einstellung der Extension ebenfalls direkt im Formular des dazugehörigen Hauptelements tun. Dazu dient der Link Create new, der mithilfe einer entsprechenden Voreinstellung zusätzlich noch den Tabellentitel der zu erstellenden Datensätze verwenden kann, sodass dort z.B. auch Create new Address stehen könnte. Neben den bekannten Icons Informationen, Neues Element anlegen, Sortieren, Ausblenden und Löschen erscheint je nach Einstellung der Extension ein weiteres Icon, nämlich ein orangefarbenes Symbol aus zwei sich kreuzenden Doppelpfeilen. Dieses Symbol dient zum Verschieben einzelner Unterelemente innerhalb des übergeordneten Elements. Klicken Sie darauf und verschieben Sie das Element mit gehaltener Maustaste an die gewünschte Stelle, wie in Abbildung 5-11 gezeigt.

Lizensiert für Markus Mueller

Abbildung 5-11: Verschieben eines Unterelements mit der Drag-and-Drop-Funktionalität von IRRE Beachten Sie dabei jedoch auch, dass Änderungen in der Reihenfolge der Elemente erst dann gespeichert werden, wenn Sie das dazugehörige Hauptelement speichern.

Diskussion

Max. Linie

Seit TYPO3-Version 4.1 stellt der Kern von TYPO3 eine neue Funktionalität zur Verknüpfung zwischen mehreren Datensätzen zur Verfügung. Neben den bekannten Selectboxen, die es als sogenannte Gruppenfelder auch mit entsprechendem Auswahl-Wizard gibt, tritt nun eine völlig andere Art der Bearbeitung verknüpfter Datensätze auf den Plan. Hauptelemente und deren Unterelemente können jetzt gleichzeitig innerhalb eines einzigen Backend-Formulars editiert werden. Sie sind also gleichsam in Reihe – englisch inline – geschaltet. Die Methode heißt folglich Inline Relational Record Editing oder abgekürzt einfach IRRE.

5.14 Mit IRRE verknüpfte Datensätze bearbeiten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 195

Max. Linie

Eine der Grundregeln, die Sie bei der Arbeit mit IRRE immer beachten müssen, haben wir bereits in der Lösung erwähnt. Jedoch sei auch hier nochmals ausdrücklich darauf hingewiesen:

Links

Beachten Sie immer, dass sämtliche Änderungen, die Sie in den Unterelementen vornehmen, erst dann gespeichert werden, wenn Sie das dazugehörige Hauptelement speichern. Die einzige Ausnahme hiervon wird beim Erzeugen neuer Elemente gemacht, die per Ajax-Call zumindest als leere Elemente bereits in der Datenbank angelegt werden. Änderungen daran werden allerdings auch erst nach dem Speichern des Hauptelements endgültig übernommen.

Eine weitere Eigenart der IRRE-Verknüpfungen ist, dass die Unterelemente sich an verschiedenen Speicherorten befinden können, nachdem Sie ein Element kopiert haben. Es ist dem Autor der Extension überlassen, ob sich Unterelemente beim Kopieren mit ihrem Hauptelement mitbewegen dürfen oder nicht. Dürfen sie sich mitbewegen, befinden sich nach dem Kopiervorgang sowohl das Hauptelement als auch dessen Unterelemente auf der gleichen Seite. Andernfalls befinden sich alle Unterelemente in einem dafür vorgesehenen Ordner. Falls Sie die kopierten Elemente also nicht sofort an der erwarteten Stelle vorfinden, könnte das an einer entsprechend abweichenden Einstellung der Extension liegen. Lizensiert für Markus Mueller

Neben der in der Lösung gezeigten Variante der direkten Erzeugung von Elementen aus dem Formular des Hauptelements heraus gibt es übrigens noch eine zweite Möglichkeit, einem Hauptelement per IRRE Unterelemente zuzuordnen. Während es auf der Seite der Hauptelemente die gezeigten zusätzlichen aufklappbaren Listen von Formularen gibt, in denen sich die Unterelemente befinden, verfügen die Unterelemente nämlich oftmals selbst über ein Feld, in dem man angezeigt bekommt, zu welchem Hauptelement sie gehören. Da es sich bei diesem Feld um eine Selectbox handelt, kann man hier selbstverständlich nicht nur ablesen, welche Hauptelemente auf dieses Element zugreifen, sondern auch quasi rückwärts verknüpfend weitere Hauptelemente hinzufügen. Sie können also für die Erzeugung und spätere Verknüpfung von Elementen verschiedene Personen beauftragen, von denen jeder jeweils eingeschränkte Rechte hat und nur genau eine der beiden Tätigkeiten ausüben darf. Ein Beispiel wäre ein Team von Redakteuren, die Datensätze von Urlaubsorten und dazugehörigen Pauschalreiseangeboten anlegen, diese aber nicht verknüpfen dürfen. Die Verknüpfung von Ort und Angebot mit einem entsprechenden saisonabhängigen Preis wird danach von der Verkaufsabteilung vorgenommen, die wiederum nichts an den Inhalten der verknüpften Elemente ändern darf.

Max. Linie

Damit haben wir auch gleich die dritte Neuerung von IRRE beschrieben, denn es ist nun nicht nur möglich, die beiden verknüpften Elemente im Backend zu bearbeiten, sondern auch den Eintrag in der Verknüpfungstabelle selbst. Diese sogenannten IntermediateTabellen haben eigene Backend-Formulare, in denen z.B. weitere Attribute hinzugefügt

196 | Kapitel 5: Inhalte verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

werden können. Im Fall der Verknüpfung von Urlaubsorten und Angeboten wären das z.B. ein Preis oder ein Zeitraum, in dem das Angebot Gültigkeit haben soll. Insgesamt hat sich der Komfort beim Bearbeiten verknüpfter Elemente mit TYPO3 durch die Einführung von IRRE sicherlich deutlich erhöht. Jedoch sollte man dabei den Faktor Performance nicht außer Acht lassen, denn momentan wird nur die Erzeugung neuer Elemente bei Bedarf per Ajax-Call realisiert. Beim Auslesen der verknüpften Elemente werden nicht nur alle Daten in der Datenbank gelesen, sondern auch alle dazugehörigen Formulare im Backend erzeugt. Sie sind zwar zunächst nicht sichtbar, aber der gesamte HTML-Code und die dazugehörigen Elemente wie Bilder oder Rich Text Editor-Instanzen werden bereits komplett im Formular vorgehalten und nur ein- bzw. ausgeblendet. Solange hier nicht ebenfalls bedarfsgerecht mit Ajax-Calls gearbeitet wird, um die Daten aufgeklappter Formulare nachträglich vom Server zu beziehen, sollten Sie daher möglichst sparsam im Umgang mit IRRE-Elementen sein.

Siehe auch Wenn Sie einfach nur einmal ausprobieren wollen, wie man mit IRRE im Backend arbeiten kann, installieren Sie sich doch einfach die Extension Tutorial for Inline Relational Record Editing IRRE, die Sie unter dem Extension-Key irre_tutorial im TER finden. Lizensiert für Markus Mueller

Wenn Sie wissen wollen, wie Sie nun Ihre eigenen Extensions mithilfe von IRRE komfortabler gestalten können, lesen Sie dazu die Rezepte 17.9 und 17.10.

Max. Linie

Max. Linie 5.14 Mit IRRE verknüpfte Datensätze bearbeiten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 197

Vakat Lizensiert für Markus Mueller

First

Kapitel 6

KAPITEL 6

Das Backend anpassen

6.0

Einführung

Lizensiert für Markus Mueller

Das Backend stellt die zentrale Oberfläche für den Umgang mit den Daten Ihrer Website dar. Über das Backend können Sie Datenbankinhalte und Dateien intuitiv über den Webbrowser verwalten oder Einstellungen an Ihrer TYPO3-Installation vornehmen. Die Oberfläche lässt sich dabei sehr flexibel an eigene Bedürfnisse anpassen. Sie können Eingabefelder ausblenden oder Optionen in Auswahlmenüs umbenennen. Sogar die grundlegende Aufteilung des Frameset lässt sich auf Ihre jeweiligen Arbeitsgewohnheiten einstellen. In Rezept 6.1 erfahren Sie, wie Sie die Standardaufteilung ändern können, um etwa die linke Modulleiste auszublenden und auf dem Bildschirm Platz für die Bearbeitungsformulare zu schaffen. Sämtliche Funktionen, die Sie im Backend verwenden können, werden durch sogenannte Backend-Module zur Verfügung gestellt. Dabei stellt jedes Modul eine funktionale Einheit im Backend dar, die auf eine bestimmte Funktion spezialisiert ist, mit der Sie bestimmte Arbeitsvorgänge erledigen können. Die Module sind wiederum in Hauptmodule gruppiert. Folgende Hauptmodule sind standardmäßig vorhanden: Web Hier verwalten Sie über den Seitenbaum die Datenbankinhalte Ihrer Website. Sie werden erfahrungsgemäß hauptsächlich mit diesen Modulen arbeiten. Datei Hier verwalten Sie über eine Ordnerstruktur Dateien auf dem Dateisystem des Servers. Wenn Sie Dateien in Ihre Website integrieren möchten, können Sie diese hier ablegen. Benutzerwerkzeuge Über diese Module können Benutzereinstellungen, Aufgaben und Workspaces des aktuell angemeldeten Benutzers bearbeitet werden.

Max. Linie

Max. Linie | 199 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Admin-Werkzeuge Hier finden Sie Module für administrative Aufgaben, wie etwa eine Liste aller angemeldeten Benutzer oder den Erweiterungs-Manager, mit dem Sie Erweiterungen installieren können.

Links

Hilfe Hier finden Sie Module, die Ihnen helfen, TYPO3 besser zu verstehen, beispielsweise nützliche Dokumentationen zur Verwendung der Module oder TypoScript. Jedes dieser Hauptmodule können Sie mit einem Klick auf den Titel kompakt darstellen, um nicht benötigte Module auszublenden und wieder ausklappen. Eine ausführliche Funktionsbeschreibung zu den vorhandenen Modulen erhalten Sie über das Modul Über Module im Hauptmodul Hilfe. Eine besondere Bedeutung hat das Hauptmodul Web, denn jedes der untergeordneten Module kann über die TYPO3-eigene Konfigurationssprache TSconfig angepasst werden. Mit TSconfig-Befehlen geben Sie Anweisungen an bestimmte Module im Backend, die diese Einstellungen dann interpretieren und entsprechend umsetzen. Dabei ist TSconfig von der Schreibweise her ähnlich wie TypoScript aufgebaut – mit dem Unterschied, dass Sie mit TypoScript die Inhaltsausgabe im Frontend Ihrer Website beeinflussen und TSconfig dazu verwenden, die Oberfläche und Funktionalität des Backends anzupassen. Lizensiert für Markus Mueller

Beispielsweise können Sie im Seitenmodul per TSconfig-Anweisungen die vorhandenen Inhaltsspalten reduzieren. In Rezept 6.2 erfahren Sie, wie Sie mit wenigen Zeilen TSconfig-Code das Modul Seite anpassen können, etwa wenn Sie weniger als die vier standardmäßig vorhandenen Inhaltsspalten benötigen. Je nach Gestaltungsvorgaben der Website kann es jedoch auch vorkommen, dass Sie eine unterschiedliche Anzahl von Inhaltsspalten benötigen. Bei vielen Projekten werden Sie daher eine andere Spaltenanzahl verwenden wollen. In den Rezepten 6.2, 6.3 und 6.4 erfahren Sie, wie Sie die Inhaltsspalten im Seitenmodul anpassen können. Der TSconfig-Code kann dabei entweder im Feld TSconfig der Seiteneigenschaften oder in den Einstellungen von Backend-Benutzern oder Benutzergruppen liegen. Wenn Sie Änderungen auf bestimmte Seitenbäume anwenden möchten, sollten Sie den Code in die Seiteneigenschaften einbinden. Sollen die Änderungen lediglich einzelne Backend-Benutzer oder -Benutzergruppen betreffen, geben Sie den TSconfig-Code in das Benutzerprofil ein. Der TSconfig-Code, der in den Seiteneigenschaften eingegeben wird, wird auch als Seiten- bzw. Page-TSconfig bezeichnet. TSconfig-Angaben aus dem Benutzer- oder Gruppendatensatz werden als Benutzer-/User-TSconfig bezeichnet.

Max. Linie

Eine Besonderheit von Page-TSconfig ist, dass sämtliche Angaben auf die jeweiligen Unterseiten vererbt werden. Das bedeutet, dass Sie über Page-TSconfig sehr komfortabel auch umfangreiche Seitenbäume anpassen können. Wenn Sie eine TSconfig-Einstellung für eine bestimmte Seite oder einen Seitenbaum wieder deaktivieren möchten, müssen Sie dies in dem Feld TSconfig der jeweiligen Unterseite angeben. Zudem überschreiben die Angaben aus dem User-TSconfig stets die Seiten-TSconfig-Angaben, sodass Sie die TSconfig-Einstellungen für den jeweiligen Seitenbaum für bestimmte Benutzer oder Benutzergruppen

200 | Kapitel 6: Das Backend anpassen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

so auch aufheben oder erweitern können. In den folgenden Rezepten finden Sie bei jedem Codeabschnitt einen Hinweis, der Ihnen sagt, in welches der beiden Felder der jeweilige TSconfig-Code eingegeben werden muss. Durch diese Konfigurationsmöglichkeiten können Sie das Backend sehr flexibel anpassen, zudem sind sehr feine Einstellungsmöglichkeiten auf der Formularebene möglich. So können Sie per Seiten-TSconfig definieren, wie bestimmte Optionen in den Auswahllisten ausgegeben werden oder welche Felder im Modul oder den Eingabeformularen angezeigt werden sollen. Dadurch, dass nur noch die wesentlichen Bearbeitungsmöglichkeiten angeboten werden, wird die Verwendung des Backends erfahrungsgemäß leichter. Die Rezepte 6.5 und 6.6 befassen sich eingehend mit diesen Möglichkeiten. In Rezept 6.7 erfahren Sie, wie Sie bestehende Eingabefelder anpassen können, um beispielsweise ein einzeiliges Eingabefeld in ein mehrzeiliges Textfeld umzuwandeln. Darüber hinaus behandelt das Rezept 6.8, welche Möglichkeiten Sie haben, die Werte in den Feldern zu validieren und so vor dem Speichern in der Datenbank zu überprüfen. Wenn Sie die Position von Formularfeldern anpassen möchten, finden Sie in den Rezepten 6.9 und 6.10 die nötigen Hintergrundinformationen dazu. Rezept 6.9 beschreibt, wie Sie die Position einzelner Eingabefelder anpassen können, etwa um eigene Fomularfelder an einer bestimmten Position einzubinden oder logische Feldgruppen zu bilden.

Lizensiert für Markus Mueller

Bei umfangreichen Formularen können Sie die Felder auch mehrspaltig in einer Zeile anordnen. Das hat den Vorteil, dass die Übersichtlichkeit erhöht wird und das Formular leichter bearbeitet werden kann. In Rezept 6.10 erfahren Sie, wie Formularfelder – auf ähnliche Art und Weise – über mehrere Spalten verteilt werden, beispielsweise um sie nebeneinander zu platzieren. Die Formulare wirken dadurch meist aufgeräumter und sind besser handhabbar.

6.1

Die Seitenaufteilung im Backend beeinflussen

Problem Sie möchten die Aufteilung des Backends beeinflussen, um zum Beispiel mehr Platz für die Inhaltseingabe zu schaffen.

Lösung

Max. Linie

Aktivieren Sie in Ihren Benutzereinstellungen unter Beim Start die Option Schmale Ansicht im Backend verwenden. Diese Ansicht wurde speziell für Benutzer mit kleinen Bildschirmen entwickelt. Die Fensterbereiche Seitenbaum und Bearbeitung werden dadurch nacheinander eingeblendet, was sehr viel Platz spart. Das heißt, Sie wählen zuerst die gewünschte Seite im Seitenbaum und erhalten daraufhin das Bearbeitungsformular in einem eigenen Frame.

6.1 Die Seitenaufteilung im Backend beeinflussen | 201 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Diskussion

Links

TYPO3 wurde für eine Auflösung von 1.024 x 768 Pixeln oder höher ausgelegt. Manche Bildschirme – beispielsweise von Laptops – zeigen dadurch das Backend nur unvollständig an, was die Bedienung erschwert. Um das Arbeiten auf kleinen Bildschirmen angenehmer zu gestalten, können Sie durch folgende Einstellungen gerade nicht benötigte Elemente ausblenden. Blenden Sie den Seitenbaum aus, indem Sie auf den Rahmen zwischen Seitenbaum und Eingabemaske klicken. Daraufhin verschwindet der Seitenbaum, sodass Sie mehr Platz für die Bearbeitung der Inhalte haben und die Eingabeformulare vollständig sehen. Um weiter Platz zu sparen, können Sie die Erklärungen unterhalb der Eingabefelder ausblenden, indem Sie in Ihren Benutzereinstellungen die Option Hilfetexte anzeigen, wenn möglich deaktivieren. Die ausführliche Feldbeschreibung finden Sie weiterhin über die Icons der kontextsensitiven Hilfe, wenn Sie in der Auswahlliste Kontext-sensitive Hilfe die Option Nur Hilfesymbol anzeigen wählen. Wenn Sie auf solch ein Symbol klicken, erhalten Sie eine ausführliche Hilfe mit Beschreibung und weiterführenden Links. Erfahrene Benutzer können diese Icons mit der Option Deaktiviere Inhalt-Kontextmenüs auch ganz ausblenden. Lizensiert für Markus Mueller

Siehe auch In Rezept 7.4 erfahren Sie, wie Sie den Frame für den Seitenbaum verbreitern oder schmaler machen.

6.2

Anzahl der Inhaltsspalten erhöhen

Problem Sie benötigen mehr als vier Inhaltsspalten für die Inhaltseingabe.

Lösung Erweitern Sie den Wertebereich für die Inhaltsspalten, in dem Sie das TCA der Tabelle tt_content über eine Extension anpassen. Der Wertebereich für die Inhaltsspalten wird im TCA der Tabelle tt_content an folgender Stelle festgelegt: $TCA['tt_content']['columns']['colPos']['config']['items'][]

Über eine Extension können Sie diesen Wertebereich erweitern. Geben Sie dazu in der Datei ext_tables.php folgenden Code ein:

Max. Linie

t3lib_div::loadTCA('tt_content'); $TCA['tt_content']['columns']['colPos']['config']['items']['4']['0'] = 'Fünfte Spalte'; $TCA['tt_content']['columns']['colPos']['config']['items']['4']['1'] = 4;

202 | Kapitel 6: Das Backend anpassen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Warum verwenden wir hier als Beschreibung Fünfte Spalte und als Wert die Zahl 4? Der Grund dafür liegt darin, wie PHP Arrays zählt. Der Array-Index beginnt in PHP immer bei 0. Für die fünfte Spalte vergeben wir daher den Wert 4. Die neue Spalte erscheint nun bei jedem Inhaltselement in der Auswahlliste Spalten. Abschließend müssen Sie diese neue Spalte noch im Seitenmodul freischalten. Öffnen Sie dazu die Seiteneigenschaften der Seite, in der Sie die zusätzliche Spalte aktivieren möchten, und fügen Sie den folgenden TSconfig-Code in das Feld TSconfig ein (TYPO3 vererbt diese Einstellung auf sämtliche Unterseiten): mod { SHARED.colPos_list = 1,0,2,3,4 }

Im Backend wird die neue Spalte wie gewünscht auf Position fünf neben der Randspalte angezeigt.

Diskussion

Lizensiert für Markus Mueller

Standardmäßig stellt TYPO3 Ihnen vier Inhaltsspalten zur Verfügung. Die normale Inhaltsspalte ist mit dem Wert 0 definiert, 1 ist der linken Spalte zugeordnet, 2 steht für die rechte Spalte, und 3 bezeichnet die Randspalte. Die Erweiterung der Spalten folgt immer diesem Muster: t3lib_div::loadTCA('tt_content'); $TCA['tt_content']['columns']['colPos']['config']['items']['n']['0'] = 'LLL:EXT:cms/locallang_ttc.php:colPos.I.n'; $TCA['tt_content']['columns']['colPos']['config']['items']['n']['1'] = n;

n steht dabei für eine beliebige Zahl. Sie können auf diese Weise bis zu 999 Spalten anlegen.

Siehe auch In Rezept 6.4 erfahren Sie, wie Sie Inhaltsspalten umbenennen. Wenn Sie deutlich mehr als sechs Inhaltsspalten benötigen, sollten Sie vor dem Erweitern der Inhaltsspalten Ihre Datenstruktur überdenken und einen Blick auf die TemplaVoilà-Extension werfen. Mehr Informationen zu dieser Extension finden Sie unter folgender Adresse: http://typo3.org/ extensions/repository/view/templavoila/.

6.3

Anzahl der Inhaltsspalten verringern

Problem

Max. Linie

Sie möchten die Anzahl der Inhaltsspalten verringern, um die Inhaltseingabe auf die Spalten zu begrenzen, die auf der Website angezeigt werden.

6.3 Anzahl der Inhaltsspalten verringern This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 203

Max. Linie

Links

Lösung Wählen Sie die Seite, auf der die Inhaltsspalten verringert werden sollen, und öffnen Sie die Seiteneigenschaften. Geben Sie dann folgenden Code in das Feld TSconfig ein: mod.web_layout { tt_content.colPos_list = 0,2 }

Mit diesen Einstellungen werden nur noch die Inhaltsspalten Normal und Rechts angezeigt.

Diskussion

Lizensiert für Markus Mueller

Durch die oben genannte Angabe wird zwar die Anzeige im Seitenmodul eingeschränkt, im Auswahlfeld der Inhaltselemente kann die Spalte jedoch noch geändert werden. Wenn Inhaltselemente über dieses Feld geändert und abgespeichert werden, können sie im Seitenmodul nicht mehr dargestellt werden, da die entsprechende Spalte ausgeblendet wurde. Um dies zu verhindern, sollten Sie daher zusätzlich den Eintrag für die Inhaltsspalte in der Auswahlliste Spalten entfernen. Fügen Sie dazu zusätzlich zu dem anfangs genannten Code noch die folgenden Zeilen hinzu und geben Sie diesen Code in das Feld TSconfig in den Seiteneigenschaften ein: TCEFORM.tt_content { colPos.removeItems = 1,3 }

Beachten Sie, dass diese Angaben – wie alle TSconfig-Einstellungen – auf die unteren Seiten vererbt werden und somit ganze Seitenbäume beeinflussen können. Falls Sie auf untergeordneten Seiten wieder mehr Inhaltsspalten benötigen, können Sie die Angaben überschreiben. Diese gelten dann wiederum für alle untergeordneten Seiten. Eine Übersicht der vergebenen TSconfig-Einstellungen erhalten Sie über das Modul Info. Wählen Sie dort die Option Seiten-TSconfig, und Sie erhalten daraufhin eine Übersicht aller TSconfig-Optionen, die Sie im Seitenbaum verwenden.

Siehe auch In Rezept 6.4 erfahren Sie, wie Sie Inhaltsspalten umbenennen.

6.4

Inhaltsspalten umbenennen

Problem

Max. Linie

Sie möchten die Inhaltsspalten umbenennen, um deren Verwendung intuitiver zu machen.

204 | Kapitel 6: Das Backend anpassen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Lösung Standardmäßig stellt TYPO3 Ihnen vier Inhaltsspalten zur Verfügung. Die normale Inhaltsspalte ist mit dem Wert 0 definiert, 1 ist der linken Spalte zugeordnet, 2 steht für die rechte Spalte und 3 bezeichnet die Randspalte. Um bestehende Spalten umzubenennen, geben Sie Folgendes in Ihr Seiten-TSconfig-Feld ein: TCEFORM.tt_content { colPos.altLabels.0 colPos.altLabels.1 colPos.altLabels.2 colPos.altLabels.3 }

= = = =

Normale Spalte Linke Spalte Rechte Spalte Randspalte

Diskussion

Lizensiert für Markus Mueller

Wenn Sie Backend-Benutzer haben, die mit den oben genannten deutschen Bezeichnungen wenig anfangen können, ist es ebenfalls möglich, mehrsprachige Labels zu erzeugen. Verwenden Sie dazu die von TYPO3 zur Verfügung gestellten Möglichkeiten, das Backend mehrsprachig zu gestalten. TYPO3 erkennt die Spracheinstellungen des angemeldeten Backend-Benutzers und zeigt in den Feldern die entsprechenden Sprachwerte an. Im TSconfig-Feld setzen Sie lediglich einen Wert ein, der auf den entsprechenden Wert in der Sprachdatei zeigt. Dieser Zeiger ist immer nach folgendem Muster aufgebaut: LLL:EXT:extension_key/locallang.xml:zeiger = Sprachwert

Mit LLL: legen Sie fest, dass Sie einen dynamischen Sprachwert lesen möchten. EXT: bedeutet, dass Sie den Extension-Ordner der Extension anwählen. Das ist standardmäßig der Ordner typo3conf/ext/. Danach folgt der Extension-Key und der Name der Sprachdatei. Mit dem Wert nach dem Doppelpunkt zeigen Sie auf den Sprachwert in der Sprachdatei. Da die Sprachwerte aus dem TCA der Tabelle tt_content geändert werden, sollten Sie die Datei demgemäß locallang_tca.xml nennen. XML-Dateien werden von TYPO3 automatisch als Sprachdateien erkannt, wenn sie mit locallang beginnen. (In Rezept 17.7 erfahren Sie mehr über den Aufbau dieser Sprachdateien und wie Sie eigene Sprachwerte hinzufügen können.) Zusätzlich gibt es spezielle Extensions, mit denen andere Programmierer oder Community-Mitglieder weitere Übersetzungen in diese Dateien einpflegen können. In Rezept 20.4 erfahren Sie mehr darüber, wie Übersetzungen dieser Dateien standardkonform erstellt und verwaltet werden.

Max. Linie

Auf diese Sprachwerte greifen Sie nun über das Seiten-TSconfig zu. Dabei erkennt TYPO3 anhand der Spracheinstellungen des Backend-Benutzers die Sprache und liest die entsprechenden Sprachwerte aus der Datei. Für den Fall, dass einer der Sprachwerte nicht in der gewünschten Sprache vorhanden ist, greift TYPO3 auf den Default-Wert zurück. Mit folgendem Seiten-TSconfig-Code weisen Sie die Sprachwerte den beiden ersten Listeneinträgen zu:

6.4 Inhaltsspalten umbenennen | 205 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

TCEFORM.tt_content { colPos.altLabels.0 = LLL:EXT:extension_key/locallang_tca.xml:colPos.I.0 colPos.altLabels.1 = LLL:EXT:extension_key/locallang_tca.xml:colPos.I.1 }

Links

Wenn Sie, wie in Rezept 6.2 beschrieben, eigene Inhaltsspalten erzeugt haben, sollten Sie diese auch mehrsprachig auslegen. Geben Sie dazu folgenden Code in die Datei ext_tables. php ein: $TCA['tt_content']['columns']['colPos']['config']['items']['4']['0'] = 'LLL:EXT:extension_key/locallang_tca.xml:colPos.I.4';

Siehe auch In Rezept 6.2 erfahren Sie, wie Sie die Anzahl der Inhaltsspalten erhöhen können. Dagegen erläutert Rezept 6.3 die nötigen Schritte, um die Anzahl der Inhaltsspalten zu verringern. Mehr über die Entwicklung von Extensions erfahren Sie in Kapitel 16; dort wird auch der Umgang mit dem TCA genauer erläutert.

6.5

Auswahllisten optimieren

Lizensiert für Markus Mueller

Problem Sie möchten in Auswahllisten die Auswahlmöglichkeiten in Backend-Eingabefeldern begrenzen, neue Optionen hinzufügen oder bestehende Einträge umbenennen.

Lösung Passen Sie die Auswahllisten über die TCEFORM-Funktionen removeItems, addItems oder altLabels an. Jede dieser Funktionen muss eindeutig einem Feld zugewiesen werden. Dazu benötigen Sie den Tabellen- und den Feldnamen. Anhand dieser beiden Werte formulieren Sie dann den eigentlichen TSconfig-Befehl, den Sie in das Feld TSconfig einer Seite eingeben. Sämtliche Eingabemasken unterhalb dieser Seite werden dementsprechend angepasst. Mit removeItems blenden Sie einzelne Optionen aus. Der Funktionsaufruf folgt dabei diesem Muster: TCEFORM.tabelle.feld.removeItems = wert

Der Platzhalter wert entspricht dabei dem Wert der Option in der Auswahlliste. Zum Beispiel können Sie damit die Auswahlliste Spalten anpassen, wenn Sie – wie in Rezept 6.3 beschrieben – die Inhaltsspalten im Modul Seite reduziert haben. Mit folgendem TSconfigBefehl blenden Sie die Spalten Links und Rand aus:

Max. Linie

TCEFORM.tt_content { colPos.removeItems = 1,3 }

206 | Kapitel 6: Das Backend anpassen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Möchten Sie das Auswahlfeld erweitern, fügen Sie mit dem Befehl addItems neue Optionen hinzu. Geben Sie dabei mit folgendem TSconfig-Code den Wert und den Titel der neuen Option an: TCEFORM.tabellen_name.feld_name.addItems.feld_wert = feld_titel

Achten Sie darauf, dass der Wert nur einmal in der Auswahlliste vorkommen darf, da TYPO3 die Werte ansonsten nicht eindeutig interpretieren kann. Wenn Sie zum Beispiel einen neuen Überschriftentyp erzeugen möchten, werden Sie das Feld header_layout in der Eingabemaske für die Tabelle tt_content anpassen müssen. Für das folgende Beispiel legen wir eine neue Überschrift mit dem Wert 6 und dem Titel Eigenes Layout an: TCEFORM.tt_content.header_layout.addItems.6 = Eigenes Layout

Nach dem Abspeichern der Seiteneigenschaften wird der neue Überschriftentyp dann wie gewünscht in der Auswahlliste Typ im Bereich Überschrift eingebunden (in Rezept 15.6 erfahren Sie, wie Sie eigene Überschriftentypen auch über eine Extension erzeugen können). Mit altLabels vergeben Sie alternative Beschriftungen für vorhandene Einträge in Auswahllisten. Der Code ist dabei wie bei addItems aufgebaut und unterscheidet sich lediglich im Funktionsaufruf: Lizensiert für Markus Mueller

TCEFORM.tabellen_name.feld_name.altLabels.feld_wert = feld_titel

Über den Feldwert sprechen Sie die jeweilige Option in der Auswahlliste an, deren Titel Sie abändern möchten. Der Wert feld_titel ersetzt den entsprechenden Titel der Option. Mit folgendem TSconfig-Code ändern Sie beispielsweise die Bezeichnung für die Überschrift 1 von Layout 1 auf die eigene Bezeichnung Seitenüberschrift: TCEFORM.tt_content { header_layout.altLabels.1 = Seitenüberschrift }

Um Ihre eigenen Beschriftungen mehrsprachig anzulegen, sollten Sie die Lokalisierungsmechanismen von TYPO3 nutzen. Ersetzen Sie dazu den Wert Seitenüberschrift durch einen dynamischen Zeiger auf einen Sprachwert in einer speziellen Sprachdatei, in die Sie die jeweiligen Sprachwerte auslagern. Diese Sprachdatei stellen Sie über eine eigene Extension zur Verfügung. TYPO3 ermittelt dann automatisch anhand der jeweiligen Einstellungen des Backend-Benutzers den richtigen Sprachwert oder greift auf den Standardwert zurück, wenn keine passende Übersetzung vorhanden ist. Diese Zeiger sind dabei stets nach folgendem Muster aufgebaut: TCEFORM.tt_content { header_layout.altLabels.1 = LLL:EXT:extension_key/locallang.xml:zeiger }

Max. Linie

Max. Linie 6.5 Auswahllisten optimieren | 207 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Links

Diskussion Die oben genannten Einstellungen haben Auswirkungen auf sämtliche Formulare, in denen das Feld vorkommt. Was aber, wenn Sie das Feld nur in bestimmten Datensätzen anpassen möchten? Mit folgendem TCEFORM-Code legen Sie fest, in welchen Inhaltselementen Ihre Anpassung umgesetzt wird. Als Befehl können Sie alle drei anfangs genannten Möglichkeiten verwenden: TCEFORM.tabelle.feld.types.inhaltselement.funktion = wert

So können Sie im Inhaltselement Tabelle die Einträge im Layoutfeld anders benennen als im Inhaltselement Aufzählung: TCEFORM.tt_content { layout.types.table.altLabels.0 = Layout Tabelle layout.types.bullets.altLabels.0 = Layout Aufzählung }

Als Inhaltselemente stehen Ihnen die Werte aus der Tabelle 6-1 zur Verfügung: Tabelle 6-1: Die verschiedenen Inhaltselemente

Lizensiert für Markus Mueller

Max. Linie

Inhaltselement

Beschreibung

header

Überschrift

text

Text

textpic

Text mit Bild

image

Bild

bullets

Aufzählung

table

Tabelle

uploads

Dateiverweise

multimedia

Multimedia

mailform

Formular

search

Suchen

login

Anmeldung

menu

Menü/Sitemap

shortcut

Datensatz einfügen

list

Plugin einfügen

script

Skript

div

Trenner

html

HTML-Code

Die Auswahlmöglichkeiten für Seitentypen, Inhaltselemente, Plugins oder Sprachen können Sie auch über die Benutzereinstellungen begrenzen. Diese Einstellungen legen Sie dabei individuell für jede Benutzergruppe fest. Gehen Sie dazu wie folgt vor:

208 | Kapitel 6: Das Backend anpassen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Legen Sie eine Benutzergruppe an und aktivieren Sie dort unter Zugriffsliste das Kontrollkästchen Zugriffslisten mit einschließen. Speichern Sie den Datensatz, falls die Eingabemaske nicht automatisch neu geladen wird. Danach erscheinen weitere Auswahlfelder, mit denen Sie die Rechte dieser Gruppe sehr fein festlegen können. Mit den Einträgen im Bereich Seitentypen bestimmen Sie den Umfang der Auswahlmöglichkeiten der unterschiedlichen Seitentypen in der Eingabemaske der Seiteneigenschaften. Alle aktivierten Seitentypen dürfen von den Benutzern verwendet werden. Im Bereich Erlaubte Ausschlussfelder legen Sie fest, welche Einträge oder Optionen ausgeblendet werden. Wenn Sie im Abschnitt Seiteninhalt: Typ die jeweiligen Kontrollkästchen aktivieren, werden die entsprechenden Optionen im Feld Typ der Inhaltselemente deaktiviert. Mit den Kontrollkästchen im Abschnitt Seiteninhalt: Erweiterung legen Sie fest, welche Extensions auf den Seiten verwendet werden dürfen. Im Bereich Auf Sprachen einschränken bestimmen Sie, welche Sprache die Benutzer bearbeiten dürfen.

Siehe auch In Rezept 6.2 erfahren Sie, wie Sie neue Inhaltsspalten im Backend integrieren.

Lizensiert für Markus Mueller

6.6

Eingabefelder und Bearbeitungsmöglichkeiten reduzieren

Problem Sie möchten im Backend Eingabefelder oder Optionen ausblenden, um die Oberfläche auf die nötigsten Formularfelder zu begrenzen.

Lösung Steuern Sie die Darstellung der Formulare per Seiten-TSconfig über die entsprechenden TCEFORM-Einstellungen. Mithilfe dieser Einstellungen beeinflussen Sie die TYPO3Formular-Rendering-Engine und können dadurch sehr fein bestimmen, welche Felder TYPO3 in den Backend-Formularen darstellt und welche ausgeblendet werden. TCEFORM-Einstellungen legen Sie im TSconfig-Feld einer Seite ab, sodass sie – wie alle Seiten-TSconfig-Angaben – auch auf ganze Seitenbäume angewendet werden können. So können Sie Eingabemasken für einzelne Seiten oder Seitenbäume anpassen. Um Eingabefelder auszublenden, geben Sie den Code stets nach folgendem Muster ein: TCEFORM.tabellen_name.feld_name.disabled = 1

Max. Linie

Max. Linie 6.6 Eingabefelder und Bearbeitungsmöglichkeiten reduzieren | 209 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Der Tabellenname steht für die Tabelle, deren Bearbeitungsmaske Sie ändern möchten. Häufig verwendete Tabellennamen sind tt_content für Seiteninhalte und pages für Seiten. Der Feldname bezieht sich direkt auf das Tabellenfeld. Dieses wird mit dem Befehl disabled vollständig ausgeblendet und für die Bearbeitung gesperrt. Wenn Sie das Feld jedoch bei bestimmten Typen wieder einblenden möchten, können Sie den TSconfigCode mit folgender Zeile ergänzen (in der Diskussion von Rezept 6.5 finden Sie eine Übersicht der vorhandenen Formulartypen für Inhaltselemente):

Links

TCEFORM.tabellen_name.feld_name.types.formulartyp.disabled = 1

Beispielsweise blenden Sie mit folgendem Code das Feld Überschrift bei allen Seiteninhalten aus: TCEFORM.tt_content.header.disabled = 1

Um das Feld beim Inhaltstyp Überschrift wieder anzuzeigen, ergänzen Sie den Code um folgende Zeile: TCEFORM.tt_content.header.types.header.disabled = 0

Diskussion Lizensiert für Markus Mueller

Falls Sie die notwendigen Angaben für den Tabellen- oder Feldnamen nicht auswendig kennen, bietet Ihnen TYPO3 mit dem Modul Konfiguration eine komfortable Möglichkeit, die Struktur sämtlicher in TYPO3 registrierten Tabellen einzusehen. Wechseln Sie dazu in das Modul Konfiguration und wählen Sie in der Auswahlliste Menü den Eintrag $TCA (tables.php). TYPO3 zeigt Ihnen daraufhin die Namen der vorhandenen Tabellen. Mithilfe der Plus- und Minussymbole können Sie die Detailinformationen der Tabellen aus- und einklappen. Öffnen Sie dann für die gewünschte Tabelle den Bereich columns. Sie erhalten daraufhin für die jeweilige Tabelle eine Liste aller Spalten, die Sie über den eingangs genannten TCEFORM-Befehl ausblenden können. Notieren Sie sich den Tabellen- und den Feldnamen und formulieren Sie gemäß dem oben genannten Muster Ihre TCEFORM-Angabe. Wenn mehrere Personen an der Website arbeiten, sollten Sie darauf achten, dass alle Einstellungen sofort nach dem Speichern in Kraft treten. Ändern Sie die Oberfläche mit den oben genannten Angaben, sollten Sie dies vorher ankündigen, um Verwirrung zu vermeiden.

Siehe auch In Rezept 16.11 erfahren Sie, welche Bedeutung die Formulartypen haben. Die Diskussion von Rezept 4.6 zeigt einen Überblick über die möglichen Seitentypen, falls Sie die Eingabeformulare von Seiten anpassen möchten.

Max. Linie

Max. Linie 210 | Kapitel 6: Das Backend anpassen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Rechts

6.7

Eingabefelder anpassen

Problem Sie möchten Felder von Eingabeformularen anpassen, beispielsweise um einzeilige Eingabefelder in mehrzeilige Textfelder umzuwandeln.

Lösung Ändern Sie die Eigenschaften des jeweiligen Eingabefelds über eine Extension. Ermitteln Sie dazu zuerst die aktuelle Feldkonfiguration über das Modul Konfiguration. Wählen Sie dort in der Auswahlliste Menü den Eintrag $TCA (tables.php). TYPO3 zeigt Ihnen daraufhin die Namen aller vorhandenen Tabellen, deren Eingabefelder Sie anpassen können. Mithilfe der Plus- und Minuszeichen klappen Sie die weiteren Informationen zu diesen Tabellen aus oder ein. Öffnen Sie dann für die gewünschte Tabelle den Unterbereich columns. In diesem Bereich erhalten Sie eine Liste aller verfügbaren Eingabefelder. Erweitern Sie anschließend das Feld und dessen Unterbereich config. Hier können Sie nun die eigentlichen Feldeigenschaften einsehen. Lizensiert für Markus Mueller

Klicken Sie im nächsten Schritt auf den gewünschten Parameter in den eckigen Klammern. Daraufhin erscheint am Seitenanfang ein Eingabefeld, in dem der aktuelle Wert dieses Parameters angezeigt wird. Geben Sie diesen Wert nun in die Datei ext_tables.php Ihrer Extension ein und ändern Sie den Wert nach Ihren Wünschen. Laden Sie dazu das TCA der Tabelle und passen Sie über die geänderte Wertzuweisung die Eigenschaften des Felds an. Achten Sie darauf, dass Sie vor der Änderung das TCA der jeweiligen Tabelle in das Skript mit einbinden, um sicherzustellen, dass Sie die Angaben im TCA der Tabelle anpassen können. Dies erfolgt über den Funktionsaufruf t3lib_div:: loadTCA('tabellen_name'). Ansonsten kann es passieren, dass das TCA zum aktuellen Zeitpunkt noch nicht verfügbar ist und Ihre Anpassungen nicht übernommen werden. Mit dem Funktionsaufruf fügen Sie sämtliche TCA-Informationen an der aktuellen Position ein, sodass Sie darauf zugreifen können. Ändern Sie abschließend die Darstellung des Felds, indem Sie den Schlüsselwert type durch form_type ersetzen. Mit diesem Schlüsselwert weisen Sie TYPO3 an, das Feld im Backend lediglich anders darzustellen und ansonsten weiterhin passend zum ursprünglichen Feldtyp zu validieren und zu verarbeiten. Der Schlüsselwert form_type hat also nur Auswirkungen auf die Darstellung des Felds. Der Schlüsselwert type definiert hingegen die grundlegenden Feldeigenschaften. Der vollständige PHP-Code sollte am Ende nach folgendem Muster aufgebaut sein:

Max. Linie

t3lib_div::loadTCA('tabellen_name'); $TCA['tabellen_name']['columns']['feld_name']['config']['form_type'] = 'wert';

6.7 Eingabefelder anpassen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie | 211

Der Wert von type kann sich – je nachdem, welche Eigenschaft Sie anpassen möchten – von dem gezeigten Beispiel unterscheiden.

Links

Wir empfehlen Ihnen, diese Änderungen über eine Extension vorzunehmen, mit der Sie das TCA der gewünschten Tabelle anpassen (in Rezept 16.2 erfahren Sie, wie Sie eine Extension erstellen). Die Änderungen am TCA nehmen Sie über die Datei ext_tables.php vor, die Sie in dem jeweiligen Extension-Ordner finden (sollte die Datei nicht vorhanden sein, können Sie diese auch per Hand erstellen). In dieser Datei laden Sie zuerst das TCA der Tabelle und passen dann die Feldeigenschaften im Bereich config an.

Diskussion Zur Verdeutlichung wird im folgenden Beispiel das Feld Überschrift im Inhaltselement Text vom Typ input auf text umgestellt – dadurch werden mehrzeilige Texte möglich. Ermitteln Sie dazu zuerst nach der oben beschriebenen Methode den gewünschten Wert für das Feld Überschrift und ändern Sie dann über die Angaben in der Datei ext_tables. php die Werte.

Lizensiert für Markus Mueller

TYPO3 speichert die Überschriften der Inhaltselemente standardmäßig im Feld header der Tabelle tt_content. Ermitteln Sie also im Modul Konfiguration in der Tabelle tt_content über die Einstellungen für das Feld header den Wert type. Dieser ist durch folgende TCAAngabe standardmäßig auf input gesetzt: $TCA['tt_content']['columns']['header']['config']['type'] = 'input';

Geben Sie diesen Code nun in die Datei ext_tables.php ein und ändern Sie den Wert input auf den Wert text. Zudem ändern Sie den Schlüsselwert type auf form_type, um die Änderung des Typs auf die Felddarstellung im Backend zu begrenzen: t3lib_div::loadTCA('tt_content'); $TCA['tt_content']['columns']['header']['config']['form_type'] = 'text';

Sie könnten die Darstellung auch direkt über den Schlüsselwert type anpassen, jedoch kann es dadurch zu Nebeneffekten mit Validierungsfunktionen in TYPO3 kommen, da Sie dadurch direkt in die Feldkonfiguration eingreifen. Der Schlüsselwert form_type wirkt sich hingegen nur auf die Felddarstellung im Backend aus und wird bei allen anderen Prozessen ignoriert. Mit form_type erreichen Sie also eine sauberere Trennung von Feldlogik und Felddarstellung und machen Ihre Änderung automatisch transparenter bzw. auch für andere Entwickler nachvollziehbarer. Beachten Sie, dass der Spaltentyp in der Tabelle tt_content für die Überschrift vom Typ tinytext ist. Das bedeutet, dass maximal 256 Zeichen als Überschrift gespeichert werden

Max. Linie

können. Vermeiden Sie daher die Eingabe von längeren Inhalten, da diese nicht in der Datenbank gespeichert werden können, oder erweitern Sie den Spaltentyp in der Datenbank auf einen passenden Typ, zum Beispiel text.

212 | Kapitel 6: Das Backend anpassen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Mit den oben genannten Anpassungen können Sie zahlreiche Feldkonfigurationen der vorhandenen Felder anpassen. Für jeden Feldtyp gibt es diverse Einstellungsmöglichkeiten. Eine vollständige Liste der jeweiligen Parameter finden Sie in der offiziellen Dokumentation unter dem Link http://typo3.org/documentation/document-library/core-documentation/ doc_core_api/current/view/4/2/. Beachten Sie bei Änderungen dieser Art immer auch die jeweiligen Feldeinstellungen in der Datenbank. Auch wenn Sie im TCA einen größeren Feldwert erlauben, können Sie diesen nicht in der Datenbank abspeichern, wenn das entsprechende Feld in der Datenbank nicht korrekt konfiguriert ist. Zudem würde TYPO3 beim Speichern eine Meldung darüber ausgeben, dass der Wert nicht vollständig gespeichert werden konnte. Kontrollieren Sie daher vor diesen Anpassungen die jeweiligen Feldeigenschaften und ändern Sie sie entsprechend ab.

Siehe auch

Lizensiert für Markus Mueller

In Rezept 2.5 erfahren Sie mehr über die einzelnen Tabellen, deren Eingabefelder Sie anpassen können. Die Grundlagen der Extension-Erstellung werden in Rezept 16.2 erläutert. In Rezept 16.3 erhalten Sie Einblick in die Integration eigener Datenbankfelder in bestehende Tabellen. Dort erfahren Sie auch, wie Sie die jeweiligen Feldeigenschaften bequem über den Extension-Kickstarter festlegen können.

6.8

Die Auswertung von Eingabefeldern anpassen

Problem Sie möchten in Ihren Eingabefeldern nur bestimmte Inhalte speichern und vor dem Speichern der Inhalte in der Datenbank sicherstellen, dass die Daten in einer gültigen Form vorliegen.

Lösung Verwenden Sie die entsprechende eval-Funktion für das gewünschte Eingabefeld. Registrieren Sie diese eval-Funktionen in den Feldeigenschaften.

Max. Linie

Beispielsweise können Sie so Pflichtfelder bestimmen oder die Eingabe per JavaScript verarbeiten, etwa um in einem Eingabefeld führende Leerzeichen zu entfernen. Diese Kontrollmechanismen definieren Sie in den Feldeigenschaften, sodass sie bei der Formularerzeugung automatisch von TYPO3 eingebunden werden. Sämtliche Kontrollmechanismen geben Sie in der Eigenschaft eval an (eval ist die Abkürzung für evaluation = Auswertung).

6.8 Die Auswertung von Eingabefeldern anpassen | 213 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Links Beachten Sie, dass diese Eingaberegeln nur von einzeiligen Eingabefeldern unterstützt werden.

Ändern Sie die Eigenschaften des jeweiligen Eingabefelds über eine Extension (falls Sie im Umgang mit Extensions noch nicht geübt sind, erhalten Sie in Rezept 16.2 das nötige Hintergrundwissen). Ermitteln Sie dazu zuerst die aktuellen Feldeigenschaften über das Modul Konfiguration, denn es kann sein, dass das gewünschte Feld schon über solche Kontrollfunktionen verfügt. Diese können Sie weiterhin nutzen bzw. erweitern. Andernfalls finden Sie so auch schnell die richtige Stelle, über die Sie die neuen Kontrollfunktionen registrieren und das Feld um eine solche Eigenschaft erweitern können.

Lizensiert für Markus Mueller

Wählen Sie im Modul Konfiguration in der Auswahlliste Menü am Seitenanfang den Eintrag $TCA (tables.php). TYPO3 zeigt Ihnen daraufhin die Namen aller vorhandenen Tabellen, deren Eingabefelder Sie anpassen können. Mithilfe der Plus- und Minussymbole klappen Sie die weiteren Informationen zu diesen Tabellen aus oder ein. Öffnen Sie dann für die gewünschte Tabelle den Unterbereich columns. In diesem Bereich erhalten Sie eine Liste aller verfügbaren Eingabefelder. Erweitern Sie anschließend das Feld und dessen Unterbereich config. Hier können Sie nun die eigentlichen Feldeigenschaften einsehen. Wenn Sie dort den Wert eval sehen, klicken Sie darauf. Sie erhalten dadurch die aktuellen Überprüfungsfunktionen der Felder, die Sie erweitern können. Ansonsten klicken Sie auf den Wert config, um die Feldeigenschaften manuell zu erweitern. Daraufhin erscheint am Seitenanfang ein Eingabefeld, in dem der aktuelle Wert dieses Parameters angezeigt wird. Geben Sie ihn nun in die Datei ext_tables.php Ihrer Extension ein und ändern Sie den Wert nach Ihren Wünschen, sodass der Code nach folgendem Muster aufgebaut sein sollte: $TCA['tabellen_name']['columns']['feld_name']['config']['eval'] = 'eval_funktion';

Fügen Sie anschließend über dieser Zeile noch folgenden Funktionsaufruf hinzu: t3lib_div::loadTCA('tabellen_name');

Dort laden Sie anschließend das TCA der Tabelle und passen über die geänderten Wertzuweisungen die Eigenschaften des Felds an. Achten Sie darauf, dass Sie vor der Änderung das TCA der jeweiligen Tabelle in das Skript mit einbinden, um sicherzustellen, dass Sie die Angaben im TCA der Tabelle anpassen können. Dies erfolgt über den Funktionsaufruf t3lib_div::loadTCA('tabellen_name'). Ansonsten kann es passieren, dass das TCA zum aktuellen Zeitpunkt noch nicht verfügbar ist und dadurch Ihre Anpassungen nicht übernommen werden können. Der vollständige PHP-Code sollte am Ende nach folgendem Muster aufgebaut sein: t3lib_div::loadTCA('tabellen_name'); $TCA['tabellen_name']['columns']['feld_name']['config']['eval'] = 'eval_funktion';

Max. Linie

Wenn Sie den config-Bereich manuell erweitern müssen, sollten Sie besonders darauf achten, dass der Schlüsselwert ['eval'] vorhanden ist.

214 | Kapitel 6: Das Backend anpassen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Sie können dabei auch mehrere eval-Funktionen auf ein Eingabefeld anwenden. Trennen Sie diese einfach durch Kommata voneinander. Mit folgendem PHP-Code bestimmen Sie zum Beispiel, dass die vorhandenen Leerzeichen am Anfang und Ende der Zeichenkette automatisch entfernt werden und das Feld Überschrift als Pflichtfeld gekennzeichnet wird: $TCA['tt_content']['columns']['header']['config']['eval'] = 'trim,required';

Folgende eval-Funktionen stehen Ihnen standardmäßig zur Verfügung:

Allgemein required

Das Feld wird zu einem Pflichtfeld. Ist es leer, kann das Formular nicht abgespeichert werden. unique

Das Feld muss einen eindeutigen Wert speichern, der noch nicht in Datensätzen dieser Tabelle auf der aktuellen Seite vorkommen darf. Auf anderen Seiten darf der gleiche Wert jedoch vorkommen. uniqueInPid

Das Feld muss einen eindeutigen Wert speichern, der noch nicht in Datensätzen dieser Tabelle innerhalb des aktuellen Seitenbaums vorkommen darf. Lizensiert für Markus Mueller

Datum und Uhrzeit date

Der Wert wird zu einem Datum umgewandelt und als Unix-Zeitstempel abgespeichert. datetime

Der Wert wird zu einem Datum inklusive Uhrzeitangabe umgewandelt und als UnixZeitstempel abgespeichert. time

Der Wert wird zu einer Uhrzeit umgewandelt. Die Uhrzeit wird in Sekunden in der Datenbank abgespeichert. timesec

Der Wert wird zu einer Uhrzeit inklusive zwei Stellen für Sekunden umgewandelt und in Sekunden in der Datenbank abgespeichert. year

Der Wert wird zu einer Jahreszahl umgewandelt. Diese Jahrezahl kann zwischen 1970 und 2038 liegen. Für andere Jahreszahlen sollten Sie die eval-Funktion int verwenden und die maximale Zeichenlänge auf vier Stellen begrenzen.

Max. Linie

In jedem Datumsfeld können Sie mit folgenden Zeichen den jeweils aktuellen Zeitwert ermitteln: d steht für day und setzt automatisch den aktuellen Zeitstempel ein (alternativ dazu können Sie t für today oder n für now verwenden).

6.8 Die Auswertung von Eingabefeldern anpassen | 215 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Wenn Sie ein +1 in das Datumsfeld eingeben, wird der Wert entsprechend erhöht. Analog dazu setzen Sie mit -1 einen Wert je nach Feld um einen Tag oder eine Stunde zurück.

Links

Zeichenketten filtern alpha

Erlaubt nur Zeichen von a bis z sowie deren Großbuchstaben. num

Erlaubt nur Zahlen von 0 bis 9. alphanum

Erlaubt nur Zeichen von a bis z sowie deren Großbuchstaben und Zahlen von 0 bis 9, jedoch keine Sonderzeichen. alphanum_x

Erlaubt nur Zeichen von a bis z sowie deren Großbuchstaben und Zahlen von 0 bis 9 und die Sonderzeichen _ und - . is_in

Erlaubt nur eine vordefinierte Zeichenkette, die Sie mit is_in in den Feldeigenschaften registrieren können. Eine Erklärung zu dieser Funktion finden Sie im Abschnitt »Weitere Feldeigenschaften« weiter unten. Lizensiert für Markus Mueller

trim

Entfernt analog zur gleichnamigen PHP-Funktion die führenden und abschließenden Leerzeichen aus der Zeichenkette. nospace

Entfernt sämtliche Leerzeichen aus der Zeichenkette.

Zeichenketten verarbeiten int

Wandelt die Eingabe in einen ganzzahligen Zahlenwert um. double2

Wandelt den Wert in eine Gleitkommazahl mit zwei Stellen um. password

Wandelt den Wert in eine verschlüsselte Zeichenkette um, wenn das Feld verlassen wird. Der Text wird danach nur noch durch Sternchen verschlüsselt angezeigt, sodass er nicht mehr im Klartext lesbar ist. md5

Wandelt den Wert in einen MD5-Hash um. upper

Wandelt den Wert in Großbuchstaben um.

Max. Linie

lower

Wandelt den Wert in Kleinbuchstaben um.

216 | Kapitel 6: Das Backend anpassen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts Weitere Feldeigenschaften Zusätzlich gibt es neben eval noch weitere Feldeigenschaften, die mit den oben genannten eval-Funktionen zusammenspielen oder diese ergänzen: max

Legt die maximale Anzahl der Zeichen fest, die in dem Feld eingegeben werden dürfen (die Angabe entspricht dabei dem Wert maxlength, den Sie in HTML für die maximale Zeichenlänge bei Eingabefeldern verwenden können). is_in

Hiermit legen Sie die Zeichen fest, die in dem Feld ausschließlich vorkommen dürfen. Die eigentliche Überprüfung legen Sie mit der eval-Funktion is_in fest. $TCA['tabellen_name']['columns']['feld_name']['config']['eval'] = 'is_in'; $TCA['tabellen_name']['columns']['feld_name']['config']['is_in'] = 'TYPO3';

Somit werden nur die Zeichen T, Y, P, O und 3 nach der Eingabe übernommen. range

Lizensiert für Markus Mueller

Überprüft nach dem Speichern die eingegebenen Zahlenwerte auf einen Minimalund Maximalwert (beide Angaben können unabhängig voneinander angegeben werden): lower legt den Minimalwert fest, upper den Maximalwert (verwechseln Sie diese Einstellungen nicht mit den oben genannten eval-Funktionen lower und upper, mit denen Sie die Zeichenkette in Klein- bzw.Großbuchstaben umwandeln können). Mit folgendem Code können Sie beispielsweise Jahreszahlen von 1906 bis 2050 erlauben: $TCA['tabellen_name']['columns']['feld_name']['config']['max'] = '4'; $TCA['tabellen_name']['columns']['feld_name']['config']['eval'] = 'int'; $TCA['tabellen_name']['columns']['feld_name']['config']['range'] = array( 'lower' => 1906, 'upper' => 2050 );

Diskussion

Max. Linie

Zusätzlich zu den vorhandenen Überprüfungsfunktionen können Sie auch eigene Funktionen definieren und in die Formularverarbeitung einbinden. Dabei stehen Ihnen zwei Möglichkeiten zur Verfügung: Zum einen können Sie das Feld mit einer eigenen JavaScriptFunktion bearbeiten und so vor dem Versenden auf seine Gültigkeit hin überprüfen. Zum anderen können Sie den Feldinhalt auch nach dem Versenden des Formulars mit einer eigenen PHP-Funktion überprüfen. Als Grundlage für diese individuelle Verarbeitungsmöglichkeit dient in beiden Fällen eine PHP-Klasse, in der Sie die jeweiligen Funktionen implementieren. Anschließend registrieren Sie diese PHP-Klasse über eine sogenannte ScriptClass-Variable. Dadurch kann Ihre Klasse von TYPO3 bei der Verarbeitung der Backend-Formulare berücksichtigt werden. Abschließend geben Sie den Namen der PHPKlasse als eval-Funktion in den Feldeigenschaften an, sodass die entsprechenden Funktionen bei der Darstellung des Formulars auch berücksichtigt werden.

6.8 Die Auswertung von Eingabefeldern anpassen | 217 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Erstellen Sie dazu nun im ersten Schritt eine neue PHP-Datei im Extension-Verzeichnis und speichern Sie diese unter dem Namen class.tx_extensionkey_evalfunc1.php ab. Der Dateiname setzt sich aus dem Extension-Key (ohne Unterstriche) und der Funktionsbeschreibung zusammen. Zusätzlich erhält jede Datei am Ende einen Zähler, wodurch es später leichter wird, weitere eval-Funktionen einzurichten.

Links

In dieser Datei definieren Sie nun die folgende Klasse samt der Methode, die später den Feldinhalt per JavaScript analysiert: class tx_extensionkey_evalfunc1 { function returnFieldJS() { return ' return value; '; } }

Achten Sie darauf, dass der Klassenname mit dem Präfix tx_ beginnt. Ansonsten werden die Methoden der Klasse nicht bei der Überprüfung berücksichtigt.

Lizensiert für Markus Mueller

Beachten Sie hierbei, dass Sie über die PHP-Funktion JavaScript zurückgeben. Die Schreibweise sieht daher vielleicht auf den ersten Blick etwas ungewohnt aus. Mit dem folgenden Code würden Sie zum Beispiel den aktuellen Benutzernamen an den aktuellen Feldwert anhängen, wenn der Benutzer die Eingabe beendet und in das nächste Feld wechselt: class tx_extensionkey_evalfunc1 { function returnFieldJS() { $username = $GLOBALS['BE_USER']->user['username']; return ' return value + " ('. $username .')"; '; } }

Um die Werte nach dem Absenden serverseitig zu überprüfen, fügen Sie noch folgende Methode in die bestehende Klasse ein: ... function evaluateFieldValue($value, $is_in, $set) { return $value; } ...

Achten Sie darauf, dass Sie die notwendigen Parameter angeben, um eine reibungslose Verarbeitung zu ermöglichen. Die Parameter haben folgende Bedeutung: $value

Max. Linie

Übergibt den eigentlichen Feldwert, den Sie weiter analysieren können. Diesen Wert müssen Sie unbedingt wieder über return zurückgeben.

218 | Kapitel 6: Das Backend anpassen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts $is_in

Ein optionaler Parameter, der diejenigen Zeichen enthält, die in dem Wert vorkommen müssen, falls die eval-Funktion is_in angewandt wird. Damit können Sie beispielsweise den Wert nach bestimmten Textmustern untersuchen. $set

Wenn dieser Wert gesetzt ist, darf der Wert geändert werden. Ansonsten sollte er nur durchgereicht werden. Selbstverständlich können Sie beide Funktionen auch gleichzeitig verwenden, sodass in der Datei am Ende folgender PHP-Code vorhanden ist: class tx_extensionkey_evalfunc1 { function returnFieldJS() { return ' return value; '; } function evaluateFieldValue($value, $is_in, $set) { return $value; } } Lizensiert für Markus Mueller

Speichern Sie diese Datei nun ab und wechseln Sie anschließend in die Datei ext_localconf. php. Dort registrieren Sie die eben erstellte Klasse über die folgende Variablenzuweisung in der TYPO3-Klasse, die für die Formularerzeugung im Backend verantwortlich ist. Diese Zuweisung ist dabei stets nach folgendem Muster aufgebaut: $TYPO3_CONF_VARS['SC_OPTIONS']['tce']['formevals']['eval_funktion'] = pfad_zur_phpdatei;

Die eval-Funktion entspricht dabei dem Namen Ihrer PHP-Klasse. Für das oben genannte Beispiel würden Sie also diese Zeile einfügen: $TYPO3_CONF_VARS['SC_OPTIONS']['tce']['formevals']['tx_extensionkey_evalfunc1'] = 'EXT:extension_key/class.tx_extensionkey_evalfunc1.php';

Abschließend können Sie Ihre eigene eval-Funktion des Felds nach folgendem Muster anwenden: $TCA['tt_content']['columns']['feld_name']['config']['eval'] = 'tx_extensionkey_evalfunc1';

Dadurch lassen sich Überprüfungsroutinen einbinden, mit denen Sie auf sehr flexible Art und Weise die Eingabemöglichkeiten kontrollieren können.

Max. Linie

Max. Linie 6.8 Die Auswertung von Eingabefeldern anpassen | 219 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

6.9

Die Anordnung von Eingabefeldern ändern

Links

Problem Sie möchten die Position von Eingabefeldern anpassen, beispielsweise um eigene Felder an bestimmte Positionen im Formular zu verschieben.

Lösung Ändern Sie die Anordnung der Feldnamen im Wert showitem des jeweiligen Formulartyps. Die Formulartypen werden im TCA-Abschnitt types der entsprechenden Tabelle gespeichert. Wir empfehlen Ihnen, diese Änderungen über eine neue Extension vorzunehmen, mit der Sie das TCA der gewünschten Tabelle anpassen (in Rezept 16.2 erfahren Sie, wie Sie eine Extension erstellen). Die Änderungen am TCA nehmen Sie über die Datei ext_tables.php vor, die sich in dem Extension-Ordner befinden muss. Dort laden Sie zuerst das TCA der Tabelle und passen dann die Feldanordnung im Bereich showitem für den jeweiligen Formulartyp an. Lizensiert für Markus Mueller

Ermitteln Sie dazu zuerst die Feldtypen und deren Felder. Wechseln Sie in das Modul Konfiguration und wählen Sie in der Auswahlliste Menü den Eintrag $TCA (tables.php). Daraufhin erscheinen die Namen der im TCA registrierten Tabellen. Mithilfe der Plusund Minuszeichen können Sie die Detailinformationen dieser Tabellen aus- und einklappen. Öffnen Sie dann für die gewünschte Tabelle den Bereich types. Sie erhalten eine Liste aller verfügbaren Formulartypen, die Sie anpassen können (der Standardtyp ist immer 0). Öffnen Sie anschließend den gewünschten Typ und klicken Sie auf dessen Eigenschaft showitem. Daraufhin erscheint am Seitenanfang ein Eingabefeld, in dem der aktuelle Inhalt von showitem angezeigt wird. Übernehmen Sie diesen Wert in die Datei ext_tables.php Ihrer Extension und ändern Sie die Anordnung der Feldnamen. Dieser Wert ist dabei stets nach folgendem Muster aufgebaut: $TCA['tabellen_name']['types']['0']['showitem'] = 'feld1,feld2,...';

Das Eingabefeld feld2 würde in der Eingabemaske unterhalb von feld1 angezeigt werden. Um das Feld feld1 nun vor feld2 zu setzen, setzen Sie den Wert feld2 einfach vor den Wert feld1. Jeder Eintrag in showitem kann über vier zusätzliche Werte verfügen, mit denen das Feld individuell angepasst werden kann. Achten Sie beim Ändern der Position darauf, dass Sie die zusätzlichen Feldparameter nicht durcheinander bringen. Diese sind direkt mit dem Feldnamen verknüpft und dürfen sich durch die Verschiebung der Felder nicht ändern. Diese Parameter sind wie folgt aufgeteilt:

Max. Linie

..., wert_1; wert_2; wert_3; wert_4; wert_5, ...

220 | Kapitel 6: Das Backend anpassen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Der erste Wert wert_1 steht für den Feldnamen. Mit wert_2 vergeben Sie alternative Feldbeschriftungen. Die Angabe in wert_3 steht für eine Paletten-ID. Damit können Sie Feldgruppen aus palettes verknüpfen und in der zweiten Optionspalette unterhalb des Felds anzeigen. Spezielle Einstellungen für Textfelder speichern Sie in wert_4. So können Sie beispielsweise interaktive Eingabefelder (RTE) anpassen oder das Verhalten für Zeilenumbrüche festlegen. Mit wert_5 legen Sie Darstellungsoptionen des Felds fest (weitere Informationen zu diesen Parametern finden Sie in der Diskussion von Rezept 6.10). Geben Sie abschließend noch oberhalb der soeben erstellten Zeile den Funktionsaufruf t3lib_div::loadTCA() ein, um das TCA der jeweiligen Tabelle in Ihr PHP-Skript zu importieren. Erst dadurch werden Änderungen am TCA einer anderen Tabelle möglich. Der Code sollte nun nach folgendem Muster aufgebaut sein: t3lib_div::loadTCA('tabellen_name'); $TCA['tabellen_name']['types']['0']['showitem'] = 'feldnamen ...';

In diesem Beispiel wird der Feldtyp 0 vorausgesetzt. Manche Datensätze besitzen je nach Typ unterschiedliche Formularkonfigurationen (in Rezept 19.4 erfahren Sie mehr über den Zusammenhang von types und Eingabeformularen). Lizensiert für Markus Mueller

Max. Linie

Diskussion Mit den anfangs beschriebenen Schritten können Sie die Position von bestehenden Formularfeldern bequem anpassen. Was aber, wenn Sie eigene Felder in bestehende Formulare integrieren möchten? Um eigene Felder in die Formulare zu integrieren, gehen Sie wie folgt vor: Erstellen Sie eine Extension, mit der Sie eine bestehende Tabelle erweitern (als Grundlage dient dabei Rezept 16.3). Nachdem Sie diese Extension erstellt und installiert haben, öffnen Sie die Datei ext_tables.php. Dort finden Sie folgende Vorgaben, die vom Kickstarter eingefügt wurden: In der Variablen $tempColumns werden sämtliche Einstellungen der hinzugefügten Felder gespeichert. Über den Funktionsaufruf addTCAcolumns wird das bestehende TCA der gewünschten Tabelle erweitert. Die Funktion addToAllTCAtypes integriert Ihre neu erstellten Felder letztendlich in die bestehenden Formulartypen der Tabelle, indem sie an die vorhandenen Feldern angehängt werden. Der vom ExtensionKickstarter erzeugte Code ist dabei nach folgendem Muster aufgebaut: $tempColumns = array( 'feld_name' => array( 'exclude' => 1, 'label' => 'Titel', 'config' => array( 'type' => 'input', 'size' => '30', ) ), );

6.9 Die Anordnung von Eingabefeldern ändern | 221 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

t3lib_div::loadTCA('tabellen_name'); t3lib_extMgm::addTCAcolumns('tabellen_name', $tempColumns, 1); t3lib_extMgm::addToAllTCAtypes('tabellen_name','feld_name;;;;1-1-1');

Links

Um die Feldposition Ihrer Felder nun individuell zu bestimmen, fügen Sie dem Funktionsaufruf addToAllTCAtypes noch zwei weitere Parameter hinzu. Mit dem ersten Parameter können Sie den Formulartyp festlegen, in dem Ihr Feld ausschließlich eingefügt werden soll. Wenn der Wert leer ist, wird das Feld in jeden Feldtyp eingefügt (was standardmäßig auch der Fall ist). Mit dem zweiten Parameter können Sie über eine spezielle Syntax einen Feldnamen angeben, vor dem das Feld eingefügt wird. Der gesamte Funktionsaufruf ist dabei nach dem folgenden Muster aufgebaut (die Parameter sind diesmal der Übersichtlichkeit halber untereinander angeordnet, und die neuen Parameter werden hervorgehoben): t3lib_extMgm::addToAllTCAtypes ( 'tabellen_name', 'feld_name;;;;1-1-1', formular_typ, feld_position );

Hierbei würde das Feld feld_name vor das Feld feld_position gesetzt werden. Lizensiert für Markus Mueller

Wenn Ihnen die Verwendung dieser Funktion zu unflexibel erscheint, können Sie die Position der Felder auch leicht per Hand anpassen. Folgendes Beispiel soll diesen Vorgang verdeutlichen: Fügen Sie der Eingabemaske für Frontend-Benutzer das Feld Vorname hinzu. Dabei soll das neue Feld vor das bestehende Feld Name gesetzt werden. Öffnen Sie dazu die Datei ext_tables.php. Dort finden Sie den eingangs beschriebenen Code, der vom Kickstarter erzeugt wurde. Das Feld Vorname wird dadurch am Ende des Eingabeformulars angefügt. Beachten Sie, dass wir hier zum besseren Verständnis den Feldnamen vorname verwenden. Wenn Sie eine Tabelle über den Kickstarter erstellen, wird dieser Feldname durch den Extension-Key und das Präfix tx_ erzeugt und daher anders lauten: $tempColumns = array( 'vorname' => array( 'exclude' => 1, 'label' => 'Vorname', 'config' => array( 'type' => 'input', 'size' => '30', ) ), ); t3lib_div::loadTCA('fe_users'); t3lib_extMgm::addTCAcolumns('fe_users', $tempColumns, 1); t3lib_extMgm::addToAllTCAtypes('fe_users','vorname;;;;1-1-1');

Max. Linie

Im nächsten Schritt kommentieren Sie den Funktionsaufruf addToAllTCAtypes aus und nehmen die Anpassung im Bereich showitem manuell vor, indem Sie – wie anfangs in der

222 | Kapitel 6: Das Backend anpassen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Lösung beschrieben – die aktuelle Feldanordnung über das Modul Konfiguration ermitteln und anpassen (der Übersichtlichkeit halber werden die Feldwerte hier untereinander gesetzt):

Lizensiert für Markus Mueller

$tempColumns = array( 'vorname' => array( 'exclude' => 1, 'label' => 'Vorname', 'config' => array( 'type' => 'input', 'size' => '30', ) ), ); t3lib_div::loadTCA('fe_users'); t3lib_extMgm::addTCAcolumns('fe_users', $tempColumns, 1); // t3lib_extMgm::addToAllTCAtypes('fe_users','vorname;;;;1-1-1'); $TCA['fe_users']['types']['0']['showitem'] = ' username;;;;2-2-2, password, usergroup, lockToDomain, --div--, vorname;;;;1-1-1, name;;2;;3-3-3, address, zip, city, country, telephone, fax, email, www, image;;;;4-4-4, --div--, TSconfig;;;;5-5-5 ';

Wenn Sie das Eingabeformular öffnen, werden Sie feststellen, dass das Feld nun zwar direkt in das Formular integriert ist, aber noch durch einen Abstand vom Eingabefeld Name getrennt erscheint. Dieser Abstand wird durch den fünften Parameter 3-3-3 beim Feld name erzeugt. Entfernen Sie nun diese Angabe beim Feld name und setzen Sie sie in die Feldkonfiguration des Felds vorname ein, sodass Sie anschließend diese Feldkonfiguration haben: $TCA['fe_users']['types']['0']['showitem'] = ' username;;;;2-2-2, password, usergroup, lockToDomain,

Max. Linie

Max. Linie 6.9 Die Anordnung von Eingabefeldern ändern | 223 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

--div--, vorname;;;;3-3-3, name;;2;;, address, zip, city, country, telephone, fax, email, www, image;;;;4-4-4, --div--, TSconfig;;;;5-5-5

Links

';

Das Feld Vorname wird nun wie gewünscht über dem Eingabefeld Name angezeigt. Nach diesem Muster können Sie jedes Eingabeformular nach Ihren Wünschen gestalten. Beachten Sie, dass für ein voll funktionsfähiges Beispiel noch weitere Schritte notwendig sind. Beispielsweise sollten Sie die Feldbeschreibung mit Sprachmarkern erzeugen und in der Datenbank das entsprechende Feld zur Verfügung stellen.

Lizensiert für Markus Mueller

Es kann vorkommen, dass mehrere Extensions die Feldanordnung ein und desselben Formulars anpassen. Achten Sie daher bei Anpassungen dieser Art darauf, dass Ihre Angaben nicht durch eine andere Extension überschrieben werden oder Sie die Einstellungen anderer Extensions mit den hier beschriebenen Änderungen überschreiben. Wenn Sie eine solche Anpassung durchgeführt haben, müssen Sie bei jeder nachfolgenden Installation einer weiteren Extension prüfen, ob diese möglicherweise zusätzliche Felder bereitstellt. Hierbei kann es dann je nach Ladereihenfolge zu unerwünschten Ergebnissen kommen. Dies können Sie nur vermeiden, indem Sie sicherstellen, dass Ihre Extension jeweils als letzte geladen wird. Um die Feldeinstellungen aller Extensions zu berücksichtigen, müssen Sie deren Anpassungen im Bereich showitem per Hand zusammenführen, da die Änderungen der anderen Extensions ansonsten nicht übernommen werden.

Siehe auch

Max. Linie

In Rezept 1.5 erfahren Sie mehr über die weiteren Optionen des Moduls Konfiguration. Manche Datensätze besitzen unterschiedliche Formulartypen, mit denen je nach Datentyp unterschiedliche Felder angezeigt werden können, in Rezept 19.4 erhalten Sie einen tieferen Einblick in die Zusammenhänge von Types und Eingabeformularen. Um eine bestehende Tabelle zu erweitern, sollten Sie eine Extension anlegen. Die nötigen Schritte dazu werden in Rezept 16.3 erklärt. Wenn Sie die Anordnung von Feldern der zweiten Optionspalette anpassen möchten, nehmen Sie die Anpassungen im Bereich palettes vor. In Rezept 6.10 erfahren Sie, wie Sie die Anordnung von Feldern der zweiten Optionspalette ändern können.

224 | Kapitel 6: Das Backend anpassen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

6.10 Eingabeformulare mehrspaltig darstellen Problem Sie möchten Formularfelder in Spalten anordnen, um Eingabeformulare intuitiver und effektiver zu gestalten.

Lösung Legen Sie die Felder in der zweiten Optionspalette ab. Darin werden Eingabefelder standardmäßig in Spalten aufgeteilt. Ändern Sie dazu im TCA der jeweiligen Tabelle die Abschnitte types und palettes nach folgendem Muster: ... 'types' => array( '0' => array( 'showitem' => 'feld_00,feld_01,feld_02' ) ), ... Lizensiert für Markus Mueller

Max. Linie

zu ... 'types' => array( '0' => array( 'showitem' => '--palette--;;1', 'canNotCollapse' => '1' ) ), 'palettes' => array( '1' => array( 'showitem' => 'feld_00,feld_01,feld_02', 'canNotCollapse' => '1' ), ...

Zuerst legen Sie innerhalb des Abschnitts types über ein numerisches Array die einzelnen Formulartypen für Ihr Eingabeformular fest. Standardmäßig verwendet TYPO3 den Typ 0. Für jeden Typ können Sie über den Wert showitem die einzelnen Feldnamen angeben, die Sie über die columns erstellt haben. In Rezept 19.4 erfahren Sie weitere Details zu unterschiedlichen Formulartypen und wie Sie diese in der Praxis nutzen können. Die Reihenfolge der Feldnamen bestimmt, wie die Felder nachher angeordnet werden. TYPO3 arbeitet die Feldnamen dabei linear von vorne nach hinten ab und zeigt die Felder standardmäßig untereinander. Mit dem Wert --palette-- bietet Ihnen TYPO3 die Möglichkeit, Felder in der zweiten Optionspalette abzulegen. Darin werden die Felder standardmäßig nebeneinander angeordnet. Verschieben Sie dazu die Feldnamen in das

6.10 Eingabeformulare mehrspaltig darstellen | 225 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Array palettes und verknüpfen Sie den Wert --palette-- über die Paletten-ID mit den entsprechenden Feldern. Die Paletten-ID wird über den dritten Parameter angegeben. Mehr zu den Parametern erfahren Sie in der anschließenden Diskussion.

Links

Mit der Option canNotCollapse verhindern Sie, dass die Paletten vom Benutzer ausgeblendet werden können. Die Felder werden also unabhängig davon, ob die Option Zweite Optionspalette anzeigen aktiviert ist, immer nebeneinander angezeigt.

Diskussion Jeder Eintrag in showitem kann über vier zusätzliche Werte individuell angepasst werden. Dabei spielt es keine Rolle, ob Sie die Anpassung in types oder palettes vornehmen, denn die Einstellungen betreffen immer das Feld an sich und nicht den Bereich, in dem das Feld angezeigt wird. Die Feldeinstellungen erfolgen über Werte, die durch Semikola voneinander getrennt werden. Der Aufbau dieser Feldeinstellungen entspricht dabei folgendem Muster: ..., wert_1; wert_2; wert_3; wert_4; wert_5, ...

Lizensiert für Markus Mueller

Mit wert_1 legen Sie den Feldnamen des Felds fest, das an der jeweiligen Position angezeigt werden soll. Die möglichen Feldnamen definieren Sie bereits im Bereich columns des jeweiligen TCA. Ist der Feldname ungültig, wird das Feld nicht angezeigt. Alternativ zum Feldnamen können Sie hier auch mit speziellen Platzhaltern neue Paletten anlegen oder Abstände in Ihren Formularen erzeugen. Mit wert_2 vergeben Sie alternative Feldbeschriftungen. Dies ist vor allem für Paletten hilfreich, denn Eingabefelder werden in der Regel schon über die Feldeigenschaften benannt. Jedoch können Sie diesen Wert auch mit dem wert_2 überschreiben und so beispielsweise für unterschiedliche Formulartypen abweichende Feldbeschreibungen anzeigen. Den Titel geben Sie entweder direkt oder über LLL-Marker ein: ...--palette--;LLL:EXT:extension_key/locallang_db.xml:tx_ext_key.feldname;1...

Der Parameter wert_3 steht für eine Paletten-ID. Damit können Sie Feldgruppen aus palettes verknüpfen und in der zweiten Optionspalette unterhalb des Felds bzw. – wie in der Lösung oben beschrieben – innerhalb einer eigenen Palette anzeigen. Spezielle Einstellungen für Textfelder speichern Sie in wert_4. So können Sie beispielsweise interaktive Eingabefelder (RTE) anpassen oder das Verhalten für Zeilenumbrüche festlegen. Auf diese Weise können Textfelder für jeden Formulartyp mit unterschiedlichen Eigenschaften ausgestattet werden. Mit wert_5 legen Sie Darstellungsoptionen für das Feld fest. Dabei werden diese Optionen in drei weitere Bereiche colorschemes, styleschemes und borderschemes eingeteilt. Diese Werte sind technisch gesehen Schlüsselwerte im Array $TBE_STYLES und werden dem Feld nach folgendem Muster zugewiesen: ... ;{colorschemes-id}-{styleschemes-id}-{borderschemes-id}, ...

Max. Linie

Max. Linie 226 | Kapitel 6: Das Backend anpassen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Rechts

Wenn Sie Felder von der ersten in die zweite Optionspalette verschieben, achten Sie besonders darauf, dass Sie in Ihrem Formular ein Feld nicht mehrmals verwenden und Paletten nur einmal mit einem Feld verknüpfen. Eine häufig vorkommende Fehlerquelle ist, Felder in der ersten und in der zweiten Optionspalette gleichzeitig darzustellen oder eine Palette zweimal einem Feld zuzuweisen. Die Werte werden dann von TYPO3 nicht mehr abgespeichert. Umgehen Sie diese Fehlerquelle, indem Sie die Feldnamen vor dem Speichern auf ihre Eindeutigkeit hin überprüfen. Um Ihr Formular weiter zu unterteilen, können Sie mit folgenden Angaben spezielle Trennelemente einfügen: ... --div--;LLL:EXT:extension_key/locallang_db.xml:tx_ext_key.feldname;;;1-1-1, ...

Durch diese Angaben erzeugen Sie standardmäßig einen horizontalen Abstand zwischen den Eingabefeldern. So können Sie beispielsweise lange Formulare übersichtlicher halten. Beachten Sie, dass Sie dann auf alle Fälle wert_4 angeben müssen, um die Trennung sichtbar zu machen. Fehlt dieser Wert, weist TYPO3 dem Trennelement keinen Rahmen zu, sodass es unsichtbar bleibt.

Lizensiert für Markus Mueller

Besonders interessant bei dem Element --div-- ist das Zusammenspiel mit der Option dividers2tabs, die Sie im ctrl-Abschnitt des TCA angeben können. Haben Sie im ctrlAbschnitt Ihrer Tabelle die Option dividers2tabs aktiviert, erzeugt die Angabe --div-aus den nachfolgenden Feldangaben einen neuen Formularbereich, den Sie über eine spezielle Navigationsleiste auswählen können. Sämtliche Felder, die nach dem Element --div-- angegeben werden, finden Sie dann in dem neuen Formularbereich. Abbildung 6-1 verdeutlicht die Auswirkungen dieser Option. Beachten Sie, dass Sie dann unbedingt wert_2 angeben müssen, um dem Bereich eine Bezeichnung zu geben.

Abbildung 6-1: Durch die Einstellung »dividers2tabs« erzeugen die Trennelemente automatisch neue Formularbereiche

Siehe auch Weitere praktische Anwendungsbeispiele für die Formulartypen erhalten Sie in Rezept 19.4. Dort erfahren Sie, wie Sie unterschiedliche Typen Ihrer Datensätze verwenden.

Max. Linie

Max. Linie 6.10 Eingabeformulare mehrspaltig darstellen | 227 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Vakat Lizensiert für Markus Mueller

First

Kapitel 7an

KAPITEL 7

Die Übersicht im Backend erhöhen

7.0

Einführung

Mit zunehmender Datenmenge wird es immer wichtiger, die Inhalte zu kontrollieren. Das trifft sowohl auf Redakteure als auch auf Administratoren zu. In diesem Kapitel erfahren Sie, mit welchen Tools Sie im TYPO3-Backend schnell einen Überblick über bestehende Inhalte bekommen und Ihre Arbeitswege verkürzen können. Lizensiert für Markus Mueller

In den Rezepten 7.1 und 7.2 erfahren Sie, wie Sie die Arbeit an Ihren zuletzt geänderten Dokumenten nahtlos weiterführen können, wenn Sie die Arbeit am Backend unterbrochen haben. TYPO3 bietet Ihnen die Möglichkeit, nach dem Login direkt an den entsprechenden Inhalten weiterzuarbeiten. Der Seitenbaum im TYPO3-Backend stellt die essenzielle und zentrale Verwaltungseinheit im Backend dar. Über den Seitenbaum können Sie sämtliche Datenbankinhalte verwalten und bearbeiten. In den Rezepten 7.3 und 7.4 erfahren Sie, wie Sie den Seitenbaum weiter optimieren und an Ihre Arbeitsweisen anpassen können. Eine zentrale Rolle für die Verwaltung umfangreicher Datenmengen stellen die Module Liste und Info dar. Über das Modul Liste erhalten Sie eine tabellarische Auflistung aller Seiteninhalte der gewählten Seite. Über die einzelnen Spaltentitel können Sie die Datensätze bequem sortieren und bearbeiten. In den Rezepten 7.5 und 7.6 erfahren Sie, wie Sie diese besonderen Bearbeitungsfunktionen anwenden und so selbst umfangreiche Datenbestände übersichtlich verwalten können. Die Rezepte 7.7 und 7.8 konzentrieren sich darauf, wie Sie die Seiten im Seitenbaum anpassen können. In Rezept 7.7 erfahren Sie, wie Sie Tabelleninhalte im Modul Seite auflisten können. Dies ist beispielsweise dann nützlich, wenn Sie – zusätzlich zu den regulären Seiteninhalten – auch bestimmte Datensätze im Modul Seite anzeigen möchten. Rezept 7.8 verdeutlicht, wie Sie das Icon der Seiten im Seitenbaum anpassen können.

Max. Linie

Max. Linie | 229 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

7.1

Oft verwendete Datensätze schnell erreichen

Links

Problem Sie möchten schnell zu oft benutzten Datensätzen oder Stellen in Ihrem Seitenbaum springen.

Lösung Legen Sie für die gewünschten Stellen sogenannte Verweise an, mit denen Sie direkt zur jeweiligen Ansicht im TYPO3-Backend springen können. Um einen Verweis (im Folgenden »Shortcut« genannt, wie im TSconfig-Code) anzulegen, klicken Sie auf das Symbol Einen Verweis auf diese Seite erzeugen?, das Sie in der rechten oberen Ecke unterhalb der Funktionsleiste finden. Nachdem Sie diese Aktion bestätigt haben, erscheint in der Funktionsleiste unterhalb des Shortcut-Icons ein neuer Eintrag. Klicken Sie auf das ShortcutIcon in der Funktionsleiste, öffnet sich die Shortcut-Liste. Mit einem weiteren Klick auf den Shortcut gelangen Sie zur gewünschten Ansicht.

Lizensiert für Markus Mueller

Diskussion Shortcuts bieten eine sehr komfortable Möglichkeit, schnell zu bestimmten Ansichten oder Datensätzen zu springen. Jedes Icon repräsentiert dabei das entsprechende Modul, in dem der Shortcut angelegt wurde. Wenn Sie zum Beispiel einen Verweis auf eine Listenansicht speichern, wird der Shortcut mit dem Symbol des Listenmoduls dargestellt. So wird schnell sichtbar, in welchem Kontext Sie sich nach dem Klicken befinden. Ebenso wird der Titel der aktuellen Ansicht als Titel übernommen. Im Shortcut-Panel der Funktionsleiste können Sie Ihre Shortcuts nachträglich verwalten, etwa um ihnen einen eindeutigen Titel zu geben. Diese Angaben erscheint dann später im Titeltext des jeweiligen Icons. Zusätzlich können Sie die Shortcuts in bestimmte Funktionsbereiche gruppieren oder wieder aus dem Shortcut-Frame entfernen. Um den Bearbeitungsmodus zu starten, wählen Sie den gewünschten Shortcut aus und klicken auf den kleinen Stift. Nun erscheint ein Bearbeitungsformular, mit dessen Hilfe Sie die Eigenschaften für den gewählten Shortcut speichern können. In dem Eingabefeld vergeben Sie den Shortcut-Titel. Im Auswahlfeld finden Sie die Liste der vorhandenen Gruppen. Wenn Sie eine Gruppe wählen, wird der Shortcut nach dem Speichern in die jeweilige Gruppe einsortiert, was besonders bei vielen Shortcuts die Übersicht sehr erhöht.

Max. Linie

Wenn Sie als Administrator angemeldet sind, werden Sie zwei unterschiedliche Gruppierungsmöglichkeiten feststellen: Einmal können Sie lokale Gruppen verwenden, mit denen Sie für sich selbst die vorhandenen Shortcuts strukturieren können. Zusätzlich stehen Ihnen noch sogenannte globale Gruppen zur Verfügung, denen in der Auswahlliste die Bezeichnung Global: vorangestellt ist. Im Gegensatz zu den normalen Gruppen können Sie

230 | Kapitel 7: Die Übersicht im Backend erhöhen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

diese globalen Gruppen auch anderen Benutzern zur Verfügung stellen, etwa um diesen vordefinierte Shortcuts zu wichtigen Stellen oder Datensätzen zur Verfügung zu stellen. Um diese globalen Gruppen anderen Benutzern freizuschalten, gehen Sie wie folgt vor: Legen Sie einen oder mehrere Shortcuts über die Bearbeiten-Funktion in einer globalen Gruppe ab und speichern Sie die Auswahl mit dem entsprechenden Symbol. Geben Sie danach den TSconfig-Code nach folgendem Muster in das entsprechende Feld TSconfig der gewünschten Benutzergruppe oder des Benutzers ein, um die Shortcut-Gruppe freizuschalten: options.shortcutGroups { gruppen_id=1 }

Jede der fünf vorhandenen Gruppen können Sie mit dem Wert 1 aktivieren. Wenn Sie diesen Wert leer lassen, werden Shortcuts dieser Gruppe standardmäßig angezeigt. Ist der Wert auf 0 gesetzt, wird die Shortcut-Gruppe ausgeblendet. Achten Sie daher darauf, die Gruppen explizit auszublenden, wenn Sie nicht möchten, dass sie angezeigt werden. Den Gruppen sind dabei standardmäßig folgende Zahlenwerte zugeordnet:

Lizensiert für Markus Mueller

1 2 3 4 5

Seiten Datensätze Dateien Werkzeuge Verschiedenes

Wenn Sie zum Beispiel die Gruppe Global: Seiten für andere Benutzer freischalten möchten, legen Sie den Shortcut über das Auswahlfeld in der Gruppe ab, speichern diese Auswahl und geben danach folgenden Code in das TSconfig-Feld der gewünschten Benutzergruppe oder des Benutzers ein, um diese Gruppe öffentlich zu schalten: options.shortcutGroups { 1=1 }

Die Shortcuts dieser Gruppe erscheinen daraufhin automatisch im unteren Bildschirmbereich und können direkt von den Benutzern verwendet werden. Um die Zuordnung dieser Gruppen an eigene Bedürfnisse anzupassen, können Sie diese Gruppe auch über folgende Syntax umbenennen: options.shortcutGroups { 1=1 2=Eigene Gruppe 3=0 4= 5= }

Max. Linie

Die Shortcuts der Gruppe 1, 2, 4 und 5 werden dadurch automatisch aktiviert und den Benutzern zur Verfügung gestellt, falls Shortcuts darin abgelegt wurden. Die Gruppe 2 hat den Titel Eigene Gruppe. Die Gruppe 3 wird ausgeblendet.

7.1 Oft verwendete Datensätze schnell erreichen | 231 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Alternativ können Sie Shortcuts auch in der Gruppe Global: Alle ablegen. Die Shortcuts dieser Gruppe sind dann für sämtliche Benutzer sichtbar, sofern der Seitenbereich angezeigt wird. Den Bereich schalten Sie mit folgendem TSconfig-Code frei:

Links

options { shortcutFrame = 1 }

Achten Sie darauf, dass Sie diese Option für die gewünschten Benutzer aktiviert haben, da diese ansonsten die freigeschalteten Verweise nicht sehen können. Eine andere Möglichkeit, schnell an bestimmte Datensätze zu gelangen, stellt das Suchfeld in der rechten oberen Ecke dar. Dieses erscheint, wenn Sie auf die Lupe klicken. Möchten Sie direkt zu einer Seite springen, genügt es, wenn Sie dort die Seiten-ID eingeben. Für Datensätze anderer Tabellen müssen Sie den Tabellennamen voranstellen. Verwenden Sie dazu folgende Syntax: tabellen_name:datensatz_id

Lizensiert für Markus Mueller

Die Datensatz-ID ermitteln Sie, indem Sie mit der Maus über das jeweilige Icon des Datensatzes fahren. Nach kurzer Zeit erscheint der Titel der Grafik, in dem die ID des Datensatzes angezeigt wird (in Rezept 7.3 erfahren Sie weitere Möglichkeiten, die SeitenID zu ermitteln). In der Praxis hat es sich als sehr hilfreich erwiesen, die Seiten-IDs direkt im Seitenbaum anzuzeigen. Dadurch können sie sehr zügig ermittelt werden. Geben Sie dazu folgenden Code in das Feld TSconfig des Benutzers oder der Benutzergruppe ein: options { pageTree.showPageIdWithTitle = 1 }

Zusätzlich können Sie mit den folgenden Optionen einstellen, wie sich die Sprünge auf den Seitenbaum auswirken. Standardmäßig wird der restliche Seitenbaum geschlossen, und nur die Zielseite erhält den Fokus. Mit der Option shortcut_onEditId_dontSetPageTree unterbinden Sie jegliche Reaktion des Seitenbaums, wenn eine Seiten-ID angesprungen werden soll. Genau das Gegenteil erreichen Sie, wenn Sie die Option shortcut_ onEditId_keepExistingExpanded aktivieren. Der Seitenbaum bleibt dann stets ausgeklappt, und es öffnen sich nach Eingabe einer neuen Seiten-ID entsprechend weitere Seitenbäume. options { # die Zielseite erhält den Fokus - der Seitenbaum bleibt unverändert shortcut_onEditId_dontSetPageTree = 0 # die Zielseite erhält den Fokus - andere Seitenbäume werden NICHT eingeklappt # dabei sollte shortcut_onEditId_dontSetPageTree = 0 sein shortcut_onEditId_keepExistingExpanded = 1 }

Max. Linie

Auf diese Weise können Sie auch in sehr umfangreichen Seitenbäumen sehr schnell zum gewünschten Datensatz gelangen.

232 | Kapitel 7: Die Übersicht im Backend erhöhen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

7.2

Zuletzt bearbeitete Datensätze anzeigen

Problem Sie möchten direkt zu Ihren zuletzt bearbeiteten Datensätzen springen, beispielsweise um einen begonnenen Bearbeitungsvorgang abzuschließen.

Lösung Wechseln Sie in das Modul Dokumente. Sind noch Datensätze aus Ihrer vorangegangenen Sitzung geöffnet, wird automatisch die Bearbeitungsmaske des aktuellsten Datensatzes geöffnet. Über die Auswahlliste Geöffnete Dokumente wechseln Sie zu anderen Datensätzen, sofern diese vorhanden sind.

Diskussion

Lizensiert für Markus Mueller

Max. Linie

TYPO3 speichert für jeden Benutzer die geöffneten Datensätze, bis diese wieder geschlossen werden. Ist ein Datensatz geöffnet, wird er für die anderen Backend-Benutzer mit einem entsprechenden Hinweis versehen. Öffnet ein anderer Benutzer einen bereits geöffneten Datensatz, erhält dieser nochmals einen deutlichen Hinweis darauf, dass momentan an dem Datensatz gearbeitet wird. Wenn dieser Warnhinweis ignoriert wird, gehen beim Speichern möglicherweise Änderungen verloren. Über das oben genannte Modul Dokumente erhalten Sie einen guten Überblick über Ihre zuletzt bearbeiteten Dokumente – was aber, wenn Sie sehen möchten, welche Datensätze insgesamt neu erstellt oder bearbeitet wurden? Um zu sehen, welche neuen Datensätze von allen Benutzern in die Datenbank eingepflegt wurden, können Sie sich die sogenannten Befehle zu Nutze machen, mit denen Sie zum Beispiel sehr bequem häufig benötigte Datenbankabfragen durchführen können (wenn Sie zuvor noch nicht mit Befehlen gearbeitet haben, sollten Sie Rezept 5.2 lesen, um an Hintergrundwissen zu gelangen). Im Folgenden erstellen Sie eine solche Abfrage, mit der die aktuellsten Seiten ermittelt werden. Installieren Sie dazu die Extension User>Task Center, Actions (sys_action). Diese Extension legt eine neue Datenbanktabelle an, in der die Befehle gespeichert werden, und bindet die entsprechenden Eingabemasken in das Backend ein. Neue Befehle erstellen Sie dann über das Modul Liste in der Wurzelseite (mit der ID 0) Ihrer TYPO3-Installation (beachten Sie, dass Sie dazu Administratorrechte benötigen). Legen Sie dort ein neues Inhaltselement vom Typ Befehl an und wählen Sie in der Auswahlliste Typ den Wert SQL-query. Geben Sie der Aktion anschließend einen aussagekräftigen Titel, beispielsweise Neue Seiten anzeigen. Im Feld Beschreibung können Sie zusätzliche Hinweise zur Benutzung des Befehls geben und beschreiben, welche Funktionen dieser Befehl durchführt. Diese Beschreibung erscheint später unterhalb des Befehlstitels.

7.2 Zuletzt bearbeitete Datensätze anzeigen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 233

Max. Linie

Links Wenn Sie möchten, dass auch andere Backend-Benutzer Zugriff auf diesen Befehl haben, können Sie über das Feld Assign action to groups eine oder mehrere Backend-Benutzergruppen angeben, die so ebenfalls Zugriff auf diesen Befehl haben. Der Befehl erscheint dann automatisch bei allen Benutzern dieser Gruppe im Bereich Aufgaben. Ansonsten haben nur Sie Zugriff. Wir empfehlen Ihnen, Befehle zunächst selbst ausgiebig zu testen und sie erst dann für die Benutzergruppen freizuschalten.

Nachdem Sie den Befehl abgespeichert haben, erscheint er im Modul Aufgaben automatisch im Bereich Befehle, in dem später sämtliche Befehle gesammelt werden. Von dort aus können Sie jeden einzelnen Befehl komfortabel per Mausklick aufrufen. Da die Konfiguration dieses Befehls noch nicht abgeschlossen ist, wechseln Sie nun in das Modul DBÜberprüfung. Dort erzeugen Sie über einen Abfrage-Assistenten die nötige Datenbankabfrage, mit der Sie die aktuellen Datensätze ermitteln. Abschließend verknüpfen Sie diese Abfrage mit dem zuvor erstellten Befehl. Um den Abfrage-Assistenten zu erreichen, wählen Sie im Feld links oben die Option Full search. Danach erscheinen zwei weitere Auswahllisten. Stellen Sie in der mittleren die Option Advanced query ein. Ganz rechts sollten Sie Select records aktiviert haben.

Lizensiert für Markus Mueller

Die Eingabemaske wechselt dann in das Abfragemodul, mit dem Sie die Tabellen durchsuchen können. Legen Sie in Select a table die Tabelle Seite fest. Um später ein aussagekräftiges Ergebnis zu erhalten, sollten Sie im Feld Select fields mindestens die Felder uid und title auswählen (fehlerhafte Eingaben können Sie über das Eingabefeld wieder entfernen). Diese Angaben werden später beim Aufruf des Befehls als Spalten in einer Liste angezeigt. Unter Make Query wählen Sie nun den Eintrag [FIELD: uid]. Damit setzen Sie die Abfrage auf das Feld uid in der Tabelle pages (die Tabelle pages speichert standardmäßig alle Seiten, die Sie im TYPO3-Backend anlegen). Im nächsten Feld legen Sie den Vergleichsoperator fest. Wählen Sie hier is greater than. Im dritten Feld geben Sie eine 0 ein. Das Kontrollkästchen dazwischen können Sie ignorieren. Es dient lediglich dazu, den Vergleichsoperator umzukehren, was in der gewünschten Anwendung nicht sinnvoll ist. Um die neuen Suchkriterien zu aktivieren, klicken Sie danach auf das Icon Update. Die restlichen Felder können Sie leer lassen. Für die richtige Sortierung der Liste wählen Sie in der Auswahlliste Order By den Eintrag tstamp. Dadurch werden die Inhalte nach der letzten Aktualisierung sortiert. Aktivieren Sie außerdem die Option Descending. Dadurch stellen Sie sicher, dass der aktuellste Eintrag immer oben angezeigt wird. Um die Liste überschaubarer zu halten, können Sie das Limit noch auf 20 setzen. Aktualisieren Sie die Abfrage anschließend erneut über das Update-Icon, sodass am Ende im Feld SQL Query folgende SQL-Anweisung ausgegeben werden sollte:

Max. Linie

SELECT uid,title FROM pages WHERE pages.uid > 0 AND NOT pages.deleted ORDER BY tstamp DESC LIMIT 20

234 | Kapitel 7: Die Übersicht im Backend erhöhen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Im nächsten Schritt wird diese Abfrage mit dem anfangs erstellten Befehl verknüpft. Wählen Sie dazu im oberen Formularbereich Load/Save Query den Eintrag des zuvor erstellten Befehls Neue Inhalte unterhalb der Markierung Save to Action: aus und bestätigen Sie diese Auswahl mit dem Button Save. Nachdem TYPO3 Ihnen diesen Schritt mit Query OK and saved. bestätigt hat, wechseln Sie in das Modul Aufgaben und klappen dort den Bereich Befehle auf, indem Sie auf die entsprechende Schaltfläche klicken. Möchten Sie nun abschließend auf den Titel des Befehls klicken, wird dieser ausgeführt und die entsprechende Liste im rechten Seitenbereich angezeigt. Wenn Sie diesen Befehl nun auch anderen Backend-Benutzern zur Verfügung stellen, wechseln Sie zurück in den Befehlsdatensatz und weisen über das Feld Assign action to groups die gewünschten Backend-Benutzergruppen zu.

Siehe auch Dieses Rezept zeigt nur eine Funktion von vielen, die Sie mit Befehlen vereinfachen können. In Rezept 5.2 erfahren Sie, wie Sie Befehle auch für andere Arbeitsschritte verwenden können. Über diese Kombination aus Befehl und SQL-Abfrage können Sie auch sehr leicht andere Tabellen abfragen, die im TCA registriert sind. Eine Übersicht der häufigsten Tabellen erhalten Sie in Rezept 2.5. Lizensiert für Markus Mueller

7.3

Seiten-IDs ermitteln

Problem Sie möchten die Seiten-ID erfahren, um sie zum Beispiel für interne Verlinkungen zu verwenden.

Lösung Bewegen Sie Ihren Mauszeiger im Seitenbaum über ein Seitensymbol. Daraufhin erscheint als Information die Seiten-ID. Falls Sie im Seiten-Header einen Alias vergeben haben, wird dieser neben der ID angezeigt. Auf diese Weise erfahren Sie auch den aktuellen Status der Seite, beispielsweise ob sie momentan sichtbar oder versteckt ist, wann sie angezeigt oder ausgeblendet wird und welche Benutzergruppe darauf zugreifen darf.

Max. Linie

Zusätzlich gibt es je nach Seitentyp noch spezielle Informationen: Beim Seitentyp Verweis werden Verknüpfungsmodus und Seitentitel der verlinkten Seite sichtbar. Analog dazu wird beim Seitentyp Externe URL der entsprechende externe Link dargestellt. Bewegen Sie den Mauszeiger über das Icon des Seitentyps Mount Seite, erhalten Sie den Pfad zur gemounteten Seite.

7.3 Seiten-IDs ermitteln This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 235

Max. Linie

Diskussion

Links

Wenn Sie mehrere Seiten gleichzeitig kontrollieren möchten oder Ihnen die oben genannte Vorgehensweise auf Dauer zu mühsam ist, können Sie sich die Seiteneigenschaften auch über das Modul Info anzeigen lassen. Wählen Sie dazu die gewünschte Startseite und aktivieren Sie danach das Modul Info. Anschließend aktivieren Sie in der rechten Auswahlliste die Option Seitenbaum-Übersicht. Dadurch erscheinen zwei neue Auswahllisten am Listenkopf, über die Sie Einfluss auf die Art und den Umfang der Informationen nehmen können. Mit der ersten Auswahlliste bestimmen Sie, wie tief Sie in den Seitenbaum tauchen möchten. Wenn Sie nur wenige Seiten vergleichen möchten, wählen Sie eine entsprechend kleine Anzahl von Ebenen. Beachten Sie, dass sich eine zu große Ebenenanzahl negativ auf die Geschwindigkeit beim Seitenaufbau auswirkt, da alle Seiten – unabhängig von der Option Seitenbaum stoppen – angezeigt werden und so mitunter sehr lange Seitenbäume entstehen (mit der Option Seitenbaum stoppen können Sie über die Seiteneigenschaften festlegen, dass die Unterseiten der aktuellen Seite nicht im Seitenbaum erscheinen).

Lizensiert für Markus Mueller

Mit der zweiten Auswahlliste bestimmen Sie, welche Felder in der Übersicht angezeigt werden. Die Auswahl Basiseinstellungen gewährt einen Einblick in die oben beschriebenen Seiteneigenschaften, wie Seiten-ID, Alias, Start- und Stoppzeiten, Zugriff, Ziel, URL und Verweis zur Seite. Die Auswahl Cache und Alter zeigt die Werte, die festlegen, wie die Seite von TYPO3 im Frontend behandelt wird. Beispielsweise bekommen Sie die Cache-Einstellungen jeder Seite aufgelistet. Damit können Sie schnell kontrollieren, ob Sie die Seiten optimal cachen, und eventuell Performanceverbesserungen einführen. Mit der Auswahl Datensatz-Übersicht erhalten Sie eine zusammenfassende Liste aller vorhandenen Datensätze. Diese Darstellung ist dann sehr hilfreich, wenn Sie sich schnell einen Überblick über die aktuelle Anzahl der vorhandenen Datensätze verschaffen möchten. Über die Bearbeitungssymbole können Sie die gewünschten Datensätze direkt aus dem Infomodul heraus ändern. Dabei können Sie entweder die Bearbeitung auf einzelne Felder beschränken oder einzelne Datensätze komplett ändern. Zusätzlich zu den oben beschriebenen Möglichkeiten können Sie die Seiten-ID auch direkt im Seitenbaum anzeigen. Geben Sie dazu folgenden Code im Feld TSconfig Ihres Backend-Benutzers ein: options.pageTree { showPageIdWithTitle = 1 }

Max. Linie

Die Seiten-ID erscheint dann permanent im Seitenbaum links neben dem Seitentitel. Dadurch kann es passieren, dass manche Seitentitel rechts abgeschnitten werden. Mit folgendem TSconfig-Code verbreitern Sie den Frame auf die gewünschten Pixel:

236 | Kapitel 7: Die Übersicht im Backend erhöhen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

setup.default { frameWidth = 400 }

Wünschen Sie eine variable Breite für den Seitenbaum, kombinieren Sie den oben genannten Wert mit folgender Angabe: setup.default { resizeFrame = 1 }

Der Seitenbaum-Frame kann dadurch individuell verbreitert werden, indem Sie den Rand mit der Maus auf die gewünschte Breite ziehen. Beachten Sie, dass der Frame immer auf die Standardbreite zurückgesetzt wird, wenn Sie Datensätze kopieren oder verschieben.

7.4

Längere Seitentitel im Seitenbaum ermöglichen

Problem Sie möchten im Seitenbaum auch längere Titel vollständig anzeigen lassen. Lizensiert für Markus Mueller

Lösung Geben Sie folgenden Code in Ihr Benutzer-TSconfig-Feld ein: setup.override { titleLen = 128 }

Mit dieser Anweisung legen Sie die Titellänge von 128 Zeichen fest, unabhängig davon, welchen Wert der Benutzer in seinen Einstellungen festlegt. Wenn Sie diesen Code in das TSconfig-Feld der Benutzergruppe schreiben, erhalten alle Benutzer dieser Gruppe diese Vorgabe. Der Wert sollte 255 Zeichen nicht überschreiten, da das entsprechende Datenbankfeld maximal 255 Zeichen speichern kann. Sollten Sie mehr als 255 Zeichen benötigen, müssen Sie die Datenbanktabelle entsprechend bearbeiten, indem Sie den Feldtyp auf MEDIUMTEXT bzw. TEXT setzen. Jedoch sollten Sie diesen Vorgang gründlich überlegen, weil dadurch die Größe der Datenbank unnötig aufgebläht wird und das Ganze nur in Sonderfällen sinnvoll ist.

Diskussion Um Ihnen mehr Übersicht im Seitenbaum zu ermöglichen, können Sie mit folgendem Code zusätzlich die Frame-Breite des Seitenbaums vergrößern:

Max. Linie

setup.default { navFrameWidth = 400 }

7.4 Längere Seitentitel im Seitenbaum ermöglichen | 237 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Der Standardwert beträgt 245 Pixel.

Links

Wünschen Sie eine variable Breite, sollten Sie den oben genannten Wert hiermit kombinieren: setup.default { resizeFrame = 1 }

Mit diesen Angaben erhalten Sie einen 400 Pixel breiten Frame für den Seitenbaum, den Sie noch je nach Belieben vergrößern können: setup.default { navFrameWidth = 400 resizeFrame = 1 }

Beachten Sie, dass der Seitenbaum immer auf die Standardbreite gesetzt wird, wenn Sie Datensätze kopieren oder verschieben.

7.5

Tabelleninhalte nur bei Bedarf anzeigen

Lizensiert für Markus Mueller

Problem Sie möchten auch bei zahlreichen Datensätzen die Übersicht behalten, beispielsweise wenn in einer Seite mehrere Hundert unterschiedliche Datensätze gesammelt werden.

Lösung Unterbinden Sie mit folgendem Seiten-TSconfig die ausführliche Darstellung der Datenbankinhalte. mod.web_list { listOnlyInSingleTableView = 1 }

Sie erhalten daraufhin im Listenmodul nur noch eine kompakte Übersicht der vorhandenen Tabellen. Mit einem Klick auf den Tabellentitel oder auf das Icon Nur diese Tabelle anzeigen öffnet sich die Tabelle in der Einzelansicht, und der Tabelleninhalt wird aufgelistet.

Diskussion Diese Einstellungen können auch im Benutzer-TSconfig gespeichert werden. Achten Sie darauf, dass Sie diese Einstellungen nicht beim eigenen Admin-Account verwenden:

Max. Linie

Max. Linie 238 | Kapitel 7: Die Übersicht im Backend erhöhen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Rechts

mod.web_list { listOnlyInSingleTableView = 1 disableSingleTableView = 1 }

Dadurch würden Sie sich als Administrator selbst von der Dateneingabe ausschließen. Der Grund: Nach dem Schließen der gespeicherten Benutzereinstellungen werden alle Inhaltselemente – auch Ihr eigenes Benutzerprofil – ausgeblendet, und Sie haben keine Möglichkeit mehr, diese über das Backend zu ändern. Wenn Sie experimentierfreudig sind und diese Einstellungen trotz aller Warnungen getätigt haben, hilft folgender Weg, um die Dateneingabe wieder »freizuschalten«: Legen Sie mit dem Link Neuen Datensatz anlegen einen neuen Admin-Benutzer an, der nicht diese Einstellungen im Benutzer-TSconfig hat. Loggen Sie sich dann mit diesem Account ein und löschen Sie die oben genannten TSconfig-Einstellungen.

Lizensiert für Markus Mueller

Wenn Sie keine Datensätze mehr direkt anlegen können, hilft nur noch der Weg über das Install-Tool. Dort können Sie einen neuen Admin-Benutzer anlegen. Wechseln Sie dazu in das Modul Installation und wählen Sie den Abschnitt Database Analyzer. Dort finden Sie am Seitenende die Option Create »admin« user. Der neue Administrator-Account wird damit umgehend erstellt. Beachten Sie bei der Vergabe der Zugangsdaten, dass dieser zusätzliche Benutzer ein Sicherheitsrisiko darstellen kann. Wählen Sie daher die Zugangsdaten entsprechend sorgfältig und löschen Sie ihn, nachdem Sie Ihren ursprünglichen Account wiederhergestellt haben. Alternativ zu dem anfangs gezeigten Beispiel können Sie die Datensätze einer Tabelle auch vollständig ausblenden, indem Sie die Tabelle von der Anzeige im Listenmodul ausschließen. Geben Sie dazu folgenden TSconfig-Code in das TSconfig-Feld der Seite, des Backend-Benutzers oder der Benutzergruppe ein: mod.web_list { hideTables = tabellen_name }

Ersetzen Sie anschließend den Platzhalter tabellen_name mit dem entsprechenden Tabellennamen (eine Tabellenübersicht finden Sie in Rezept 2.5). Mehrere Tabellennamen trennen Sie durch ein Komma voneinander.

Siehe auch Rezept 7.7 behandelt die übersichtliche Darstellung von Inhaltselementen im Seitenmodul und wie Sie dort Inhalte sinnvoll verknüpft darstellen können.

Max. Linie

Max. Linie 7.5 Tabelleninhalte nur bei Bedarf anzeigen | 239 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

7.6

Anzahl der Datensätze im Listenmodus erhöhen

Links

Problem Sie möchten die Anzahl der aufgelisteten Datensätze von 20 auf 100 oder mehr erhöhen.

Lösung Erstellen Sie nach den Vorgaben von Rezept 16.2 eine Extension und öffnen Sie anschließend die Datei ext_tables.php im Extension-Verzeichnis. Fügen Sie dort folgenden Code ein, um für die Tabelle tt_content die maximale Anzahl der Datensätze anzupassen: t3lib_div::loadTCA('tt_content'); $TCA['tt_content']['interface']['maxDBListItems'] = '100'; $TCA['tt_content']['interface']['maxSingleDBListItems'] = '300';

Sie ermöglichen damit eine längere Liste sowohl in der Übersicht als auch in der Detailansicht der Tabelle.

Diskussion Lizensiert für Markus Mueller

Selbstverständlich können Sie so auch andere Tabellen anpassen. Geben Sie dazu den Code nach folgendem Muster in die Datei ext_tables.php ein: t3lib_div::loadTCA('tabellen_name'); $TCA['tabellen_name']['interface']['maxDBListItems'] = '100'; $TCA['tabellen_name']['interface']['maxSingleDBListItems'] = '300';

Passen Sie nun den Namen der Tabelle an und speichern Sie die Datei (in Rezept 2.5 finden Sie eine Übersicht der vorhandenen Tabellen). Danach erweitern Sie die Listenansicht der Tabelle entsprechend den Angaben. In der normalen Listenansicht werden nun 100 Datensätze auf einmal angezeigt. Wenn Sie dort auf den Tabellentitel klicken, gelangen Sie in die sogenannte Detailansicht der Tabelle, in der nun 300 Einträge aufgelistet werden. Wenn Sie momentan an einer eigenen Extension arbeiten, sollten Sie die Werte direkt im Abschnitt interface der Tabelle ändern. In der Datei ext_tables.php sollte der Code dann folgendermaßen aussehen: $TCA['tabellen_name'] = Array ( ... 'interface' => Array ( 'maxDBListItems' => '100', 'maxSingleDBListItems' => '300', ) ...

Max. Linie

Sollten Ihnen die oben genannten Begriffe noch fremd sein, finden Sie in Rezept 16.3 die nötigen Hintergrundinformationen.

240 | Kapitel 7: Die Übersicht im Backend erhöhen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Als kleine Unterstützung für den Umgang mit den langen Listen können Sie folgenden Code in Ihr Benutzer-TSconfig eingeben, mit dem Sie festlegen, dass jede zweite Zeile in der Liste farbig hervorgehoben wird: mod.web_list { alternateBgColors = 1 }

Dadurch fällt es leichter, den Zeilenverlauf nachzuvollziehen.

Siehe auch In den Rezepten 16.2 und 16.3 erfahren Sie mehr über die Einstellungsmöglichkeiten von Datenbanktabellen in TYPO3.

7.7

Eigene Datensätze im Seitenmodul anzeigen

Problem Lizensiert für Markus Mueller

Sie möchten im Seitenmodul – zusätzlich zu den Seiteninhalten – die Datensätze von eigenen Extensions auflisten, etwa um deren Bearbeitung über das Modul Seite vorzunehmen.

Lösung Binden Sie Ihre eigene Tabelle über eine Extension im Seitenmodul ein, indem Sie den gewünschten Tabellennamen und die Felder, die angezeigt werden sollen, über eine spezielle Extension-Variable in der Extension cms registrieren. Erstellen Sie dazu – wie in Rezept 16.2 beschrieben – eine Extension und bearbeiten Sie anschließend die Datei ext_ localconf.php im jeweiligen Extension-Ordner. Geben Sie dort nun folgenden PHP-Code ein: $table = 'tabellen_name'; $TYPO3_CONF_VARS['EXTCONF']['cms']['db_layout']['addTables'][$table][0] = array( 'fList' => 'feld1;feld2,feld3', 'icon' => TRUE );

Max. Linie

Damit registrieren Sie Ihre Tabelle für die Darstellung im Modul Seite und geben gleichzeitig die Felder sowie deren Position in der Liste an. Ersetzen Sie dann tabellen_name durch den gewünschten Tabellennamen und geben Sie im Parameter fList (field-Liste) die gewünschten Spaltennamen an, die in der Ansicht erscheinen sollen. Diese Werte können Sie mit zwei unterschiedlichen Trennzeichen gliedern: Werden die Spaltennamen durch Kommata getrennt, bilden sie für jeden Wert eine eigenständige Spalte. Der Feldtitel erscheint dabei automatisch als Spaltenüberschrift. Wenn Sie mehrere Werte innerhalb einer Spalte darstellen möchten, sollten Sie das Semikolon als Trennzeichen

7.7 Eigene Datensätze im Seitenmodul anzeigen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 241

Max. Linie

verwenden. Die Werte erscheinen daraufhin untereinander. feld1 wird in dem Beispiel also mit feld2 in einer Spalte angezeigt. feld3 erscheint rechts davon in einer neuen Spalte. Mit dem Wert icon legen Sie fest, ob das Icon des Datensatzes in der Liste am linken Rand erscheint. Über dieses Icon ist es dann möglich, das Kontextmenü aufzurufen und weitere Bearbeitungsoptionen durchzuführen. Wenn Sie nur die Bearbeitung der Datensätze erlauben möchten, sollten Sie diesen Wert auf FALSE setzen.

Links

Mit folgender Anweisung erscheinen zum Beispiel Benutzername und Passwort von Frontend-Benutzern untereinander in einer gemeinsamen Spalte. Die restlichen Daten werden separat davon in eigenen Spalten angezeigt: $table = 'fe_users'; $TYPO3_CONF_VARS['EXTCONF']['cms']['db_layout']['addTables'][$table][0] = array( 'fList' => 'username;password,name,email,telephone,address,zip,city', 'icon' => TRUE );

Aus Platzgründen haben wir das Feld usergroup entfernt. Die Standardeinstellung für die Tabelle fe_users ist username,password,usergroup,name,email,telephone,address,zip,city.

Diskussion Lizensiert für Markus Mueller

Durch die Darstellung der Datensätze im Seitenmodul können Sie Ihre Datensätze übersichtlich unterhalb des regulären Seiteninhalts auflisten. Gerade bei umfangreichen Listen ist damit ein sehr intuitives Arbeiten möglich, da bestimmte Felder über die Trennung mithilfe von Semikola auch logisch gegliedert in einer Spalte dargestellt werden können. Dabei werden sämtliche Felder im Klartext ausgelesen. Dies kann bei Dateifeldern, in denen Sie Bilder speichern, jedoch auch hinderlich sein, denn ein Bildname ist meist nicht so aussagekräftig wie das jeweilige Bild selbst. Was aber, wenn Sie Bilder direkt in der Liste als Vorschaubild anzeigen möchten? Für diesen Fall bietet Ihnen TYPO3 die Möglichkeit, in den Tabelleneigenschaften das jeweilige Feld als sogenanntes Thumbnail-Feld zu definieren. Der Inhalt dieses Felds wird dann anhand des Dateinamens in ein Vorschaubild umgewandelt und kann automatisch per Mausklick vergrößert werden.

Max. Linie

Um dieses Feld für eine Tabelle einzurichten, gehen Sie wie folgt vor: Falls noch kein Dateifeld vorhanden ist, sollten Sie im ersten Schritt ein Dateifeld vom Typ group in Ihrer Datenbanktabelle anlegen (wenn Sie noch nicht wissen, wie Sie diese Felder hinzufügen, sollten Sie vorher unbedingt Rezept 16.3 lesen). Legen Sie in diesem Feld anschließend das gewünschte Bild ab. Öffnen Sie nun die Datei ext_tables.php und registrieren Sie dieses Feld im Bereich ctrl des TCA der Tabelle mit der Option thumbnail als Bildspalte. Anschließend binden Sie das Feld – wie anfangs gezeigt – im Seitenmodul ein, um die Datensätze auch dort aufzulisten. Achten Sie darauf, dass Sie das Feld für das Vorschaubild – durch ein Komma von den anderen Feldnamen getrennt – in eine eigene Spalte legen.

242 | Kapitel 7: Die Übersicht im Backend erhöhen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Am Beispiel der Frontend-Benutzer richten Sie dieses Feld wie folgt ein: Als Erstes sollten Sie dem Frontend-Benutzer ein Bild zuweisen, das Sie später in der Liste anzeigen möchten. Wechseln Sie anschließend in die Datei ext_tables.php und geben Sie dort folgenden PHP-Code ein, um das Feld image im TCA der Tabelle fe_users als Thumbnail-Feld zu registrieren. Damit wird die Voraussetzung geschaffen, dass das Feld image später in der Listenansicht als Vorschaubild verwendet werden kann: t3lib_div::loadTCA('fe_users'); $TCA['fe_users']['ctrl']['thumbnail'] = 'image';

Öffnen Sie anschließend die Datei ext_localconf.php im gleichen Extension-Ordner und geben Sie dort den Code ein, mit dem Sie die Spaltenaufteilung im Modul Seite anpassen: $table = 'fe_users'; $TYPO3_CONF_VARS['EXTCONF']['cms']['db_layout']['addTables'][$table][0] = array(array( 'fList' => 'username;password,name,email,telephone,address,zip,city,image', 'icon' => TRUE );

Lizensiert für Markus Mueller

Wechseln Sie nun in das Modul Seite und wählen Sie den Ordner aus, in dem die Frontend-Benutzer gespeichert werden. Das Bild des Frontend-Benutzers wird dann – sofern vorhanden – automatisch angezeigt. Wenn Sie mehrere Bilder in einem Dateifeld speichern, werden diese in der Spalte der Reihe nach untereinander aufgelistet. Dadurch, dass die Bilddaten nun passend zum jeweiligen Frontend-Benutzer dargestellt werden, können Sie sich schnell einen Überblick über die vorhandenen Benutzer verschaffen.

7.8

Eigene Seiten-Icons anzeigen

Problem Sie möchten eigene Grafiken für Seiten oder SysOrdner anzeigen lassen, beispielsweise um im Backend bestimmte Bereiche Ihrer Website über die Seitensymbole speziell zu kennzeichnen.

Lösung Passen Sie im Array $PAGE_TYPES den Wert icon an und überschreiben Sie den Standardwert mit der Pfadangabe zu einer eigenen Grafikdatei. Die Seitengrafik muss eine Breite von 18 Pixeln und eine Höhe von 16 Pixeln haben und im PNG- oder GIF-Format vorliegen.

Max. Linie

Wir empfehlen Ihnen, diese Anpassung über eine eigene Extension vorzunehmen. Wenn Ihnen diese Vorgehensweise noch ungewohnt erscheint, sollten Sie zuerst die Einleitung von Kapitel 16 lesen, um die nötige Grundlage für dieses Rezept zu haben. Danach wird es Ihnen leichter fallen, die hier beschriebenen Vorgänge nachzuvollziehen.

7.8 Eigene Seiten-Icons anzeigen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 243

Max. Linie

In dem Extension-Ordner legen Sie anschließend den Unterordner res an. Dort speichern Sie die Grafik ab, die Sie später als Seiten-Icon verwenden möchten. Anschließend passen Sie in der Datei ext_tables.php das Array $PAGES_TYPES für den gewünschten Seitentyp an. Zuerst wird über einen Funktionsaufruf der Pfad zur Extension ermittelt. Dies ist wichtig, damit die Grafikdatei richtig eingebunden werden kann. Danach ändern Sie die Eigenschaft für den gewünschten Seitentyp. Fügen Sie dazu folgenden Code in die Datei ext_tables.php ein:

Links

$ext_path = t3lib_extMgm::extRelPath($_EXTKEY); $PAGES_TYPES['seiten_typ'] = array( 'icon' => $ext_path .'res/seiten_icon', );

Ersetzen Sie die hervorgehobenen Werte seiten_typ und seiten_icon mit Ihren Werten. Standardmäßig stehen Ihnen in TYPO3 folgende Seitentypen zur Verfügung:

Lizensiert für Markus Mueller

1

Standard

3

Link zu externer URL

4

Verweis

6

Backend-Benutzer Bereich

7

Einstiegspunkt

199

Visuelles Trennzeichen für Menü

254

SysOrdner

255

Papierkorb

Wenn Sie einen eigenen Seitentyp erstellt haben, können Sie natürlich auch diesen als Seitentyp verwenden und das Icon anpassen.

Diskussion Wenn Sie den Status der Seite ändern, etwa indem Sie sie auf Versteckt setzen, werden Sie feststellen, dass Ihr Icon möglicherweise nicht mehr angezeigt wird. Das hat den Hintergrund, dass TYPO3 für jeden Zustand der Seite eine eigene Grafik verwendet, die Sie zusätzlich zu der Standardgrafik in dem Ordner res/ anlegen müssen. Liegt das Icon nicht in dem entsprechenden Zustand vor, verwendet TYPO3 ein Standard-Icon. Die folgende Liste zeigt die wichtigsten Zustände der Seiten-Icons: pagesh.gif

Die Seite ist versteckt. pageshp.gif

Die Seite und deren Unterseiten sind versteckt.

Max. Linie

pageshtf.gif

Die Seite ist versteckt und besitzt zeitliche Sichtbarkeitseinstellungen.

244 | Kapitel 7: Die Übersicht im Backend erhöhen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts pageshtfp.gif

Die Seite und deren Unterseiten sind versteckt und besitzen zeitliche Sichtbarkeitseinstellungen. pageshtfu.gif

Die Seite ist versteckt, besitzt zeitliche Sichtbarkeitseinstellungen und ist nur für bestimmte Frontend-Benutzer sichtbar. pageshtfup.gif

Die Seite und deren Unterseiten sind versteckt, besitzen zeitliche Sichtbarkeitseinstellungen und sind nur für bestimmte Frontend-Benutzer sichtbar. pageshu.gif

Die Seite ist versteckt und nur für bestimmte Frontend-Benutzer sichtbar. pageshup.gif

Die Seite und deren Unterseiten sind versteckt und nur für bestimmte FrontendBenutzer sichtbar. pagestf.gif

Die Seite besitzt zeitliche Sichtbarkeitseinstellungen. pagestfp.gif

Die Seite und deren Unterseiten besitzen zeitliche Sichtbarkeitseinstellungen. Lizensiert für Markus Mueller

pagestfu.gif

Die Seite besitzt zeitliche Sichtbarkeitseinstellungen und ist nur für bestimmte Frontend-Benutzer sichtbar. pagestfup.gif

Die Seite und deren Unterseiten besitzen zeitliche Sichtbarkeitseinstellungen und sind nur für bestimmte Frontend-Benutzer sichtbar. pagesu.gif

Die Seite ist nur für bestimmte Frontend-Benutzer sichtbar. pagesup.gif

Die Seite und deren Unterseiten sind nur für bestimmte Frontend-Benutzer sichtbar. pages__x.gif

Der Status kann über kein anderes Icon dargestellt werden. Dieses Icon sollten Sie zur Sicherheit immer anlegen.

Max. Linie

Die Umwandlung der Icons kann mit TYPO3 auch automatisch erfolgen. TYPO3 überlagert dann die Standardgrafik mit der entsprechenden Statusgrafik. Sie brauchen also lediglich die Grundgrafik anzugeben, und TYPO3 erstellt die restlichen Icons bei Bedarf automatisch. Um diese Funktion zu verwenden, ist es jedoch notwendig, dass Sie bestimmte Grafikpakete auf Ihrem Server installiert haben, die diese Grafikfunktionen zur Verfügung stellen. Um dies zu testen, wechseln Sie in das Install-Tool und wählen den Menüpunkt All Configuration. Suchen Sie dort nach dem Wert noIconProc und lesen

7.8 Eigene Seiten-Icons anzeigen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 245

Max. Linie

Sie die entsprechenden Anmerkungen. Wenn die nötigen Softwarepakete auf Ihrem Server vorhanden sind, können Sie das Kontrollkästchen aktivieren. Alternativ dazu können Sie diese Funktion auch freischalten, indem Sie folgenden Wert direkt in die Datei localconf.php eingeben:

Links

$TYPO3_CONF_VARS['GFX']['noIconProc']= 0;

Siehe auch In der Diskussion von Rezept 4.6 erhalten Sie nützliche Hintergrundinformationen zu Seitentypen: wie Sie diese erstellen und mit den jeweiligen Seiteneigenschaften aus diesem Rezept verknüpfen. In der Einleitung von Kapitel 16 erfahren Sie mehr über den Aufbau einer Extension und welche Bedeutung die Ordnerstruktur für die Verwendung von Extensions hat. In Rezept 19.4 erfahren Sie, wie Sie bei Datensätzen je nach Typ unterschiedliche Icons anzeigen lassen können.

Lizensiert für Markus Mueller

Max. Linie

Max. Linie 246 | Kapitel 7: Die Übersicht im Backend erhöhen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

First

Kapitel 8

KAPITEL 8

TypoScript verstehen und verwalten

8.0

Einführung

Die Grundfunktionalität eines datenbankbasierten Frameworks besteht in der Regel darin, Inhalte in eine Datenbank einzupflegen und diese dann – in welcher Form auch immer – für verschiedene Betrachter und Medien aufbereitet wieder auszugeben. Lizensiert für Markus Mueller

Eines haben dabei sämtliche verschiedenen Systeme gemeinsam: Eine bestimmte Anzahl von Funktionen wird in geringfügig abgewandelter Form ständig wiederholt. Datenbankabfragen liefern eine definierte Anzahl von Inhaltselementen, die wiederum in ein vordefiniertes Set von Vorlagen (sogenannten Templates) eingebaut werden müssen, bevor sie für die endgültige Ausgabe zusammengesetzt werden. Die Tatsache, dass diese Funktionen sich prinzipiell sehr ähnlich sind, legt nahe, hierfür eine vereinfachte Schreibweise einzuführen – eine Art Stenografie für Programmfunktionen. Diese sollte auf der einen Seite die Möglichkeit bieten, die Funktionen selbst aufzurufen, auf der anderen Seite sollten eventuell nötige Parameter, Inhalte und ähnliche Dinge an eben diese Funktionen übergeben werden können. Außerdem wäre es äußerst komfortabel, die übergebenen Funktionen und Parameter gegebenenfalls noch intern mithilfe weiterer eigener Funktionen modifizieren zu können. Da TYPO3 auf PHP basiert, bietet es sich an, hierfür ein multidimensionales Array zu definieren, das für die einzelnen Funktionen eigene Arrays zur Verfügung stellt. In diesen Arrays würden wiederum deren Parameter und/oder Unterfunktionen mit weiteren Parametern übergeben. Das Ergebnis wäre ein umfangreiches Super-Array, mit dessen Hilfe die Ausgabe des Systems bis ins kleinste Detail gesteuert werden kann. Die Tiefe der Struktur wäre theoretisch unendlich. Praktisch betrachtet, würden dennoch Grenzen durch die jeweils verwendete Hardware und deren maximale Performance gesetzt. Nichts anderes ist TypoScript!

Max. Linie

Max. Linie | 247 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Links Es handelt sich nicht um eine Programmiersprache im eigentlichen Sinn, obwohl der Name die Vermutung nahe legen würde, sondern um eben solch ein Array, das nach Meinung vieler begeisterter Nutzer die eigentliche Innovation bei der Entwicklung von TYPO3 darstellt. Die Syntax von TypoScript ist dabei denkbar einfach und weitgehend angelehnt an JavaScript. Einem Objekt wird mithilfe von Operatoren ein Wert zugewiesen. Zusätzliche Eigenschaften werden dabei in einem Objektpfad ebenfalls über Operatoren mit Werten versehen. Die einzelnen Teile des Objektpfads werden dabei mithilfe von Punkten getrennt. Hier ein Beispiel: meinObjekt = OBJECT meinObjekt = Wert1 meinObjekt.meineEigenschaft = Wert2 meinObjekt.meineEigenschaft.ersteEigenschaft = Wert3 meinObjekt.meineEigenschaft.zweiteEigenschaft = Wert4

Lizensiert für Markus Mueller

Die Zuweisung eines Werts, der ausschließlich aus Großbuchstaben besteht, ist in der Regel den echten Toplevel-, Content- und Menu-Objekten vorbehalten. Sie könnten zwar rein theoretisch gesehen auch andere Werte nur in Großbuchstaben notieren, jedoch sollten Sie zur besseren Unterscheidung darauf verzichten. Eigenschaften im Objektpfad werden bis auf wenige Ausnahmen immer in camelCase-Notation angegeben. Bei eigenen TypoScriptAnweisungen, die Sie z.B. in Extensions verwenden, sollten Sie diese Regeln ebenfalls befolgen.

Als Operatoren kommen die Zeichen =, < und > sowie zum Zusammenfassen die runden Klammern ( ) zum Einsatz. Sobald ein Operator oder eine Klammer in einer Zeile auftaucht, erkennt der TypoScript-Parser alles vor diesem Zeichen als Objektpfad und alles danach bzw. innerhalb der Klammern als Wert. Geschweifte Klammern { } hingegen werden nicht als eigentliche Operatoren verwendet. Sie dienen dazu, den TypoScriptCode zu strukturieren und einem Objekt mehrere Eigenschaften gleichzeitig zuzuweisen. Erlaubt sind also auch solche Konstrukte: meinParameter = class=meineKlasse meinObjekt.meineEigenschaft = Wert1<1 meinObjekt.meineEigenschaft.ersteEigenschaft =
meinObjekt.meineEigenschaft ( class=meineKlasse id=meineId )

Max. Linie

meinObjekt.meineEigenschaft = Wert1 meinObjekt.meineEigenschaft { ersteEigenschaft = Wert2 ersteEigenschaft.unterEigenschaft (

248 | Kapitel 8: TypoScript verstehen und verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

|

) zweiteEigenschaft = Wert3 zweiteEigenschaft.unterEigenschaft (

|

) }

Sie sollten immer im Hinterkopf behalten, dass es sich bei den verwendeten Zeichen um Zuweisungsoperatoren handelt und nicht um eine mathematisch korrekte Schreibweise. Das Zeichen = weist einen Wert zu, deswegen ist auch die erwähnte Zuweisung meineEigenschaft = Wert1<1 in TypoScript korrekt. Es werden hier keine Werte miteinander verglichen, sondern der String "Wert1<1" wird als Wert für meineEigenschaft zugewiesen!

Speziell die Klammerung in geschweiften Klammern sollten Sie von Anfang an bevorzugen, denn sie wird Ihnen helfen, den Code übersichtlich und schlank zu halten. Das vorige Beispiel sähe ohne geschweifte Klammern folgendermaßen aus: meinParameter = class=meineKlasse meinObjekt.meineEigenschaft = Wert1<1 Lizensiert für Markus Mueller

meinObjekt.meineEigenschaft.ersteEigenschaft =
meinObjekt.meineEigenschaft ( class=meineKlasse id=meineId ) meinObjekt.meineEigenschaft = Wert1 meinObjekt.meineEigenschaft.ersteEigenschaft = Wert2 meinObjekt.meineEigenschaft.ersteEigenschaft.unterEigenschaft (

|

) meinObjekt.meineEigenschaft.zweiteEigenschaft = Wert3 meinObjekt.meineEigenschaft.zweiteEigenschaft.unterEigenschaft (

|

) }

Je tiefer Sie dabei in weitere Unterebenen vorstoßen, desto schwieriger wird es, den Überblick zu behalten, und desto größer wird der Anteil an überflüssigen Wiederholungen von Objektpfaden, den Sie zu bearbeiten haben.

Max. Linie

Wann immer möglich, sollten Sie daher geschweifte Klammern und Einrückungen verwenden!

This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Einführung

Max. Linie | 249

Links Mithilfe der Operatoren <, =< und > können Sie Eigenschaften, Funktionen und sogar ganze TypoScript-Blöcke kopieren, referenzieren oder abschalten. Mit diesem Code würden Sie z.B. eine Kopie von meinElement1.meineEigenschaft1 anlegen und in meinElement2. meineEigenschaft2 verwenden: meinElement2.meineEigenschaft2 < meinElement1.meineEigenschaft1

Dieser Code wiederum würde meineEigenschaft1 deaktivieren: meinElement1.meineEigenschaft1 >

Komfortabler ist es oft, keine Kopie, sondern eine Referenz auf des entsprechende Element zu erstellen, weil der TypoScript-Parser das entsprechende Setup so nicht mehrmals durchlaufen muss. Sämtliche Änderungen an Element1 werden somit automatisch auch an Element2 vorgenommen. Bei einer Kopie müssten Sie diese Änderungen gegebenenfalls an mehreren Stellen nacharbeiten, bei einer Referenz können Sie darauf verzichten. meinElement2.meineEigenschaft2 =< meinElement1.meineEigenschaft1

Der Nachteil bei dieser Vorgehensweise ist, dass Sie im TypoScript-Object-Browser nicht erkennen können, welche Einstellungen für meineEigenschaft2 gerade gelten sollen. Dazu müssten Sie immer auf meineEigenschaft1 zurückgreifen. Außerdem können Sie auf diese Weise zugewiesene Untereigenschaften nur überschreiben, nicht jedoch deaktivieren. Lizensiert für Markus Mueller

Dieser Code meinElement2.meineEigenschaft2 =< meinElement1.meineEigenschaft1 meinElement2.meineEigenschaft2.unterEigenschaft = ein anderer Wert

würde also funktionieren, meinElement2.meineEigenschaft2 =< meinElement1.meineEigenschaft1 meinElement2.meineEigenschaft2.unterEigenschaft >

jedoch nicht! Seit TYPO3 4.0 existiert noch ein weiterer Operator :=, mit dessen Hilfe Sie vordefinierte Funktionen verwenden können, um die Werte einzelner Parameter zu verändern. Da diese Option in Form eines Hook eingebaut wurde, können Sie selbst weitere Funktionen einbinden und diese mit der folgenden Syntax nutzen: meinElement.meineFunktion := eineFunktion(Parameter)

Die Übergabe der Funktionsparameter erfolgt dabei wie in einer echten PHP-Funktion. Lesen Sie dazu auch Rezept 8.11, in dem wir die Vorgehensweise beschreiben. In den folgenden Rezepten wollen wir Ihnen die eigentliche Funktionsweise von TypoScript erläutern, bevor wir in den weiterführenden Kapiteln an konkreten Anwendungsbeispielen demonstrieren, wie umfangreich und mächtig TypoScript in der Anwendung sein kann. Mithilfe dieser Rezepte wird Ihnen Schritt für Schritt klarer werden, was eigentlich passiert, wenn Sie die wohl bekannteste TypoScript-Anweisung verwenden –

Max. Linie

styles.content.get.

250 | Kapitel 8: TypoScript verstehen und verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts 8.1

TypoScript anstatt eigener PHP-Funktionen nutzen

Problem Sie wollen die Ausgabe von TYPO3 nach Ihren eigenen Wünschen gestalten. Dabei möchten Sie eigene Menüvarianten verwenden, Inhaltselementen bestimmte Layouts zuweisen, die TYPO3 so nicht zur Verfügung stellt, und zusätzliche Funktionen einbauen, um gezielt auf bestimmte Bereiche der Datenbank zugreifen zu können.

Lösung Verwenden Sie TypoScript und konfigurieren Sie damit die Ausgabefunktionen von TYPO3. Setzen Sie dabei nicht nur die Rezepte aus diesem Buch ein, sondern lesen Sie auch die TypoScript-Referenz sowie TypoScript by Example auf typo3.org. Versuchen Sie auf diese Weise, Ihre eigenen TypoScript-Schnipsel zu erzeugen.

Lizensiert für Markus Mueller

Selbst wenn Sie dabei an Grenzen stoßen sollten, bei denen TypoScript zu aufwendig einzusetzen wäre oder nicht den nötigen Funktionsumfang liefert und daher eigene PHPFunktionen erforderlich würden, bauen Sie diesen PHP Code ebenfalls mithilfe von TypoScript in Ihre bestehende Konfiguration ein. Bevor Sie mit eigenem PHP-Code arbeiten oder gar, wie in späteren Kapiteln beschrieben, eine spezielle eigene Extension erzeugen, sollten Sie immer sicherstellen, dass dies notwendig ist, weil TypoScript Ihnen nicht die passende Lösung bietet.

Damit sorgen Sie dafür, dass Ihre Konfiguration so flexibel wie möglich bleibt und auch von anderen Administratoren einfach nachvollzogen und erweitert werden kann.

Diskussion TYPO3 ist ein System, das zu einem Großteil auf einer SQL-Datenbank und der Programmiersprache PHP basiert. TYPO3-Einsteiger lassen sich daher in zwei Kategorien einteilen: Menschen, die bereits über Erfahrungen mit PHP verfügen – z.B. Programmierer, IT-Spezialisten und Systemadministratoren –, und Menschen, die keinerlei PHPKenntnisse besitzen – z.B. Designer, Redakteure und Layouter.

Max. Linie

Die erste Gruppe neigt dazu, die Arbeitsweise des Systems und den dabei eingesetzten PHP-Code mit ihrer bisherigen Arbeitsweise zu vergleichen. Dabei kommen viele zu dem Ergebnis, dass TYPO3 viel zu umständlich programmiert sei, die Funktionen viel zu schwerfällig und die Coding-Guidelines zu schwer nachzuvollziehen. Sie entscheiden sich daher oft dafür, entweder den TYPO3-eigenen Code direkt zu modifizieren und vermeintlich zu vereinfachen oder eine Extension zu erzeugen, die eigenen proprietären PHP-Code verwendet, weil sie glauben, damit schneller ans Ziel zu kommen.

8.1 TypoScript anstatt eigener PHP-Funktionen nutzen | 251 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Links Spätestens beim nächsten Update auf eine neuere TYPO3-Version wird klar, dass der vermeintliche Geschwindigkeitsvorteil eine Fehleinschätzung war, denn Sie müssen alle Änderungen erneut einfügen und gegebenenfalls anpassen.

Die zweite Gruppe geht die Problematik von der anderen Seite an und installiert zunächst eines der sogenannten Static Templates, in denen bereits Layouts, Konfigurationen und gewisse Grundfunktionalitäten enthalten sind. Dabei verwenden sie in der Regel ein Template, das dem eigenen Design am nächsten kommt, und tauschen die darin verwendeten Logos und Grafiken aus. Auch Static Templates basieren auf TypoScript, und es ist meist deutlich schwieriger, den bestehenden Code den eigenen Bedürfnissen anzupassen als direkt mit eigenem Code zu arbeiten. Zudem sind die aktuell verfügbaren Static Templates nur noch aus historischen Gründen vorhanden. Sie verwenden zu einem Großteil veralteten HTML-Code und werden daher Zug um Zug durch modernere Templates, die auf Extensions basieren, ersetzt.

Lizensiert für Markus Mueller

Beide Vorgehensweisen sind absolut nicht empfehlenswert, denn Sie werden unabhängig von Ihren PHP-Kenntnissen schnell an diverse Grenzen und Hindernisse stoßen, die Sie in der Arbeit mit dem System TYPO3 unnötig behindern. Verwenden Sie daher so weit wie möglich Ihren eigenen, individuell erzeugten TypoScript-Code und greifen Sie nur, wenn es unbedingt erforderlich ist, auf PHP-Funktionen zurück. Binden Sie diese Funktionen immer entweder mit TypoScript oder mithilfe einer Extension ein und vermeiden Sie manuelle Modifikationen am bestehenden Code! Der Titel dieses Rezepts versteht sich nicht als Einschränkung, sondern als Chance sowohl für erfahrene PHP-Programmierer als auch für Einsteiger. TypoScript ist nämlich nicht nur einfacher nachzuvollziehen als entsprechende PHP-Funktionen, es erspart auch dem versierten Entwickler eine Menge Arbeit, weil er sich nicht um all die Dinge selbst kümmern muss, die beim Ausführen von TypoScript-Anweisungen automatisch im Hintergrund abgewickelt werden. Hierzu einige Beispiele: Sie wollen Texte und Überschriften aus der Tabelle tt_content auslesen und im Frontend ausgeben. Ein versierter PHP-Entwickler würde dazu ein paar Funktionen schreiben, um die Daten zunächst aus der Tabelle auszulesen und danach für die Ausgabe zu formatieren. Der geschätzte Umfang dieser Funktionen beträgt ungefähr 20 Zeilen individuellen PHP-Codes.

Max. Linie

Weil in der Regel nur der Inhalt einer bestimmten Seite ausgelesen werden soll, müssen die Funktionen um eine Abfrage erweitert werden, die die UID der aktuellen Seite mit berücksichtigt. Es kommen also circa 5 weitere Zeilen PHP-Code hinzu. Außerdem hat der Redakteur im Backend festgelegt, dass die Seite nur für eine bestimmte Gruppe von eingeloggten Frontend-Usern zu sehen sein soll. Eine weitere Abfrage muss her, die sämtliche 252 | Kapitel 8: TypoScript verstehen und verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts Sicherheitseinstellungen und Berechtigungen der User berückichtigt, was ein Minimum von weiteren 30 Zeilen PHP-Code erforderlich macht. Der Inhalt wurde vom Redakteur mithilfe eines Start-/Stopp-Datums zeitlich eingeschränkt. Auch hier wird eine weitere Funktion nicht unter 5 Zeilen Umfang benötigt, um die Abfrage entsprechend zu modifizieren. Für jeden weiteren Parameter, der in diesem noch recht einfachen Szenario berücksichtigt werden soll, müssten eigene Funktionen geschrieben werden, die schnell ein Ausmaß von mehreren 100 Zeilen erreichen würden. Selbst wenn es Ihnen gelänge, den Codeumfang aufgrund geschickt angewendeter Programmiertechniken zu reduzieren, wäre es dennoch ein proprietärer Code, der viele Nachteile mit sich brächte: • Ungeprüft durch die Kernentwickler und das Security-Team, könnten schwer wiegende Sicherheitslücken ins System gelangen. • Durch die Verwendung eigener Coding-Regeln wäre es gegebenenfalls nicht möglich, mit vorhandenen Extensions zu arbeiten. • Modifikationen am Verhalten der Ausgabe könnten nur durch den Entwickler selbst vorgenommen werden. • Weiterführende Entwicklungen in kommenden Versionen von TYPO3 müssten manuell nachgepflegt werden. Lizensiert für Markus Mueller

Die Liste ließe sich beliebig fortführen. – Und so einfach wird es, wenn Sie das Gleiche in TypoScript tun: meinContent = CONTENT meinContent { table = tt_content renderObj = COA renderObj { 10 = TEXT 10.field = header 10.wrap =

|

20 = TEXT 20.field = bodytext 20.wrap =

} }

Die Vorteile dieser Vorgehensweise: • Parameter wie Seiten-ID, User-Berechtigungen, Start-/Stopp-Datum und ähnliche werden automatisch im Hintergrund abgearbeitet. • Es werden immer vereinheitlichte und geprüfte Bausteine aus dem umfangreichen Funktionsbaukasten von TYPO3 verwendet .

Max. Linie

• Durch die strikte Berücksichtigung der TYPO3-Coding-Guidelines innerhalb des Funktionsbaukastens wird sichergestellt, dass Sie mit vorhandenen Extensions arbeiten können, so deren Autoren sich ebenfalls an diese Guidelines gehalten haben.

8.1 TypoScript anstatt eigener PHP-Funktionen nutzen | 253 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Links • Modifikationen am Verhalten der Ausgabe können durch verschiedene Administratoren direkt und ohne weitergehende PHP-Kenntnisse über TypoScript-Eingabeformulare im Backend vorgenommen werden. • Durch die Verwendung von Conditions und Extension-Templates kann das Verhalten schnell und einfach an verschiedenste Parameter angepasst werden. • Weiterführende Entwicklungen in kommenden Versionen von TYPO3 werden automatisch berücksichtigt. In den folgenden Kapiteln werden wir Ihnen anhand vieler praktischer Beispiele demonstrieren, welche Möglichkeiten Ihnen TypoScript eröffnet und wie Sie diese effektiv und sinnvoll nutzen können. Unserer Meinung nach ist es nicht nur sinnvoller, sondern zwingend erforderlich, TypoScript für sämtliche TYPO3-basierten Projekte zu verwenden. Die offizielle und gleichzeitig optimale Schnittstelle, um das Verhalten des TYPO3-Frontends zu steuern, ist eben TypoScript und nicht, wie vielleicht bei anderen Systemen üblich, eine PHP-API!

8.2

TypoScript-Templates sinnvoll aufteilen

Lizensiert für Markus Mueller

Problem Sie wollen einen Webauftritt mit mehreren Websites erstellen. Sie möchten dabei alle Websites mit nur einem Template-Satz abbilden.

Lösung Anstatt alle TypoScript-Objekte, die Sie zur Darstellung Ihrer Websites benötigen, in einem Template zu definieren, gliedern Sie Ihr TypoScript-Template in mehrere funktionsbezogene Untertemplates auf. Mithilfe des Dialogs Include basis template binden Sie die Untertemplates anschließend in Ihr Haupttemplate ein. Diese speichern Sie in einem Templates-SysOrdner außerhalb Ihres Seitenbaums für die Webinhalte ab, wie in Abbildung 8-1 zu sehen. Alle seitenspezifischen Angaben wie Einstiegspunkte für Menüs, Beschriftungen von Bannern, Metatags, Spracheinstellungen usw. definieren Sie über Konstanten, die jeweils in einem Shortcut-Template in den Startseiten der Websites definiert werden (siehe Abbildung 8-2).

Max. Linie

Max. Linie 254 | Kapitel 8: TypoScript verstehen und verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Rechts

Abbildung 8-1: Der zentrale Ordner mit den funktionsbezogenen Templates

Lizensiert für Markus Mueller

Abbildung 8-2: Das Template mit den Site-spezifischen Einstellungen

Diskussion Sobald Sie einen Webauftritt realisieren, der aus mehr als einer Website mit gleichem Aufbau besteht, sollten Sie darüber nachdenken, wie Sie redundanten TypoScript-Code vermeiden und den Aufbau Ihrer Template-Struktur so effizient wie möglich gestalten können. Der anfängliche Mehraufwand, der durch die Kapselung von Inhaltsobjekten in eigene Templates entsteht, zahlt sich sehr schnell aus – egal ob eine weitere Website hinzukommt, kleine Änderungen an der gemeinsamen Struktur durchgeführt werden müssen oder gar ein Redesign erforderlich ist. Zuerst teilen Sie Ihr TypoScript-Template in mehrere funktionsbezogene Einzeltemplates auf. Beispielsweise können Sie das TypoScript für Ihre Metanavigation (Kontakt, Impressum, Anfahrt) in einem Template-Datensatz mit dem Namen temp.metaNavi speichern. In dessen SETUP-Feld legen Sie ein neues, temporäres COA-Objekt an:

Max. Linie

temp.metaNavi = COA temp.metaNavi { 10 = HMENU

8.2 TypoScript-Templates sinnvoll aufteilen | 255 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Links 10 { special = directory special.value = {$metaNavi_id} 1 = TMENU 1 { NO = 1 CUR = 1 noBlur = 1 wrap =

| NO { wrapItemAndSub =

} CUR < .NO CUR { doNotLinkIt = 1 linkWrap = | } } } }

In Ihrem Haupttemplate brauchen Sie zur Ausgabe Ihrer Metanavigation nur noch eine Zeile: Lizensiert für Markus Mueller

marks.METANAVI < temp.metaNavi

oder subparts.METANAVI < temp.metaNavi

Wenn Sie auch die anderen Objekte für die Inhaltsdarstellung auf diese Art gestalten, reduziert sich der Umfang des Haupttemplates haupttemplate auf wenige Zeilen: page = PAGE page { 10 = TEMPLATE 10 { template = FILE template.file = fileadmin/main.html workOnSubpart = DOKUMENT subparts { METANAVI < temp.metaNavi BREADCRUMB < temp.breadcrumbNavi MAINNAVI < temp.mainNavi INHALT < styles.content.get } } }

Diese Unterteilung in funktionsbezogene Untertemplates erleichtert auch die Teamarbeit, da Arbeitsbereiche klar definiert und Überschneidungen vermieden werden können.

Max. Linie

Ihre Objekte zur Inhaltsdarstellung in den Untertemplates sollten Sie immer als COA-Setzkastenelemente anlegen – auch wenn das anfangs unnötig erscheint. So können Sie flexibel

256 | Kapitel 8: TypoScript verstehen und verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts auf Änderungswünsche reagieren und problemlos Elemente vor oder nach den bestehenden Inhaltsobjekten einfügen, ohne die Struktur des Haupttemplates oder der Designvorlage verändern zu müssen. Möchten Sie vor der Metanavigation noch ein Bild einfügen, erweitern Sie das COA-Element für die Metanavigation einfach folgendermaßen: temp.metaNavi = COA temp.metaNavi { 5 = TEXT 5 { value =

} } [treeLevel = 1] page { 30 { value = Geänderter Text für die Seiten auf Ebene 1 } } [end]

Lizensiert für Markus Mueller

In diesem Beispiel können Sie erkennen, wie der Ausgabetext für alle Seiten, die sich genau auf Ebene 1 befinden, geändert wird. Die im Condition-Block nicht eingesetzten Eigenschaften und Objekte behalten ihren Standardwert. page.30 bleibt also in diesem Beispiel ein TEXT-Objekt. Conditions können nur direkt auf der obersten Ebene und nicht innerhalb verschachtelter Objekte verwendet werden. An der Stelle, an der Sie Conditions in das Template einfügen, müssen alle Objektdefinitionen mit einer geschweiften Klammer } geschlossen sein. Innerhalb des Condition-Blocks können Sie hingegen problemlos mit der Klammersyntax arbeiten. // Boolesches Oder: '||', 'OR' oder 'or' [conditionBezeichnung=Wert] || [andereConditionBezeichnung=Wert] // bedingte TypoScript-Anweisungen [end]

Syntax für Boolesches UND: // erfordert TYPO3-Version 4.0 oder höher // Boolesches Und: '&&', AND' oder 'and' [conditionBezeichnung=Wert] && [andereConditionBezeichnung=Wert] // bedingte TypoScript-Anweisungen [end]

Diskussion Sie können natürlich beliebig viele Condition-Blöcke verwenden, wenn gewünscht sogar auch an verschiedenen Stellen des Templates:

Max. Linie

[conditionBezeichnung=Wert] && [zweiteConditionBezeichnung=Wert] // bedingte TypoScript-Anweisungen [andereConditionBezeichnung=Wert]

8.8 Extension-Templates und Conditions nutzen | 279 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Links // bedingte TypoScript-Anweisungen [end] // hier beginnt wieder der globale Geltungsbereich des TypoScript

Wenn mehrere solcher Condition-Blöcke zutreffend sind, wird beim Rendern ausschließlich der erste Block berücksichtigt. In diesem Fall spielt also die Reihenfolge der Deklarationen eine Rolle. Die Conditions werden natürlich auch beim Caching der Inhalte berücksichtigt. TYPO3 hält im Cache für jede zutreffende Condition eine Ausgabe vor und sorgt auch dafür, dass die entsprechende Version aus dem Cache ausgelesen wird, jedenfalls solange Sie das Cachen nicht deativiert haben. Allerdings wächst der Speicherbedarf der CacheTabellen dadurch stark an, da jede Seite für jede Condition dort komplett abgelegt wird, sobald die in der Condition abgefragten Angaben das erste Mal zutreffen. Im Folgenden finden Sie eine Auswahl der am häufigsten verwendeten Conditions, die TYPO3 Ihnen zur Verfügung stellt: [PIDinRootline = Seiten-uid, Seiten-uid, ...]

Lizensiert für Markus Mueller

Über diese Condition können Sie das gleiche Ziel erreichen, das durch die Verwendung eines Extension-Templates auf einer untergeordneten Seite erzielt wird. Sie trifft zu, wenn eine der gelisteten Seiten-uids in der Rootline enthalten ist. Zur Erinnerung: Die Rootline enthält alle Seiten-ids, die in der Verästelung des Seitenbaums von der obersten Seite (Root-Page) zur aufgerufenen Seite liegen. Beispiel: [PIDinRootline = 123]

Trifft auf die Seite 123 sowie auf den gesamten Seitenbaum unterhalb von Seite 123 zu. [PIDupinRootline = Seiten-uid, Seiten-uid, ...] Diese Condition entspricht im Prinzip [PIDinRootline = Seiten-uid, Seiten-uid, ...] mit dem einzigen Unterschied, dass nur untergeordnete Seiten berücksichtigt

werden und nicht die Seite selbst. Beispiel: [PIDupinRootline = 123]

Trifft ausschließlich für alle Unterseiten von 123 zu. Das gleiche Verhalten lässt sich auch durch die Einbindung eines Extension-Templates im Feld Template on next Level eines Template-Datensatzes erzeugen. [treeLevel = Seitenebene, Seitenebene, ...]

Hiermit können Werte abhängig von der Ebene im Seitenbaum gesetzt werden. Beispiel: [treeLevel = 0,2]

Trifft auf die oberste und die zweite Seitenebene zu. [globalVar= var1=value, var2value3, ...]

Max. Linie

Dies ist die wohl mächtigste Condition. Damit können alle globalen Variablen ausgewertet werden, die in der Laufzeitumgebung von TYPO3 zur Verfügung stehen.

280 | Kapitel 8: TypoScript verstehen und verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts Dabei muss zunächst eines der folgenden speziellen Schlüsselwörter verwendet werden: GP für den Zugriff auf Get- oder Post-Variablen, TSFE für den Zugriff auf Variablen aus dem TypoScript-Frontend-Objekt, ENV für den Zugriff auf die PHP-Umgebungsvariablen, IENV für den Zugriff auf die PHP-Umgebungsvariablen, nachdem sie durch TYPO3 für Systemunabhängigkeit optimiert wurden, LIT für den Vergleich mit einem internen String. Hinter diesem Schlüsselwort werden, durch einen Doppelpunkt getrennt, der eigentliche Variablenname und der Vergleichsoperator mit dem Wert angegeben. Auf Unterschlüssel von Array-Variablen kann mit der Syntax ArrayVariable|Schlüssel zugegriffen werden. Beispiele: [globalVar = GP:style = 2]

Trifft zu, wenn eine Get- oder Post-Variable style mit dem Wert 2 übergeben wurde. Nützlich, um beispielsweise alternative Stylesheets einzubinden. [globalVar = GP:tx_extKey|showUid = 4]

Trifft zu, wenn eine Get- oder Post-Variable einer Extension tx_extKey[showUid] mit dem Wert 4 übergeben wurde. [globalVar = TSFE:id = 2, TSFE:id > 123]

Trifft zu, wenn die angeforderte Seiten-id gleich 2 oder größer 123 ist. [globalVar = TSFE:page|layout = 1] Lizensiert für Markus Mueller

Trifft zu, wenn das Feld layout der angeforderten Seite den Wert 1 enthält. Nützlich, um eine andere HTML-Vorlage oder CSS-Stylesheets einzubinden. Felder aus Inhaltselementen können in Conditions nicht verwendet werden. [globalVar = LIT:1 = {$beliebige Konstante}]

Trifft zu, wenn die TypoScript-Konstante beliebige Konstante gleich 1 gesetzt ist. [loginUser = fe_users-uid, fe_users-uid, ...]

Hiermit können Sie auf das Login bestimmter Benutzer im Frontend reagieren. Statt einzelner UIDs können Sie auch den * verwenden, um nur abzufragen, ob der User eingeloggt ist, nicht aber, um welchen User es sich handelt. [usergroup = group1-uid, group2-uid, ...] Analog zu [loginUser = fe_users-uid, fe_users-uid, ...], diesmal für Frontend-

Benutzergruppen. [IP = ipaddress1, ipaddress2, ...]

Diese Condition ermöglicht die Verwendung der IP-Adressen der Benutzer. Auch hier kann der * als Wildcard genutzt werden. Beispiel: [IP = 123.12.*.*]

Trifft auf Besucher aus dem gesamten Netz 123.12 zu. [useragent = agent]

Max. Linie

Hiermit kann direkt auf den vom Browser oder einem anderweitigen Client übertragenen User-Agent-String zugegriffen werden.

8.8 Extension-Templates und Conditions nutzen | 281 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Links [compatVersion = 3.9]

Über diese in der TYPO3-Version 4.0 neu eingefügte Condition können Sie TypoScript abhängig von einer speziellen Kompatibilitätsversion anwenden. Der UpdateWizard setzt dazu gegebenenfalls eine Installationsvariable $TYPO3_CONF_VARS ["SYS"]["compat_version"] = '3.8'; , mit der sich eine aktuelle TYPO3-Version in einen Kompatibilitätsmodus zu einer älteren Version setzen lässt. Diese Condition ist wahr, sobald die in der Condition verwendete Version höher als die in der Installationsvariablen hinterlegte Version ist. Sollte keine $TYPO3_CONF_VARS["SYS"] ["compat_version"] gesetzt sein, erfolgt der Vergleich mit der Versionsnummer aus dem TYPO3-Source-Paket. Diese Condition wird vor allem im statischen TypoScript-Template der Extension css_styled_content verwendet. [userFunc = user_condition(testCommand)]

Sollten Ihnen die bisherigen Conditions und die komplette Liste in der TSref noch nicht das gewünschte Ergebnis liefern können, haben Sie selbstverständlich die Möglichkeit, eine eigene PHP-Funktion zu verwenden. Dazu müssen Sie lediglich eine Funktion function user_condition($cmd) in der localconf.php oder einer ext_localconf.php definieren. Der Methodenname ist dabei frei wählbar, lediglich das Präfix user_ ist vorgegeben. Diese Methode muss einen Eingangsparameter verarbeiten, der in der Condition übergeben wird, und einen Booleschen Wert als Rückgabe liefern. Lizensiert für Markus Mueller

Siehe auch In Rezept 9.4 beschäftigen wir uns mit der Steuerung der Seitenausgabe mithilfe von Conditions. Eine vollständige Referenz der implementierten Conditions finden Sie in Kapitel 4.1 der TSref unter http://typo3.org/documentation/document-library/references/ doc_core_tsref/current/view/4/1/.

8.9

Template-Ressourcen effektiv einsetzen

Problem Sie wollen in Ihren TypoScript-Templates auf externe Dateien wie z.B. Bilder, Schriften und Stylesheets zugreifen. Dabei wollen Sie sicherstellen, dass diese Dateien immer und in einer bestimmten Version zur Verfügung stehen und nicht zufällig durch einen anderen Backend-Nutzer geändert oder gar gelöscht werden.

Lösung

Max. Linie

Verwenden Sie das Feld Resources im TypoScript-Template-Editor und wählen Sie dort die nötigen Dateien aus. Klicken Sie dazu im Webmodul auf Template und wählen Sie danach das gewünschte TypoScript-Template über den Seitenbaum aus. Wählen Sie nun 282 | Kapitel 8: TypoScript verstehen und verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts im Auswahlfeld im Bereich Template Tools die Option Info/Modify und klicken Sie auf den Link Click here to edit whole template record. Im nun erscheinenden Template-Editor finden Sie direkt unter den Eingabefeldern für Constants und Setup den Bereich Resources. Hier können Sie wahlweise über das Ordnersymbol ein Dateibrowserfenster öffnen und bereits hochgeladene Dateien aus einer Dateiliste auswählen, oder Sie laden eine neue Datei über den Durchsuchen-Button direkt von Ihrer Festplatte in das TypoScript-Template. Sollten Sie die Dateien in verschiedenen TypoScript-Templates benötigen, empfiehlt es sich, diese vorher in den fileadmin-Bereich bzw. in das Ihnen zugewiesenen Filemount hochzuladen und über das Ordnersymbol auszuwählen. Nachdem Sie eine oder mehrere Dateien hochgeladen und/oder ausgewählt haben, speichern Sie das TypoScript-Template. TYPO3 legt dadurch eine Kopie dieser Datei in einen speziellen Upload-Ordner und speichert den exakten Pfad dorthin in der Datenbank. Danach können Sie die zugewiesenen Dateien innerhalb Ihres TypoScript-Templates benutzen, ohne dafür einen speziellen Pfad angeben zu müssen.

Diskussion Lizensiert für Markus Mueller

Neben dem eigentlichen TypoScript-Code und diversen PHP-Dateien, die beispielsweise durch Extensions zur Verfügung gestellt werden, kommen immer wieder verschiedenste Dateien innerhalb eines TypoScript-Templates zum Einsatz. Dies können Bilddateien für Logos oder Hintergründe sein, Schriften für grafische Header oder Menüs, PHP-Dateien, die beispielsweise in USER-Elementen Verwendung finden sollen, ohne dafür eigens eine Extension erstellen zu müssen, HTML-Dateien, die als Basis für TEMPLATE-Elemente dienen, Stylesheets und viele mehr. Von Hause aus ermöglicht Ihnen TYPO3 innerhalb des in der Lösung beschriebenen Bereichs Resources, folgende Dateitypen zu verwenden: AI, BMP, CSS, GIF, HTML/HTM, ICO, INC, JPG/JPEG, JS, PCX, PDF, PFB/PFM, PNG, TGA, TIF, TMPL, TTF, TXT Der Hauptvorteil bei der Nutzung dieses Feldes im TypoScript-Template-Editor liegt in der eindeutigen Zuweisung der dort gewählten Dateien zu exakt diesem einen TypoScript-Template. Nur so können Sie sicherstellen, dass sämtliche Dateien, die für die korrekte Ausführung des im Template enthaltenen TypoScript-Codes notwendig sind, auf jeden Fall zur Verfügung stehen.

Max. Linie

Solange Sie allein an einem TYPO3-Auftritt arbeiten, mag es ausreichend sein, die Dateien im Fileadmin-Bereich vorzuhalten und im TypoScript-Code entsprechende Pfadangaben zu machen. In diesem Fall ist diese Vorgehensweise manchmal sogar sinnvoller, weil die verwendeten Daten nicht kopiert werden müssen und daher Platz sparender gearbeitet werden kann. Spätestens wenn mehrere Administratoren Zugriff auf das

8.9 Template-Ressourcen effektiv einsetzen | 283 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Links Backend haben, sollten Sie jedoch dafür sorgen, dass niemand aus Versehen wichtige Dateien ändern oder löschen kann, die Sie in Ihrem TypoScript-Template benötigen. Zudem ist es mit direkt zugewiesenen Dateien wesentlich einfacher, komplette TypoScript-Templates z.B. auf andere Server oder sogar in völlig andere Projekte zu übertragen. In diesem Fall werden die verwendeten Dateien beim Export mit berücksichtigt und direkt in das entsprechende Paket mit eingebaut. Sie sollten jedoch beachten, dass es nach dem Einbinden von z.B. TemplateDaten oder Stylesheets nicht mehr möglich ist, diese direkt über TYPO3 zu editieren. Laden Sie also wenn möglich nur Dateien in den Bereich Resources, die nicht mehr geändert werden müssen, oder sorgen Sie dafür, dass Sie mit einem externen Editor auf den entsprechenden Upload-Ordner zugreifen können.

8.10 Mit Wraps Inhalte für die Ausgabe verpacken Problem Lizensiert für Markus Mueller

Sie wollen Inhalte aus der Datenbank auf Ihrer Website ausgeben. Da Ihre Redakteure keinerlei HTML-Kenntnisse besitzen, sollen diese sich auf die rein inhaltliche Eingabe beschränken, während die entsprechende Formatierung und Strukturierung der einzelnen Elemente automatisiert vom System übernommen werden soll. Dabei sollen Überschriften mit entsprechenden Tags von h1 bis h5 versehen werden und Fließtexte in p-Tags erscheinen. Außerdem wollen Sie für bestimmte Felder zusätzliche Bezeichnungen festlegen, auf die die Redakteure keinen Einfluss haben sollen. Diese Bezeichnungen sollen teilweise vor dem eigentlichen Wert des Felds ausgegeben werden, teilweise aber auch danach.

Lösung Verpacken Sie die Inhalte für die Ausgabe in sogenannte Wraps. Ein Wrap besteht dabei in der Regel aus einem Platzhalter für den eigentlichen Inhalt sowie der Verpackung. Der übliche Platzhalter innerhalb eines solchen Wraps ist der senkrechte Strich |, auch PipeSymbol genannt. Die grundlegende Schreibweise für einen Wrap sieht daher so aus: Vordere Verpackung|Hintere Verpackung

Dabei können beide Teile der Verpackung beliebige Werte erhalten oder bei Bedarf auch leer bleiben. Es ergeben sich also folgende Kombinationen:

Max. Linie

Vordere Verpackung|Hintere Verpackung Vordere Verpackung| |Hintere Verpackung |

284 | Kapitel 8: TypoScript verstehen und verwalten This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts Vorsicht! – Der sogenannte Whitespace, also etwaige Leerzeichen vor oder nach dem eigentlichen Wrap, werden per trim entfernt. Sie müssen also im Notfall mit HTML-Entsprechungen wie arbeiten. Es gibt jedoch eine Ausnahme, den sogenannten noTrimWrap, für den eine andere Syntax zum Einsatz kommt. |

Vordere Verpackung|Hintere Verpackung |

Diese Schreibweise z.B. erzeugt in Verbindung mit einem noTrimWrap jeweils zwei zusätzliche Leerzeichen vor und nach der Verpackung. Die beiden äußeren Pipe-Symbole dienen dabei als Begrenzer, das innere als Platzhalter für den zu verpackenden Inhalt.

Diskussion Wraps gehören zu den grundlegenden Funktionen bei der Erstellung von TypoScriptTemplates für die Inhaltsausgabe. Mit ihrer Hilfe können Sie nicht nur dafür sorgen, dass die jeweiligen Inhalte semantisch korrekte HTML-Auszeichnungen erhalten, Sie können auch weitere statische oder dynamische Inhalte in die Verpackung einbauen. Ein einfacher Code zur Ausgabe einer korrekt formatierten Überschrift sähe zum Beispiel so aus: Lizensiert für Markus Mueller

temp.header = TEXT temp.header { field = header wrap =

|

}

Bei der Ausgabe würde der Wert des Felds header in h1-Tags verpackt und ausgegeben. Das gleiche Prinzip, hier für einen Fließtext: temp.bodytext = TEXT temp.bodytext { field = bodytext wrap =

}

und hier für eine Tabellenzeile: temp.tablerow = TEXT temp.tablerow { field = bodytext wrap = | }

Max. Linie

Sie können also auch mehrere Tags verwenden, was die Vermutung nahe legt, dass selbst umfangreicherer HTML-Code als Wrap verwendet werden kann. Auch dies ist selbstverständlich möglich. Verwenden Sie hierzu eine andere Schreibweise, die es ermöglicht, Wraps auch mehrzeilig anzulegen, wobei die Zeilenschaltungen in der Ausgabe beibehalten werden. Dies ist recht hilfreich für die Strukturierung des HTML-Codes, der ansonsten komplett in eine Zeile geschrieben würde.

8.10 Mit Wraps Inhalte für die Ausgabe verpacken | 285 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Links Bei dieser Form der Notation wird das Gleichheitszeichen weggelassen und der mehrzeilige Code für den Wrap in eine runde Klammer geschrieben. temp.logoHead = TEXT temp.logoHead { field = header wrap (

|

###PAGETITLE###

Inhalt xcbs e e rweeeeeeeeee rew

In der Beispieldatei können Sie die folgenden besonderen Markierungen erkennen:

Max. Linie

###DOKUMENT### Diese Markierung wird als Hauptunterteilung verwendet. Wir wollen lediglich diesen Teil der HTML-Vorlage verwenden und die restlichen Teile unberücksichtigt lassen, weil TYPO3 den -Bereich bereits automatisch für uns erzeugt und wir diesen später nicht doppelt in der Ausgabe haben wollen.

590 | Kapitel 13: Statische und dynamische Inhalte ausgeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

###PAGETITLE### Hier werden Sie dynamisch den Seitentitel einbinden. ###NAVIGATION### Dieser Platzhalter steht für das Hauptmenü, das später an dieser Stelle dynamisch von TYPO3 eingebunden werden soll. ###CONTENT### Dies ist der Bereich, in dem der eigentliche dynamische Inhalt ausgegeben werden soll. Fügen Sie nun das folgende TypoScript-Setup in Ihr TypoScript-Template ein:

Lizensiert für Markus Mueller

Max. Linie

// Anlegen eines temporären Objekts für eine Navigation // wird später als Kopie in die Ausgabe eingebunden temp.navigation.main = HMENU temp.navigation.main { wrap = 1 = TMENU 1 { wrap =

| NO { wrapItemAndSub =

} } 2 < .1 3 < .1 } // hier die Definition des PAGE-Objekts mit Verwendung des TEMPLATE-Objekts // Einbindung einer HTML-Designvorlage page = PAGE page { 100 = TEMPLATE 100 { template = FILE template { file = fileadmin/vorlagen/index.html } workOnSubpart = DOKUMENT marks { PAGETITLE = TEXT PAGETITLE { field = title } } subparts { NAVIGATION < temp.navigation.main CONTENT < styles.content.get } } }

13.12 Eine HTML-Vorlage verwenden This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie | 591

Zunächst erzeugen Sie, wie bereits hinlänglich bekannt, ein PAGE-Objekt. Als Ausgabeobjekt innerhalb des PAGE-Objekts verwenden Sie in diesem Fall jedoch nicht direkt eines der bekannten cObjects TEXT oder CONTENT, sondern das TEMPLATE-Objekt.

Links

Zunächst müssen Sie das TEMPLATE-Objekt mit einer Vorlage füllen, theoretisch können Sie dazu beliebige cObjects benutzen, sinnvoll ist hier die Verwendung eines FILEObjekts, was eine Datei aus dem Dateisystem einliest. Der Inhalt der Datei wird somit an das TEMPLATE-Objekt übergeben. Damit das TEMPLATE-Objekt nur den Teil der Datei verwendet, der mit den Markierungen ###DOKUMENT### begrenzt ist, wird die Eigenschaft workOnSubpart=DOKUMENT gesetzt. Die beiden weiteren Eigenschaften des TEMPLATE-Objekts marks und subparts werden anschließend dazu benutzt, die jeweiligen Markierungen zu füllen. Die zu verwendenden Markierungen werden im TypoScript jeweils als Eigenschaften unterhalb von marks bzw. subparts eingesetzt. Bitte beachten Sie dabei, dass Groß- und Kleinschreibweise unterschieden werden und die Markierungen im TypoScript ohne die umgebenden ###-Zeichen zu verwenden sind. Außerdem können Sie eine Bezeichnung nicht gleichzeitig für marks und subparts verwenden.

Lizensiert für Markus Mueller

Mit marks sprechen Sie einzelne Markierungen an, in diesem Fall wird jedes Vorkommen der Zeichenkette ###MARKIERUNG### mit dem angegebenen TypoScript-Objekt ersetzt. Mit subparts ersetzen Sie Teilbereiche einer Vorlage. Dazu muss der Bezeichner genau zweimal in der Vorlage enthalten sein. In diesem Fall werden die gesamten Inhalte vom ersten Vorkommen von ###SUBPARTMARKIERUNG### bis zum zweiten Vorkommen komplett ersetzt. Die Subpart-Markierungen können, wie im Beispiel, in Kommentare eingebettet werden, um das Layout der statischen Vorlage nicht zu beeinflussen. Anders als bei den marks werden die Kommentarzeichen bei den subparts in der Ausgabe entfernt.

Sowohl marks als auch subparts sind vom Datentyp cObject, d.h., ihnen kann jedes beliebige in TypoScript verfügbare cObject zugewiesen werden. Dabei können Sie natürlich auch wie im Beispiel Kopien von TypoScript-Objekten verwenden. Ihrer Schöpfungskraft sind dabei fast keine Grenzen gesetzt, Sie können sich von den vielen Rezepten in diesem und den anderen Kapiteln anregen lassen.

Diskussion Ein großer Vorteil bei diesem Verfahren ist, dass Sie Ihr Layout zunächst völlig unabhängig von TYPO3 mit (X-)HTML und CSS entwickeln und testen können. In der Praxis treten dabei schnell Probleme mit den Pfaden zu eingebundenen Ressourcen auf. In der obigen XHTML-Vorlage wird beispielsweise mit folgendem Code eine Bilddatei eingebunden:

Max. Linie

592 | Kapitel 13: Statische und dynamische Inhalte ausgeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Hier wird also eine Bilddatei über eine relative Pfadangabe eingebunden. Wenn Sie die Vorlage in TYPO3 einbinden und im Frontend ausgeben, wird diese relative Pfadangabe nicht mehr zur gewünschten Datei führen. Das TEMPLATE-Objekt sieht natürlich auch für diese Problemstellung eine Lösung vor. Mit der Eigenschaft relPathPrefix können Sie solche Pfadangaben automatisch mit einem Präfix versehen lassen. Modifizieren Sie das obige TypoScript wie folgt: // Code aus obigem Beispiel // zusätzliche Angabe: page { 100 { relPathPrefix = fileadmin/vorlagen/ // optional abweichend für bestimmte Tags: // relPathPrefix.TAG = fileadmin/ressourcen/ } }

Als Ergebnis wird der Pfad zu dem eingebundenen Bild in der Ausgabe wie folgt umgeschrieben:

Lizensiert für Markus Mueller

Nun ist das Bild sowohl in der Vorlage als auch in der endgültigen Ausgabe von TYPO3 korrekt eingebunden. In Sonderfällen können Sie noch für bestimmte Tags ein abweichendes Präfix vergeben. Dies würde für Bilder über folgende Konfiguration möglich sein: relPathPrefix.IMG = ressourcen/. Leider ist das nur möglich, wenn auch relPathPrefix gesetzt ist. Achten Sie auf entsprechend korrekte Bezeichnungen der Markierungen, gerade bei der Anzahl der # vertut man sich leicht. Bei subparts müssen immer zwei exakt gleich bezeichnete Markierungen vorhanden sein. Beachten Sie, dass es bei subparts auch erforderlich ist, dass Sie irgendeine Zeichenkette zwischen den Markierungen einbinden, die Ersetzung bei direktem Aufeinanderfolgen der Anfangs- und Endmarkierung funktioniert nicht.

Das TEMPLATE-Objekt muss nicht unbedingt auf eine Datei zugreifen. Da für dessen Eigenschaft template jedes beliebige cObject zu verwenden ist, zeigt folgender Code, wie Sie die Vorlage über das TEXT-Objekt direkt im TypoScript angeben können:

Max. Linie

page = PAGE page { 100 = TEMPLATE 100 { template = TEXT template { // mehrzeilige Wertzuweisung für TEXT.value mit '()' value (

###PAGETITLE###

) }

13.12 Eine HTML-Vorlage verwenden This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie | 593

marks { PAGETITLE = TEXT PAGETITLE { field = title } }

Links

} }

Da es sich auch beim TEMPLATE-Objekt selbst um ein cObject handelt, können Sie es selbstverständlich nicht nur im PAGE-Objekt, sondern an allen Stellen, an denen cObjects verwendet werden können, einbinden. Es ist also beispielsweise möglich, über eine entsprechende Markierung und ein dazu passendes workOnSubpart auch einen Teil des header zu extrahieren und es in page.headerData.55 zu verwenden.

Lizensiert für Markus Mueller

page = PAGE page { headerdata.55 = TEMPLATE headerdata.55 { template = FILE template { file = fileadmin/vorlagen/index.html } workOnSubpart = HEADER } }

Auch viele Plugins in TYPO3 verwenden zur Ausgabe XHTML-Vorlagen. Hierbei kommen allerdings zumeist spezielle Extension-spezifische Implementierungen zum Einsatz. So ist es beispielsweise bei der Extension tt_news nur erforderlich, im TypoScript über plugin.tt_news.templateFile = fileadmin/vorlagen/myttnews.html eine Vorlage zuzuweisen, hier sind die Optionen des TEMPLATE-Objekts nicht analog verwendbar. Sollten Sie eine andere Zeichenkette als ### zur Auszeichnung der Platzhalter wünschen, können Sie die Eigenschaft markerWrap des TEMPLATE-Objektes verwenden. # Das TEMPLATE-Objekt liegt in page.100 page.100 { markerWrap = $$$|$$$ }

Sie müssen die Zeichenkette, mit der die Platzhalter beginnen sollen, und die Zeichenkette, mit der die Platzhalter enden, durch das Zeichen | getrennt angeben. Achten Sie dabei darauf, dass Sie Zeichenketten verwenden, die nicht als reguläre Inhalte auftreten.

Max. Linie

Max. Linie 594 | Kapitel 13: Statische und dynamische Inhalte ausgeben This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Rechts

Siehe auch Mit der Extension Page Template Selector (Key: 'rlmp_tmplselector') haben Sie die Möglichkeit, dem Redakteur auf Seitenebene eine Auswahl an HTML-Vorlagen in einem Auswahlfeld zur Verfügung zu stellen. Die jeweils gewählte Datei wird dann von der Extension an das TEMPLATE-Objekt übergeben. Mit der Extension Template Auto-parser (Key: 'automaketemplate') können Sie die HTML-Vorlagen vorab verarbeiten lassen, um bestimmte Tags automatisch mit entsprechenden ###MARKERN### zu versehen. Nach unseren Erfahrungen ist es aber allein schon zum Zweck der Dokumentation und Transparenz sinnvoll, die dynamischen Teile einer Vorlage manuell mit Markern/Subparts auszuzeichnen. In Rezept 9.3 finden Sie ein Beispiel dafür, wie eine solche Vorlage zur Erzeugung eines dynamischen CSS-Stylesheets genutzt werden kann.

Lizensiert für Markus Mueller

Max. Linie

Max. Linie 13.12 Eine HTML-Vorlage verwenden This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 595

Vakat Lizensiert für Markus Mueller

First

Kapitel 14

KAPITEL 14

TypoScript ausreizen

14.0 Einführung

Lizensiert für Markus Mueller

In den ersten Kapiteln zum Thema TypoScript haben wir Ihnen wie versprochen die eigentliche Funktionsweise erläutert, bevor wir in den weiterführenden Kapiteln an konkreten Anwendungsbeispielen demonstriert haben, wie umfangreich und mächtig TypoScript in der Anwendung sein kann. In diesem Kapitel wollen wir Ihnen nun abschließend zeigen, dass Sie weitaus mehr mit reinem TypoScript erreichen können, als es auf den ersten Blick den Anschein haben mag. Obwohl TypoScript in erster Linie eine Konfigurationssprache ist und keine wirkliche Programmiersprache, lassen sich damit erstaunliche Ergebnisse erzielen, wenn Sie als Anwender in der Lage sind, ab und zu ein wenig um die Ecke zu denken. Eine elegante Kombination aus den einzelnen Elementen, teilweise entgegen ihrer ursprünglichen Bestimmung genutzt, ist dabei oftmals der sinnvollere Ansatz als eine statische Lösung mit eigenem PHP-Code. Denn eine TypoScript-basierte Lösung bietet immer ein Maximum an Flexibilität. Sie benötigen ein alphabetisches Inhaltsverzeichnis oder eine mehrseitige Navigation mit einem Seitenbrowser? Sie wollten schon immer ein Menü konstruieren, das dem Seitenbaum im TYPO3-Backend nachempfunden ist? Sie wollen die TYPO3-internen Bildbearbeitungsfunktionen einmal wirklich ausnutzen? Sie wollen ein Newssystem ohne spezielle Extension ausschließlich auf Basis von Seiten und Inhaltselementen realisieren? Das alles lässt sich äußerst komfortabel mithilfe von TypoScript lösen. In den folgenden Rezepten zeigen wir Ihnen, wie.

Max. Linie

Alle Rezepte dieses Kapitels bewegen sich sicherlich in einem Grenzbereich, in dem es sorgfältig abzuwägen gilt, was letztlich sinnvoller ist: die hier gezeigte TypoScript-basierte Lösung oder aber ein eigens dafür erstelltes PHP-Skript mit der gleichen Funktionalität. TypoScript ist dabei auf jeden Fall die flexiblere Lösung, während die PHP-Lösung bei gutem Programmierstil um einiges performanter sein dürfte.

| 597 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Es ging uns in diesem Kapitel jedoch nicht darum, die beste oder schnellste Lösung zu präsentieren, sondern vor allem darum, zu demonstrieren, dass TypoScript zu deutlich mehr in der Lage ist, als nur diverse Parameter an ein paar PHP-Funktionen zu übergeben.

Links

Ein letzter Hinweis, bevor Sie sich mit diesem Kapitel beschäftigen: Die hier gezeigten Rezepte sind absolut ungeeignet für TypoScript-Neulinge! – Wenn Sie noch keine weitergehenden Erfahrungen mit TypoScript gesammelt haben, sollten Sie zunächst mit Kapitel 8 beginnen und sich dann langsam hierhin vorarbeiten.

14.1 TypoScript-Elemente intelligent als Hilfsmittel nutzen Problem

Lizensiert für Markus Mueller

Sie kennen sich mit den Grundprinzipien von TypoScript aus und haben bereits einige Erfahrung, was den Einsatz der verschiedenen TypoScript-Elemente betrifft. Dabei sind Sie hin und wieder an Grenzen gestoßen, an denen Sie mit den in der TSref und auch in den vorhergehenden Rezepten dieses Buchs beschriebenen Möglichkeiten nicht mehr weitergekommen sind. Nun benötigen Sie verschiedene Ansätze, wie Sie mit TypoScript-Bordmitteln dennoch über diese Grenzen hinausgehen können, ohne dabei auf andere Hilfsmittel zurückgreifen zu müssen.

Lösung Verwenden Sie TypoScript-Elemente unabhängig von ihrem ursprünglichen Einsatzbereich und lösen Sie sich dabei von der eigentlichen Bedeutung des Elementnamens. Kombinieren Sie verschiedene TypoScript-Elemente mithilfe von stdWrap-Funktionen. Setzen Sie dabei einfach auf Ihre Kreativität und denken Sie ruhig des Öfteren ein wenig um die Ecke. Wir haben dieses Rezept bewusst an den Anfang dieses Kapitels gestellt, weil es Ihnen die Grundlagen dazu liefern soll, die vielfältigen Möglichkeiten, die Ihnen TypoScript bietet, später wirklich ausreizen zu können. Die eigentliche Kernfunktionalität von TypoScript befindet sich vor allem im stdWrapBaukasten. Immer dann, wenn ein stdWrap-Parameter eines Elements seinerseits über eigene stdWrap-Eigenschaften verfügt, können Sie durch den Einsatz von cObject ein weiteres TypoScript-Element nutzen, um den Inhalt dieses Parameters zu bestimmen.

Max. Linie

Mithilfe von TEXT und der stdWrap-Funktion split, die wiederum ein einzelnes IMAGEElement ansteuert, können Sie z.B. einen Bildblock rendern: lib.meinBildblock = COA lib.meinBildblock {

598 | Kapitel 14: TypoScript ausreizen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Lizensiert für Markus Mueller

10 = TEXT 10 { field = image split { token = , cObjNum = 1|*|2|*|3 1 = IMAGE 1 { file { import = uploads/pics/ import { current = 1 } width = 200m height = 100m } wrap =

} 2 < .1 2.wrap =

3 < .1 3.wrap =

} } wrap =

}

Genauso gut können Sie TEXT aber auch verwenden, um einen dynamischen Wrap zu erzeugen, der auf bestimmte Parameter reagieren kann: lib.meinEingepackterInhalt = COA lib.meinEingepackterInhalt { 10 = TEXT 10.value = Ein wenig Text 20 = TEXT 20.value = Und noch etwas mehr Text stdWrap.outerWrap.cObject = TEXT stdWrap.outerWrap.cObject { value = | dataWrap =

} }

Oder Sie nutzen ein HMENU als Lieferant für eine Liste von Seiten-IDs:

Max. Linie

lib.meinInhalt = CONTENT lib.meinInhalt { table = tt_content select { pidInList.cObject = HMENU pidInList.cObject { entryLevel = -1 1 = TMENU 1 {

14.1 TypoScript-Elemente intelligent als Hilfsmittel nutzen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie | 599

NO { doNotLinkIt = 1 stdWrap.field = uid allWrap = ||*|,||*| }

Links

} } } }

Das Element CONTENT eignet sich umgekehrt wiederum hervorragend, um ein Menü zu erstellen:

Lizensiert für Markus Mueller

lib.meinMenue = COA lib.meinMenue { 10 = TEXT 10.value = Die neuesten 5 Unterseiten 10.wrap =

|

20 = COA 20 { wrap =

| 10 = CONTENT 10 { table = pages select { orderBy = tstamp max = 5 } renderObj = TEXT renderObj { field = title typolink.parameter.field = uid wrap =

} } } }

Und der Einsatz eines COA-Elements empfiehlt sich z.B. für die dynamische Zuordnung von Parametern für einen typolink:

Max. Linie

lib.meinDynamischerLink = COA lib.meinDynamischerLink { 10 = TEXT 10 { field = header typolink.parameter.cObject = COA typolink.parameter.cObject { 10 = TEXT 10.dataWrap = {field:pid}#{field:uid} 20 = TEXT 20 { field = layout noTrimWrap = | - layout|| }

600 | Kapitel 14: TypoScript ausreizen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

30 = TEXT 30 { field = subheader noTrimWrap = | || } } } }

Natürlich können Sie auch mit einer intelligenten Reihenfolge verschiedener stdWrapFunktionen erstaunliche Ergebnisse erzielen. temp.meinDynamischerInhalt = TEXT temp.meinDynamischerInhalt { dataWrap = DB : tt_content : {GPvar:meineUid} : bodytext wrap3 = {|} insertData = 1 }

Diskussion

Lizensiert für Markus Mueller

TypoScript ist auf der einen Seite ein unglaublich mächtiges Werkzeug, um ein so komplexes System wie TYPO3 so komfortabel wie möglich zu konfigurieren und die dahinterliegenden PHP-Funktionen zu steuern. Auf der anderen Seite führt es oftmals zu Verwirrungen, weil viele Programmierer den Fehler begehen, es als eine wirkliche Programmiersprache zu betrachten, und daher meinen, die Grenzen des Machbaren seien bei der Nutzung von TypoScript recht eng gesteckt. Bei näherer Betrachtung stellt sich jedoch vielfach heraus, dass TypoScript weitaus flexibler ist, als es zunächst den Anschein hat, und dass man damit viele Dinge lösen kann, deren Bewältigung auf den ersten Blick nicht möglich erschien. Zugegeben, Sie müssen manchmal ein wenig um die Ecke denken, um zum Erfolg zu kommen, aber wenn Sie das erst einmal getan haben, werden Sie feststellen, dass es nur wenige Dinge gibt, die sich nicht mithilfe von TypoScript lösen lassen. Sie sollten dabei allerdings immer auch die Performance des Systems im Hinterkopf behalten, das Sie gerade mit TypoScript konfigurieren wollen. Auch wenn wir in diesem Buch in einigen Beispielen einen recht exzessiven Einsatz von TypoScript demonstrieren, bedeutet dies nicht, dass TypoScript immer das Mittel der Wahl sein sollte. Oftmals kommt eine entsprechende PHP-Funktion, die Sie über eine Extension einbinden, schneller zum Ziel, was sich speziell bei sehr dynamischen Seiten mit kurzfristig wechselnden Inhalten bemerkbar macht, weil deren Inhalte nicht aus dem Cache geholt werden können. Jedoch tragen die gezeigten Beispiele sicherlich dazu bei, das allgemeine Verständnis für TypoScript zu verbessern.

Bildblock rendern

Max. Linie

Im ersten Codebeispiel zeigen wir Ihnen, wie Sie mithilfe eines TEXT-Elements einen Bildblock erzeugen können. Das eigentliche IMAGE-Element kommt hier erst sehr spät zum Einsatz, denn der Inhalt des image-Felds der Tabelle tt_content besteht zunächst einmal

14.1 TypoScript-Elemente intelligent als Hilfsmittel nutzen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 601

Max. Linie

aus Dateinamen, was im Prinzip nichts anderes ist als eine Aneinanderreihung simpler Textabschnitte.

Links

Dieser Text wird nun ausgelesen und mithilfe der stdWrap-Funktion split anhand des Kommas als Trennzeichen in einzelne Abschnitte zerlegt, von denen jeder danach genau einen Dateinamen enthält. lib.meinBildblock = COA ib.meinBildblock { 10 = TEXT 10 { field = image split { token = , } } wrap =

}

Lizensiert für Markus Mueller

Max. Linie

Da die Funktion split über optionSplit-Eigenschaften verfügt, können Sie hier anhand der Position eines Bilds innerhalb des Blocks bestimmen, wie dieses Bild gerendert werden soll. In diesem Fall unterscheiden wir nur zwischen erster, mittlerer und letzter Position, wobei die mittlere Position für alle Bilder außer dem ersten und dem letzten Gültigkeit hat. Lesen Sie hierzu bei Bedarf die einführenden Rezepte zu den stdWrap-Funktionen split und optionSplit. Für jeden Bildtyp gibt es nun ein eigenes kleines Setup, in dem zum ersten Mal das eigentliche IMAGE-Element zum Einsatz kommt. Der Dateiname wird dabei mithilfe von current = 1 eingefügt, denn im Rahmen von split wird current immer mit dem Inhalt des Abschnitts gefüllt, der gerade gerendert werden soll. cObjNum = 1|*|2|*|3 1 = IMAGE 1 { file { import = uploads/pics/ import { current = 1 } width = 200m height = 100m } wrap =

} 2 < .1 2.wrap =

3 < .1 3.wrap =

Wir haben die einzelnen Elemente lediglich kopiert und ihnen danach verschiedene Wraps zugewiesen. Sie können selbstverständlich noch weiter gehen und sämtliche Parameter der einzelnen Bildtypen unterschiedlich gestalten.

602 | Kapitel 14: TypoScript ausreizen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts Dynamischer Wrap Im zweiten Beispiel sehen Sie, wie Sie mithilfe eines TEXT-Elements den Inhalt des Wraps eines anderen Elements dynamisch befüllen können. Nicht alle Wraps verfügen über stdWrap-Eigenschaften, daher müssen Sie für diesen Trick einen der passenden Wraps wie z.B. den hier gezeigten outerWrap verwenden. Da Sie im Rahmen von stdWrap auf sämtliche darin verfügbaren Funktionen zurückgreifen können, steht Ihnen selbstverständlich auch die Funktion cObject zur Verfügung. Das bedeutet für dieses Beispiel, dass Sie den outerWrap aus einem beliebigen TypoScriptElement erzeugen können. Hier haben wir ein TEXT-Element genommen, Sie können aber auch ein COA- oder gar ein USER-Element verwenden, um den Inhalt des Wraps zu bestimmen. Da ein Wrap immer einen entsprechenden Platzhalter verwendet, der unter Standardbedingungen dem Pipe-Symbol | entspricht, müssen Sie darauf achten, dass dieser Platzhalter nicht verloren geht. Aus diesem Grund ist der eigentliche value des TEXT-Elements mit eben diesem Platzhalter belegt. Danach wird um den Platzhalter herum per dataWrap ein dynamischer Inhalt gelegt. Das Ergebnis des TEXT-Elements wäre:

Lizensiert für Markus Mueller

Wie Sie sehen können, ist der Platzhalter noch vorhanden, sodass der outerWrap sich ebenfalls wie gewünscht um den Inhalt des ursprünglichen Elements legen kann.

pidInList per HMENU erzeugen Das dritte Beispiel demonstriert den Einsatz eines HMENU-Elements, um für das selectStatement eines CONTENT-Elements die dafür erforderliche Liste von Elternseiten zu erzeugen. Dies ist deswegen recht hilfreich, weil die Angabe von pidInList nicht komplett eliminiert werden kann. Geben Sie keinen Wert an, wird als Default-Wert this verwendet. Sie können also immer nur auf die aktuelle oder eine explizit angegebene Seite zugreifen. Wir haben in diesem Beispiel das entryLevel des HMENU-Elements auf -1 gesetzt. Es erzeugt also ein Menü der direkten Unterseiten der aktuellen Seite. Sie können natürlich andere entryLevel verwenden und selbstverständlich auch weitere Ebenen einsetzen, um die Anzahl der verfügbaren uid-Werte zu vergrößern. lib.meinInhalt = CONTENT lib.meinInhalt { table = tt_content select { pidInList.cObject = HMENU pidInList.cObject { entryLevel = -1 } } }

Max. Linie

Max. Linie 14.1 TypoScript-Elemente intelligent als Hilfsmittel nutzen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 603

Mithilfe von doNotLinkIt wird nun innerhalb des TMENU-Items NO dafür gesorgt, dass der sonst in Menüs übliche Link nicht ausgegeben wird. Stattdessen greifen Sie unter Verwendung von stdWrap auf das Feld uid zurück und verpacken dessen Wert in einem allWrap.

Links

1 = TMENU 1 { NO { doNotLinkIt = 1 stdWrap.field = uid allWrap = ||*|,||*| } }

Da alle Parameter innerhalb eines Menuitems über optionSplit verfügen, lässt es sich hier recht einfach bewerkstelligen, dass der erste Eintrag keinen Wrap erhält. Das Ergebnis ist daher eine saubere, kommaseparierte Liste der uid-Werte aller Unterseiten. Das CONTENT-Element wird demzufolge deren Inhalte darstellen.

Menü per CONTENT erzeugen

Lizensiert für Markus Mueller

Max. Linie

Wie Sie im folgenden Beispiel sehen können, eignet sich umgekehrt auch ein CONTENT-Element durchaus, um damit ein Menü zu erzeugen. Wir haben es zunächst in einem COA-Setzkasten untergebracht, um die Zuweisung einer zusätzlichen Überschrift zu vereinfachen. Da der Parameter pidInList auch dann mit seinem Default-Wert this genutzt wird, wenn Sie ihn nicht explizit angeben, zeigt dieses Beispiel ein Menü der Unterseiten der aktuellen Seite. Durch die Verwendung von tstamp DESC für orderBy erfolgt eine Sortierung nach dem neuesten Datum, und mithilfe von max wird die Ausgabe auf fünf Seiten begrenzt. lib.meinMenue = COA lib.meinMenue { 10 = TEXT 10.value = Die neuesten 5 Unterseiten 10.wrap =

|

20 = COA 20 { wrap =

| 10 = CONTENT 10 { table = pages select { orderBy = tstamp DESC max = 5 } } } }

Haben Sie im vorigen Beispiel noch deren Inhalte ausgegeben, so erzeugt der nun folgende Code ein echtes Menü mit Links zu den jeweiligen Seiten. Diese Links werden mithilfe von

604 | Kapitel 14: TypoScript ausreizen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

typolink erzeugt, dessen Eigenschaft parameter per stdWrap-Funktion field den Wert der jeweiligen uid einer Seite zugewiesen bekommt. So entsteht jeweils ein Link zur Seite, der als Text den Titel der Seite erhält. renderObj = TEXT renderObj { field = title typolink.parameter.field = uid wrap =

}

Mithilfe der entsprechenden Wraps haben wir auch in diesem Beispiel für eine valide und semantisch korrekte Ausgabe als ungeordnete Liste gesorgt.

Typolink-Parameter per COA erzeugen Das nächste Beispiel geht noch etwas detaillierter auf die Funktion typolink ein. Deren Eigenschaft parameter besteht nämlich aus bis zu vier verschiedenen Teilen, die sich selbstverständlich auch dynamisch erzeugen lassen, denn typolink.parameter verfügt seinerseits über stdWrap-Eigenschaften. Lesen Sie dazu bei Bedarf die entsprechenden Rezepte zum Thema typolink. Wie hier gezeigt, kann man die einzelnen Abschnitte also hervorragend mithilfe eines COA-Elements bestücken. Lizensiert für Markus Mueller

lib.meinDynamischerLink = COA lib.meinDynamischerLink { 10 = TEXT 10 { field = header typolink.parameter.cObject = COA typolink.parameter.cObject { } } }

Im ersten Abschnitt erzeugen Sie nun zunächst den Link auf die Elternseite und dort direkt zum passenden Inhaltselement. Dazu benötigen Sie die uid der Elternseite des Elements, also dessen pid, und zusätzlich seine eigene uid. Diese werden durch ein Doppelkreuz getrennt und sorgen so dafür, dass der Link bereits zum richtigen Sprungziel führt: 10 = TEXT 10.dataWrap = {field:pid}#{field:uid}

Es gibt jedoch noch weitere Bereiche von parameter zu besetzen. Jeder dieser Bereiche wird, wie bereits im typolink-Beispiel des stdWrap-Kapitels beschrieben, anhand eines Leerzeichens erkannt. Sie wollen auf die Angabe eines Targets verzichten, aber eine CSSKlasse sowie einen Titel zuweisen. Den Verzicht auf eine Eigenschaft markieren Sie mit einem Minuszeichen, daher sieht der nächste Abschnitt folgendermaßen aus:

Max. Linie

20 = TEXT 20 { field = layout noTrimWrap = | - layout|| }

14.1 TypoScript-Elemente intelligent als Hilfsmittel nutzen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie | 605

Sie benötigen die Funktion noTrimWrap, damit die Leerzeichen zwischen den einzelnen Angaben erhalten bleiben und nicht per PHP-Funktion trim() abgeschnitten werden. Hier wird also das Target übersprungen, und auf Basis des Werts aus dem Feld layout wird eine passende CSS-Klasse layoutX zugewiesen. Abschließend wird noch ein titleAttribut erzeugt, das seinen Inhalt aus dem Feld subheader bezieht.

Links

30 = TEXT 30 { field = subheader noTrimWrap = | || }

Selbstverständlich hätten Sie diese Reihe auch direkt mit einem einzigen dataWrap erzeugen können: lib.meinDynamischerLink = TEXT lib.meinDynamischerLink { value = Linktext typolink.parameter.dataWrap = {field:pid}#{field:uid} - {field:layout} {field:title} }

Jedoch können Sie bei der ursprünglichen Lösung jeden einzelnen Teil wiederum in Abhängigkeit von anderen Parametern variabel gestalten, indem Sie z.B. if-Abfragen einbauen oder die stdWrap-Funktion override nutzen. Lizensiert für Markus Mueller

Max. Linie

lib.meinDynamischerLink = COA lib.meinDynamischerLink { 10 = TEXT 10 { value = Linktext typolink.parameter.cObject = COA typolink.parameter.cObject { 10 = TEXT 10.dataWrap = {field:pid}#{field:uid} 20 = TEXT 20 { field = layout override.data = GPvar:layout noTrimWrap = | - layout|| } 30 = TEXT 30 { field = title if.isTrue.data = GPvar:showtitle noTrimWrap = | || } } } }

Das Ergebnis wäre eine dynamisierte Ausgabe des Links, die auf zwei GET-/POST-Variablen reagieren kann, nämlich layout und showtitle. Sobald die Variable layout nicht leer ist, überschreibt sie den Wert des Felds layout bei der Erzeugung der CSS-Klasse, und der Titel des Links wird nur dann erzeugt, wenn showtitle ebenfalls nicht leer ist. 606 | Kapitel 14: TypoScript ausreizen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts Rekursiv dynamisieren Unser letztes Beispiel ist deswegen besonders elegant, weil es zeigt, wie Sie ein TypoScript-Konstrukt, das ursprünglich keinerlei dynamische Eingaben zulässt, durch die geschickte Anordnung verschiedener Parameter dennoch dynamisch gestalten können. Bei der eigentlich nur statisch zu belegenden Zeile handelt es sich um folgende spezielle Syntax der stdWrap-Funktion data: data = DB : tt_content : 123 : bodytext

Damit können Sie den Inhalt des Felds bodytext aus dem Inhaltselement mit der uid 123 auslesen. Wenn Sie nun in der Lage wären, die Zahleneingabe dynamisch vorzunehmen, z.B. über einen GET-Parameter, wäre es möglich, schnell und komfortabel beliebige Inhaltselemente anzusteuern, und genau das zeigt dieses Beispiel. Bedingt durch die absolut festgelegte Reihenfolge der stdWrap-Funktionen, können Sie nämlich dafür sorgen, dass diese Zeile quasi doppelt ausgewertet wird. Dazu wird zunächst mithilfe von dataWrap ein dynamischer Wert an die Stelle von 123 geschrieben. temp.meinDynamischerInhalt = TEXT temp.meinDynamischerInhalt { dataWrap = DB : tt_content : {GPvar:meineUid} : bodytext } Lizensiert für Markus Mueller

Das Ergebnis wäre jetzt lediglich die Ausgabe folgender Textzeile im Frontend: DB : tt_content : 123 : bodytext

wobei 123 für einen beliebigen Zahlenwert steht, der über den GET-Parameter meineUid übergeben wurde. Durch die folgenden beiden TypoScript-Parameter wird dieser Text aber seinerseits wieder zu einem dynamischen Stück TypoScript-Code gemacht: wrap3 = {|} insertData = 1

Es entsteht nämlich zunächst aufgrund der Verwendung von wrap3 ein Text, der wiederum direkt so im Frontend ausgegeben würde: {DB : tt_content : 123 : bodytext}

Durch den Einsatz der Funktion insertData werden aber sämtliche Werte innerhalb der der geschweiften Klammern nochmals dynamisch ausgewertet, und aus dem eigentlich statischen Text wird so die korrekte Datenbankabfrage. Dies funktioniert selbstverständlich nur, weil die Reihenfolge der Funktionen innerhalb des stdWrap-Baukastens festgelegt ist: dataWrap kommt vor wrap3, und beide liegen vor insertData.

Max. Linie

Wie Sie sehen, ist selbst der redundante Einsatz verschiedener Wraps in TypoScript nicht nur willkürlich oder gar unnütz, sondern durchaus auch sinnvoll und hilfreich. Die Beispiele dieses Rezepts zeigen natürlich nur einen kleinen Teil der Möglichkeiten. Lassen Sie Ihrer Kreativität einfach ein wenig Freiraum, und Sie werden noch viele weitere Möglichkeiten finden, wie Sie die Flexibilität von TypoScript ausreizen können. Einige davon zeigen wir Ihnen in den folgenden Rezepten.

14.1 TypoScript-Elemente intelligent als Hilfsmittel nutzen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 607

Max. Linie

Siehe auch

Links

Wenn Sie die Funktionsweise der einzelnen hier verwendeten stdWrap-Funktionen genauer kennenlernen wollen, lesen Sie das Kapitel 10.

14.2 Die Ausgabe in Abhängigkeit von Bedingungen dynamisch anpassen Problem Sie wollen bei der Ausgabe Ihrer Seiten auf bestimmte Bedingungen reagieren können. Diese Bedingungen gehen aber über die reine Abfrage der Seiten-ID, des Browsers oder bestimmter Zeit- oder User-Angaben hinaus. Daher reicht Ihnen die Palette der verfügbaren Conditions nicht aus, und Sie benötigen einen weiter reichenden Ansatz, um die möglichen Zustände zu verarbeiten. Sie wollen aber dennoch ohne den Einsatz einer userFunc auskommen und das Ziel mit TypoScriptBordmitteln erreichen, weil Sie sich nicht die Mühe machen wollen, eigenen PHP-Code in Form einer Extension einzubinden. Lizensiert für Markus Mueller

Lösung Verwenden Sie das TypoScript-Element CASE und benutzen Sie weitere stdWrap-Funktionen, mit denen Sie den key für die Entscheidung zwischen den einzelnen Ergebnissen mit Inhalt versehen. Dies kann eine einfache Abfrage zum Beispiel des layout-Felds der Seite sein: lib.meinSchalter = COA_INT lib.meinSchalter { 10 = CASE 10 { key.data = page:layout default = TEXT default.value = Grundlayout 1 = TEXT 1.value = Speziallayout 1 2 = TEXT 2.value = Speziallayout 2 } }

Sie können aber auch komplexere Strukturen einbauen, indem Sie ein cObject als key benutzen:

Max. Linie

lib.meinSchalter = COA_INT lib.meinSchalter { 10 = CASE

608 | Kapitel 14: TypoScript ausreizen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

10 { key.cObject = COA key.cObject { 10 = TEXT 10.data = page:layout 20 = TEXT 20.data = date:w } default = TEXT default.value = Grundlayout 10 = TEXT 10.value = Speziallayout 1 am Wochenende 16 < .10 11 = TEXT 11.value = Speziallayout 1 in der Woche 12 < .11 13 < .11 14 < .11 15 < .11 } }

Diskussion Lizensiert für Markus Mueller

TYPO3 liefert Ihnen im Rahmen der schon im Kapitel 8 beschriebenen Conditions bereits eine recht breit gefächerte Palette von Reaktionen auf mögliche Bedingungen. Die Arbeit mit diesen Conditions wird aber oftmals deutlich verkompliziert – zum einen, weil Conditions nur außerhalb geschweifter Klammern verwendet werden dürfen, zum anderen, weil es nicht ganz einfach ist, mehrere Bedingungen miteinander zu kombinieren, wenn diese Bedingungen mehrere eindeutig definierte Zustände kennen und nicht nur wahr oder falsch. Mithilfe des TypoScript-Elements CASE können Sie dieses Problem elegant und komfortabel lösen, denn Sie können den Inhalt des eigentlichen Entscheidungsträgers, genannt key, mithilfe von stdWrap-Funktionen bestimmen. Als key können dabei auch Texte verwendet werden, was eine Kombination verschiedener Felder zum Befüllen ermöglicht. PHP-Entwickler werden die Struktur des CASE-Elements kennen, denn sie ist im Prinzip identisch mit einem switch(). Für jedes der Ergebnisse der möglichen Kombinationen können Sie im CASE-Element ein entsprechendes Element anlegen, das immer dann verwendet wird, wenn das Ergebnis dem Namen des Elements entspricht. Wird kein passender Elementname zum Ergebnis gefunden, kommt stattdessen das default-Element zum Einsatz.

Max. Linie

Im ersten Beispiel gibt es nur einen einzigen Parameter, nämlich das Feld layout, das im Backend als Select-Box dargestellt wird und verschiedene numerische Werte annehmen kann. Je nach gewähltem Layout reagiert das CASE-Element mit einer passenden Ausgabe, also entweder einem Grundlayout oder den Varianten Speziallayout1 oder Speziallayout2.

14.2 Die Ausgabe in Abhängigkeit von Bedingungen dynamisch anpassen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

| 609

Max. Linie

Das zweite Beispiel ist schon ein wenig komplizierter, denn auch der zweite Parameter kann verschiedene numerische Werte annehmen, nämlich die Wochentage von 0 bis 6. Es ergibt sich also eine Kombination aus Wochentag und layout-Feld, die bei n angenommenen Layoutvarianten als Ergebnis einen der folgenden Werte haben könnte:

Links

10,11,12,13,14,15,15,20,21,22,...,n6

Sie müssen nun für die relevanten Ergebnisse – und nur für diese – jeweils ein entsprechendes Element anlegen. Alle anderen Elemente können Sie danach kopieren, falls sie den gleichen Wert haben sollen wie ein bereits angelegtes Element, oder Sie ignorieren sie einfach, und sie werden mit der default-Einstellung gerendert. Das gezeigte Beispiel verwendet nur zwei Parameter – und dazu noch solche, die auch als Condition verwendbar gewesen wären. Jedoch zeigt sich bereits hier der Vorteil gegenüber Conditions: Sie können wesentlich präziser auf die einzelnen Zustände reagieren, ohne für jedes einzelne Ergebnis eine passende Kombination aus Conditions anlegen zu müssen. Der Code bleibt übersichtlicher und schlanker. Im Unterschied zu Conditions werden die möglichen Zustände von CASE zudem nicht bereits beim Parsen des TypoScript-Codes ausgewertet, sondern erst dann, wenn das Element selbst durch die Frontend-Engine gerendert wird. Lizensiert für Markus Mueller

Max. Linie

Speziell wenn Sie nun weitere Parameter hinzufügen, befinden Sie sich gegenüber dem Einsatz von Conditions bereits deutlich auf der Überholspur. Mit dieser Variante reagieren Sie zum Beispiel nur dann auf die beiden anderen Parameter, wenn zusätzlich noch feststeht, dass es sich um das erste Element auf der Seite handelt. lib.meinSchalter = COA_INT lib.meinSchalter { 10 = CASE 10 { key.cObject = COA key.cObject { 10 = TEXT 10.data = page:layout 20 = TEXT 20.data = date:w 30 = TEXT 30.data = cObj:parentRecordNumber } default = TEXT default.value = Grundlayout 101 = TEXT 101.value = Speziallayout 1 am Wochenende 161 < .101 111 = TEXT 111.value = Speziallayout 1 in der Woche 121 < .111 131 < .111

610 | Kapitel 14: TypoScript ausreizen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

141 < .111 151 < .111 } }

Und diese Variante behandelt alle Seiten, deren Titel mit dem Begriff »TYPO3« beginnt, nochmals gesondert, indem sie ihnen ein T zuweist, während alle anderen Seiten ein N erhalten.

Lizensiert für Markus Mueller

Max. Linie

lib.meinSchalter = COA_INT lib.meinSchalter { 10 = CASE 10 { key.cObject = COA key.cObject { 10 = TEXT 10.data = page:layout 20 = TEXT 20.data = date:w 30 = TEXT 30.data = cObj:parentRecordNumber 40 = TEXT 40.value = T 40.if.value.data = page:title 40.if.value.substring = 0,5 40.if.equals.value = TYPO3 50 < .40 50.value = N 50.if.negate = 1 } default = TEXT default.value = Grundlayout 101T = TEXT 101T.value = TYPO3 Layout 1 am Wochenende 161T < .101T 111T = TEXT 111T.value = TYPO3 Layout 1 in der Woche 121T < .111T 131T < .111T 141T < .111T 151T < .111T 101N = TEXT 101N.value = Normal Layout 1 am Wochenende 161N < .101N 111N = TEXT 111N.value = Normal Layout 1 in der Woche 121N < .111N 131N < .111N 141N < .111N 151N < .111N } }

14.2 Die Ausgabe in Abhängigkeit von Bedingungen dynamisch anpassen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie | 611

Um zu verdeutlichen, welche Wirkung die letzte Variante auf die Ausgabe des Inhalts hat, hier noch einmal in Worten die Entscheidungskriterien:

Links

1. Wenn das layout-Feld einen anderen Wert hat als 1, nimm auf jeden Fall den default-Wert. 2. Wenn der Wochentag 0 oder 6 lautet, nimm das Wochenende, ansonsten die Woche. 3. Wenn es sich um ein anderes Element als das erste auf der Seite handelt, nimm auf jeden Fall den default. 4. Wenn der Titel der Seite mit TYPO3 beginnt, nimm den passenden TYPO3-Text, ansonsten den normalen. Am letzten Beispiel kann man übrigens auch recht gut erkennen, dass es sich bei den Elementnamen nicht etwa um wirkliche Nummerierungen handelt, wie sie beispielsweise in einem COA-Setzkasten vorkommen, sondern um frei kombinierbare Strings. Sie können selbstverständlich beliebig viele weitere Parameter verwenden, mit denen Sie das Ergebnis des COA-Elements im key des CASE-Elements verändern. Denken Sie dabei lediglich immer daran, die namentlichen Entsprechungen für jedes relevante Ergebnis ebenfalls anzulegen. Lizensiert für Markus Mueller

Siehe auch Wenn Sie wissen wollen, wie Sie mithilfe von Conditions auf ähnliche Weise den Inhalt unter bestimmten Bedingungen verändern können, lesen Sie Rezept 8.8.

14.3 Ein alphabetisches Inhaltsverzeichnis anlegen Problem Sie haben eine umfangreiche Seite mit vielen interessanten Inhaltselementen. Anstelle der üblichen Sitemap auf Seitenebene wollen Sie ein komplettes, alphabetisch sortiertes Verzeichnis aller Inhaltselemente einer Sprache anlegen. Dabei soll der Link des aufgelisteten Titels direkt zum ausgewählten Element führen. Außerdem wollen Sie die Links gruppieren, wobei jede Gruppe den Anfangsbuchstaben als Markierung erhalten soll. Speziell wenn Sie TYPO3 dazu benutzen, Inhalte für Bücher, technische Publikationen, Diplomarbeiten oder ähnliche Dinge zu erzeugen, ist ein solches Inhaltsverzeichnis sehr nützlich, wenn nicht unumgänglich.

Lösung

Max. Linie

Verwenden Sie HMENU, LOAD_REGISTER und CONTENT. Erzeugen Sie mithilfe eines TMENU eine Liste von Seiten und nutzen Sie diese, um die dazugehörigen Inhalte mit einem CONTENT-Element aus der Datenbank auszulesen. 612 | Kapitel 14: TypoScript ausreizen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

Dieser Code kommt in Ihr TS-Setup: temp.getPages = HMENU temp.getPages { special = directory special.value = 1 1 = TMENU 1 { expAll = 1 NO { doNotShowLink = 1 stdWrap.cObject = LOAD_REGISTER stdWrap.cObject { allPages.dataWrap = {register:allPages},{field:uid} } } } 2 < .1 3 < .1 4 < .1 }

Lizensiert für Markus Mueller

Max. Linie

temp.getContentList = COA temp.getContentList { wrap =

| 10 < temp.getPages 20 = CONTENT 20 { table = tt_content select { pidInList.data = register:allPages orderBy = header languageField = sys_language_uid andWhere = sectionIndex=1 AND header!='' } renderObj = COA renderObj { 10 = TEXT 10 { outerWrap.cObject = COA outerWrap.cObject { 10 = TEXT 10 { value =

|

if.isFalse.data = register:firstLetter } 20 = TEXT 20 { value =

|

Lizensiert für Markus Mueller

}

Und dieser kommt ins TS-Setup Ihrer Seite: page.10 < temp.getContentList

Diskussion Eine der komfortabelsten Eigenschaften von TYPO3 ist die Fähigkeit, beliebige Varianten von Menüs, Sitemaps und sonstigen Navigationselementen zu erstellen. Wenn Sie content(default) oder CSS-styled-content verwenden, können Sie auf einen vordefinierten Satz solcher Elemente zugreifen, indem Sie einfach ein Inhaltselement vom Typ Menü/Sitemap auf der Seite einfügen. In der Regel arbeiten diese Navigationselemente auf Seitenebene. Das bedeutet, dass Sie entweder eine Seitenstruktur oder die Inhaltsstruktur einer oder mehrerer Seiten als Menü abbilden können. Genau genommen ist eine Sitemap jedoch nichts anderes als ein Inhaltsverzeichnis. Deswegen ist es durchaus sinnvoll, wenn dieses Inhaltsverzeichnis nicht nur alle verfügbaren Seitentitel auflistet, sondern gleich deren Inhalte. Eine alphabetische Sortierung sollte dabei selbstverständlich sein, und zur besseren Übersicht werden die Elemente nach Anfangsbuchstaben gruppiert. Die jeweilige Sprache wird bei mehrsprachigen Seiten ebenfalls berücksichtigt.

Max. Linie

Um ein solches alphabetisch sortiertes Inhaltsverzeichnis mit Bordmitteln und ohne eine spezielle Extension zu realisieren, benötigen Sie in erster Linie drei TypoScript-Elemente: die Elemente HMENU, LOAD_REGISTER und CONTENT sowie zusätzlich ein paar Funktionen aus dem stdWrap-Baukasten.

614 | Kapitel 14: TypoScript ausreizen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

LOAD_REGISTER ist im Prinzip nichts anderes als eine Zwischenablage, die per TypoScript mit beliebigen Inhalten gefüllt werden kann. Alle diese Inhalte verfügen über stdWrap-Eigenschaften, sodass Sie den Inhalt des Registers wie ein echtes cObject bearbeiten können. HMENU und das dazugehörige TMENU haben in diesem Fall nur reine Füllfunktion, um eine Liste von Seiten in das LOAD_REGISTER zu befördern. Per CONTENT wird das eigentliche Menü gerendert, wobei dort ein weiteres LOAD_REGISTER für die Anfangsbuchstaben zum Einsatz kommt. Doch nun zu den Details. Im ersten Teil erzeugen Sie ein HMENU, das den kompletten Seitenbaum unterhalb einer bestimmten Seite darstellen soll. Im Beispiel haben wir die Seite 1 verwendet, Sie können dort aber auch jede andere Seite eintragen oder gegebenenfalls das Feld pages abfragen, wenn Sie diesen Code für ein Inhaltselement Menü/Sitemap verwenden wollen. Wichtig ist vor allem der Parameter expAll=1, der dafür sorgt, dass alle Unterseiten ebenfalls durchlaufen werden.

Lizensiert für Markus Mueller

temp.getPages = HMENU temp.getPages { special = directory special.value = 1 1 = TMENU 1 { expAll = 1 NO { doNotShowLink = 1 stdWrap.cObject = LOAD_REGISTER stdWrap.cObject { allPages.field = uid allPages.dataWrap = {register:allPages},| } } } 2 < .1 3 < .1 4 < .1 }

Da Sie in diesem Fall ein blindes Menü erzeugen wollen, das lediglich Inhalte ins LOAD_ REGISTER füllt, benötigen Sie zunächst den Parameter doNotShowLink=1. Hiermit wird sichergestellt, dass keinerlei Link im Frontend zu sehen ist. Ab der Zeile 2 < .1 wird der bis dahin erzeugte Code für die weiteren Ebenen bereitgestellt. Wenn Sie mehr als vier Ebenen in Ihrer Seite verwenden, müssen Sie hier weitere Zeilen nach dem gleichen Muster einfügen.

Max. Linie

Der eigentliche Kern dieses Menüs ist jedoch die besondere Verarbeitung der Seiteninformationen. Weil jedes NO-Element (und alle anderen Zustände wie ACT, IFSUB, CUR usw.) über stdWrap-Eigenschaften verfügt, können Sie statt des üblichen title-Felds auch eigene cObject-Elemente einbauen. In diesem Fall erzeugt jedes Menüelement einen Eintrag im Register allPages. Das einzutragende Feld ist die UID der Seite, weil diese später benötigt

14.3 Ein alphabetisches Inhaltsverzeichnis anlegen | 615 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

wird, um die dazugehörigen Inhaltselemente zu ermitteln. Damit das Register nicht einfach überschrieben wird, stellen Sie den bisherigen Wert plus ein Komma per dataWrap voran. So erzeugen Sie eine kommaseparierte Liste aller Seiten, die in einem Menü erscheinen dürfen. Seiten vom Typ nicht im Menü oder mit gesetztem im Menü verstecken werden nicht berücksichtigt.

Links

stdWrap.cObject = LOAD_REGISTER stdWrap.cObject { allPages.dataWrap = {register:allPages},{field:uid} }

Das zweite temporäre Element erzeugt die eigentlichen Links. Weil Sie direkt zu den einzelnen Elementen verlinken wollen, benötigen Sie die UID des jeweiligen Elements aus der Tabelle tt_content. Auf Basis dieser UID werden bei Verwendung von content(default) oder CSS-styled-content die Anker bei den einzelnen Elementen gesetzt. Ein Link zu solch einem Anker besteht also prinzipiell aus den zwei Zahlen pid#uid sowie seit TYPO3-Version 4.0 einem c vor der UID, um die Anker W3C-konform mit id-Attributen zu versehen. Linktext

Lizensiert für Markus Mueller

Die UID der Elemente erhalten Sie durch das cObject CONTENT. Hier können Sie festlegen, aus welcher Tabelle die Elemente ausgewählt werden sollen (in diesem Fall tt_content), welche Seiten dabei als Eltern vorkommen dürfen (pidInList), welches Feld als Sortierkriterium verwendet werden soll (orderBy), welche Sprache die Elemente haben sollen (languageField) und welche Kriterien sie erfüllen müssen, um zum Einsatz zu kommen (andWhere). Im Prinzip erzeugen Sie damit eine genau definierte MySQLAbfrage, die eine Anzahl von Elementen zurückgibt. Was genau mit diesen Elementen geschehen soll, legen Sie im renderObj fest. Besonders zu beachten ist hier, wie das zuvor erzeugte Register allPages verwendet wird. Durch die Positionierung am Anfang (10 < temp.getPages) wird sichergestellt, dass das Register vollständig gefüllt ist, bevor die Elemente ausgewählt werden. Mithilfe von pidInList.data = register:allPages wird die kommaseparierte Liste in die Abfrage eingefügt. In dieser vereinfachten Form würde der folgende Code bereits funktionieren und eine Liste von Links mit jeweils einer Zeilenschaltung am Ende erzeugen.

Max. Linie

temp.getContentList = COA temp.getContentList { 10 < temp.getPages 20 = CONTENT 20 { table = tt_content select { pidInList.data = register:allPages orderBy = header languageField = sys_language_uid andWhere = sectionIndex=1 AND header!='' } renderObj = TEXT

616 | Kapitel 14: TypoScript ausreizen This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Rechts

renderObj { field = header typolink { parameter.dataWrap = {field:pid}#c{field:uid} } wrap = |
} } }

Das Feld header liefert die Überschrift des jeweiligen Elements, wobei Sie im Bereich andWhere festlegen sollten, dass nur Elemente mit gefülltem header verwendet werden dürfen, für die der sectionIndex gesetzt ist. Andere Elemente und deren header werden damit ignoriert. Sie können also weiterhin Ihren Seiteninhalt in mehrere Elemente aufteilen, und nur die relevanten erscheinen im Menü. Mithilfe von typolink wird aus dem header ein TYPO3-kompatibler Link gebaut, der eventuell anzuhängende GET-Parameter automatisch mit berücksichtigt. Benötigt werden dazu lediglich zwei Teile: die PID des Elements (sprich die UID der Seite, auf der es sich befindet) und seine eigene UID, damit der entsprechende Anker angesprochen werden kann. Alles Weitere wird von typolink erledigt. In diesem Fall ergibt dataWrap die kürzeste Schreibweise, um zwei verschiedene Felder direkt einzufügen. Lizensiert für Markus Mueller

Max. Linie

Die Liste als solche ist jetzt fertig. Es geht nun also darum, sie ein wenig übersichtlicher zu gestalten und zum Beispiel eine echte ul-Liste mit den jeweiligen Anfangsbuchstaben zu erzeugen. Hierzu müssen Sie ein wenig tiefer in die TypoScript-Materie eintauchen. Zunächst machen Sie aus dem einfachen TEXT ein Setzkastenelement COA. Innerhalb dieses COA können Sie verschiedene zusätzliche Elemente um den eigentlichen Link herumgruppieren. renderObj = COA renderObj { 10 = TEXT 10 { value = etwas davor
} 20 = TEXT 20 { field = header typolink { parameter.dataWrap = {field:pid}#c{field:uid} } wrap = |
} 30 = TEXT 30 { value = etwas danach
} }

14.3 Ein alphabetisches Inhaltsverzeichnis anlegen | 617 This is the Title of the Book, eMatter Edition Copyright © 2008 O’Reilly & Associates, Inc. All rights reserved.

Max. Linie

Die gewünschte ul-Liste soll folgendermaßen aussehen:

Links

A
- Ameisen
- Ananas
B
- Bananen
- Bonobos

Die Regel hierfür lautet: Wenn ein Anfangsbuchstabe erstmalig vorkommt, soll vor dem entsprechenden Link

Anfangsbuchstabe

|
|
- |
- |
- |
- |
- |
- |
- |
- |
- |
- |

TYPO3 Kochbuch, 2.Auflage

|

|

|

|

|

|

|

###PAGETITLE###

|

|

|

20 = TEXT 20.dataWrap = <span>{register:headerlines}

40 = TEXT 40.value = <span style="display:block 50 = TEXT 50.value = ; width:1px; height:1px; overflow:hidden;"> 60 = TEXT 60.current = 1 60.wrap = |

Überschrift

|

Sie sind hier

Blättern

Neueste Nachrichten

Neueste Nachrichten des Jahres

Neueste Nachrichten des Monats

Neueste Nachrichten des Tages

Direkte Unterseiten

Ähnliche Nachrichten

Passende Nachrichten

'. $this->cObj->data['header'] .'

'. $header .' auf der Seite '. $title .'

Die Ausgabe meines Frontend-Plugins

TYPO3 Kochbuch

TYPO3 Kochbuch

Aktuelle Seitenauswahl:

TYPO3 Kochbuch

Aktuelle Seitenauswahl:

Typo3

Praxiswissen TYPO3 (TYPO3-Version 4.3), 4. Auflage

Rails Kochbuch

jQuery Kochbuch

Regulare Ausdrucke Kochbuch

ASP.NET Kochbuch mit C#

LaTeX Kochbuch

Studenten Kochbuch

C++ Kochbuch

TYPO3 4.2 E-Commerce

TYPO3 4.3 Multimedia Cookbook

TYPO3 4.3 Multimedia Cookbook

TYPO3 4.3 Multimedia Cookbook

Das TYPO3-Profihandbuch

TYPO3 4.3 Multimedia Cookbook

Du liebe Tomate (Kochbuch)

Das große Pizza-Kochbuch

TYPO3: Enterprise Content Management: The Official TYPO3 Book, written and endorsed by the core TYPO3 Team

Emil Müller Kochbuch

QBasic-Kochbuch V1.0

Das Kochbuch für Geeks

Tapas. Das Kochbuch

Das Kochbuch für Eiweißallergiker

jQuery Kochbuch Edition

Das Grosse Nutella-Kochbuch

Regulaere Ausdruecke Kochbuch Edition

Julia's hessisches Kochbuch

Harry's Kochbuch (262 Rezepte)

Das Friesacher Kochbuch

PHP Kochbuch 3 Edition

Recommend Documents