Alexander Ebner, Patrick Schuster

TYPO3 undTypoScriptKochbuch

Lösungen für die TYPO3-Programmierung mit TypoScript und PHP

ISBN-10: 3-446-41046-5ISBN-13: 978-3-446-41046-6

Vorwort

Weitere Informationen oder Bestellungen unterhttp://www.hanser.de/978-3-446-41046-6

sowie im Buchhandel

XV

Vorwort

Im Jahr 1998 von dem Dänen Kasper Skårhøj ins Leben gerufen, hat es TYPO3 innerhalb der letzten zehn Jahre geschafft, sich an die Spitze der Enterprise Content-Management-Systeme im Bereich Open Source zu setzen. Aber nicht nur in diesem Bereich spielt es in der obersten Liga – es ist auch manchen kommerziellen Systemen weit überlegen. Nur durch eine konsequente und visionäre Entwicklung mithilfe einer stetig wachsenden und hoch motivierten Community konnte TYPO3 zu dem werden, was es heute ist. Und dies ist noch lange nicht das Ende der Entwicklung. Gerade jetzt, wo Sie dieses Buch lesen, wird TYPO3 in ein neues Zeitalter geführt, das modern und zukunftsorientiert pro-grammiert all jene Anwendungsfälle abdecken soll, die uns in Zukunft erwarten werden. Aber auch schon jetzt haben wir ein sehr komplexes und flexibles System, mit dem sich nahezu jede Aufgabe meistern lässt. Das allerdings geht natürlich auf Kosten der Bedie-nung. So ist es leider nicht möglich, eine derartige Leitungsfähigkeit mit ein paar Klicks hier und da zu erreichen. So ist es notwendig und wichtig, Anleitungen zu haben, die den Interessierten gut und kompetent durch die TYPO3-Welt führen. Auch dieses Buch soll solch eine Anleitung da-zu sein. Allerdings wollten wir kein weiteres „Me too“-Buch auf den Markt bringen, das TYPO3 von Anfang bis Ende systematisch erklärt – in diesem Bereich gibt es bereits einige sehr gute Bücher. Unsere Intention hingegen war es, eine Sammlung an Lösungen bereitzustel-len, wo es für den Leser gilt, eine konkrete Aufgabe zu meistern. Ähnlich einem richtigen Kochbuch spielt der Einstiegspunkt in das Buch keine Rolle. Sie können bei jedem Kapitel anfangen zu lesen und auch beliebig wieder aufhören zu lesen. Alle Einheiten sind in sich abgeschlossen. Sie können sich aber auch ein Kapitel heraussu-chen, das Sie ganz besonders interessiert. Oder aber Sie lesen das Buch von vorne bis hin-ten durch und lassen sich inspirieren. Sie werden konkrete Handlungsanweisungen finden, aber auch viele Ideen, über die Sie einen neuen Einblick in TYPO3 gewinnen werden. Manchmal gar versuchen wir Ihnen die Philosophie, die TYPO3 zugrunde liegt, nahezubringen oder auch einfach aufzuzeigen, wie die Welt, die hinter TYPO3 steht, funktioniert.

Vorwort

XVI

Manche Passagen werden Ihnen als Referenz für Ihre tägliche Arbeit dienen, und andere werden Sie inspirieren, einmal einen neuen Weg einzuschlagen. In jedem Fall werden Sie funktionierende Beispiele aus der Praxis vorfinden, da wir jedes davon in einer realen Umgebung ausgetestet und auf konstruierte Pseudobeispiele verzich-tet haben. Sollte dennoch bei Ihnen etwas nicht wie vorgesehen funktionieren – was durchaus sein kann, da Ihre Konfiguration unter Umständen eine ganz andere ist –, so scheuen Sie sich nicht, uns zu kontaktieren. Wir werden Ihnen gerne bei der Lösung behilflich sein.

Danksagung

