RTE HTMLarea

classes.[classname]

Defines the classes available in the RTE. classname is the actual name of the style-class you are configuring. Notice you must specifically assign the classes to the various facilities also. See later.

Properties:

.name = label of the class (may be a reference to an entry in a localization file of the form LLL:EXT:[fileref]:[labelkey])

.value = the style for the class

.noShow = boolean; if set, the style of the class is not used to render it in the pop-up selector.

# specification of alternating classes for rows and/or columns of a table

.alternating {

    rows {

        startAt = int+ (default = 1)

        oddClass = class-name

        evenClass = class-name

        oddHeaderClass = class-name

        evenHeaderClass = class-name

    }

    columns {

        startAt = int+ (default = 1)

        oddClass = class-name

        evenClass = class-name

        oddHeaderClass = class-name

        evenHeaderClass = class-name

    }

}

# specification of counting classes for rows and/or columns of a table

.counting {

    rows {

        startAt = int (default = 1)

        rowClass = class-name (should not be a substring of other class names)

        rowLastClass = class-name

        rowHeaderClass = class-name (should not be a substring of other class names)

        rowHeaderLastClass = class-name

    }

    columns {

        startAt = int (default = 1)

        columnClass = class-name(should not be a substring of other class names)

        columnLastClass = class-name

        columnHeaderClass = class-name(should not be a substring of other class names)

        columnHeaderLastClass = class-name

    }

}

Example:

# General configuration of the available classes:

RTE.classes {

  mainBodyText {

    name = Body Text (Primary)

    value = font:bold; color:blue;

  }

}

# Specific configuration for the Character/Text Style menu:

RTE.default.classesCharacter = mainBodyText

Example:

# Configuration of an alternating and counting class

RTE.classes.countingtable {

    name = Counting class

    alternating {

        rows {

            startAt = 1

            oddClass = tr-odd

            evenClass = tr-even

            oddHeaderClass = thead-odd

            evenHeaderClass = thead-even

        }

        columns {

            startAt = 1

            oddClass = td-odd

            evenClass = td-even

            oddHeaderClass = th-odd

            evenHeaderClass = th-even

        }

    }

    counting {

        rows {

            startAt = 1

            rowClass = tr-count-

            rowLastClass = tr-last

            rowHeaderClass = thead-count-

            rowHeaderLastClass = thead-last

        }

        columns {

            startAt = 1

            columnClass = td-count-

            columnLastClass = td-last

            columnHeaderClass = th-count-

            columnHeaderLastClass = th-last

        }

    }

}

mutuallyExclusiveClasses.[label]

(htmlArea RTE only)

list of id-strings

Defines a set of classes that are mutually exclusive An element may have only one of the listed classes assigned to it at any given time.

colors.[id-string]

Defines the colors available in the RTE.

Properties:

.name = Label of the color in menu

.value = The HTML-color value

Example:

# General configuration of the available colors:

RTE.colors {

  color1 {

    name = Background color

    value = blue

  }

  color2 {

    name = Another color I like!

    value = #775533

  }

  noColor {

    name = No color

    value =

  }

}

# Specific setting for the font color selector:

RTE.default.colors = color1, color2, noColor

fonts.[id-string]

Defines the fonts available in the RTE.

Properties:

.name = Label of the font in menu (may be a reference to an entry in a localization file of the form LLL:EXT:[fileref]:[labelkey])

.value = The font face value (comma-separated list of font-family names; if a font-family name contains spaces, it should be quoted with single quotes)

Example:

# General configuration of the available fonts:

RTE.fonts {

  face1 {

    name = Verdana

    value = verdana, arial

  }

  face2 {

    name = Comic Sans

    value = 'Comic Sans MS'

  }

  noFace {

    name = No font

    value =

  }

}

# Specific setting for the fontstyle selector:

RTE.default.buttons.fontstyle.addItems = face2 , face1, noFace

fontSizes.[id-string]

(htmlArea RTE only)

Defines the font sizes available in the RTE.

Properties:

.name = Label of the font size in menu (may be a reference to an entry in a localization file of the form LLL:EXT:[fileref]:[labelkey])

.value = The font size value

Example:

# General configuration of the available font sizes:

RTE.fontSizes {

  size1 {

    name = Large

    value = 16px

  }

  size2 {

    name = Small

    value = 8px

  }

}

# Specific setting for the fontsyze selector:

RTE.default.buttons.fontsize.addItems = size1, size2

default.[...]

config.[tablename].[field].[...]

config.[tablename].[field].types.[type].[...]

These objects contain the actual configuration of the RTE interface.  For the properties available, refer to the table below. This is a description of how you can customize in general and override for specific fields/types.

'RTE.default'  configures the RTE for all tables/fields/types

'RTE.config.[tablename].[field]' configures a specific field. The values inherit the values from 'RTE.default' in fact this is overriding values.

'RTE.config.[tablename].[field].types.[type]' configures a specific field in case the 'type'-value of the field matches type. Again this overrides the former settings.

disabled

boolean

If set, the editor is disabled.

showButtons

list of id-strings

List of buttons that should be shown in th editor toolbar.

Note: showButtons = * shows all available buttons.

In the case of htmlArea RTE:

Available buttons are: blockstylelabel, blockstyle, textstylelabel, textstyle, fontstyle, fontsize, formatblock, blockquote, insertparagraphbefore, insertparagraphafter, lefttoright, righttoleft, language, showlanguagemarks, left, center, right, justifyfull, orderedlist, unorderedlist, definitionlist, definitionitem, outdent, indent, formattext, bidioverride, big, bold, citation, code, definition, deletedtext, emphasis, insertedtext, italic, keyboard,  monospaced, quotation, sample, small, span, strikethrough, strong, subscript, superscript, underline, variable, textcolor, bgcolor, textindicator, emoticon, insertcharacter, line, link, unlink, image, table, user, acronym, findreplace, spellcheck, chMode, inserttag, removeformat, copy, cut, paste, undo, redo, showhelp, about, toggleborders, tableproperties, tablerestyle, rowproperties, rowinsertabove, rowinsertunder, rowdelete, rowsplit, columnproperties, columninsertbefore, columninsertafter, columndelete, columnsplit, cellproperties, cellinsertbefore, cellinsertafter, celldelete, cellsplit, cellmerge

If extension static_info_tables is not installed, the spellcheck, language and acronym buttons are not enabled.

If the encoding of the content element is not either iso-8859-1 or utf-8, the spellcheck button is not enabled.

Buttons user and acronym are never available in the front end.

Button unlink is not available if button link is not available.

None of the table operations buttons are available is the button table is not available.

Note: Safari does not support the paste button.

Note: Opera does not support the copy, cut and paste buttons.

hideButtons

list of id-strings

List of buttons that should not be shown in the editor toolbar.

toolbarOrder

(htmlArea RTE only)

list of id-strings

Specifies the order and grouping of buttons in the RTE tool bar. The keywords space, bar and linebreak may be used to insert a space, a separator or a line break at the corresponding position in the tool bar.

Default: blockstylelabel, blockstyle, space, textstylelabel, textstyle, linebreak,

