Inhaltsübersicht. 1 Einleitung Grundlegendes zum Universum von TYPO Installation 29

Transkript

1 Inhaltsübersicht 1 Einleitung 21 2 Grundlegendes zum Universum von TYPO Installation 29 I* Das Frontend - Ausgabe und Darstellung der Daten 59 5 Das Backend - Eingabe und Pflege der Daten HowTos Das Framework - Werkzeugkasten für die eigene Extension Extensions entwickeln Extensions, von denen Sie lernen können Spezialthemen FLOW3 653 Stichwortverzeichnis 675 Bibliografische Informationen digitalisiert durch

2 Inhaltsverzeichnis Einleitung Zielsetzung und Zielgruppen Extensions Anglizismen überall Orientierung Neue Inhalte der zweiten Auflage Dank 24 Grundlegendes zum Universum von TYPO Open Source und GPL Die Entstehungsgeschichte von TYPO Die Community Die Association Active Members Supporting Members 28 Installation Systemvoraussetzungen Hardware Software Paketwahl und Platzierung auf dem Server Lösungen für häufig anzutreffende Probleme Das Installationstool Standardmäßiges Passwort ändern Basiseinstellungen Datenbank mit $TCA vergleichen Bildbearbeitung überprüfen Gezielt Einstellungen suchen und verändern Backup/Recovery vorsehen Export des Seitenbaums Backup durch TYP03-Extensions Eigene Scripts Ihren Provider fragen Extensions einsetzen Extension Manager konfigurieren Extensions installieren 47

3 3.6 Sprachpakete laden Los geht s 3.8 TYPO3-Update durchführen Dateistruktur umstellen für den Sprung von Version Dateistruktur ab 4.x, neuen TYPO3-Kern einbinden Datenbank aktualisieren Konfiguration überprüfen, Update Wizard Extensions überprüfen Reference-Index-Tabelle aktualisieren Cache leeren und temporäre Dateien löschen Superadmin-Script Besonderheiten und mögliche Fehler beim Upgrade auf die TYP03-Version Materialien zum Weitermachen 58 Das Frontend - Ausgabe und Darstellung der Daten Tutorial - Die erste Webseite Vorbereitungen und Inhalte importieren Das erste TypoScript-Template Das HTML-Template und CSS einbinden Marker ersetzen Verschachtelungen übersichtlicher darstellen Hauptnavigation erstellen Eine Breadcrumb-Navigation erstellen Die Seiteninhalte anzeigen lassen Grundlagen Aus der Datenbank in den Browser Was ist TypoScript (nicht)? Zusammenspiel mit PHP TypoScript versus TSconfig Der Begriff»Template« HTML-Templates vorbereiten (dynamische und statische Bereiche) TypoScript-Syntax und -Semantik Begriffe: Objekt, Objektname, Eigenschaft, Funktion & Co Datentypen (data types) Operatoren und Kommentare Konstanten Bedingungen Die Bedeutung der Reihenfolge Die TypoScript-Referenz (TSRef)

4 4.4 TypoScript-Templates verwalten Der TypoScript-Template-Datensatz TypoScript-Konfigurationsbereiche wiederverwenden (temp.*, styles.* und lib.*) TypoScript-Templates übersichtlich organisieren TypoScript-Templates in Dateien auslagern TypoScript-Editoren Das Modul Web, Template TypoScript-Templates bearbeiten (Info/Modify) TypoScript-Struktur betrachten (Object Browser) Template-Organisation überblicken (Template Analyzer) Konstanten bequem ändern (Constant Editor) Das Grundgerüst des Setup-Feldes (Toplevel Objects) Grundlegende Konfigurationen (CONFIG) Globale Marker (CONSTANTS) Das eigene Layout (PAGE) Metatags (META) plugin Ausgabe von Datensätzen [tt_*] Navigationen (Menüs) Grundlagen Der Ausgangspunkt (HMENU) Textmenüs (TMENU) Grafische Menüs (GMENU) Layermenüs (TMENUJ.AYER, GMENUJ.AYER) Menü als Auswahlbox (JSMENU, JSMENUITEM) Weitere Menütypen Spezielle Funktionen in Menüs ( Proc) Menüpunkte unterschiedlich behandeln (optionsplit) Die Ausgabe von Inhalten (cobjects) Dynamische Textausgabe (HTML, TEXT) Inhaltselemente zusammenfassen (COA, C0AJNT) Dateien einbinden (FILE) Bilder darstellen (IMAGE, IMG_RESOURCE) Datensätze ausgeben (CONTENT, RECORDS) Navigationen (HMENU) Text mit Bild darstellen (IMGTEXT) Fallunterscheidungen einsetzen (CASE) Globale Variablen verwenden [LOAD_REGISTER und RESTORE REGISTER)

