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}
Lange haben wir darauf gewartet – nun ist sie endlich verfügbar: Die neue LTS Version von Typo3 in der Version 9.5.
Typo3 9 LTS kommt mit ein paar wirklich nützlichen Features. Als wichtigste Neuerung ist wohl die Funktion „Speaking Urls“ hervorzuheben. Es ist nun ohne zusätzliche Plugins (wie z.B. RealURL) möglich, schöne Urls zu generieren – diese Funktion wurde nämlich mit Typo3 9.5 endlich in den Typo3 Core integriert.
Neben der schönen Generierung von Urls, das ja für Suchmaschinenoptimierung auch wichtig ist sind auch weitere Maßnahmen in dieser Richtung umgesetzt worden.
Es wurde den Seiteneigenschaften ein eigener Reiter für dieses Thema spendiert – dieser vereint schon vorhandene Felder mit neuen. Es gibt eine neue Meta-Tag-API sowie eine Seitentitel-API, ebenso können XML-Sitemaps generiert werden.
Im neuen Modul „Sites“ können Einstellungen für Sprachen, Einstiegspunkte, Redirects u.v.m. für einzelne Sites innerhalb der Typo3 Installation definiert werden.
Das „Install Tool“ wurde nun komplett in das Typo3 Backend integriert – und in 4 neue Module aufgeteilt:
Alles in allem finde ich, dass die neue LTS Version Typo3 9.5 ein sehr gelungenes Update ist. Es wartet mit ein paar echten Verbesserungen auf – ich werde wohl mit demnächst mit passenden Projekten die ersten Upgrades von Typo3 8.x auf die Typo3 9.5 LTS angehen.
Der eine oder andere dürfte es vielleicht noch nicht umgesetzt haben und ist auf der Suche nach einer einfachen Integration des Cookie Consent bzw. einer Cookie Bar in Typo3 um die DSGVO zu erfüllen.
Sehr schön habe ich folgende Lösung von https://cookieconsent.insites.com gefunden. Und diese ist leicht mittels Typoscript zu integrieren:
|
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 |
###################################################### # Cookie Notice # https://cookieconsent.insites.com/download/ ###################################################### page.headerData.123 = TEXT page.headerData.123.value ( <link rel="stylesheet" type="text/css" href="//cdnjs.cloudflare.com/ajax/libs/cookieconsent2/3.0.3/cookieconsent.min.css" /> <script src="//cdnjs.cloudflare.com/ajax/libs/cookieconsent2/3.0.3/cookieconsent.min.js"></script> <style> ... hier kann man noch eigene Styles für DIVs definieren wenn man möchte </style> <script> window.addEventListener("load", function(){ window.cookieconsent.initialise({ "palette": { "popup": { "background": "#444444", "text": "#efefef" }, "button": { "background": "#89bb16", "text": "#fff" } }, "theme": "classic", "content": { "message": "Um unsere Webseite für Sie optimal zu gestalten und verbessern zu können, verwenden wir Cookies. Durch die Nutzung der Webseite stimmen Sie deren Verwendung zu.", "dismiss": "OK", "link": "Zur Datenschutzerklärung", "href": "/datenschutzerklaerung/" } })}); </script> ) |
Die externen JS und CSS müssten um die DSGVO zu erfüllen lokal gespeichert werden.
Das ganze funktioniert auch mit mehreren Sprachen – dann einfach obigen Code nochmal reinkopieren, Texte in andere Sprache ändern und folgende Typoscript-Condition um den Code einfügen:
|
1 2 3 |
[globalVar = GP:L = 1] {-- Code von oben nur Textausgabe in anderer Sprache --} [global] |
Noch nicht final geklärt ist ja die Frage, ob ein reines Informieren der User über die Cookies ausreicht, oder ob diese erst gesetzt werden dürfen, wenn der User aktiv anklickt, dass Cookies erlaubt sind.
Auch das wäre mit Cookie Consent möglich – es gibt eine Opt-in und Opt-out Funktion.
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/ } } |
Mit Typo3 8 wurde Fluid als Standalone Plugin weiterentwickelt und einigen Änderungen und Erweiterungen unterzogen. Da die Frage immer wieder mal auftaucht – hier eine kurze Übersicht die der if Viewhelper in Typo3 Fluid aufgebaut ist. Einmal in Typo3 7 und früher, einmal in Typo3 ab Version 8.
Hier gab es das elseif-Konstrukt noch nicht, und man musste die if-Conditions in der Regel verschachteln:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
<f:if condition="{variable} == 'bestimmterWert'"> <f:then> // dann führe folgendes aus </f:then> <f:else> <f:if condition="{andereVariable} == 'bestimmterWert'"> <f:then> // dann führe folgendes aus </f:then> <f:else> // dann führe diese Anweisungen aus </f:else> </f:if> </f:else> </f:if> |
Eine Ausnahme gab es, um ohne die if-Verschachtelung auszukommen – man konnte via Arrays die logische UND-Verknüpfung (&&) wie folgt nachbauen, und sich somit das Verschachteln der if-Anweisungen sparen:
|
1 2 3 |
<f:if condition="{0: jahre, 1: monate} == {0: vergleichsJahr, 1: vergleichsMonat}"> // dann führe folgendes aus </f:if> |
|
1 2 3 4 5 6 7 8 9 10 11 |
<f:if condition="{variable} == 'bestimmterWert'"> <f:then> // dann führe folgendes aus </f:then> <f:else if="{andereVariable} == 'bestimmterWert'"> // dann führe folgendes aus </f:else> <f:else> // für den Rest führe folgendes aus.. </f:else> </f:if> |
Möglich ist auch, diese Abfragen mit logischen UND bzw. ODER in kürzerer Schreibweise zu schreiben:
|
1 2 3 4 |
<f:if condition="({variableOne} && {variableTwo}) || {variableThree} || {variableFour}"> // Done if both variable one and two evaluate to true, // or if either variable three or four do. </f:if> |
Weitere Beispiele:
|
1 2 3 4 |
<f:if condition="{variable} || {andereVariable}"> // dann führe folgendes aus </f:if> |
Ist wahr, wenn eine der beiden Variablen gesetzt ist.
If – Abfragen können auch inline geschrieben werden. Das ist z.B. sinnvoll, wenn in Fluid-Templates je nach gesetzten Variablen oder bei bestimmten Varialben-Werten bestimmte CSS-Klassen ausgegeben werden sollen.
Beispielsweise wenn im Backend bei Inhaltselementen im Reiter „Erscheinungsbild“ bestimmte Layouts, Frames oder Abstände ausgewählt werden.
Hier die generelle Schreibweise:
|
1 2 3 |
{f:if(condition: variable1, then: 'bestimmterWert')} // Hier wird "bestimmterWert" ausgegeben, wenn die Variable "variable1" gesetzt ist |
|
1 2 3 |
{f:if(condition: '{variable1} == "Yes"', then: 'bestimmterWert')} // Hier wird "bestimmterWert" ausgegeben, wenn die Variable "variable1" dem String "Yes" entspricht |
|
1 2 3 |
{f:if(condition: '{variable1} == 1', then: 'bestimmterWert')} // Hier wird die Variable "bestimmterWert" ausgegeben, wenn die Variable "variable1" der Zahl 1 entspricht. |
|
1 2 3 |
{f:if(condition: '{variable1} == 1', then: 'bestimmterWert', else: 'andererWert')} // Wenn die Variable "variable1" der Zahl 1 entspricht wird "bestimmterWert" ausgegeben, in allen anderen Fällen "andererWert". |
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 } |
Die Umstellung einer Domain auf SSL (also von http:// auf https:// ) ist normalerweise kein großes Problem. Ein paar Dinge gibt es doch zu beachten.
Gerade in einer Multi-Domain Installation von Typo3 müssen ein paar Dinge beachtet werden. Einige der Tipps, die man im Web so findet passen da nicht. Zum Beispiel werden oft .htaccess Snippets genannt die alle Domains innerhalb des Typo3 zum Beispiel von http:// auf https:// weiterleiten.
Zuallerst muss das SSL-Zertifikat bestellt und eingerichtet werden – nicht vergessen, den A-Record der Domain auf die neue IP zu mappen bei den DNS-Einstellungen.
In meinem Fall habe ich aber folgendes gebraucht:
Anmerkung:
Gerade die Weiterleitung von non-www auf https://www. sollte aus SEO-Gründen nicht verkettet passieren (also keine Weiterleitung von http://domain.com nach http://www.domain.com und dann nach https://www.domain.com) sondern in einem Rutsch.
Folgender Code bewerkstelligt diese Anforderungen:
|
1 2 3 |
<strong># Redirect von www zu https (non www wird via Typo3 weitergeleitet)</strong> RewriteCond %{HTTP_HOST} !^www.domain.com$ [NC] RewriteRule ^(.*)$ https://www.domain.com/$1 [L,R=301] |
Aber besser noch dieses Snippet: (danke an Gerald)
|
1 2 3 |
<strong># Redirect von www und non-www zu https</strong> RewriteCond %{SERVER_PORT} 80 RewriteRule ^(.*)$ https://www.mynode.at/$1 [R=301,L] |
Damit das Ganze auch richtig funktioniert, müssen in Typo auch noch ein paar Einstellungen gemacht werden:
|
1 |
TCAdefaults.pages.url_scheme = 2 |
|
1 2 |
config.absRefPrefix = https://www.domain.com/ config.baseURL > |
Das wars :-).
Mit FLUID kann man nun komplexe, verschachtelte und gruppierte Abfragen durchführen, wie zum Beispiel:
|
1 2 3 4 |
<f:if condition="({variableOne} && {variableTwo}) || {variableThree} || {variableFour}"> // Done if both variable one and two evaluate to true, // or if either variable three or four do. </f:if> |
Es gibt nun die Möglichkeit, bei IF-Abfragen auch elseif-Schleifen abzufragen:
|
1 2 3 4 5 6 7 8 9 10 11 12 |
<f:if condition="{variableOne}"> <f:then>Do this</f:then> <f:else if="{variableTwo}"> Do this instead if variable two evals true </f:else> <f:else if="{variableThree}"> Or do this if variable three evals true </f:else> <f:else> Or do this if nothing above is true </f:else> </f:if> |
Neuer ViewHelper: f:or
Damit kann man verkettete Abfragen schnell durchführen – die erste Variable die nicht leer ist wird ausgegeben:
|
1 |
{variableOne -> f:or(alternative: variableTwo) -> f:or(alternative: variableThree)} |