bar, formattext, bold,  strong, italic, emphasis, big, small, insertedtext, deletedtext, citation, code, definition, keyboard, monospaced, quotation, sample, variable, bidioverride, strikethrough, subscript, superscript, underline, span, bar, fontstyle, space, fontsize, bar, formatblock, blockquote, insertparagraphbefore, insertparagraphafter, bar, lefttoright, righttoleft, language, showlanguagemarks, bar, left, center, right, justifyfull, bar, orderedlist, unorderedlist, definitionlist, definitionitem, outdent, indent, bar, textcolor, bgcolor, textindicator, bar, emoticon, insertcharacter, line, link, unlink, image, table, user, acronym, bar, findreplace, spellcheck, bar, chMode, inserttag, removeformat, bar, copy, cut, paste, bar, undo, redo, bar, showhelp, about, linebreak,  toggleborders, bar, tableproperties, tablerestyle, bar, rowproperties, rowinsertabove, rowinsertunder, rowdelete, rowsplit, bar, columnproperties, columninsertbefore, columninsertafter, columndelete, columnsplit, bar, cellproperties, cellinsertbefore, cellinsertafter, celldelete, cellsplit, cellmerge

keepButtonGroupTogether

(htmlArea RTE only)

boolean

Specifies that all buttons of a button group are displayed on the same line of the tool bar. A button group is delimited by a linebreak or by a bar.

Default: 0

Note: If enabled, the setting is honored only by Mozilla/Firefox and Safari. It is ignored when  the browser is Internet Explorer, Opera or Mozilla 1.3.

defaultContentLanguage

string

ISO code of default language of content elements. This language is used by RTE features that insert content, usually in the form of values of html tag attributes, when the language of the content element is not specified. This property applies to TYPO3 BE only.

Default: en

Note: Any value other than 'en' requires Static Info Tables to be installed.

buttons.formatblock.orderItems

(htmlArea RTE only)

list of id-strings

Specifies the order in which the block element types are presented in the block formating drop-down list.

The potential block element types are: p, h1, h2, h3, h4, h5, h6, pre, address, blockquote, div

If not set, the default order will be alphabetical, in the language of the current backend user.

Note: If set, any option not in the list will be removed from the drop-down list.

buttons.formatblock.removeItems

(htmlArea RTE only)

list of id-strings

List of options to be removed from the block formating drop-down list.

The default items are: p, h1, h2, h3, h4, h5, h6, pre, address, blockquote, div

Note: This is a synonym of hidePStyleItems.

hidePStyleItems

list of id-strings

List of options to be removed from the block formating drop-down list.

The deafult options are: p, h1, h2, h3, h4, h5, h6, pre, address, blockquote, div

In the case of htmlArea RTE, this is a synonym of buttons.formatblock.removeItems.

buttons.formatblock.items.[item-name].label

(htmlArea RTE only)

string

Alternative label for the option identified by the item name in the block formating drop-down list.

Note: The string may be a reference to an entry in a localization file of the form LLL:EXT:[fileref]:[labelkey]

buttons.formatblock.prefixLabelWithTag

(htmlArea RTE only)

boolean

If set, the option label in the block formating drop-down list is prefixed with the tagname.

Default: 0

buttons.formatblock.postfixLabelWithTag

(htmlArea RTE only)

boolean

If set, the option label in the block formating drop-down list is postfixed with the tagname.

Default: 0

buttons.formatblock.items.[item-name].hotKey

(htmlArea RTE only)

character

A hotkey will be associated with the option of the block formating drop-down list identified by the item name.

buttons.indent.useClass

(htmlArea RTE only)

string

Class name to be used when indenting by means of div sections with class attribute.

Default: indent

buttons.indent.useBlockquote

(htmlArea RTE only)

boolean

If set, indentation will be produced by means of blockquote tags instead of div sections with class attribute.

Default: 0

buttons.left.useClass

(htmlArea RTE only)

string

Class name to be used when aligning blocks of text to the left by means of class attribute.

Default: align-left

Note: This property is also used for text aligment in table operations.

buttons.center.useClass

(htmlArea RTE only)

string

Class name to be used when centering blocks of text by means of class attribute.

Default: align-center

Note: This property is also used for text aligment in table operations.

buttons.right.useClass

(htmlArea RTE only)

string

Class name to be used when aligning blocks of text to the right by means of class attribute.

Default: align-right

Note: This property is also used for text aligment in table operations.

buttons.justifyfull.useClass

(htmlArea RTE only)

string

Class name to be used when justifying blocks of text to both left and right by means of class attribute.

Default: align-justify

Note: This property is also used for text aligment in table operations.

buttons.left.useAlignAttribute

buttons.center.useAlignAttribute

buttons.right.useAlignAttribute

buttons.justifyfull.useAlignAttribute

(htmlArea RTE only)

boolean

If anyone of these four properties is set, alignment will be produced by means of align attributes instead of class attributes.

Default: 0

buttons.blockstyle.tags.[tag-name].allowedClasses

(htmlArea RTE only)

list of id-strings

Specifies the classes allowed for the block element identified by the tag name. Any string in the list may contain wild card characters. The wild card character is "*" and stands for any sequence of characters.

The classes must also be defined, using the specific tag selector, either in one of the occurrences of  the inlineStyle property or in the CSS file specified by the contentCSS property.

If the property is empty for any tag, classes associated with the given tag in either the inlineSyle properties or in the contentCSS file are used.

The classes are presented in the drop-down list in alphabetical order in the language used by the backend user.

buttons.blockstyle.tags.div.allowedClasses  is a synonym of property classesParagraph (see below) and overrides it, if present.

buttons.blockstyle.tags.table.allowedClasses  is a synonym of property classesTable (see below) and overrides it, if present.

buttons.blockstyle.tags.td.allowedClasses  is a synonym of property classesTD (see below) and overrides it, if present.

buttons.blockstyle.tags.all.allowedClasses

(htmlArea RTE only)

list of id-strings

Specifies the classes allowed for all block elements, in addition to the classes allowed for each specific element (see above).

The classes must also be defined, without any tag selector, either in one of the occurrences of  the inlineStyle property or in the CSS file specified contentCSS property.

The classes are presented in the drop-down list in alphabetical order in the language used by the backend user.

classesParagraph

list of id-strings

In the case of htmlArea RTE:

This property is a synonym of buttons.blockstyle.tags.div.allowedClasses (see above).

In the case of the Classic RTE:

Specifies the classes available in the Block Style selector. The classes defined in the 'classesParagraph' value are prepended to the types of paragraphs options. They are inserted as <DIV>-tags with a class-parameter.

classesTable

list of id-strings

Classes available for tables. See description of 'classesCharacter'.

In the case of htmlArea RTE, each of the listed class must be defined either in one of the occurrences of  the inlineStyle property or in the CSS file specified contentCSS property.

In the case of htmlArea RTE, the same list of classes is used in the class selection list of the Table Properties dialog.

In the case of htmlArea RTE, this property is overridden by property  buttons.blockstyle.tags.table.allowedClasses, if present.

classesTD

list of id-strings

Classes available for tablecells. See description of 'classesCharacter'.

In the case of htmlArea RTE, each of the listed class must be defined either in one of the occurrences of  the inlineStyle property or in the CSS file specified contentCSS property.

In the case of htmlArea RTE, the same list of classes is used in the class selection list of the Cell Properties dialog.

