Typoscript / TS-Config

Transkript

1 Typoscript / TS-Config Typoscript ist keine Programmiersprache, es ist als Konfigurationssprache anzusehen mehrere Arten von Typoscript Templatesetup (Templatesteuerung) bzw. Templateconstants (lediglich Konstanten) Page TS-Config (Konfiguration der»seitenkonfiguration«) und User TS-Config (Konfiguration der BE-Benutzer bzw. der BE-Benutzergrupen) (meist ist mit Typoscript selbst das Template-Setup gemeint) 1

2 Typoscript (Setup) Objektorientiertes Prinzip (wie z. B. auch bei Java), Beispiel: lib.meinauto = AUTO lib.meinauto.farbe = rot lib.meinauto.marke = Mercedes Benz lib.meinauto.10 = MOTOR lib.meinauto.10.typ = ottokraftstoff lib.meinauto.10.e10 = 1 lib.meinauto.20 = Rad lib.meinauto.20.size = 18 lib.meinauto.20.material = Alu (Zähler) usw. = Objekterweiterung weiteres Beispiel: page = PAGE page.10 = TEXT page.10.value = Hallo Welt page.10.wrap = <strong> </strong> 2

3 Typoscript (Setup) Werte werden in PHP als Array gespeichert, z.b. page = PAGE page.10 = TEXT page.10.value = Hallo Welt page.10.wrap = <h2> </h2> Wird über PHP folgendermaßen abgebildet: $data['page'] = 'PAGE'; $data['page.'][10] = 'TEXT'; $data['page.']['10.']['value'] = 'Hallo Welt'; $data['page.']['10.']['wrap'] = '<h2> </h2>'; weiteres Beispiel: page = PAGE page.10 = TEXT page.10.value = Hallo Welt page.10.wrap = <strong> </strong> 3

4 Weitere TS-Grundlagen (Setup) contentobjects (cobjects): Klassenelemente wie TEXT, IMAGE, HMENU COA =»Container Object Array«Containerelement in das per Objekterweiterung weitere cobjects eingefügt werden können Beispiel: lib.mycontainer = COA lib.mycontainer.10 = TEXT lib.mycontainer.10.value = Heute ist ein schöner Tag lib.mycontainer.20 = IMAGE lib.mycontainer.20.file = toplogo.gif 4

5 Weitere TS-Grundlagen (Setup) Operatoren: < kopiert ein Objekt, > leert ein Objekt Beispiel: ib.mycontainer = COA lib.mycontainer.10 = TEXT lib.mycontainer.10.value = Heute ist ein schöner Tag lib.mycontainer.20 < lib.mycontainer.10 weitere Syntax: ib.mycontainer = COA lib.mycontainer { 10 = TEXT 10 { value = Heute ist ein schöner Tag 20 < lib.mycontainer.10 5

6 Conditions (TS-Setup) Syntax: [eigenschaft = wert], wenn wahr, dann werden die nachfolgenden Zeilen ausgewertet bis zur Definition von [end] oder [global] Operatoren: && = und, = oder Beispiele: [browser = msie] && [version = <8] (dieses Condition kann als Ersatz der Conditional Comments verwendet werden) [treelevel = levelnumber, levelnumber, ] Referenz zu Conditions: doc_core_tsref/4.1.0/view/4/1/ 6

7 stdwrap (TS-Setup) sehr mächtige Klasse, die von vielen cobjects vererbt wird (z.b. cobject TEXT) Daten dynamisch auslesen z.b. mit der Eigenschaft field (Datenbankfelder) lib.myobject = TEXT lib.myobject { field = SYS_LASTCHANGED date = d.m.y weitere Bedingungen machbar Bsp.: lib.myobject.if.istrue.field = header Referenz zu stdwrap: references/doc_core_tsref/4.1.0/view/5/1/ 7

8 Ein Menü erstellen (TS-Setup) Syntax: [eigenschaft = wert], wenn wahr, dann werden die nachfolgenden Zeilen ausgewertet bis zur Definition von [end] oder [global] lib.topnav = HMENU lib.topnav { li> special = directory special.value = 11 1 = TMENU 1.wrap = <ul class= nav > </ul> 1{ # no: normal state NO{ wrapitemandsub = <li> &#124</li> * <li> &#124</li> * <li> </ wrapitemandsub = <li> &#124</li> 8

9 Ein Menü erstellen (TS-Setup) # act: state for menu items which are found in the rootline ACT = 1 ACT{ wrapitemandsub = <li> &#124</li> * <li> &#124</li> * <li> </ li> ATagParams = class="menu-item-active" ATagTitle.field = description // subtitle // title # cur: state for the current page CUR{ wrapitemandsub = <li> &#124</li> * <li> &#124</li> * <li> </ li> 9

10 Page TS-Config / User TS-Config Page TS-Config dient der Konfiguration von Seitenbereichen (Eigenschaften werden vererbt) Rich Text Editor wird hier konfiguriert, Beispiel: RTE.default.contentCSS = fileadmin/templates/rte.css RTE.default.proc.allowTags = h1, h2, h3, h4, div, p, br, span, ul, ol, li RTE.default.proc.denyTags = font, img Bestimmte Überschrifttypen ausschalten: TCEFORM.tt_content.header_layout.removeItems = 1,6,7,8,9,10,100 User TS-Config dient der Konfiguration auf Benutzer bzw. Benutzergruppenbasis options.disabledelete = 1 Alle Eigenschaften der Page TS-Config können auch über User TS-Config festgelegt werden page.tcemain.table.pages.disableprependatcopy = 1 10

11 Referenz / Literatur Referenzen TSREF (für s Template Setup): doc_core_tsref/4.1.0/view/toc/0/ Page TS-Config: doc_core_tsconfig/4.1.0/view/1/3/ User TS-Config: doc_core_tsconfig/4.1.0/view/1/2/ Literatur Ebook: TYPO3-final.pdf 45 Minuten Typoscript: 11