TypoScript von Anfang an

Transkript

1 TypoScript von Anfang an Spaß an und mit TypoScript Patrick Lobacher

2 Zitat Kaspar Skårhøj TypoScript was based on the clear whish from me, that TYPO3 had to be flexible enough for any website I could dream up. (Oktober 2007)

3 Vorurteile über TypoScript TypoScript ist kompliziert TypoScript ist unlogisch TypoScript brauche ich nicht wirklich TypoScript ist etwas für Programmierer TypoScript ist ein notwendiges Übel

4 Vorurteile über TypoScript TypoScript ist kompliziert TypoScript ist unlogisch Stimmt ja gar nicht!! (naja, zumindest nicht alles...) TypoScript brauche ich nicht wirklich TypoScript ist etwas für Programmierer TypoScript ist ein notwendiges Übel

5 Die Wahrheit dagegen ist TypoScript ist extrem leistungsfähig TypoScript ist relativ einfach zu lernen Für TypoScript werden keinerlei Programmierkenntnisse vorausgesetzt TypoScript ist genau DER Unterschied zu anderen CMS wie Joomla oder Drupal TypoScript kann sogar Spaß machen

6 Wo wird TypoScript genau verwendet? Start einer gerade eben installierten TYPO3-Instanz: Es fehlen offensichtlich Seiten...

7 Wo wird TypoScript genau verwendet? Nach dem Anlegen der Seiten: Missverständliche Meldung! Es gibt TypoScript-Templates und HTML-Templates

8 Wo wird TypoScript genau verwendet? Anlegen eines Templates im Backend

9 Wo wird TypoScript genau verwendet? Template-Tools

10 Wo wird TypoScript genau verwendet? Inhalt des Feldes Setup : # Default PAGE object: page = PAGE page.10 = TEXT page.10.value = HELLO WORLD! Ausgabe der Seite ist HELLO WORLD!

11 TypoScript-Templates Ein TypoScript-Template kann einer Seite zugeordnet werden und wird nach unten vererbt (kaskadieren) Eine weiteres TypoScript-Template kann ein anderes überschreiben Extensions können auch eigene TypoScript-Templates einbringen

12 Die Definition von TypoScript TypoScript bildet mithilfe von Plaintext und einer gegebenen Syntax hierarchische Informationen in ein multidimensionales assoziative PHP- Array ab.

13 Die Definition von TypoScript TypoScript bildet mithilfe von Plaintext und einer gegebenen Syntax hierarchische Informationen in ein multidimensionales assoziatives PHP- Array ab.

14 Allgemeine Syntax Eine Standard-Codezeile sieht wie folgt aus : objektpfad operator wert Ausnahme: Includes und Conditions

15 Allgemeine Syntax Im Objektpfad werden die einzelnen Bestandteile (sofern vorhanden) mittels Punkt getrennt. Dies stellt die Hierachie dar. Beispiele: objekt1 = wert1 objekt2.eigenschaft2 = wert2 objekt3.eigenschaft3.eigenschaft3 = wert3 objekt4.eigenschaft4.objekt4 = wert4

16 Assoziatives Array? INHALT = CONTENT INHALT { table = tt_content select.orderby = sorting select.where = colpos = 1 select.languagefield = sys_language_uid } INHALT = CONTENT INHALT.table = tt_content INHALT.select.orderBy = sorting INHALT.select.where = colpos = 1 INHALT.select.languageField = sys_language_uid $GLOBALS['TSFE'][ INHALT ] = CONTENT ; $GLOBALS['TSFE'][ INHALT. ][ table ] = tt_content; $GLOBALS['TSFE'][ INHALT. ][ select. ][ orderby ] = sorting ; $GLOBALS['TSFE'][ INHALT. ][ select. ][ where ] = colpos = 1 ; $GLOBALS['TSFE'][ INHALT. ][ select. ][ where ][ languagefield ] = sys_language_uid ;

17 Assoziative multidimensionale Variablen