In the case of htmlArea RTE, this property is overridden by property  buttons.blockstyle.tags.td.allowedClasses, if present.

buttons.blockstyle.showTagFreeClasses

(htmlArea RTE only)

boolean

Specifies that classes not associated with any tag in the contentCSS style sheet should be or should not be shown in the block style drop-down list.

Default: 0

Note: See also property showTagFreeClasses.

buttons.blockstyle.prefixLabelWithClassName

(htmlArea RTE only)

boolean

If set, the option name  in the block style drop-down list is prefixed with the class name.

Default: 0

buttons.blockstyle.postfixLabelWithClassName

(htmlArea RTE only)

boolean

If set, the option name e in the  block style drop-down list is postfixed with the class name.

Default: 0

buttons.formattext.orderItems

(htmlArea RTE only)

list of id-strings

Specifies the order in which the options, or inline element types, are presented in the text formating drop-down list.

If not set, the default order will be alphabetical, in the language of the current backend user.

buttons.formattext.removeItems

(htmlArea RTE only)

list of id-strings

List of options to be removed from the text formating drop-down list using same names as toolbar elements.

buttons.formattext.prefixLabelWithTag

(htmlArea RTE only)

boolean

If set, the option name  in the text formating drop-down list is prefixed with the tagname.

Default: 0

buttons.formattext.postfixLabelWithTag

(htmlArea RTE only)

boolean

If set, the option name e in the text formating drop-down list is postfixed with the tagname.

Default: 0

buttons.textstyle.tags.[tag-name].allowedClasses

(htmlArea RTE only)

list of id-strings

Specifies the classes allowed for each inline element (tag) in the text styling drop-down list.  Any string in the list may contain wild card characters. The wild card character is "*" and stands for any sequence of characters.

Supported tags are: abbr, acronym, b, bdo, big, cite, code, del, dfn, em, i, ins, kbd, q, samp, small, span, strike, strong, sub, sup, tt, u, var

The classes must also be defined either in one of the occurrences of  the inlineStyle property or in the CSS file specified contentCSS property.

If the property is empty for any tag, classes associated with the given tag in either the inlineSyle properties or in the contentCSS file are used.

The classes are presented in the textstyle drop-down list in alphabetical order in the language used by the backend user.

buttons.textstyle.tags.all.allowedClasses

(htmlArea RTE only)

list of id-strings

Specifies the classes allowed for all inline elements, in addition to the classes allowed for each specific element (see above).

The classes must also be defined either in one of the occurrences of  the inlineStyle property or in the CSS file specified contentCSS property.

The classes are presented in the drop-down list in alphabetical order in the language used by the backend user.

buttons.textstyle.showTagFreeClasses

(htmlArea RTE only)

boolean

Specifies that classes  not associated with any tag in the contentCSS style sheet should be or should not be shown in the text styling drop-down list.

Default: 0

buttons.textstyle.prefixLabelWithClassName

(htmlArea RTE only)

boolean

If set, the option name  in the text styling drop-down list is prefixed with the class name.

Default: 0

buttons.textstyle.postfixLabelWithClassName

(htmlArea RTE only)

boolean

If set, the option name e in the text styling drop-down list is postfixed with the class name.

Default: 0

classesCharacter

list of id-strings

In the case of htmlArea RTE:

This property is a synonym of buttons.textstyle.tags.span.allowedClasses (see above).

The classes must be defined either in one of the occurrences of  the inlineStyle property or in the CSS file specified contentCSS property.

If the property is empty, classes associated with the span tag in either the inlineSyle properties or in the contentCSS file are used.

In the case of the Classic RTE:

Specifies the classes available in the Character Style selector. Although the Character Style selector is aimed at text-formatting, it will also apply classes to other elements, for instance tables or images if selected as well as links and table-cells. The allowed classes for these operations may be configured separately by listing the classes with the options, you find below.

showTagFreeClasses

(htmlArea RTE only)

boolean

Specifies that CSS classes  not associated with any tag in the contentCSS style sheet should be or should not be shown in the block style and the text style selection lists.

Default: 0

Note: Setting this property to 1 is equivalent to setting both buttons.blockstyle.showTagFreeClasses and buttons.textstyle.showTagFreeClasses to 1.

disablePCexamples

boolean

If set, the examples of classes in Paragraph and Character selectors are disabled.

Note: In the case of htmlArea RTE, the styling is removed on the options of the block styling and text styling drop-down lists.

buttons.language.restrictToItems

(htmlArea RTE only)

list of strings

List of language ISO codes to which the language marking drop-down list is limited to.

Note: If not set, all languages found in the static_languages table will appear in the drop-down list.

buttons.language.useLangAttribute

(htmlArea RTE only)

boolean

If set, the lang attribute is used fro language marks.

Default: 1

Note: If both useLangAttribute and useXmlLangAttribute are unset, the lang attribute will be used.

buttons.language.useXmlLangAttribute

(htmlArea RTE only)

boolean

If set, the xml:lang attribute is used fro language marks.

Default: 0

buttons.language.prefixLabelWithCode

(htmlArea RTE only)

boolean

If set, the option name e in the language marking drop-down list is prefixed with the language ISO code.

Default: 0

buttons.language.postfixLabelWithCode

(htmlArea RTE only)

boolean

If set, the option name e in the language marking drop-down list is postfixed with the language ISO code.

Default: 0

buttons.spellcheck.enablePersonalDictionaries

(htmlArea RTE only)

boolean

If set, personal dictionaries are enabled.

Default: 0

Note: The option is ignored if PHP safe_mode is enabled on the server.

Note: The feature must also be enabled in User TSConfig.

Note: Personal dictionaries are stored in subdirectories of uploads/tx_rtehtmlarea

buttons.spellcheck.dictionaries.items

(htmlArea RTE only)

list-of-id-strings

The list of Aspell dictionary codes available to the spell checking feature. This list is used only if safe_mode is enabled. If safe_mode is not enabled, the list is automatically obtained from Aspell.

Default: en

buttons.spellcheck.dictionaries.restrictToItems

(htmlArea RTE only)

list-of-id-strings

List of Aspell dictionary codes to which the drop-down list of dictionaries is limited in the spell checker dialogue.

Note: If not set, all dictionaries obtained from Aspell or, if safe_mode is enabled, all dictionaries listed in property buttons.spellcheck.dictionaries.items, will appear in the drop-down list.

buttons.spellcheck.dictionaries.[language-iso-code].defaultValue

(htmlArea RTE only)

string

Aspell dictionary code of the dictionary to be used by default to spell check a content element in the language specified by the ISO code. The specified dictionary will be pre-selected in the drop-down list of dictionaries.

Default: the language ISO code.

disableTYPO3Browsers

(htmlArea RTE only)

boolean

If set, the TYPO3 element browser is disabled in both the image and link dialogues.

Default: 0

Note: The TYPO3 element browser is not available when the editor is used in the TYPO3 front end.

classesImage

list of id-strings

Classes available for images.

In the case of htmlArea RTE, each of the listed class must be defined either in one of the occurrences of  the inlineStyle property or in the CSS file specified by contentCSS property.

In the case of htmlArea RTE, the same list of classes is used in the class selection list of the Insert/Modify image dialog.

In the case of the Classic RTE, see description of 'classesCharacter'.