Wir danken vor allem Kaspar Skårhøj für sein Engagement, seine Ausdauer und Kraft, et-was derart Revolutionäres wie TYPO3 – zudem auch noch unter der GPL-Lizenz – veröf-fentlicht zu haben. Dieses Produkt hat unser aller Leben beeinflusst und auch in gewissen Maßen (positiv) geändert. Viele davon (einen der Autoren eingeschlossen) verdienen ihren Lebensunterhalt mit TYPO3. Leider hat sich Kaspar 2007 aus der aktiven Entwicklung herausgenommen, was uns allen einen schmerzhaften Stich versetzt hat. Wir wünschen ihm viel Kraft und Glück auf sei-nem weiteren Lebensweg. Direkt danach gilt unser Dank natürlich der großartigen und einzigartigen Community, die sich zu TYPO3 gebildet hat. Wir sind sehr stolz und froh, ein Teil davon sein zu dürfen. Unzählige schöne Stunden und interessante Kontakte haben sich dadurch in den letzten Jahren ergeben und wir freuen uns schon sehr auf die nächsten. Ganz besonders herausgreifen möchten wir persönlich Robert Lemke, den die positive Energie förmlich ergriffen hat. Selten haben wir eine derart kraftvolle und zuversichtliche Ausstrahlung erlebt, und man meint, sein neues Baby TYPO3 5.0, genannt Phönix, sei schon auf der Welt, wenn er mit diesem einzigartigen visionären Lächeln davon spricht. Aber wir danken natürlich auch und ganz besonders all den anderen Menschen weltweit, die TYPO3 hoffentlich noch lange am Leben erhalten werden. Wir möchten uns auch bei unserem Lektor Fernando Schneider bedanken, der das Buch in der nun vorliegenden Fassung erst möglich machte.

Danksagung Alex

Ich möchte mich besonders bei meiner zauberhaften Freundin Sonja bedanken, für die ich nicht nur Liebe über allen Maßen empfinde, sondern auch Respekt für ihre Engelsgeduld, mit der sie meine Arbeit an dem Buch und dem damit verbundenen Mangel an Zeit ertra-gen hat. Für den Antrieb den sie mir gab und ihre Sicht der Dinge. Auch meinen Eltern und meiner Oma gebührt großer Dank. Sie haben mir den Rücken frei gehalten und mich unterstützt, wo sie konnten. Dieses Buch wird wohl das einzige Compu-ter-Buch im Schrank meiner Großmutter sein.

Vorwort

XVII

Nicht zuletzt möchte ich mich auch bei Patrick bedanken, für guten Wein, interessante Ge-spräche, Inspiration, unermüdlichen Optimismus und die Idee, dieses Buch zu schreiben.

Danksagung Patrick

Mein größter Dank gilt meiner bezaubernden und über alles geliebten Frau Marina, die mit unendlicher Geduld ertragen hat, dass sich mein Leben in den letzten sechs Monaten nur noch um TYPO3 gedreht hatte – und das zumal mitten in unseren Hochzeitsvorbereitun-gen. Allerdings ist sie nicht ganz unschuldig daran, da Sie während der TYPO3 Developer Days 2006 per Skype zu mir meinte, ich solle doch selbst ein Buch schreiben, nachdem ich ihr mitgeteilt hatte, dass ich es sehr aufregend finde, alle jede Autoren einmal live zu se-hen, deren Bücher ich längst verschlungen hatte. Dieser einfache Satz führte nun zu dem Ihnen vorliegenden Werk mit über 800 Seiten. Vielleicht wird sie sich derlei Äußerungen in Zukunft doppelt überlegen. Ich will natürlich auch Alex danken – schon alleine dafür, dass er sich hat überreden las-sen, dieses Projekt zusammen mit mir zu realisieren. Ohne ihn hätte ich es bestimmt nicht durchgehalten, nach einem Zehn-Stunden-Tag noch daran zu arbeiten. Die zahlreichen Ge-spräche und unsere Weinproben waren und sind mir ein Genuss – auch weit über dieses Buch hinaus. Weiterhin danke ich meinen geliebten Eltern, meinem Bruder, auf den ich sehr stolz bin, und meiner Oma, die diese Zeilen sicherlich von Ihrer Wolke dort oben lesen wird. München, im Juli 2007

Alexander Ebner, Patrick Schuster

TYPO3 undTypoScriptKochbuch

Lösungen für die TYPO3-Programmierung mit TypoScript und PHP

ISBN-10: 3-446-41046-5ISBN-13: 978-3-446-41046-6

Leseprobe

Weitere Informationen oder Bestellungen unterhttp://www.hanser.de/978-3-446-41046-6

sowie im Buchhandel

169

12 12 Backend anpassen

TYPO3 bietet umfangreiche Möglichkeiten das Backend anzupassen und den Benutzern damit die Arbeit zu erleichtern. Hier erfahren Sie, wie Sie das Backend an Ihre Bedürfnisse anpassen können. Für Anpassungen des RTE beachten Sie bitte Kapitel 28.

R12.1 Anmeldemaske anpassen

Aufgabe

Sie möchten die Anmeldemaske der CI Ihres Unternehmens anpassen. Dazu soll das Lay-out und die Darstellung geändert werden.

