Typoscript-Konfiguration

Die Einstellung des RTE kann sowohl im Page TSconfig- als auch im User TSconfig-Bereich erfolgen. Das RTE Htmlarea-Handbuch dokumentiert die zahlreichen Möglichkeiten sehr ausführlich, für manchen Administrator aber auch etwas zu ausführlich... Mein Tipp: Sofern kein spezieller Grund dagegen spricht, vergessen Sie die User TSconfig und konzentrieren Sie sich auf die Page TSconfig. Dadurch fällt es Ihnen leichter, den Überblick zu behalten und außerdem ist es m.E. eher selten sinnvoll, das Rechtesystem von Typo3 bis auf die RTE-Ebene herunterzubrechen.

Für viele Typo3-Installationen ist es vollkommen ausreichend, in der Root-Seite des Internet-Auftritts alle RTE-relevanten Typoscript-Einstellungen vorzunehmen. Was Sie genau in den Seiteneigenschaften der Rootseite im Feld TSconfig eintragen, kann von Fall zu Fall variieren, als sinnvoll erscheint mir die folgende Konfiguration:

# RTE: Basis-Einstellungen
RTE.default{
  # CSS-Formatierung
  contentCSS = fileadmin/template/rte.css
  classesParagraph = einleitendes_Zitat,  Zitatblock, Codeblock, kleiner_Text
  classesCharacter = hervorgehobener_Text, gesperrter_Text
  classesTable = formatierte_Tabelle
  # classesTD =
  hidePStyleItems= H3,H4,H5,H6,PRE,address
  showTagFreeClasses = 1
  #Freigabe Tabellenkonfiguration
  disableAlignmentFieldsetInTableOperations = 0
  disableSpacingFieldsetInTableOperations = 0
  disableColorFieldsetInTableOperations = 0
  disableLayoutFieldsetInTableOperations = 0
  disableBordersFieldsetInTableOperations = 0
}

# RTE: Verarbeitungsoptionen
RTE.default.proc {
  allowedClasses = einleitendes_Zitat,  Zitatblock, Codeblock, kleiner_Text, hervorgehobener_Text, gesperrter_Text, formatierte_Tabelle
}

# RTE: Vor-Formatierung für Verlinkungen aufheben
RTE.classesAnchor {
    internalLink >
    externalLink >
    externalLinkInNewWindow >
    internalLinkInNewWindow >
    download >
    mail >
}

Die Typoscript-Konfiguration im Detail:

Der gesamte RTE-relevante Typoscript-Code ist in drei Blöcke unterteilt:

  • RTE.default: Hier legen Sie fest, in welcher Konfiguration sich der RTE für die Redakteure öffnet.
  • RTE.default.proc: Sobald Sie über den RTE eingegebene Inhalte abspeichern, greifen die Typo3-eigenen Verarbeitungsroutinen zu. Sowohl beim Schreiben in die Datenbank als auch beim Wiedereinlesen aus der Datenbank in den RTE wird Ihr Inhalt überprüft und gegebenenfalls entsprechend bestehender Vorgaben geändert. Die Kontrollroutinen von Typo3 lassen sich hier anpassen.
  • sonstiges: diverse Konfigurationsmöglichkeiten.

Die Basis-Konfiguration

Diese legen Sie innerhalb dieses Blockes fest:

RTE.default{
  [...]
}

Als erstes kümmern wir uns um die CSS-Einstellungen. Lassen Sie den Redakteuren keine zu lange Leine, was die textlichen Gestaltungsmöglichkeiten innerhalb der Homepage betrifft. Wenn jeder Redakteur Typ, Farbe und Größe der gewünschten Schrift frei bestimmen kann, könnte die gestalterische Einheitlichkeit Ihrer Web-Präsenz bald der Vergangenheit angehören. Professionell gestaltete Internet-Auftritte geben genau vor, welche Überschriften und Textformate in einer Homepage verwendet werden dürfen! Legen Sie mittels CSS genau fest, welche Formate Ihren Redakteuren zur Verfügung stehen sollen.