buttons.image.TYPO3Browser.disabled

(htmlArea RTE only)

boolean

If set, the TYPO3 image browser is disabled.

Default: 0

Note: The TYPO3 image browser is never available when the editor is used in the frontend.

blindImageOptions

list of strings

List of tab items in the image selector to remove. Key list is magic, plain, dragdrop, image

Note: If key image is in the list, the properties editing tab for any current image will not be presented.

Note: If integration with DAM is enabled, upload is also a possible tab.

Note: dragdrop is not available in Opera.

buttons.image.options.removeItems

(htmlArea RTE only)

list of strings

List of tab items to remove from the dialog of the image button. Possible tab items are: magic, plain, dragdrop, image

Note: If key image is in the list, the properties editing tab for any current image will not be presented.

Note: If integration with DAM is enabled, upload is also a possible tab.

Note: dragdrop is not available in Opera.

Note: This property is a synonymous of property blindImageOptions.

buttons.image.options.magic.maxWidth

(htmlArea RTE only)

int+

Maximum width of magic images in pixels.

Default: 300

buttons.image.options.magic.maxHeight

(htmlArea RTE only)

int+

Maximum height of magic images in pixels.

Default: 1000

Note: By setting a large enough height, images should be resized based on their width.

buttons.image.options.plain.maxWidth

(htmlArea RTE only)

int+

Maximum width of selectable plain images in pixels.

Default:  640

buttons.image.options.plain.maxHeight

(htmlArea RTE only)

int+

Maximum height of selectable plain images in pixels.

Default: 680

buttons.image.title.useDAMColumn

string

Name of the column of the tx_dam table that will be used to set the image title attribute.

Default: caption

Note: This property is ignore if the extension configuration variable "Enable the DAM media browser" is not set.

buttons.image.properties.removeItems

list of strings

List of properties to remove from the image properties editing window. Key list is align, alt, border, class, clickenlarge, float, height, paddingTop, paddingRight, paddingBottom, paddingLeft, title, width

Note: When a plain image is edited, if proc.plainImageMode is set to lockDimentions, lockRatio or lockRatioWhenSmaller, the height property is removed from the properties window. If proc.plainImageMode is set to lockDimensions, both the width and height properties are removed.

buttons.image.properties.class.default

string

Class to be assigned by default to an image when it is inserted in the RTE.

classesLinks

list of id-strings

Classes available for links. See description of 'classesCharacter'.

In the case of htmlArea RTE, classesAnchor offers more options.

classesAnchor

(htmlArea RTE only)

list of id-strings

Classes available in the Insert/Modify link dialog.

These classes must be defined by the RTE.classesAnchor property.

The anchor accessibility feature should be enabled using the Extension Manager.

classesAnchor.default.page

(htmlArea RTE only)

string

The name of the default class selector for links to internal pages.

classesAnchor.default.url

(htmlArea RTE only)

string

The name of the default class selector for links to external url's.

classesAnchor.default.file

(htmlArea RTE only)

string

The name of the default class selector for links to files.

classesAnchor.default.mail

(htmlArea RTE only)

string

The name of the default class selector for links to email addresses.

buttons.link.TYPO3Browser.disabled

(htmlArea RTE only)

boolean

If set, the TYPO3 element browser is disabled.

Default: 0

Note: The TYPO3 element browser is never available when the editor is used in the frontend.

defaultLinkTarget

string

This sets the default target for new links in the RTE.

Note: See also the classesAnchor configuration.

blindLinkOptions

list of strings

List of tab items in the link selector to remove. Key list is page,file,url,mail,spec

Note: More tabs may be provided by extensions such as DAM.

buttons.link.options.removeItems

(htmlArea RTE only)

list of strings

List of tab items to remove from the dialog of the link button.  Possible tab items are: page,file,url,mail,spec

Note: More tabs may be provided by extensions such as DAM.

Note: This property is a synonymous of property blindLinkOptions.

buttons.link.targetSelector.disabled

(htmlArea RTE only)

boolean

If set, the selection of link target is removed from the link insertion/update dialog.

Default : 0

buttons.link.popupSelector.disabled

(htmlArea RTE only)

boolean

If set, the selection of a popup window as link target is removed from the link insertion/update dialog.

Default: 0

buttons.link.pageIdSelector.enabled

(htmlArea RTE only)

boolean

If set, the specification of a page id, without using the page tree, is enabled in the link insertion/update dialog.

Note: This feature is intended for authors who have to deal with a very large page tree. Note that the feature is disabled by default.

Default: 0

buttons.link.queryParametersSelector.enabled

(htmlArea RTE only)

boolean

If set, the specification of query parameters to be added on the link is enabled in the link insertion/update dialog.

Default: 0

buttons.link.properties.class.required

(htmlArea RTE only)

boolean

If set, a class must be selected for any link. Therefore, the empty option is removed from the class selector.

buttons.link.[type].properties.class.required

(htmlArea RTE only)

boolean

If set, a class must be selected for any link of the given type. Therefore, the empty option is removed from the class selector. Possible types are: page, file, url, mail, spec. More types may be provided by extensions such as DAM.

buttons.link.properties.title.readOnly

(htmlArea RTE only)

boolean

If set, the title is set based on the RTE.classesAnchor configuration and cannot be modified by the author.

buttons.link.[type].properties.title.readOnly

(htmlArea RTE only)

boolean

If set, the title for the given type of link is set based on the RTE.classesAnchor configuration and cannot be modified by the author. Possible types are: page, file, url, mail, spec. More types may be provided by extensions such as DAM.

buttons.acronym.pages

list of page id's

List of page id's from which to obtain the acronym records.

Note: If not set, the list of current webmounts is used.

Note: If no acronym records are found in the specified page id's, the acronym button will not be present in the toolbar. If no records of type acronym or abreviation are found, the corresponding tab of the acronym dialogue will not be disabled.

Note: In IE, before IE7, the abreviation tab of the acronym dialogue is never shown.

buttons.acronym.recursive

int

The number of levels in the page tree, under each page listed in buttons.acronym.pages or under each webmount, from which acronyms are retrieved.

Default: 0

buttons.acronym. lockBeUserToDBmounts

boolean

If set, the pid's listed under buttons.acronym.pages (see above)  are validated against the user's current webmounts.

If not set or if the user is admin, buttons.acronym.pages is ignored and acronyms from all pages are retrieved.

Default: The default value of this property is the value of the property with same name in the backend section of theTYPO3 configuration as set by the Install Tool.

colors

list of id-strings

Defines the specific colors generally available in the color selectors. The id-strings must be configured in the RTE.colors array (see description earlier).

Example:

RTE.default {

  colors = color1, color2,noColor

}

disableColorPicker

boolean

Disables the color picker matrix in all color dialogs. The color picker lets you select web-colors.

Note: In the case of htmlArea RTE, this applies only when the TYPO3 configurable color selection dialog is enabled.

disableSelectColor

(htmlArea RTE only)

boolean

If set, the TYPO3 configurable color selection dialogue is disabled.

Default: 0

hideFontFaces

list of id-numbers,

* removes all

Lets you remove any of the default font faces in the Font Style selector. Values are ranging from 1 to 9. These are the possible  options, and their respective name => value pairs, that you can remove:

1: Arial => Arial,sans-serif