Lösung Dazu legen Sie eine neue Extension an. Wenn Sie mit der Extension-Erstellung noch nicht vertraut sind, erhalten Sie in Kapitel 35 Extensions erstellen und programmieren nähere Informationen dazu. Starten Sie den Kickstarter, und legen Sie eine Extension mit einem neuen Extension-Key an. Außer General-Info muss nichts konfiguriert werden. Die Extension soll so angelegt werden, dass sich das Login-Bild jedes Mal ändert. Der Pfad zu den Bildern soll im Backend geändert werden können, um einfacher neue Bilder einfügen zu können. Legen Sie die Datei ext_conf_template.txt, an und geben Sie das folgende Listing ein.

Listing 12.1 ext_conf_template.txt

# cat=basic; type=string; label=Pfad zu den Loginbildern picture_path = # cat=basic; type=string; label=Logo-Datei logo =

Diese Eintragungen stellen zwei Textfelder zur Verfügung, die bei der Installation der Ex-tension angezeigt werden. Damit können Sie die Pfade zu den Anmeldebildern konfigurie-

12 Backend anpassen

170

ren. Legen Sie nun die Datei ext_localconf.php an. Diese Datei überlagert die Datei typo3/index.php mit der Datei class.ux_SC_index.php.

Listing 12.2 ext_localconf.php

<?php $ext_path = t3lib_extMgm::extPath($_EXTKEY); $TYPO3_CONF_VARS['BE']['XCLASS']['typo3/index.php'] = $ext_path. "class.ux_SC_index.php"; ?>

Die Datei class.ux_SC_index.php erweitert die Datei index.php per XClass-Verfahren. Mit der Funktion wrapLoginForm konfigurieren Sie das Aussehen des Formu-lars.

Listing 12.3 class.ux_SC_index.php

<?php class ux_SC_index extends SC_index { function wrapLoginForm($content) { $logo = $GLOBALS['TBE_STYLES']['logo_login']; $loginboxImage = $this->makeLoginBoxImage(); $content=' <table callspacing="0" cellpadding="0" border="0" id="wrapper"> <tr> <td class="c-wrappercell" align="center"> <div id="loginimage"><img src="'.$logo.'" border=0></div> <table callspacing="0" cellpadding="0" border="0" id="loginwrapper"> <tr> <td>'.$loginboxImage.'</td> <td>'.$content.'</td> </tr> </table> <div id="copyrightnotice">'.$this->makeCopyrightNotice().' </div>'.$this->makeLoginNews().' </td> </tr> </table>'; return $content; } } ?>

Damit die Einstellungen, die während der Installation der Extension gemacht wurden, ak-tiv werden, müssen sie ausgewertet werden. Legen Sie die Datei ext_tables.php an.

Listing 12.4 ext_tables.php

<?php $lConf = unserialize($TYPO3_CONF_VARS['EXT']['extConf'][$_EXTKEY]); $ExtPath = t3lib_extMgm::extRelPath($_EXTKEY); $GLOBALS['TBE_STYLES']['loginBoxImage_rotationFolder'] = $lConf['picture_path'] ? "../".$lConf['picture_path'] : $ExtPath."res/loginimages/"; $GLOBALS['TBE_STYLES']['logo_login'] = $lConf['logo'] ? "../".$lConf['logo'] : $GLOBALS['TBE_STYLES']['logo_login']; ?>

R12.1 Anmeldemaske anpassen

171

Die Standardbilder für das Login-Formular liegen im Verzeichnis res/loginimages im Extension-Pfad. Legen Sie das Verzeichnis an, und füllen Sie es mit Bildern, die rotierend im Anmeldeformular angezeigt werden sollen. Installieren Sie nun die Extension, und konfigurieren Sie die Bildpfade.

Abbildung 12.1 Extension-Konfiguration

Wenn Sie die Felder leer lassen, werden die Bilder aus dem Extension-Pfad hergenommen. Für das Logo wird das normale TYPO3-Logo verwendet.

Abbildung 12.2 Das etwas abgewandelte Login-Formular

Bitte beachten Sie können das komplette Layout ändern. Allerdings dürfen Copyright- und GPL-Hinweise nicht entfernt oder verändert werden.

12 Backend anpassen

172

R12.2 Backend-User auf das Frontend umleiten

