DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

Typical default configuration

This default configuration establishes default settings in Page TSconfig and User TSconfig with most commonly used features representing a good start for typical sites.

The following is inserted in Page TSconfig:

## Define labels and styles to be applied to class selectors in the interface of the RTE

## The examples included here make partial re-use of color scheme and frame scheme from CSS Styled Content extension

RTE.classes {
        align-left {
                name = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_tooltips.xlf:justifyleft
                value = text-align: left;
        }
        align-center {
                name = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_tooltips.xlf:justifycenter
                value = text-align: center;
        }
        align-right {
                name = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_tooltips.xlf:justifyright
                value = text-align: right;
        }
        csc-frame-frame1 {
                name = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_contentcss.xlf:frame-frame1
                value = background-color: #EDEBF1; border: 1px solid #333333;
        }
        csc-frame-frame2 {
                name = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_contentcss.xlf:frame-frame2
                value = background-color: #F5FFAA; border: 1px solid #333333;
        }
        important {
                name = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_contentcss.xlf:important
                value = color: #8A0020;
        }
        name-of-person {
                name = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_contentcss.xlf:name-of-person
                value = color: #10007B;
        }
        detail {
                name = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_contentcss.xlf:detail
                value = color: #186900;
        }
        component-items {
                name = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_contentcss.xlf:component-items
                value = color: #186900;
        }
        action-items {
                name = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_contentcss.xlf:action-items
                value = color: #8A0020;
        }
        component-items-ordered {
                name = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_contentcss.xlf:component-items
                value = color: #186900;
        }
        action-items-ordered {
                name = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_contentcss.xlf:action-items
                value = color: #8A0020;
        }
}

## Anchor classes configuration for use by the anchor accesibility feature

RTE.classesAnchor {
        externalLink {
                class = external-link
                type = url
                titleText = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_accessibilityicons.xlf:external_link_titleText
        }
        externalLinkInNewWindow {
                class = external-link-new-window
                type = url
                titleText = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_accessibilityicons.xlf:external_link_new_window_titleText
        }
        internalLink {
                class = internal-link
                type = page
                titleText = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_accessibilityicons.xlf:internal_link_titleText
        }
        internalLinkInNewWindow {
                class = internal-link-new-window
                type = page
                titleText = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_accessibilityicons.xlf:internal_link_new_window_titleText
        }
        download {
                class = download
                type = file
                titleText = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_accessibilityicons.xlf:download_titleText
        }
        mail {
                class = mail
                type = mail
                titleText = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_accessibilityicons.xlf:mail_titleText
        }
}

## Default RTE configuration

RTE.default {

## Markup options

enableWordClean = 1
removeTrailingBR = 1
removeComments = 1
removeTags = center, font, o:p, sdfield, strike, u
removeTagsAndContents = link, meta, script, style, title

## Toolbar options

## The TCA configuration may add buttons to the toolbar

showButtons = blockstylelabel, blockstyle, textstylelabel, textstyle
showButtons := addToList(formatblock, bold, italic, subscript, superscript)
showButtons := addToList(orderedlist, unorderedlist, outdent, indent, textindicator)
showButtons := addToList(insertcharacter, link, table, findreplace, chMode, removeformat, undo, redo, about)
showButtons := addToList(toggleborders, tableproperties)
showButtons := addToList(rowproperties, rowinsertabove, rowinsertunder, rowdelete, rowsplit)
showButtons := addToList(columninsertbefore, columninsertafter, columndelete, columnsplit)
showButtons := addToList(cellproperties, cellinsertbefore, cellinsertafter, celldelete, cellsplit, cellmerge)

## More toolbar options

keepButtonGroupTogether = 1

## Enable status bar

showStatusBar =  1

## Hide infrequently used block types in the block formatting selector

buttons.formatblock.removeItems = pre,address

## List all class selectors that are allowed on the way to the database

proc.allowedClasses = external-link, external-link-new-window, internal-link, internal-link-new-window, download, mail
proc.allowedClasses := addToList(align-left, align-center, align-right, align-justify)
proc.allowedClasses := addToList(csc-frame-frame1, csc-frame-frame2)
proc.allowedClasses := addToList(component-items, action-items)
proc.allowedClasses := addToList(component-items-ordered, action-items-ordered)
proc.allowedClasses := addToList(important, name-of-person, detail)
proc.allowedClasses := addToList(indent)

## Restrict the list of class selectors presented by the RTE to the following for the specified tags:

buttons.blockstyle.tags.div.allowedClasses = align-left, align-center, align-right
buttons.blockstyle.tags.div.allowedClasses := addToList(csc-frame-frame1, csc-frame-frame2)
buttons.blockstyle.tags.table.allowedClasses = csc-frame-frame1, csc-frame-frame2
buttons.blockstyle.tags.td.allowedClasses = align-left, align-center, align-right
buttons.textstyle.tags.span.allowedClasses = important, name-of-person, detail

## Configuration of classes for links

## These classes should also be in the list proc.allowedClasses

buttons.link.properties.class.allowedClasses = external-link, external-link-new-window, internal-link, internal-link-new-window, download, mail
buttons.link.page.properties.class.default = internal-link
buttons.link.url.properties.class.default = external-link-new-window
buttons.link.file.properties.class.default = download
buttons.link.mail.properties.class.default = mail

## Configuration specific to the TableOperations feature

## Remove the following fieldsets from the properties popups

disableAlignmentFieldsetInTableOperations = 1
disableSpacingFieldsetInTableOperations = 1
disableColorFieldsetInTableOperations = 1
disableLayoutFieldsetInTableOperations = 1

## Show borders on table creation

buttons.toggleborders.setOnTableCreation = 1

## Configuration specific to the bold and italic buttons

## Add hotkeys associated with bold and italic buttons

buttons.bold.hotKey = b
buttons.italic.hotKey = i

## Configuration of microdata schema

   schema {
                sources {
                        schemaOrg = EXT:rtehtmlarea/extensions/MicrodataSchema/res/schemaOrgAll.rdf
                }
        }
}

## front end RTE configuration for the general public

RTE.default.FE < RTE.default
RTE.default.FE.showStatusBar = 0
RTE.default.FE.hideButtons = chMode, blockstyle, textstyle, underline, strikethrough, subscript, superscript, lefttoright, righttoleft, left, center, right, justifyfull, table, inserttag, findreplace, removeformat, copy, cut, paste
RTE.default.FE.userElements >

## tt_content TCEFORM configuration

## Let use all the space available for more comfort.

TCEFORM.tt_content.bodytext.RTEfullScreenWidth = 100%

The following is inserted in User TSconfig:

## Enable the RTE by default for all users

setup.default.edit_RTE = 1