5 12 INHALTSVERZEICHNIS Mail-Formulare erzeugen (FORM) Eigene PHP-Scripts verwenden (USER, USERJNT, PHP_SCRIPT) HTML-Templates verwenden (TEMPLATE) Redaktionelles (Be-)Arbeiten im Frontend Die alte Methode: Das EDITPANEL Das neue Frontend Editing Hintergrundinfos und Links Erweiterte Konfiguration: Funktionen Die Allzweckwaffe (stdwrap) Bilddateien einbinden (imgresource) Klickvergrößern ( magelinkwrap) SQL-Statement konfigurieren (select) Noch einmal Bedingungen ( f) Links erzeugen (typolink) Textfelder/HTML parsen (parsefunc) Bildbearbeitung mit dem GIFBUILDER Mehrsprachigkeit Verschiedene Konzepte der Mehrsprachigkeit Grundeinstellungen Alle Sprachen im gleichen Baum Übersetzungen.' Ein eigener Baum für jede Sprache Materialien zum Weitermachen Lesbare Pfade über realurl konfigurieren ' Installation und Konfiguration SpezialWissen Flexible Layouts mit templavoila Voraussetzungen Installation und Konfiguration Anwendung Spezialwissen Caching Standard-TYPOS-Caching Das neue Caching Framework Fehler finden Debuggen mit TypoScript Das AdminPanel verwenden Materialien zum Weitermachen 217

6 Das Backend - Eingabe und Pflege der Daten Backend-Benutzerverwaltung - Rechte Funktionsweise, Grundprinzip Home-Verzeichnisse Überblick behalten TypoScript-Konfiguration (TSconfig) Page TSconfig User TSconfig rtehtmlarea und weitere Rich-Text-Editoren Konfiguration im Extension Manager Konfiguration über TSconfig Versionierung und Workspaces für das Team Einführung Benutzerverwaltung und Rechtevergabe Der Workspace Manager Redaktionelles Arbeiten mit Workspaces Tipps und Tricks Ausblick Interessante (oft unbekannte) Funktionalitäten Arbeitsschritte zusammenfassen Daten durchsuchen im Backend Datenbankfelder kontrollieren Import/Export von Daten als *.t3d Drag&Drop Das Klemmbrett (Clipboard) Mehrsprachigkeit, Lokalisierung Datensätze im Modul Page anzeigen Kontrollmöglichkeiten, Logs Autologin im Backend Überblick über die aktuelle Konfiguration Scheduler Extension Manager für Administratoren Materialien zum Weitermachen 304 HowTos Darstellung im Backend anpassen Login-Formular anpassen Icons und Farben verändern Datensätze im Page-Modul anzeigen Die Position und das Erscheinen von Feldern beeinflussen

7 6.2 Label überschreiben Label über Frontend-TypoScript anpassen Label für das Backend über Page TSConfig anpassen Label über Sprachdateien Kontextsensitive Hilfe einbauen Datensätze in Feldern speziell bearbeiten (itemsprocfunc) Eigene Wizards zu Feldern hinzufügen Durch eigene Listenansichten den Überblick behalten Den kompletten Seitenbaum auf einmal erzeugen Extensions von Updates ausschließen Eigene Evaluierung für Felder im Backend Eigene Seitentypen erzeugen Backend (zu Wartungszwecken) sperren 335 Das Framework - Werkzeugkasten für die eigene Extension Aufbau und Funktionsweise Konzeptioneller Aufbau Dateisystem Dateien in typo3conf, Konfiguration Sprachvielfalt durch Lokalisierung L10n, UTF Datenbank Anforderungen an Tabellen, die von TYPO3 verwaltet werden Wichtige Tabellen Wie erkennt TYPO3 neu anzulegende Tabellen? Tabellenverknüpfungen Im Zentrum der Macht: The Core TCE (TYPO3 Core Engine) $TCA (Table Configuration Array) Spezialkonfigurationen in defaultextras $PAGES_TYPES Aufbau der Backend-Schnittstelle Aussehen der Backend-Formulare anpassen Colorschemes Styleschemes Borderschemes RTE-API Technikhintergrund zu Versionierung und Workspaces Voraussetzungen für eine versionierbare Tabelle Sonderfall Löschen und Erzeugen Eindeutige Felder (unique fields) Lebenszyklus von versionierten Elementen Workspaces-API für Programmierer

8 7.7 Kontextsensitive Menüs Kontextsensitive Hilfe Funktionsweisen von TYPO3 abändern Ändern des Core-Codes Erweiterung mittels XCLASS Hooks Services Texte (Label) anpassen Materialien zum Weitermachen 434 Extensions entwickeln Wozu dienen Extensions? Extension Key Extension Key registrieren Ja, wo liegt sie denn? Sysext vs. global vs. lokal System-Extensions, typo3/sysext Globale Extensions, typo3/ext Lokale Extensions, typo3conf/ext/ Vorrangreihenfolge Kickstarter (herkömmliche Extension) Allgemeine Informationen Verschiedene Sprachen vorsehen Eigene Datenbanktabellen anlegen Bestehende Datenbanktabellen erweitern Frontend-Plugin erstellen Backend-Modul anlegen Neue Möglichkeiten für bestehende Module hinzufügen Neue Elemente im Kontextmenü der Seiten Neuen Service definieren Statischen TypoScript-Code einfügen TSconfig hinzufügen Extensions-Dateien speichern Struktur, Aufbau und Funktionsweise (herkömmliche Extension) Extension-Daten in ext_emconf.php Weitere reservierte Datei- und Ordnernamen Konfigurationsmöglichkeiten für Extensions (ext_conf_template.txt) Bereich für Frontend-Plugins (pi*) Bereich für Backend-Module (mod*) Bereich für Services (sv*) Textinformationen und ihre Lokalisierung (L10n) Und dann geht's los!