2: Arial Black => 'Arial Black',sans-serif

3: Verdana => Verdana,Arial,sans-serif

4: 'Times New Roman' => 'Times New Roman',Times,serif

5: Garamond => Garamond

6: Lucida Handwriting =>  Lucida Handwriting

7: Courier => Courier

8: Webdings => Webdings

9: Wingdings => Wingdings

fontFace

list of id-strings

Defines additional fonts generally available in the font selector. The id-strings must be configured in the RTE.fonts array (see description earlier).

buttons.fontstyle.removeItems

(htmlArea RTE only)

list of id-numbers,

* removes all

Lets you remove any of the default font faces in the Font Style selector. Values are ranging from 1 to 9. These are the possible  options, and their respective name => value pairs, that you can remove:

1: Arial => Arial,sans-serif

2: Arial Black => 'Arial Black',sans-serif

3: Verdana => Verdana,Arial,sans-serif

4: 'Times New Roman' => 'Times New Roman',Times,serif

5: Garamond => Garamond

6: Lucida Handwriting =>  Lucida Handwriting

7: Courier => Courier

8: Webdings => Webdings

9: Wingdings => Wingdings

Note: This property is synonymous to property hideFontFaces and overrides it if present.

buttons.fontstyle.addItems

(htmlArea RTE only)

list of id-strings

Defines additional fonts available in the font selector. The id-strings must be configured in the RTE.fonts array (see description earlier).

Note: This property is synonymous to property fontFace and overrides it if present.

buttons.fontstyle.defaultItem

(htmlArea RTE only)

string

Specifies the name of the default font style. The name is the name of one of the default font faces, or the name associated to one of fonts configured in the RTE.fonts array (see description earlier).

Note: The value associated to the default font style should be exactly the same as the value of the default font-family property specified in the site style sheet as referred to by property RTE.default.contentCSS.

hideFontSizes

list of size-numbers,

* removes all

Lets you disable any of the default font sizes available in the Font Size selector. Values are ranging from 1 to 7. These are the possible options, and their respective name => value pairs, that you can remove:

1: Extra small => 8px

2: Very small => 9px

3: Small => 10px

4: Medium => 12px

5: Large => 16px

6: Very large => 24px

7: Extra large => 32px

fontSize

(htmlArea RTE only)

list of id-strings

Defines additional font sizes available in the font size selector. The id-strings must be configured in the RTE.fontSizes array (see description earlier).

buttons.fontsize.removeItems

(htmlArea RTE only)

list of size-numbers,

* removes all

Lets you disable any of the default font sizes available in the Font Size selector. Values are ranging from 1 to 7. These are the possible options, and their respective name => value pairs, that you can remove:

1: Extra small => 8px

2: Very small => 9px

3: Small => 10px

4: Medium => 12px

5: Large => 16px

6: Very large => 24px

7: Extra large => 32px

Note: This property is synonymous to property hideFontSizes and overrides it if present.

buttons.fontsize.addItems

(htmlArea RTE only)

list of id-strings

Defines additional font sizes available in the font size selector. The id-strings must be configured in the RTE.fontSizes array (see description earlier).

Note: This property is synonymous to property fontSize and overrides it if present.

buttons.fontsize.defaultItem

(htmlArea RTE only)

string

Specifies the name of the default font size. The name is the name of one of the default font sizes, or the name associated to one of font sizes configured in the RTE.fontSizes array (see description earlier).

Note: The value associated to the default font size should be exactly the same as the value of the default font-size property specified in the site style sheet as referred to by property RTE.default.contentCSS. For correct behaviour in non-IE browsers, the value of the default font size should be specified in px units.

hideTableOperationsInToolbar

(htmlArea RTE only)

boolean

Specifies that table operations buttons should be hidden in the tool bar or not.

Default: 0

Note: If enabled, table operations will appear only in the context menu, provided that they may be enabled in the given context.

keepToggleBordersInToolbar

DEPRECATED!

boolean

This property is deprecated. Use property buttons.toggleborders.keepInToolbar

buttons.toggleborders.keepInToolbar

(htmlArea RTE only)

boolean

If set, the toggleborders button will be kept in the tool bar even if property hideTableOperationsInToolbar is set.

Default: 0

buttons.toggleborders.setOnTableCreation

(htmlArea RTE only)

boolean

If set, and if the toggleborders button is enabled, the table borders will be toggled on when a new table is created.

Default : 0

buttons.toggleborders.setOnRTEOpen

(htmlArea RTE only)

boolean

If set, and if the toggleborders button is enabled, the table borders will be toggled on when the RTE opens.

Default : 0

disableContextMenu

(htmlArea RTE only)

boolean

Specifies that the context menu should be disabled or not.

Default: 0

Note: This property is a synonymous of disableRightClick property.

disableRightClick

boolean

If set, the right click (context) menu of the RTE is disabled.

showStatusBar

(htmlArea RTE only)

boolean

Specifies that the editor status bar should be displayed or not.

Default: 0

Note: showStatusBar is set to 1 in the Typical and Demo default configurations (see chapter on default configurations).

buttons.[button-name].hotKey

(htmlArea RTE only)

character

A hotkey will be associated with the specified button-name.

Note: Care should be taken that the hotkey does not conflict with pre-defined hotkeys. If it does, the hotkey will override any previously registered hotkey.

buttons.[button-name].dialogueWindow.width

(htmlArea RTE only)

int+

The opening width of the dialogue window opened when the button is pressed.

buttons.[button-name].dialogueWindow.height

(htmlArea RTE only)

int+

The opening height of the dialogue window opened when the button is pressed.

buttons.[button-name].dialogueWindow.positionFromTop

(htmlArea RTE only)

int+

The opening position from the top of the screen of the dialogue window opened when the button is pressed.

buttons.[button-name].dialogueWindow.positionFromLeft

(htmlArea RTE only)

int+

The opening position from the left of the screen of the dialogue window opened when the button is pressed.

buttons.[button-name].dialogueWindow.doNotResize

(htmlArea RTE only)

boolean

If set, the window that is opened when the button is pressed will not be resized to its contents.

Default: 0

buttons.[button-name].dialogueWindow.doNotCenter

(htmlArea RTE only)

boolean

If set, the window that is opened when the button is pressed will not be centered in the parent window.

Default: 0

mainStyleOverride

string

By default the editor style section is set with the CSS-code below. However you may override this by this option.

Default for Classic RTE:

BODY {

  border: 1px black solid;

  border-top: none;

  margin : 2 2 2 2;

  font-family:Verdana;

  font-size:10px;

  color:black;

  background-color:white;

}

TD {font-family:Verdana; font-size:10px;}

P {margin-top:0px; margin-bottom:5px;}

DIV {margin-top:0px; margin-bottom:5px;}

OL {margin: 5px 10px 5px;}

UL {margin: 5px 10px 5px;}

BLOCKQUOTE {margin-top:0px; margin-bottom:0px;}

Default for htmlArea RTE:

body.htmlarea-content-body {

    font-family: Verdana,sans-serif;

    font-size: 12px;

    color: black;

    background-color: white;

}

td { }

div { }

pre { }

ol { }

ul { }

blockquote { }

Note: In the case of htmlArea RTE, see also property ignoreMainStyleOverride.

mainStyleOverride_add.[key]