Aufgabe Oft ist es nützlich, die Webseite direkt im Frontend bearbeiten zu können. In Kapitel 27 Frontend Editing erfahren Sie, wie Sie Frontend Editing aktivieren. Normalerweise wer-den Sie sich am Backend anmelden, das Frontend aufrufen und arbeiten. Das geht auch e-leganter. Zwei Möglichkeiten bieten sich. Wenn Sie sowohl im Backend als auch im Fron-tend arbeiten, können Sie die Anmeldemaske des Backends um eine Auswahl erweitern, die Ihnen die Möglichkeit gibt zu entscheiden, wo Sie arbeiten möchten. Dazu rufen Sie das Install Tool Ihrer Installation auf (entweder über Tools > Installation oder über die URL http://<domain>/typo3/install). Im Menü wählen Sie 5: All Configuration. Scrollen Sie hinunter bis zu dem Abschnitt [BE]. Die Eigenschaft [Interfaces] erweitern Sie um den Eintrag frontend.

Abbildung 12.3 Die Anmeldemaske erweitern

Dadurch wird unter dem Passworteingabefeld ein entsprechendes Auswahlfeld eingefügt, mit dem Sie wählen können, welche Ansicht nach der Anmeldung aufgerufen werden soll.

Abbildung 12.4 Die erweiterte Anmeldemaske

R12.2 Backend-User auf das Frontend umleiten

173

Es gibt allerdings auch Benutzer, die ausschließlich mit dem Frontend Editing arbeiten. Es ist auch möglich, Benutzern das Backend ganz zu verbieten. In diesen Fällen macht es Sinn, auf die Auswahl zu verzichten und sie direkt nach der Anmeldung umzuleiten. Dabei hilft ein Link, den sich die Benutzer als Bookmark abspeichern können. Die URL lautet:

http://meinedomain.de/typo3/index.php?redirect_url=../

Sie können diese Möglichkeit auch in Kombination mit der erweiterten Anmeldemaske verwenden, da die Einstellung in dem Auswahlfeld nicht berücksichtigt wird. Sie können auch im Frontend einen Link hinterlassen. Entweder binden Sie ihn im Template ein, oder Sie erstellen eine neue Seite vom Typ externe URL, die auch im Menü auftaucht.

Abbildung 12.5 Link zu der Anmeldung mit Umleitung zum Frontend

Diskussion Wie bereits erwähnt, gibt es die Möglichkeit- Backend-Benutzern den Zugriff auf das Ba-ckend zu verweigern. Öffnen Sie den Extension Manager unter Tools > Ext Manager und wählen Sie Import Extension. Die Extension, die Sie benötigen, heißt Edit Frontend Only-flag (Extension Key: frontend_edit_only). Importieren Sie sie. Nach der Installation finden Sie bei den Einstellungen der Backend-Benutzer eine Checkbox, mit der Sie Benutzern den Zugriff auf das Backend verweigern können.

Abbildung 12.6 Der Benutzer kann sich am Backend anmelden, wird aber immer auf das Frontend umgeleitet. Das Backend steht im nicht zur Verfügung.

12 Backend anpassen

174

Da der Benutzer nicht mehr auf das Backend zugreifen kann, hat er keine Möglichkeit mehr, sich abzumelden, außer er schließt alle Browserinstanzen oder lässt die Session aus-laufen. Beides ist nicht praktikabel. Besser ist es, dem Benutzer im Frontend eine Mög-lichkeit zu geben, sich abzumelden. Dazu legen Sie in Ihrer Template-Vorlage einen Sub-part an. Keinen Marker, da der Subpart nur belegt wird, wenn eine bestimmte Bedingung erfüllt ist (ein Backend-Benutzer ist angemeldet), würde ein Marker sichtbar werden. Al-ternativ können Sie natürlich auch ein vorhandenes Element durch einen Wrap mit dem Link umschließen.

Listing 12.5 Logout-Link erstellen

01: [globalVar = TSFE : beUserLogin = 1] 02: page.10.subparts.LOGOUT_LINK = TEXT 03: page.10.subparts.LOGOUT_LINK.value = <a href="./typo3/logout.php?redirect=../index.php&ATBE=1&sendLogoutSignal=1">Logout</a> 04: [global]

Beachten Sie bitte, dass Zeile 03 in eine Zeile geschrieben werden muss, die Zeilenumbrü-che sind der Buchbreite zuzuschreiben. Der eigentliche Aufbau des Links wird in eine Condition gesetzt, die prüft, ob eine An-meldung an das Backend besteht. Wenn nicht, wird die Bedingung beUserLogin = 1 nicht erfüllt und der Link nicht angezeigt.

R12.3 Das Backend-Design ändern

Aufgabe Sie möchten das Erscheinungsbild des Backends ändern.

Lösung Es ist möglich, das Erscheinungsbild des Backends zu ändern. Das kann aus verschiedenen Gründen nötig sein. Beispielsweise wenn Sie auch im Backend auf die CI Ihrer Firma nicht verzichten möchten oder weil Ihnen das Standardthema nicht zusagt. Gerade die Icons im Seitenbaum werden gerne bemängelt, da sich durch die durchwegs graue Farbgebung die Möglichkeit verschließt, die verschiedenen Seitentypen mit einem flüchtigen Blick zu se-parieren. Es gibt einige Extensions, die das Aussehen des Backends beeinflussen. Eine kleinere Ex-tension ist Improved t3skin (Extension Key: t3skin_improved). Diese Extension ändert die Icons im Seitenbaum und ersetzt sie durch farbenfrohere Pendants. Vor allem SysOrdner sind durch ihre orange Farbgebung sehr schnell zu erkennen.

R12.3 Das Backend-Design ändern

175

Abbildung 12.7 Links die Standard-Icons, rechts die neuen Icons von Improved t3skin (die neuen Farben sind leider im Buch durch den Schwarz/Weiß Druck nicht zu erkennen)

Weiter geht es mit Gray-orange-green skin (Extension Key: skin_grey_2). Diese Extensi-on ersetzt das Backend durch eine sehr farbenfrohe Version.

Abbildung 12.8 Gray-orange-green skin

12 Backend anpassen

176

Wenn Sie eigene Anpassungen vornehmen möchten, sollten Sie das durch eine eigene Ex-tension realisieren. In Kapitel 35 Extensions erstellen und programmieren erfahren Sie die Grundlagen einer Extension-Erstellung. Um die Icons der Seitentypen im Seitenbaum zu ändern, legen Sie eine neue Extension mit dem Kickstarter an und vergeben einen eindeu-tigen Extension Key. Es reicht die Informationen im Abschnitt General Info zu vervoll-ständigen. Im Extension-Ordner sollten Sie nach dem Speichern Ihrer neuen Extension ei-nen Ordner namens res erstellen. In ihm werden die neuen Icons gespeichert. Die Icon-Zuordnung findet in Arrays statt. Pro Seitentyp benötigen Sie ein Array. Dazu muss die Datei ext_tables.php angelegt werden. Folgendes Beispiel ändert die Icons für die Sei-tentypen Standard und SysOrdner:

Listing 12.6 Icons ändern

<?php $ext_path = t3lib_extMgm::extRelPath($_EXTKEY); $PAGES_TYPES['1'] = Array ( 'icon' => $ext_path .'res/standard.gif', ); $PAGES_TYPES['254'] = Array ( 'icon' => $ext_path .'res/sysordner.gif', ); ?>

Die Icons sollten im Format GIF oder PNG vorliegen und 18 x 16 Pixel groß sein. Im Bei-spiel stehen die Ziffern 1 und 254 für die Seitentypen. Nachfolgend eine Auflistung der standardmäßigen Seitentypen: 1 Standard 2 Erweitert 3 Externe URL 4 Shortcut 5 Nicht im Menü 6 Backend-Benutzerbereich 7 Mount-Seite 199 Abstand 254 SysOrdner 255 Papierkorb

Auch das Icon eigener Seitentypen kann so geändert werden. Natürlich ist es auch möglich, das gesamte Stylesheet zu ändern, um das Backend anzu-passen. Sie finden das Original-Stylesheet in der Datei sysext/t3skin/

stylesheets/stylesheet_post.css. Um nicht das ganze Stylesheet kopieren zu müs-sen, übernehmen Sie nur die Abschnitte, die Sie ändern möchten, und kopieren diese in ei-ne neue Datei, zum Beispiel in res/mystyle.css in Ihrem Extension-Ordner. Damit die Originaldatei die übrigen Formatierungen übernimmt, wird auch diese aufgerufen. Tragen Sie Folgendes in die Datei ext_tables.php ein.

R12.3 Das Backend-Design ändern

177

Listing 12.7 Stylesheet austauschen

<?php $ext_path = t3lib_extMgm::extRelPath($_EXTKEY); //Verschiebt den Aufruf der Originaldatei nach $TBE_STYLES['stylesheet2'] $TBE_STYLES['stylesheet2'] = $TBE_STYLES['styleSheetFile_post']; //Ruft die neue Stylesheet-Datei auf $TBE_STYLES['styleSheetFile_post'] = $ext_path.'res/mystyle.css'; ?>

Weitere Möglichkeiten der BE-Anpassung finden Sie im Modul Tools > Konfiguration, wenn Sie im Auswahlmenü $TBE_STYLES wählen.