18 Was macht TYPO3 damit? $GLOBALS['TSFE'][ INHALT ] = CONTENT ; $GLOBALS['TSFE'][ INHALT. ][ table ] = tt_content; $GLOBALS['TSFE'][ INHALT. ][ select. ][ orderby ] = sorting ; $GLOBALS['TSFE'][ INHALT. ][ select. ][ where ] = colpos = 1 ; $GLOBALS['TSFE'][ INHALT. ][ select. ][ where ][ languagefield ] = sys_language_uid ; function CONTENT($conf) { $originalrec = $GLOBALS['TSFE']->currentRecord; if ($conf['table']=='pages' substr($conf['table'],0,3)=='tt_' substr($conf['table'],0,3)=='fe_' substr($conf['table'],0,3)=='tx_' substr($conf['table'],0,4)=='ttx_' substr($conf['table'],0,5)=='user_') { do { $res = $this->exec_getquery($conf['table'],$conf['select.']);

19 Konsequenzen TypoScript ist keine Sprache, es dient der Konfiguration Unbekannte TypoScript-Teile werden schlicht ignoriert => keine Fehlermeldung Durch TypoScript wird PHP-Code ausgeführt Der zuletzt gesetzte Wert ist gültig (manchmal schwierig herauszufinden)

20 Interne TypoScript- Speicherung Die Variable $GLOBALS[ TSFE ] enthält die komplette TypoScript-Konfiguration Ausgabe durch print_r($globals[ TSFE ] ); Beschreiben ist ebenfalls möglich, z.b. : $GLOBALS['TSFE']->pSetup['bodyTagAdd'] = 'onload="load()" onunload="gunload()';

21 Verarbeitung von TypoScript TYPO3-Backend INHALTE Was... TypoScript TSFE TypoScript FrontEnd TYPO3-Frontend DARSTELLUNG Wie...

22 Syntax - Operatoren objektpfad operator wert = Zuweisen [page = PAGE] := Modifikation [page.10 := appendstring( Test )] > Löschen [page.10 >] < Kopieren [ACT <.NO] =< Referenz

23 Syntax - Kommentare Es gibt mehrere Möglichkeiten, Kommentare in den Code zu bringen # Das ist ein Kommentar // Das ist auch ein Kommentar / Es ist sogar nur ein Slash notwenig /* Und mehrzeilige Kommentare sind auch möglich */

24 Syntax - Ausklammern Verkürzt den Code, erhöht die Übersichtlichkeit Lediglich andere Schreibweise INHALT = CONTENT INHALT.table = tt_content INHALT.select.orderBy = sorting INHALT.select.where = colpos = 1 INHALT.select.languageField = sys_language_uid INHALT = CONTENT INHALT { table = tt_content select.orderby = sorting select.where = colpos = 1 select.languagefield = sys_language_uid }

25 Syntax - Wraps Ein Wrap legt sich wie eine Hülle um einen Wert page.10 = TEXT page.10.value = TYPO3camp page.10.wrap = <h3> </h3> # Resultat ist nun # <h3>typo3camp</h3>

26 Top Level Objekte (TLO) TLOs sind vordefiniert und werden von TypoScript zur Verfügung gestellt TLO übernehmen die Konfiguration Die bekanntesten TLOs sind: CONFIG (Konfiguration des TYPO3-Systems) PAGE (Konfiguration und Darstellung einer Seite)

27 TLO - PAGE Inhalt des Feldes Setup : # Default PAGE object: page = PAGE page.10 = TEXT page.10.value = HELLO WORLD! Die möglichen Eigenschaften des TLO PAGE müssen nachgesehen werden

28 Gibt es eine Übersicht? TypoScript Reference Vorteil: Aktuell Nachteil: Englisch und teilweise etwas unübersichtlich

29 Gibt es eine Übersicht? TypoScript Kurz&Gut Vorteil: Deutsch, Übersichtlich, enthält TS der wichtigsten Extensions Nachteil: Naturgemäß weniger aktuell ACHTUNG! Unverschämte Eigenwerbung :-)

30 Eigenschaften des TLO PAGE

31 cobject (cobj / Content Objekte) Bringen die Inhalte ins System Die bekanntesten cobjects sind: CARRAY (Content-Array, 1,2,3,4 bei PAGE-TLO) CONTENT (liest Inhalte aus der Datenbank) HTML / TEXT (Texte) FORM (Formulare) IMAGE / IMG_RESOURCE (Bilder) TEMPLATE (HTML-Templates)

32 cobject - TEXT Inhalt des Feldes Setup : # Default PAGE object: page = PAGE page.10 = TEXT page.10.value = HELLO WORLD! Die möglichen Eigenschaften des cobject TEXT müssen nachgesehen werden

33 Eigenschaften des cobjects TEXT

34 Beispiel: Inhalte ausgeben page = PAGE page { typenum = 0 10 = CONTENT 10 { table = tt_content select.orderby = sorting select.where = colpos = 0 select.languagefield = sys_language_uid wrap = <div id= content> </div> } }

35 Beispiel: Marker füllen page = PAGE page { typenum = 0 meta.author = Patrick Lobacher stylesheet = fileadmin/typo3camp.css 10 = TEMPLATE 10.template = FILE 10.template.file = fileadmin/typo3camp.html 10.workOnSubpart = DOCUMENT 10.marks { MENU < lib.mainmenu } }

36 Beispiel: Marker füllen - Template <html xmlns=" xml:lang="en" > <head> <title>typo3camp</title> </head> <body> <!-- ###DOCUMENT### begin --> <div id="menu"> ###MAINMENU### </div> <!-- ###DOCUMENT### end --> </body> </html>

37 Beispiel: Menü lib.mainmenu = HMENU lib.mainmenu { 1 = TMENU 1.wrap = <ul class= ebene1 > </ul> 1.NO.allWrap = <li> </li> 1.ACT = 1 1.ACT.wrapItemAndSub = <li> </li> 2 <.1 2.wrap = <ul class= ebene2 > </ul> 3 <.2 3.wrap = <ul class= ebene3 > </ul> }

38 Beispiel: Menü -Ausgabe <ul class= ebene1 > <li>menüpunkt 1</li> <li>menüpunkt 2 <ul class= ebene2 > <li>menüpunkt 2-1</li> <li>menüpunkt 2-2</li> </ul> <li>menüpunkt 3</li> </ul> Menüpunkt 1 Menüpunkt 2 Menüpunkt 2-1 Menüpunkt 2-2 Menüpunkt 3

39 Weitere Informationen: TypoScript Reference TSref TypoScript in 45 Minuten (DocTeam) Übersetzung der TSref TypoScript Videotraining (video2brain)

40 Vielen Dank! Fragen???