string (css-style)

Allows to add style configuration to the values above (for .mainStyleOverride above)

Keys are:

.P / .DIV / .TD /.BODY / .BLOCKQUOTE /.OL / .UL / .PRE / .Hx will all take values which are prepended to the above settings.

Note: In the case of htmlArea RTE, see also property ignoreMainStyleOverride.

mainStyle_font

mainStyle_size

mainStyle_color

mainStyle_bgcolor

string

Setting the default font-family (verdana) , font-size (10px), font-color (black) and background color (white)

The default is shown in ".mainStyleOverride" above.

Note: In the case of htmlArea RTE, see also property ignoreMainStyleOverride.

inlineStyle.[any-keystring]

string

CSS code to be included in the editor style section. This will be included after the default code.

Note: In the case of htmlArea RTE, see also property ignoreMainStyleOverride.

skin

(htmlArea RTE only)

resource

The skin contains the CSS files and the images used to style the editor.

The skin is specified by specifying the location of the main CSS file to be used to style the editor. The folder containing the CSS file MUST also contain a structure of folders and files identical to the structure found in the folder of the default skin. All folder names and all file names must be identical.

Default: EXT:rtehtmlarea/htmlarea/skins/default/htmlarea.css

Note: these example skins do not work in Mozilla 1.3; if the property is set to one of them, the default skin will be used when the browser is Mozilla 1.3.

Note: See also property ignoreMainStyleOverride.

contentCSS

(htmlArea RTE only)

resource

The CSS file that contains the style definitions that should be applied to the edited contents.

The selectors defined in this file will also be used in the block style and text style selection lists.

Default: EXT:rtehtmlarea/res/contentcss/default.css

For example, this default could be overridden with: fileadmin/styles/my_contentCSS.css

Note: See also property ignoreMainStyleOverride.

ignoreMainStyleOverride

(htmlArea RTE only)

boolean

Instruct htmlArea RTE to ignore properties mainStyleOverride and inlineStyle.

Default: 0

Note: In htmlArea RTE, the following style sheets apply to the contents of the editing area and are linked in the following order:

1. the htmlarea-edited-content.css file from the skin being used (contains selectors for use in the editor but not intended to be applied in the frontend);

2. a css file generated from the mainStyleOverride and inlineStyle assignments;

3. the css file specified by contentCSS in Page TSConfig.

When ignoreMainStyleOverride is enabled, the middle style sheet is ignored and only the first and third style sheets are used.

proc

->PROC

Customization of the server processing of the content - also called 'transformations'.

See http://typo3.org/documentation/document-library/core-documentation/doc_core_api/current/view/5/2/

enableWordClean

(htmlArea RTE only)

boolean/

->HTMLparser

Specifies that text pasted from external sources, presumably from Microsoft Word, should be "cleaned" or not.

Default: 0

Note:If no HTMLparser configuration is specified, a limited default cleaning operation will be performed. If a HTMLparser specification is specified, parsing will be performed on the server at the time of the paste operation.

Note: Additional cleanup may be performed by the user when the removeformat  button is enabled.

Note: This feature cannot be enabled in Opera.

Note: The same cleaning operation is performed with hotkey CTRL+0, including in Opera.

enableWordClean.hotKey

(htmlArea RTE only)

character

The default hotkey of the cleaning operation, CTRL+0, is replaced by CTRL+the specified character.

removeComments

(htmlArea RTE only)

boolean

Specifies that html comments should be removed or not by the editor on save and on toggle to HTML source mode.

Default: 0

removeTags

(htmlArea RTE only)

list of tags

List of tags that should be removed by the editor on save and on toggle to HTML source mode.

removeTagsAndContents

(htmlArea RTE only)

list of tags

List of tags that should be removed by the editor, contents included, on save and on toggle to HTML source mode. The tags and the contents inside the tags will be removed.

useCSS

(htmlArea RTE only)

boolean

Specifies that Mozilla/Firefox should use style attributes or not. When enabled, Mozilla/Firefox use span tags with style attributes rather than tags such as b, i, font, etc.

Default: 0

disableEnterParagraphs

(htmlArea RTE only)

boolean

Specifies that the insertion of paragraphs when hitting the Enter key in Mozilla/Firefox and Safari should be disabled.

Default: 0

Note: If NOT enabled, the behavior of Mozilla/Firefox and Safari is modified as follows:  when the Enter key is pressed, instead of inserting a br tag, the behavior of Internet Explorer is simulated and a new paragraph is created.

Note: If enabled, the behavior of Mozilla/Firefox and Safari is not modified: a br tag is inserted when the Enter key is pressed.

disableObjectResizing

(htmlArea RTE only)

boolean

Specifies that Mozilla/Firefox should not provide handles for resizing objects such as images and tables.

Default: 0

removeTrailingBR

(htmlArea RTE only)

boolean

Specifies that trailing br tags should be removed from block elements.

Default: 0

Note: If set, any trailing br tag in a block element will be removed on save and/or change mode. However, multiple trailing br tags will be preserved.

Note: In Mozilla/Firefox/Netscape, whenever some text is entered in an empty block, a trailing br tag is added by the browser.

hideTags

DEPRECATED!

list of tags

This property is deprecated. Use property buttons.inserttag.denyTags

buttons.inserttag.denyTags

(htmlArea RTE only)

list of tags

List of tag names that should NOT be shown by the dialog of the inserttag button.

Note: Listed tag names should be among the following: a, abbr, acronym, address, b, big, blockquote, cite, code, div, em, fieldset, font, h1, h2, h3, h4, h5, h6, i, legend, li, ol, p, pre, q, small, span, strong, sub, sup, table, tt, ul

buttons.inserttag.allowedAttribs

(htmlArea RTE only)

list of attributes

List of attribute names that should be shown for all tags in the dialog of the inserttag button.

Note: Listed attribute names should be among the following: class, dir, id, lang, onFocus, onBlur, onClick, onDblClick, onMouseDown, onMouseUp, onMouseOver, onMouseMove, onMouseOut, onKeyPress, onKeyDown, onKeyUp, style, title, xml:lang

buttons.inserttag.tags.[tagname].allowedAttribs

(htmlArea RTE only)

list of attributes

List of attribute names that should be shown for the specified tagname in the dialog of the inserttag button, in addition to the attribute names specified by property buttons.inserttag.allowedAttribs.

buttons.table.disableEnterParagraphs

(htmlArea RTE only)

boolean

If set, this property will prevent the insertion of paragraphs in table cells when the enter key is pressed.

Default: 0

buttons.table.enableHandles

(htmlArea RTE only)

boolean

If set, table handles will be enabled in Firefox. These Firefox-specific handles allow to delete/insert rows and columns using small handles displayed on table  borders. However, insert operations also add a style attribute on inserted cells.

Default: 0

disableAlignmentFieldsetInTableOperations

disableSpacingFieldsetInTableOperations

disableColorFieldsetInTableOperations

disableLayoutFieldsetInTableOperations

disableBordersFieldsetInTableOperations

(htmlArea RTE only)

boolean

Disables the corresponding fieldset in all table operations dialogues.

Default: 0

buttons.table.removeFieldsets

(htmlArea RTE only)

list of strings