Der RTE überlässt Ihnen dabei die Entscheidung, ob eine CSS-Klasse ausschließlich absatzweise oder auch für kürzere Textsegmente innerhalb eines Absatzes angewendet werden darf. Zudem können Sie für jede Klasse festlegen, ob sie allgemein oder nur für bestimmte Tags (P, TD etc.) angewendet werden darf. Alle CSS-Klassen, die den Redakteuren zur Verfügung stehen sollen, definieren Sie am Besten in einer eigenen CSS-Datei, z.B. fileadmin/template/rte.css. Verwenden Sie unbedingt sprechende Klassenamen, um Redakteuren das Verständnis zu erleichtern. Selbstverständlich müssen die hier definierten Klassen auch spiegelbildlich in der CSS-Datei erscheinen, mit welcher Sie Ihre Typo3-basierte Homepage formatieren!

Der Aufbau der CSS-Datei ist verhältnismäßig simpel, entsprechend der gewünschten Zuordnungen definieren Sie die CSS-Klassen:

Beispiel: Inhaltsstruktur von rte.css

p.einleitendes_Zitat {
  [...]
}
[...]
span.hervorgehobener_Text {
  [...]
}
[...]
table.formatierte_Tabelle {
  [...]
}

Als nächstes binden wir die CSS-Datei in den RTE ein:

contentCSS = fileadmin/template/rte.css

Dann definieren wir die zugelassenen CSS-Formate für die entsprechenden HTML-Tags:

classesParagraph = einleitendes_Zitat, Zitatblock, Codeblock, kleiner_Text classesCharacter = hervorgehobener_Text, gesperrter_Text classesTable = formatierte_Tabelle
# classesTD =

Überschriften sollten Sie aus verschiedenen Gründen auch als solche behandeln, deshalb verwenden wir hier anstelle von CSS-Klassen die tatsächlichen HTML-Tags (Hx). Da Sie in der Regel aber nur 2 bis 3 Überschriftenebenen benötigen, blenden wir die übrigen ebenso wie sonstige vom RTE an dieser Stelle angebotenen Formate aus:

hidePStyleItems= H3,H4,H5,H6,PRE,address

Sofern Sie in Ihrer RTE-CSS-Datei Klassen definieren, die keinem Tag zugeordnet sind, müssen Sie diese explizit freigegeben:

showTagFreeClasses = 1

Eine Einstellung müssen wir noch vornehmen, dann ist die RTE-Oberfläche für unseren Standard-Anwendungsfall passend eingerichtet. Die Konfigurationsmöglichkeiten für Tabellen sind in unserer Einstellungsvariante relativ bescheiden. Hier weiten wir die Möglichkeiten des Redakteurs:

#Freigabe Tabellenkonfiguration
disableAlignmentFieldsetInTableOperations = 0
disableSpacingFieldsetInTableOperations = 0
disableColorFieldsetInTableOperations = 0
disableLayoutFieldsetInTableOperations = 0
disableBordersFieldsetInTableOperations = 0

 

Verarbeitungsoptionen

Nachdem Sie dem RTE diverse CSS-Klassen zugeordnet haben, müssen Sie nun noch dafür sorgen, dass Typo3 diese Klassen akzeptiert. In der Standardeinstellung löscht das CMS nämlich beim Speichern Ihrer Inhalte die Klassen-Attribute. Um das zu verhindern, tragen Sie die folgenden Zeilen ein:

# RTE: Verarbeitungsoptionen
RTE.default.proc {
  allowedClasses = einleitendes_Zitat,  Zitatblock, Codeblock, kleiner_Text, hervorgehobener_Text, gesperrter_Text, formatierte_Tabelle
}

 

Sonstiges

Als Abschluss unserer Typoscript-Einstellungen beseitigen wir noch die vorgegebenen CSS-Einstellungen für Verlinkungen. In Standard-Homepages werden diese nicht benötigt. Der classesAnchor-Ansatz ist durchaus sinnvoll, für unsere Standard-Konfiguration verwenden wir ihn aber nicht:

# RTE: Vor-Formatierung für Verlinkungen aufheben
RTE.classesAnchor {
    internalLink >
    externalLink >
    externalLinkInNewWindow >
    internalLinkInNewWindow >
    download >
    mail >
}


Impressum | Datenschutzerklärung