Unterschiede
Hier werden die Unterschiede zwischen zwei Versionen angezeigt.
— | typoscript_config [2023.12.12 16:02] (aktuell) – angelegt - Externe Bearbeitung 127.0.0.1 | ||
---|---|---|---|
Zeile 1: | Zeile 1: | ||
+ | ====== TypoScript Konfiguration ====== | ||
+ | Die Konfiguration von TYPO3 kann man direkt in der Datenbank seiner Installation abspeichern. Dieses klassische Vorgehen ist allerdings aus der Mode gekommen, denn es hat sich als besser erwiesen, die Konfiguration in einer Datei abzuspeichern und diese Datei über ein '' | ||
+ | |||
+ | === Vorteile der Einbindung einer Textdatei === | ||
+ | |||
+ | |||
+ | * Man kann unterschiedliche Konfigurationen der Webseite abspeichern. So kann man einfach zwischen Entwicklungsumgebung mit ausgeschaltetem Cache und der Live-Umgebung mit standardisiertem Cache unterscheiden. | ||
+ | * Die verschiedenen Stände der TypoScript Entwicklung lassen sich per GIT oder anderem Tool versionieren. | ||
+ | * Die gesamte Konfiguration lässt sich in einer Provider Extension packen, so dass diese nicht wie im fileadmin von außen einsehbar ist. | ||
+ | |||
+ | === Speichern von Konstanten === | ||
+ | |||
+ | Konstanten hingegen kann man wie gewohnt in der Datenbank speichern. Dies ist vor allem im Hinblick auf die Angabe der Domain und der URL der Webseite sinnvoll, die an dieser Stelle hinterlegt werden kann. | ||
+ | ===== TypoScript config (klassisch) ===== | ||
+ | |||
+ | Beispiel für eine Konfiguration mit TS für die config. | ||
+ | |||
+ | config { | ||
+ | xmlprologue | ||
+ | uniqueLinkVars | ||
+ | linkVars | ||
+ | absRefPrefix | ||
+ | cache_period | ||
+ | no_cache | ||
+ | | ||
+ | ## Character sets | ||
+ | renderCharset | ||
+ | metaCharset | ||
+ | | ||
+ | ## Sys Variablen | ||
+ | ## Ab der Version LTS v9.5 von TYPO3 sind Sprachvariablen nicht mehr nötig | ||
+ | sys_language_uid | ||
+ | sys_language_overlay = 1 | ||
+ | sys_language_mode | ||
+ | language | ||
+ | locale_all | ||
+ | htmlTag_langKey | ||
+ | | ||
+ | ## META Angaben | ||
+ | pageTitleFirst | ||
+ | noPageTitle | ||
+ | sendCacheHeaders | ||
+ | message_page_is_being_generated = Die angeforderte Seite wird Ihnen gleich angezeigt. | ||
+ | | ||
+ | spamProtectEmailAddresses = 2 | ||
+ | spamProtectEmailAddresses_atSubst = (at) | ||
+ | | ||
+ | ## RealURL Configuration | ||
+ | tx_realurl_enable | ||
+ | simulateStaticDocuments = 0 | ||
+ | } | ||
+ | | ||
+ | ===== TypoScript config (ab TYPO3 LTS v9.5) ===== | ||
+ | |||
+ | Weite Teile der Konfiguration einer TYPO3 Webseite ab der Version 9.5 werden über das Modul '' | ||
+ | Ebenso benötigt man die Extension '' | ||
+ | |||
+ | |||
+ | config { | ||
+ | xmlprologue | ||
+ | uniqueLinkVars | ||
+ | linkVars | ||
+ | absRefPrefix | ||
+ | cache_period | ||
+ | no_cache | ||
+ | | ||
+ | ## Character sets | ||
+ | renderCharset | ||
+ | metaCharset | ||
+ | | ||
+ | ## META Angaben | ||
+ | sendCacheHeaders | ||
+ | message_page_is_being_generated = Die angeforderte Seite wird Ihnen gleich angezeigt. | ||
+ | | ||
+ | spamProtectEmailAddresses = 2 | ||
+ | spamProtectEmailAddresses_atSubst = (at) | ||
+ | } | ||
+ | | ||
+ | | ||
+ | ===== Variablen der Konfiguration ===== | ||
+ | |||
+ | Hier finden Sie einige Variablen der Konfiguration, | ||
+ | |||
+ | ==== Cache==== | ||
+ | |||
+ | TYPO3 verfügt über einen sehr leistungsfähigen '' | ||
+ | Was sich für Besucher und SEO als Segen erweist, wird für Entwickler jedoch oft zum Fluch. Denn wenn man an einer Webseite entwickelt, muss man bei jedem Seitenaufruf zum Testen der Entwicklung den Cache löschen. | ||
+ | Es gibt hier jedoch eine Abhilfe. In der Konfiguration (Beispiele siehe oben) kann man zwischen Entwicklungs- und Live-Umgebung unterschiedliche Stände des Cache angeben. | ||
+ | * Die Variable '' | ||
+ | * Die Variable '' | ||
+ | |||
+ | **Entwicklung: | ||
+ | config { | ||
+ | cache_period | ||
+ | no_cache | ||
+ | } | ||
+ | | ||
+ | **Live:** | ||
+ | config { | ||
+ | cache_period | ||
+ | no_cache | ||
+ | } | ||
+ | | ||
+ | **Bitte beachten Sie:** Beim Livegang einer Webseite bitte **unbedingt** überprüfen, | ||
+ | |||
+ | ==== CSS und JS komprimieren==== | ||
+ | |||
+ | Im Bestreben, Google glücklich zu machen und die Ladezeiten einer Webseite zu verringern, bietet TYPO3 von Haus aus die Möglichkeit, | ||
+ | \\ Auch können alle jeweils ausgelieferten Dateien zu einer Datei zusammengefasst werden. Dies wird über die Befehle '' | ||
+ | \\ Was gut für SEO ist, erweist sich als Fluch für Entwickler. Denn sobald man in den Quelltext der Anwendung geht bzw. sobald man den Code Inspektor seines Browsers aufruft, landet man in einer unendlich langen Zeile eines sehr komprimierten Quelltextes. Daher sollte man für beide Variablen unterschiedliche Einstellungen wählen - und diese am besten bei den '' | ||
+ | |||
+ | **Entwicklung: | ||
+ | |||
+ | config { | ||
+ | compressCss | ||
+ | concatenateCss | ||
+ | compressJs | ||
+ | concatenateCJs | ||
+ | } | ||
+ | |||
+ | **Live: | ||
+ | |||
+ | config { | ||
+ | compressCss | ||
+ | concatenateCss | ||
+ | compressJs | ||
+ | concatenateCJs | ||
+ | } | ||
+ | ==== Eigener Kommentar im TYPO3 Header==== | ||
+ | | ||
+ | Wer in den Quelltext einer TYPO3-Webseite blickt, wird dort immer den Standard-Kommentar der jeweiligen Version seines Systems entdecken. Diesen Kommentar kann kann mit einem eigenen Text ergänzen. Wer ASCII Grafiken beherrscht, kann an dieser Stelle seiner Phantasie freien Lauf lassen! Sonst ist dies der richtige Platz, um neugierige Besucher mit der Adresse der Agentur zu versorgen oder den Besucher zu einer Bewerbung aufzufordern. | ||
+ | | ||
+ | headerComment ( | ||
+ | Dies ist ein Text | ||
+ | Denn dies ist die beste Webseite aller Zeiten! | ||
+ | ) | ||
+ | | ||
+ | ===== Neue Einbindung TypoScript ab TYPO3 9.5 ===== | ||
+ | |||
+ | Die bisherige Syntax zur Einbindung von Dateien in TypoScript erfolgte über den INCLUDE Befehl. Dieser ist in allen Versionen von TYPO3 bis einschließlich der Version 9.5 lauffähig. Allerdings ist er nicht die Zukunft. | ||
+ | |||
+ | Bisherige Einbindung einer TypoScript Datei: | ||
+ | |||
+ | < | ||
+ | |||
+ | INCLUDE_TYPOSCRIPT wird in folgenden Versionen von TYPO3 durch @import ersetzt. Hier gilt folgende Syntax: | ||
+ | |||
+ | |||
+ | Import einer **einzelnen Datei** | ||
+ | |||
+ | @import " | ||
+ | |||
+ | Import **mehrerer Dateien** eines Verzeichnisses in Reihenfolge ihres Namens | ||
+ | |||
+ | @import " | ||
+ | |||
+ | Import **aller Dateien** eines Verzeichnisses | ||
+ | |||
+ | @import " | ||
+ | |||
+ | ===== Neue Dateiendung .typoscript ab TYPO3 9.5 ===== | ||
+ | |||
+ | Ab der Version LTS v9.5 ist die alte Dateiendung .ts für TypoScript weiterhin nutzbar. Es ist jedoch nun auch möglich, die Dateiendung .typoscript zu nutzen. | ||
+ | |||
+ | ===== CK Editor konfigurieren ===== | ||
+ | |||
+ | |||
+ | Der CK Editor kommt in der normalen Konfiguration des TYPO3 Backend mit allen Elementen, die man für die tägliche redaktionelle Arbeit braucht. Es ist aber einfach möglich, den Editor über das Seiten Config zu erweitern. | ||
+ | |||
+ | Dazu geht man in den Seiteneigenschaften in den Reiter Ressourcen und das Feld Seiten TS-Config. Dort kann man die Konfiguration erweitern: | ||
+ | |||
+ | RTE.default.preset = full | ||
+ | ===== Beispiel für ein Backend Layout ===== | ||
+ | |||
+ | |||
+ | backend_layout { | ||
+ | colCount = 2 | ||
+ | rowCount = 5 | ||
+ | rows { | ||
+ | 1 { | ||
+ | columns { | ||
+ | 1 { | ||
+ | name = Text mit Inhalt | ||
+ | rowspan = 3 | ||
+ | colPos = 10 | ||
+ | } | ||
+ | 2 { | ||
+ | name = Kasten Titel | ||
+ | rowspan = 2 | ||
+ | colPos = 11 | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | 3 { | ||
+ | columns { | ||
+ | 1 { | ||
+ | name = Kasten Text | ||
+ | colPos = 12 | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | 4 { | ||
+ | columns { | ||
+ | 1 { | ||
+ | name = Text ganze Zeile | ||
+ | colspan = 2 | ||
+ | colPos = 13 | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | 5 { | ||
+ | columns { | ||
+ | 1 { | ||
+ | name = Spalte unten links | ||
+ | colPos = 14 | ||
+ | } | ||
+ | 1 { | ||
+ | name = Spalte unten rechts | ||
+ | colPos = 15 | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | } | ||
+ | |