TYPO3 Das Handbuch für Entwickler

Transkript

1 Kai Laborenz Thomas Wendt Andrea Ertel Prakash Dussoye Elmar Hinz TYPO3 Das Handbuch für Entwickler *sä Galileo Computing

2 Inhalt 1 Vorwort Für wen wurde dieses Buch geschrieben? Was befindet sich in diesem Buch? Was ist auf der CD-ROM und der Referenzkarte? Die Website zum Buch Danke! 19 Teil I Grundlagen 21 2 Einführung Neu in Version Pläne für die Zukunft TYPO3 4.0 (in der Entwicklung, Veröffentlichung geplant für Ende 2005) TYP (Veröffentlichung geplant für Frühjahr 2006) TYP (Veröffentlichung geplant für Herbst 2006) 26 3 Grundlagen und Systemarchitektur von TYPO Grundlegendes Trennung von Inhalten und Darstellung Erweiterbarkeit Mehrsprachigkeit Weitere Funktionen Entstehung von TYPO Community Open Source Systemaufbau Der Systemkern von TYP Erweiterungen (Extensions) Konfiguration 38 Inhalt 5

3 3.4 Datenbank MySQL Verwendung anderer Datenbanken mit TYP Wichtige Tabellen in der TYPO3-Datenbank 40 4 Der Aufbau von TYPO Dateinamen und Verzeichnisse Verzeichnisse einer Standard-Installation Wichtige Dateien Voraussetzungen zur Installation von TYPO Hardware und Betriebssystem Software Performance Praktische Hinweise Performance-Steigerungen 49 5 Die TYPO3-Community und Ressourcen zu TYPO Dokumentationen Dokumentationen für Redakteure Quellcode-Dokumentation Websites, Foren und Mailinglisten Mailinglisten und Newsgroups TYPO3-Websites 58 Teil II TYPO3 verwenden 59 6 Installation Installation von TYPO Installation mehrerer Sites auf einem TYPO3-System Ein Kern-viele TYPO EinTYP03 - viele Websites Erstellen multipler Sites mit Freesite Anbindung an bestehende IT-Strukturen (LDAP) Kurzbeschreibung LDAP Installation der LDAP-Extension Konfiguration der LDAP-Extension Kontaktaufnahme zum LDAP-Server Fehlersuche 77 6 Inhalt

4 7 Das Backend von TYPO Die Benutzeroberfläche von TYPO Die Module und ihre Funktionen Seiten anlegen und bearbeiten Seiteninhalte einpflegen Allgemeine Datensatzverwaltung in Root AdminPanel Import/Export von T3D-Dateien Sicherung von TYPO3-Installationen Anpassen des Backends über TSconfig TSconfig TypoScript-Wizard Page TSconfig User TSconfig Beispiele zur Backend-Anpassung RichText Editor RTE-Transformationen RTE-Konfiguration der Benutzeroberfläche Die Toolbar des Rieh Text Editors pagetsconfig.txt Absatzarten und Zeichenarten begrenzen Klassen definieren und als Absatzart zuweisen Ausgabekonfiguration Alternative Editoren für das Backend HTMLarea Andere Editoren Eine Beispielkonfiguration für den RTE (HTMLarea) Aufbau von TYPO3-Sites Vorgehensweise Ziele und Zielgruppen festlegen Inhalte planen Funktionen festlegen Dokumententypen festlegen Sitemap/Struktur planen Designvorlagen vorbereiten Extensions auswählen Template-Struktur planen Designvorlageneinbinden Struktur anlegen Benutzergruppen/Benutzer Inhalte eingeben 160 Inhalt 7

