Typo3 Infos, Snippets und Beispielcodes
In einem aktuellen Typo3-Projekt benötigte ich bei einer Ausgabe in Fluid f:format.crop und f:format.raw gleichzeitig. In meinem Fall in der Typo3 Extension News.
Das schaut dann wie folgt aus:
|
1 |
{newsItem.bodytext -> f:format.crop(maxCharacters: '{settings.cropMaxCharacters}', respectWordBoundaries:'1') -> f:format.raw()} |
Im Typo3 Standard-Contentelement Filelinks (Deutsch: Dateilinks) werden nicht alle Standard-Icons angezeigt.
Um hier z.B. ein PDF-Icon anzuzeigen muss in folgender Datei:
|
1 |
ext:bootstrap_package/Resources/Private/Templates/ContentElements/Uploads.html |
In folgender Abfrage diese Zeile ergänzt werden:
|
1 2 3 4 5 |
<f:switch expression="{f:format.case(value: file.properties.extension, mode: 'lower')}"> ..... <strong><f:case value="pdf"><i class="far fa-file-pdf mr-2"></i></f:case></strong> ..... </f:switch> |
In meinem Fall habe ich natürlich nicht das Original-Template angepasst sondern das in meinem Override-Ordner.
Obige Code-Klasse funktioniert natürlich auch nur, wenn der Fontawesome Icon-Font eingebunden ist, er soll nur als Beispiel dienen.
An dieser simplen Aufgabe bin ich einige Zeit gesessen. Wenn man z.B. im DCE für die Backend-Fields die Möglichkeit braucht mehrere Optionen auszuwählen.
Die Aufgabenstellung bei mir war:
Für eine Gruppe von Autohäusern stehen drei Automarken zu Verfügung. Für jeden Standort sollten die angebotenen Marken am Standort gewählt werden können.
Ich habe das Content Element mit der Extension DCE, die ich wirklich gerne verwende, erstellt. Als Feld habe ich ein Select-Feld verwendet, definiert als manuelle Liste mit drei Einträgen:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
<config> <type>select</type> <items type="array"> <numIndex index="0" type="array"> <numIndex index="0">Peugeot</numIndex> <numIndex index="1">0</numIndex> </numIndex> <numIndex index="1" type="array"> <numIndex index="0">Citroen</numIndex> <numIndex index="1">1</numIndex> </numIndex> <numIndex index="2" type="array"> <numIndex index="0">Mazda</numIndex> <numIndex index="1">2</numIndex> </numIndex> </items> <minitems>0</minitems> <maxitems>3</maxitems> <dce_load_schema>1</dce_load_schema> </config> |
Im Fluidtemplate wollte ich die Abfrage mittels einem IF-Konstrukt lösen:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
<f:if condition="{field.hersteller} == 0"> <f:then> <img src="fileadmin/templates/pics/peugeot-logo.svg" /> </f:then> </f:if> <f:if condition="{field.hersteller} == 1"> <f:then> <img src="fileadmin/templates/pics/citroen-logo.svg" /> </f:then> </f:if> <f:if condition="{field.hersteller} == 2"> <f:then> <img src="fileadmin/templates/pics/mazda-logo.svg" /> </f:then> </f:if> |
Das klappte aber nicht – hat die manuelle Liste des Elementes mehr als zwei Optionen lässt sie sich mittels Fluid IF so nicht mehr abfragen. (Bei zwei Optionen kann auf wahr/falsch abgefragt werden.)
Und das klappte deswegen nicht, da ein Fluid-Debug zeigte, dass die Variable kein Array ist, sondern ein String:
|
1 |
hersteller => '0,1,2' (5 chars) |
Um diesen String nun umzuwandeln hilft dce:explode (danke an die Hilfe von Armin und Erik im #dce-Channel von Slack):
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
<f:for each="{field.hersteller -> dce:explode(delimiter:',')}" as="autologos"> <f:if condition="{autologos} == 0"> <f:then> <img src="fileadmin/templates/pics/peugeot-logo.svg" /> </f:then> </f:if> <f:if condition="{autologos} == 1"> <f:then> <img src="fileadmin/templates/pics/citroen-logo.svg" /> </f:then> </f:if> <f:if condition="{autologos} == 2"> <f:then> <img src="fileadmin/templates/pics/mazda-logo.svg" /> </f:then> </f:if> </f:for> |
Namespace nicht vergessen:
{namespace dce=ArminVieweg\Dce\ViewHelpers}
Der Typoscript Code um Templates zu überschreiben (override templates) hat sich geändert. Ich musste dies bei mir in Typo3 8.x ändern – und hab die Lösung erst nach einigem Suchen gefunden.
Die Typoscript lib hat sich geändert von lib.contentElement zu lib.fluidContent.
Richtig heisst der Typoscript-Code also um Templates in Fluid zu überschreiben:
|
1 2 3 4 5 6 7 8 9 10 11 |
lib.fluidContent { templateRootPaths { 200 = fileadmin/ABCDE/Resources/Private/Templates/ } partialRootPaths { 200 = fileadmin/ABCDE/Resources/Private/Partials/ } layoutRootPaths { 200 = fileadmin/ABCDE/Resources/Private/Layouts/ } } |
Ich setze bei meinen Projekten ganz gerne auf die Lösung von Stefan Schäfer / merec.org, um Spaltenelemente basierend auf Bootstrap 3 Klassen zu realisieren.
Aufgrund der Anforderung, dass die Redakteure das Aussehen der Inhalte, im speziellen Fall auch der Bootstrap Spalten, anpassen sollen, habe ich das Typoscript Setup von Stefan noch etwas erweitert bzw. geändert.
Die prinzipielle Struktur die ich gerne wollte war:
|
1 2 3 4 5 6 |
<div class="container> <div class="row undweitereKlassen"> <div class="col-md-6 usw">INHALTE</div> <div class="col-md-6 usw">INHALTE</div> </div> </div> |
Folgende Dinge soll der Redakteur beeinflussen können:
|
1 2 3 4 5 6 |
<div class="container> <-- bei 100% diesen DIV nicht rendern <div class="row undweitereKlassen"> <--- SpaceBefore, SpaceAfter Klassen, Hintergrundfarbe <div class="col-md-6 usw">INHALTE</div> <div class="col-md-6 usw">INHALTE</div> </div> </div> |
Ich habe also beim Typoscript Code von Stefan folgendes ergänzt (heller hinterlegte Zeilen):
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 |
plugin.tx_gridelements_pi1.setup.uebb_bootstrap_2col { preCObject = LOAD_REGISTER preCObject { containerClasses.cObject = COA containerClasses.cObject { 10 = TEXT 10 { value = equal-height fieldRequired = flexform_equalHeight noTrimWrap = | || } 11 = TEXT 11 { value = v-align-children fieldRequired = flexform_verticalAlign noTrimWrap = | || } 20 = TEXT 20 { field = flexform_visibility_element noTrimWrap = | || split { token = , cObjNum = 1 1.current = 1 1.noTrimWrap = | || } } 30 = CASE 30 { key.field = layout default = TEXT default.value = 1 = TEXT 1.value = 2 = TEXT 2.value = bg-primary 3 = TEXT 3.value = bg-secondary 4 = TEXT 4.value = bg-dark 5 = TEXT 5.value = bg-dark bg-dark2 noTrimWrap = | | | } 40 = CASE 40 { key.field = space_before_class default = TEXT default.value = extra-small = TEXT extra-small.value = frame-space-before-extra-small extra-small.noTrimWrap = | || small = TEXT small.value = frame-space-before-small small.noTrimWrap = | || medium = TEXT medium.value = frame-space-before-medium medium.noTrimWrap = | || large = TEXT large.value = frame-space-before-large large.noTrimWrap = | || extra-large = TEXT extra-large.value = frame-space-before-extra-large extra-large.noTrimWrap = | || } 50 = CASE 50 { key.field = space_after_class default = TEXT default.value = extra-small = TEXT extra-small.value = frame-space-after-extra-small extra-small.noTrimWrap = | || small = TEXT small.value = frame-space-after-small small.noTrimWrap = | || medium = TEXT medium.value = frame-space-after-medium medium.noTrimWrap = | || large = TEXT large.value = frame-space-after-large large.noTrimWrap = | || extra-large = TEXT extra-large.value = frame-space-after-extra-large extra-large.noTrimWrap = | || } stdWrap.insertData = 1 stdWrap.trim = 1 } containerAttributes.cObject = COA containerAttributes.cObject { 10 = TEXT 10 { data = register: containerClasses #noTrimWrap = | class="|"| noTrimWrap = | class="row |"| } } outerWrapContainerClasses.cObject = COA outerWrapContainerClasses.cObject { 40 = CASE 40 { key.field = frame_class default = TEXT default.value = <div class="container">|</div> no-frame = TEXT default.value = <div class="container">|</div> wide = TEXT wide.value = widebg = TEXT widebg.value = } } innerWrapContainerClasses.cObject = COA innerWrapContainerClasses.cObject { 10 = CASE 10 { key.field = frame_class default = TEXT default.value = no-frame = TEXT default.value = wide = TEXT wide.value = widebg = TEXT widebg.value = <div class="container">|</div> } } wrap = {register: innerWrapContainerClasses} wrap.insertData = 1 wrap2 = <div{register: containerAttributes} wrap>| </div> wrap2.insertData = 1 outerWrap = {register: outerWrapContainerClasses} outerWrap.insertData = 1 columns.0 { preCObject = LOAD_REGISTER preCObject { contentColumnClass.cObject = COA contentColumnClass.cObject { 10 = TEXT 10 { field = flexform_width_column_xs_1 noTrimWrap = || | required = 1 } 11 = TEXT 11 { field = flexform_width_column_sm_1 noTrimWrap = || | required = 1 } 12 = TEXT 12 { field = flexform_width_column_md_1 noTrimWrap = || | required = 1 } 13 = TEXT 13 { field = flexform_width_column_lg_1 noTrimWrap = || | required = 1 } 20 = TEXT 20 { field = flexform_visibility_col1 noTrimWrap = | || split { token = , cObjNum = 1 1.current = 1 1.noTrimWrap = | || } } stdWrap.noTrimWrap = | class="|"| } } outerWrap = <div{register: contentColumnClass}> | </div> outerWrap.insertData = 1 renderObj =< tt_content } columns.1 < .columns.0 columns.1 { preCObject { contentColumnClass.cObject { 10.field = flexform_width_column_xs_2 11.field = flexform_width_column_sm_2 12.field = flexform_width_column_md_2 13.field = flexform_width_column_lg_2 20.field = flexform_visibility_col2 } } } } plugin.tx_gridelements_pi1.setup.uebb_bootstrap_3col < plugin.tx_gridelements_pi1.setup.uebb_bootstrap_2col plugin.tx_gridelements_pi1.setup.uebb_bootstrap_3col { columns.2 < .columns.0 columns.2 { preCObject { contentColumnClass.cObject { 10.field = flexform_width_column_xs_3 11.field = flexform_width_column_sm_3 12.field = flexform_width_column_md_3 13.field = flexform_width_column_lg_3 20.field = flexform_visibility_col3 } } } } plugin.tx_gridelements_pi1.setup.uebb_bootstrap_4col < plugin.tx_gridelements_pi1.setup.uebb_bootstrap_3col plugin.tx_gridelements_pi1.setup.uebb_bootstrap_4col { columns.3 < .columns.0 columns.3 { preCObject { contentColumnClass.cObject { 10.field = flexform_width_column_xs_4 11.field = flexform_width_column_sm_4 12.field = flexform_width_column_md_4 13.field = flexform_width_column_lg_4 20.field = flexform_visibility_col4 } } } } tt_content.gridelements_pi1.20.10.setup { uebb_bootstrap_2col < plugin.tx_gridelements_pi1.setup.uebb_bootstrap_2col uebb_bootstrap_3col < plugin.tx_gridelements_pi1.setup.uebb_bootstrap_3col uebb_bootstrap_4col < plugin.tx_gridelements_pi1.setup.uebb_bootstrap_4col } |
Hat man in einer Typo3-Installation mehrere Domains laufen und publiziert News (via tt_news) auf mehreren Domains dann läuft man Gefahr, ein Duplicate-Content Problem bei Google zu bekommen.
Man kann mit folgendem Typoscript-Code bei der News ein Canonical Tag hinterlegen, und verweist somit auf eine „Haupt-Url“ der News:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
page.headerData.40 = TEXT page.headerData.40 { typolink.parameter.data = TSFE:id typolink.forceAbsoluteUrl = 1 typolink.returnLast = url typolink.additionalParams.cObject = COA typolink.additionalParams.cObject { 10 = TEXT 10.dataWrap = &tx_ttnews[tt_news]={GP:tx_ttnews|tt_news} 10.if.isTrue.data = GP:tx_ttnews|tt_news 20 = TEXT 20.dataWrap = &tx_ttnews[cat]={GP:tx_ttnews|cat} 20.if.isTrue.data = GP:tx_ttnews|cat } wrap = <link href="|" rel="canonical"> } |
Je nach Template kann es notwendig sein, beim Body-Tag bestimmte CSS-Klassen aus Typo3 auszugeben.
Dies kann z.B. mit folgendem Code bewerkstelligt werden, es können aber auch direkt in Typoscript schon Unterscheidungen getroffen werden:
Unterscheidung in HTML nach IE-Version:
|
1 2 3 4 5 6 7 8 |
page.bodyTagCObject = TEXT page.bodyTagCObject.value ( <!--[if lt IE 7 ]> <body class="ie6"> <![endif]--> <!--[if IE 7 ]> <body class="ie7"> <![endif]--> <!--[if IE 8 ]> <body class="ie8"> <![endif]--> <!--[if IE 9 ]> <body class="ie9"> <![endif]--> <!--[if (gt IE 9)|!(IE)]><!--> <body> <!--<![endif]--> ) |
Unterscheidung in Typoscript, hier wird z.B. die Seiten ID mitgegeben:
|
1 2 3 4 5 |
page.bodyTag > page.bodyTagCObject = TEXT page.bodyTagCObject.field = uid page.bodyTagCObject.wrap = <body id="blog-|"> |
Um schöne Teaser der Unterseiten in Typo3 anzeigen zu können kann man mittels Typoscript eine neue Darstellung des Menüs „Menü der Unterseiten inkl. Abstract“ erstellen. So ist eine Darstellung der Unterseiten mit Titel, Kurzbeschreibung und Bild (jeweils aus dem Seitenheader der Unterseiten) möglich:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 |
###################################################### # MENÜ DER UNTERSEITEN MIT BILD AUS PAGEHEADER ###################################################### tt_content.menu { 20 { 10 = HMENU 10 { special = directory #special = list #special.value.field = pages 1 = TMENU 1.wrap = | 1.NO { doNotLinkIt = 1 stdWrap.cObject = COA stdWrap.cObject { 10 = FILES 10 { references { table = pages fieldName = media } renderObj = IMAGE renderObj { file { width = 80c height = 65c maxW = 81c maxH = 66c # height 263c # width 155c import.data = file:current:publicUrl } altText.field = title imageLinkWrap = 1 imageLinkWrap { enable = 1 typolink.parameter.field = uid } } stdWrap.wrap = <div class="row"><div class="col-md-2">|</div> } 20 = TEXT 20.field = title 20.typolink.parameter.field = uid 20.wrap = <div class="col-md-10"><h3 class="subpage-teaser">|</h3> 30 = TEXT 30.field = abstract 30.wrap = <p>|</p></div></div> } } } } } |
Wer zu Anfangszeiten den Fehler gemacht hat, doppelte Zeilenschaltungen für Absätze zu machen und P-Tags auf Margin 0 zu setzen und das Problem nun beheben möchte, weil die P-Tags korrekt als Absätze definiert werden sollen der kann das in der MySQL Datenbank wie folgt machen:
Um zu sehen, ob auch alles korrekt funktioniert zuerst ein kleiner Test, wir ändern ein Wort ab:
|
1 |
UPDATE tt_content SET bodytext = REPLACE(bodytext, 'Informationen', 'Informatiionen') WHERE uid = 443 |
Ein kurzer Check ob es funktioniert hat:
|
1 |
SELECT * FROM `tt_content` WHERE bodytext LIKE '%Informatiionen%' ORDER BY `pid` ASC |
Wird hier die Änderung richtig angezeigt dann kann es los gehen. Mit folgendem Befehl werden ALLE doppelten Zeilenschaltungen für Textelemente der Spalte „bodytext“ in der Tabelle tt_content durch einfache ersetzt:
|
1 |
UPDATE tt_content SET bodytext = REPLACE(bodytext, '\r\n\r\n', '\r\n') |
Getestet auf einem Typo3 7.6 System.