List of fieldsets to remove from the table creation dialogue. Key list is alignment, borders, color, description, language, layout, spacing, style

buttons.tableproperties.removeFieldsets

(htmlArea RTE only)

list of strings

List of fieldsets to remove from the table properties edition dialogue. Key list is alignment, borders, color, description, language, layout, spacing, style

buttons.table.properties.required

(htmlArea RTE only)

list of strings

List of fields for which a value is required in the table creation and table properties edition dialogues. Possible values are: caption, summary, captionOrSummary

buttons.table.properties.removed

(htmlArea RTE only)

list of strings

List of fields to remove from the table creation and table properties edition dialogues. Possible values are: width, height, float, headers, language, direction

buttons.table.properties.numberOfRows.defaultValue

(htmlArea RTE only)

int+

Default value for the number of rows to include in a table on creation.

Default: 2

buttons.table.properties.numberOfColumns.defaultValue

(htmlArea RTE only)

int+

Default value for the number of columns to include in a table on creation.

Default: 4

buttons.table.properties.headers.defaultValue

(htmlArea RTE only)

string

Default selected option in the headers layout selector in the table creation dialogue. Possible values are: none, top, left, both

Default: top

buttons.table.properties.headers.removeItems

(htmlArea RTE only)

list of strings

List of items to remove from the headers layout selector in the table creation dialogue. Key list is: none, top, left, both

Default: void

buttons.table.properties.headers.both.useHeaderClass

(htmlArea RTE only)

list of strings

A class to be assigned to the top row when the headers property specifies both.

Default: thead

buttons.table.properties.tableClass.defaultValue

(htmlArea RTE only)

string

Default selected class in the table class selector in the table creation dialogue.

Default: void

buttons.table.properties.width.defaultValue

(htmlArea RTE only)

+int

Default value of the table wdth in the table creation dialogue.

Default: void

buttons.table.properties.widthUnit.defaultValue

(htmlArea RTE only)

string

Default selected unit in the width unit selector in the table creation dialogue. Possible values are: %, px or em

Default: %

buttons.table.properties.widthUnit.removeItems

(htmlArea RTE only)

list of strings

List of items to remove from the table width unit selector in the table creation dialogue. Key list is: %, px, em

Default: void

buttons.table.properties.height.defaultValue

(htmlArea RTE only)

+int

Default value of the table height in the table creation dialogue.

Default: void

buttons.table.properties.heightUnit.defaultValue

(htmlArea RTE only)

string

Default selected unit in the height unit selector in the table creation dialogue. Possible values are: %, px or em

Default: %

buttons.table.properties.heightUnit.removeItems

(htmlArea RTE only)

list of strings

List of items to remove from the table height unit selector in the table creation dialogue. Key list is: %, px, em

Default: void

buttons.table.properties.float.defaultValue

(htmlArea RTE only)

string

Default selected option in the table float selector in the table creation and properties edition dialogues.. Possible values are: not set, left, right

Default: not set

buttons.table.properties.float.left.useClass

(htmlArea RTE only)

string

Class name to be assigned when left is selected in the table float selector in the table creation and properties edition dialogues.

Default: float-left

buttons.table.properties.float.right.useClass

(htmlArea RTE only)

string

Class name to be assigned when right is selected in the table float selector in the table creation and properties edition dialogues.

Default: float-right

buttons.table.properties.float.removeItems

(htmlArea RTE only)

list of strings

List of items to remove from the table float selector in the table creation and properties edition dialogues. Key list is: not set, left, right

Default: void

buttons.table.properties.cellpadding.defaultValue

(htmlArea RTE only)

+int

Default value of the table cellpadding attribute in the table creation and properties edition dialogues

Default: void

buttons.table.properties.cellspacing.defaultValue

(htmlArea RTE only)

+int

Default value of the table cellspacing attribute in the table creation and properties edition dialogues .

Default: void

buttons.table.properties.borderWidth.defaultValue

(htmlArea RTE only)

+int

Default value of the table border width attribute in the table creation and properties edition dialogues

Default: void

buttons.table.properties.borderStyle.defaultValue

(htmlArea RTE only)

string

Default selected style in the border style selector in the table creation dialogue. Possible values are: not set, none, dotted, dashed, solid, double, groove, ridge, inset, outset

Default: not set

buttons.table.properties.borderStyle.removeItems

(htmlArea RTE only)

list of strings

List of items to remove from the table border style selector in the table creation dialogue. Key list is: not set, none, dotted, dashed, solid, double, groove, ridge, inset, outset

Default: void

buttons.rowproperties.removeFieldsets

(htmlArea RTE only)

list of strings

List of fieldsets to remove from the table row properties edition dialogue. Key list is alignment, borders, color, language, layout, rowgroup, style

Default: void

buttons.rowproperties.properties.removed

(htmlArea RTE only)

list of strings

List of fields to remove from the table row properties edition dialogue. Possible values are: width, height, language, direction

Default: void

buttons.rowproperties.properties.width.defaultValue

(htmlArea RTE only)

+int

Default value of the row wdth in the table row properties edition dialogue.

Default: void

buttons.rowproperties.properties.widthUnit.defaultValue

(htmlArea RTE only)

string

Default selected unit in the row width unit selector in the table row properties edition dialogue. Possible values are: %, px or em

Default: %

buttons.rowproperties.properties.widthUnit.removeItems

(htmlArea RTE only)

list of strings

List of items to remove from the row width unit selector in the table row properties edition dialogue. Key list is: %, px, em

Default: void

buttons.rowproperties.properties.height.defaultValue

(htmlArea RTE only)

+int

Default value of the row height in the table row properties edition dialogue.

Default: void

buttons.rowproperties.properties.heightUnit.defaultValue

(htmlArea RTE only)

string

Default selected unit in the row height unit selector iin the table row properties edition dialogue. Possible values are: %, px or em

Default: %

buttons.rowproperties.properties.heightUnit.removeItems

(htmlArea RTE only)

list of strings

List of items to remove from the row height unit selector in the table row properties edition dialogue. Key list is: %, px, em

Default: void

buttons.rowproperties.properties.borderStyle.removeItems

(htmlArea RTE only)

list of strings

List of items to remove from the row border style selector  in the table row properties edition dialogue. Key list is: not set, none, dotted, dashed, solid, double, groove, ridge, inset, outset

Default: void

buttons.columnproperties.removeFieldsets

(htmlArea RTE only)

list of strings

List of fieldsets to remove from the column cells properties edition dialogue. Key list is alignment, borders, color, language, layout, style

buttons.cellproperties.removeFieldsets

(htmlArea RTE only)

list of strings

List of fieldsets to remove from the cell properties edition dialogue. Key list is alignment, borders, color, language, layout, style

buttons.cellproperties.properties.removed

(htmlArea RTE only)

list of strings

List of fields to remove from the cell properties and column cells properties edition dialogues. Possible values are: width, height, language, direction

Default: void

buttons.cellproperties.properties.width.defaultValue

(htmlArea RTE only)

+int

Default value of the row wdth in the cell properties and column cells properties edition dialogues.

Default: void

buttons.cellproperties.properties.widthUnit.defaultValue

(htmlArea RTE only)

string

Default selected unit in the row width unit selector in the cell properties and column cells properties edition dialogues. Possible values are: %, px or em

Default: %