5 8.2 Designvorlagen (HTML-Templates) The old way: Templates per Hand vorbereiten The modern way: Die Extension Template-Autoparser The futuristic way: Die Extension TemplaVoila Benutzerverwaltung Frontend-Benutzerverwaltung Geschützter Bereich Login einbauen und anpassen Login-Layoutanpassung Backend-Benutzer Rechte und Rollen definieren Benutzergruppen anlegen Benutzergruppen - Beispiele Einzelne Backend-Benutzer anlegen Backend-Benutzer-Beispiel Seitenzugriff Benutzerrechte vergleichen Workflows Was sind Workflows? Aufgabenlisten (To-Do-Listen) Extension Native Workflow System Extension Workflow TypoScript Was ist TypoScript? TypoScript im engeren und im weiteren Sinne Grundlegende Konstrukte Arbeiten mit der TypoScript-Referenz (TSref) Begriffsdefinitionen und Syntax Operatoren in TypoScript TypoScript-Verschachtelungen - mehrdimensionale PHP-Arrays TypoScript-Elemente Datentypen Funktionen Conditions Constants cobjects cobjects - veraltet Content-Objekte kopieren und referenzieren Top-Level-Objekte TypoScript-Templates Templateserstellen TypoScript-Setup TypoScript-Constants Kaskadierung von Templates Standard-Templates (static templates) Inhalt

6 9.3.6 Basis-Templates - Eigene Standard-Templates Templates ab der nächsten Ebene (Templates on next Level) Root, Rootline und Rootline-Arrays Die Template Tools Template Tool: Info/Modify Template Tool: Template Analyzer Template Tool: TypoScript Object Browser Template Tool: Constant Editor Erstellen eigener Eingabemasken im Constant Editor Template Tool: CSS Styler Clear all cache - admin functions setup.txtundconstants.txt TSconfig Der Rendering-Prozess TypoScript-Schnipsel/Praxisbeispiele Allgemeine Seitenkonfiguration TypoScript-Menüs Navigation aus Bildern der Mediafelder Ändern des Standard-<body>-Tag Auswählbare Wraps um den gesamten Inhalt der Spalte NORMAL Sitemap/Menü Login-Formular per TypoScript Ausblenden der erweiterten Suche der Extension»indexed search« Anzahl der Bilder des Mediafeldes erhöhen Mehrsprachigkeit Extensions anwenden Allgemeine Definition von Extensions Einteilung von Extensions Einteilung nach Bedeutung Einteilung nach Funktion Verwaltung von Extensions Extension-Manager TYPO3-Online-Repository Der Extension Kickstarter Wizard Anwendungsbeispiele von Extensions Extension: News Frontend-Anpassungen Extension RSS Die Extension»CSS Styled Content«385 Inhalt 9

7 11 Mehrsprachige Websites mit TYPO Unicode (utf8) Was ist Unicode? Technische Zusammenfassung TYPO3 als utf8 einrichten Überblick Sprachdateien, TypoScript und utf Zeit und Lokalisierung Grundlagen zur Zeit Die Locales TypoScript-Einstellungen für einsprachige Seiten TypoScript-Einstellungen für mehrsprachige Seiten Ein Seitenbaum für jede Sprache (Multi-Tree-Ansatz) Ein Seitenbaum für alle Sprachen (Single-Tree-Ansatz) Barrierefreie und standardkonforme Websites mit TYPO Warum Sie barrierefrei entwickeln sollten Wie sieht eine barrierefreie Website aus? Inhalt und Präsentation trennen Logische Strukturen schaffen Nicht für bestimmte Geräte arbeiten Abwärtskompatible Seiten erstellen Alternativen bereitstellen Standards beachten Standardkonforme Seiten mit TYPO3 erstellen XHTML-Cleaning Die Extension»Page Validator« Barrierefreie Websites mit TYPO Vorhandene Hilfsmittel TYPO3-Inhaltselemente barrierefrei gestalten Überschrift und Text Text-Bild und Bilder Aufzählung (Punktliste) Tabelle Dateiliste Multimedia Sitemap/Menü HTML Mailformular Suchformular Anmeldeformular Plugins Sprungmarken älaxhtml Inhalt