9 8.6 Extensions auf Basis von Extbase und Fluid Die Model-View-Control-Architektur in der Theorie Referenz-Extension blog_example Kickstarter für Extbase (extbase_kickstarter) Wichtige Code-Stellen in Extbase Workshop: Extbase-Extension schreiben Ausgangssituation Aufgabenstellung Kickstarter nutzen Erste Ausgabe erzeugen Listenansicht aus der Datenbank erzeugen CRUD (create, read, update, delete) für Fridge implementieren Kühlschrankinhalte anzeigen Kühlschrankinhalte hinzufügen und entfernen Caching Individuelles Repository ext_autoload.php Fluid, die neue Templating-Engine Fluid-Templates in der Beispiel-Extension viewhelpertest ViewHelper Einen eigenen ViewHelper schreiben ExtJS mit Extbase und Fluid Coding Guidelines Dateiaufbau Formatierung und Benennung Programmiergrundsätze, Syntax Dokumentation Datenbankzugriffe Das Rad nicht neu erfinden, API nutzen Verfügbare Konstanten Globale Variablen Zugriffsrechte im Backend prüfen mit $BE_USER Autoloader Wichtige Klassen für den Extension-Entwickler Reference Index Table Singleton-Entwurfsmuster (nur ein Objekt einer Klasse) Cache-Möglichkeiten intelligent nutzen Klassisches Plugin als USER oder USERJNT Neues Caching-Framework ab TYPO3 4.3 nutzen Was Sie verstehen und einsetzen sollten TSDataStructure, XML und Flexforms Links im Frontend richtig erzeugen

10 NHALTSVERZEICHNIS Cache während der Entwicklung unterdrücken Sessions im Frontend Workspaces beachten Alleinstehende Scripts und zeitgesteuerte Ausführung [per Scheduler) Debug: debug und devlog syslog AJAX Einbindung in herkömmliches Plugin Den eld-mechanismus nutzen Veröffentlichung Ihrer Extension Dokumentation erstellen Ins TER hochladen Ein eigenes Extension Repository aufsetzen Materialien zum Weitermachen Extensions, von denen Sie lernen können blog_example viewhelpertest cal Dokumentation Umfangreiches Frontend Editing Eigene Funktionalitäten mithilfe von Services einbringen Commerce DAM Komplexe Backend-Module Verschiedene Grundkonfigurationen vorgeben Erweiterung durch andere Extensions direct_mail realurl tt_news ratings API für externe Nutzung anbieten eld für performantes AJAX nutzen Spezialthemen Sicherheit Organisationsverschulden Beliebte Angriffsvarianten Grundsätzliche Sicherheitsmaßnahmen Einstellungen im Install Tool Standard-Admin-Benutzer deaktivieren

11 Coding Guidelines einhalten Abonnieren Sie die Mailingliste TYPOS-Announce Web Application Firewall einsetzen Weitere Möglichkeiten Zugriffsgeschützte Seiten im Frontend Spam-Vermeidung Materialien zum Weitermachen Seiten mit sehr viel Last, Performance Lasttests durchführen Technische Rahmenbedingungen und Erfahrungswerte TYP03 Cache nutzen, serverseitig Cache Control Headers, clientseitig Statische Files PHP-Beschleuniger Apache optimieren Datenbank optimieren (MySQL) Hardware, Cluster, Cloud Hosting Materialien zum Weitermachen Werkzeuge für Profis FL0W Einführung Lizenz: LGPL Installation Webserver vorbereiten FL0W3 Installieren Weitere Quellen (svn-repository) Grundlagen Aufbau einer Distribution Das Package Kommentare mit Funktion Caching Convention over Configuration Aspektorientierung FL0W3 im Einsatz: Das Blog-Beispiel Konfiguration Kontext (Context) YAML-Syntax Model View Controller Extbase/Fluid und FLOW Kickstarter in FLOW Domain Driven Design

12 11.7 Persistenz PDO / SQLite Objektorientierte Datenstruktur Test-Driven-Development Dokumentation Coding Guidelines Debugging in FLOW Die FLOW3-var_dump()-Funktion Debuggen mit xdebug Auf dem Laufenden bleiben 673 Stichwortverzeichnis