buttons.cellproperties.properties.widthUnit.removeItems

(htmlArea RTE only)

list of strings

List of items to remove from the row width unit selector in the cell properties and column cells properties edition dialogues. Key list is: %, px, em

Default: void

buttons.cellproperties.properties.height.defaultValue

(htmlArea RTE only)

+int

Default value of the row height in the cell properties and column cells properties edition dialogues.

Default: void

buttons.cellproperties.properties.heightUnit.defaultValue

(htmlArea RTE only)

string

Default selected unit in the row height unit selector in the cell properties and column cells properties edition dialogues. Possible values are: %, px or em

Default: %

buttons.cellproperties.properties.heightUnit.removeItems

(htmlArea RTE only)

list of strings

List of items to remove from the row height unit selector in the cell properties and column cells properties edition dialogues. Key list is: %, px, em

Default: void

buttons.cellproperties.properties.borderStyle.removeItems

(htmlArea RTE only)

list of strings

List of items to remove from the cell border style selector in the cell properties and column cells properties edition dialogues. Key list is: not set, none, dotted, dashed, solid, double, groove, ridge, inset, outset

Default: void

buttons.paste.mozillaAllowClipboardUrl

url

The full absolute url of the AllowClipboard Helper extension for Mozilla/Firefox. The browser extension is used to allow the RTE to access the clipboard. The url is used to install the extension when required.

Default: http://typo3.org/fileadmin/allowclipboardhelper-0.6.xpi

enablePersonalDicts

DEPRECATED!

boolean

This property is deprecated. Use property buttons.spellcheck.enablePersonalDictionaries

RTEHeightOverride

(htmlArea RTE only)

int+

If set, the specified value will override the calculated height of the RTE editing area.

See also User TSConfig options.RTESmallHeight and options.RTELargeHeightIncrement

RTEWidthOverride

(htmlArea RTE only)

int+/%

If set, the specified value will override the calculated width of the RTE editing area. Note that a percentage may be specified.

Note: The property is ignored in IE if the value is a percentage.

dialogueWindows.defaultPositionFromTop

(htmlArea RTE only)

int+

The default opening position from the top of the screen of a dialogue window opened when a button is pressed.

Note: May be averridden by a specific button configuration.

dialogueWindows.defaultPositionFromLeft

(htmlArea RTE only)

int+

The default opening position from the left of the screen of a dialogue window opened when a button is pressed.

Note: May be averridden by a specific button configuration.

dialogueWindows.doNotResize

(htmlArea RTE only)

boolean

If set, the window that is opened when any button is pressed will not be resized to its contents.

Default: 0

dialogueWindows.doNotCenter

(htmlArea RTE only)

boolean

If set, the window that is opened when any button is pressed will not be centered in the parent window.

Default: 0

userElements.[#]

string/->userCategory

Configuration of the categories of user elements

The string value sets the name of the category. Value is language-splitted (by  |) to allow for multiple languages.

userLinks.[#]

string/->userLinks

Configuration of user defined links.

The string value sets the name of the category. Value is language-splitted (by  |) to allow for multiple languages.

classesAnchor.[id-string]

(htmlArea RTE only)

Attaches special properties to the classes available in the Insert/Modify link dialog.

Properties:

.class = CSS-class-name: the name of the CSS class to which the properties are attached

.type = page, url, file, mail or spec: specifies that the class applies to anchors for internal pages, external URL's, files, email addresses or special user-defined links respectively; the class will be presented only in the corresponding tab of the 'Insert/Modify link' dialogue

.image = URL of an icon file that will prefix or postfix the content of the anchor when the class is applied to an anchor; the TYPO3 syntax EXT:extension-key/sub-directory/image-file-name may be used

.addIconAfterLink = boolean: if set, the content of the link is postfixed with the icon; default is to prefix the content of the link with the icon

.altText = the text that will be used as altText for the image when the class is applied to an anchor; may be language-splitted; the TYPO3 syntax LLL:EXT:extension-key/sub-directory/locallang.xml:label-index may also be used in order for the text to be localized to the language of the content using the specified language file and label index

.titleText = the text that will be used as title for the anchor when the class is applied to an anchor; may be language-splitted; the TYPO3 syntax LLL:EXT:extension-key/sub-directory/locallang.xml:label-index may also be used in order for the text to be localized to the language of the content using the specified language file and label index

.target = string; if set, this is the default value to be assigned to the target attribute of the link when the class is applied to the link

See the Demo default configuration for a complete example.

load

string

If set, the a predefined set of user element is loaded into this category. They are always loaded in the key starting with 100 and then forward in steps of 10.

Current options are:

"images_from_folder": Loads gif,jpg,jpeg,png images from the specified folder (defined by the .path property)

merge

Boolean

If set, then any manually configured user elements are merged onto the ones loaded by the .load operation.

path

String

(Applies for load=images_from_folder only)

Sets the path of the folder from which to fetch the images (gif,jpg,jpeg,png)

Example:

.path = fileadmin/istate/

[#]

string/->userElements

Configuration of the user elements.

The string value is the name of the user element. Language-splitted.

Example:

RTE.default.userElements {

    # Category with various elements

  10 = Various elements | Diverse elements

  10 {

      # An image is inserted

    1 = Logo 1 | Bomærke 1

    1.description = This is the logo number 1. | Dette er logo nummer 1

    1.content = <img src="###_URL###fileadmin/istate/curro.png">

      # The text-selection is wrapped with <sup> tags.

    2 = Subscript

    2.description = Selected text is wrapped in <sup>-tags.

    2.mode = wrap

    2.content = ^|

      # This submits the selected text content to the script, rte_cleaner.php

    5 = Strip all tags

    5.description = All HTML-codes are removed from selection.

    5.mode = processor

    5.submitToScript = typo3/rte_cleaner.php

  }

    # Category with images from the fileadmin/istate/ folder

  2.load = images_from_folder

  2.merge = 1

  2.path = fileadmin/istate/

    # here the logo from "Various elements" is included as well

  2.1 < .10.1

}

  # Show the user-button, if not existing

RTE.default.showButtons = user

mode

string

Which kind of object it is.

Options:

"wrap": If a wrap, then the content is exploded by "|" and wrapped around the current text selection.

"processor": The content is submitted to the php-script defined by .submitToScript. GPvar("processContent") carries the selection content of the RTE and GPvar("returnUrl") contains the return url. (The "content" property is not used here!)

default: The content is just inserted (pasted into) at the cursor or substituting any current selection.

description

string

A short description shown beneath the user element title (which is in bold)

content

string

The content inserted/wrapped into the RTE

submitToScript

string

(Applies only to mode=processor)

PHP script to which the current text selection of the RTE is submitted. The script must be relative to the site-url or a full url starting with http://...

Example:

.submitToScript = typo3/rte_cleaner.php

or

.submitToScript = http://www.domain.org/some_extenal_script.php

dontInsertSiteUrl

boolean

If set, the marker ###_URL### in the content property's content IS NOT substituted by the current site url. Normally you wish to do this for all  image-references which must be prepended with the absolute url in order to display correctly in the RTE!

url

string

The url.

If set, the marker ###_URL### in the content property's content is substituted by the current site url.

description

string

A short description shown beneath the link  title (which is in bold)

target

string

Default target (if isset())