8 12.6 Barrierefreie Menüs mit TYPO Textmenüs Grafische Menüs Ein barrierefreier RTE Einbindung von Tidy Accessible Content Exkurs: Rendering von Content-Elementen Neues Rendering erstellen Die XCLASS Tabellen Formulare Probleme mit Plugins Weitere Entwicklung von»accessible Content«455 Teil III TYPO3 erweitern Eigene Extensions programmieren Grundlagen Namenskonventionen Dateistruktur einer Extension Der Extension-Manager Die Datei ext_emconf.php Die Datei extjocalconf.php Die Datei ext_tables.php Drei Extensions als Beispiel Die Extension»Text w/ summary« Die Extension»Function Reference« Die Extension»Akronymmanager« Globale Variablen und Datenbankfunktionen Variablen Datenbankzugriffe mit dem DBAL Datenbanktabellen Backend-Programmierung Eingabemasken DasTable Configuration Array STCA STCA-Beispiel: Extension»Function Reference« STCA-Beispiel: Wizard austauschen Context Sensitive Help (CSH) TCE und TCEforms Anlegen und Bearbeiten von Inhaltstypen Der Inhaltstyp»Plugin einfügen« Backend-Module Anlegen eines Moduls Ausgabeformatierungen in Modulen Einfügen eines Submoduls in das Menü 516 Inhalt

9 Beispiel für Module - der Akronymmanager Der Navigationsbereich Rechte von Backend-Usern abfragen Frontend-Programmierung Das Frontend-Rendering Objekte im STSFE, Standard-Rendering-Funktionen Ausgabe eigener Inhalte mittels USER, USERJNT, PHP_SCRIPT, PHP_SCRIPT_INToder PHP_SCRIPT_EXT Neue Rendering-Funktionen anlegen stdwrap in Rendering-Funktionen Frontend-User und Sessions Eingabeformulare Beispiel für Eingabeformulare - Pinboard für die»function Reference« HTML-Vorlagen CSS und JavaScript Plugins -die Klasse tslib_pibase tslib_pibase-link-methoden tslib_pibase - Methoden für das Auflisten von Datensätzen tslib_pibase-methoden für Stylesheet und CSS tslib_pibase - Methoden für das Frontend-Editing tslib_pibase - Methoden für Mehrsprachigkeit und Lokalisation tslib_pibase - Methoden für Datenbankabfragen tslib_pibase - Methoden für Flexforms Flexforms Hello World mit Flexforms Flexform einbinden Flexforms gestalten Flexform - Grundstruktur Flexform-Input-Felder Flexform dynamisch Auf Flexform-Daten zugreifen Mehrsprachigkeit Eigene Locallang-Dateien für einzelne Sprachen Extensions für die Arbeit mit Locallang-Dateien Allgemeines TypoScript in Extensions Static-Templates hinzufügen TypoScript einfügen Klassen erweitern - XCLASS Hooks Services Sicher programmieren Der Extension Kickstarter Der Development Evaluator Dokumentation Caching-FAQ Inhalt

10 A CD-ROM 615 A.1 Dateien zum Buch 615 A.2 Dokumentationen 615 A.3 Videos 616 A.4 TYPO3 3.8 zum Installieren 616 A.5 Extensions 616 A.6 TYP03_API_Doxygen 617 B Zusätzliche Informationen 619 B.1 Das Install-Tool und seine Optionen 619 B.1.1 Basic Configuration 619 B.1.2 Database Analyzer 622 B.1.3 Image Processing 623 B.1.4 All Configuration 625 B.2 Ein reines CSS-Menü (für Kapitel 12) 639 B.3 CSS Styled Content im Detail 643 B.3.1 CONSTANTS: EXT:css_styled_content/static/ 643 B.3.2 SETUP: EXT:css_styled_content/static/ 646 Index 701 Inhalt 13