.. You may want to use the usual include line. Uncomment and adjust the path. .. include:: ../Includes.txt ================= EXT: htmlArea RTE ================= :Author: Stanislas Rolland :Created: 2008-01-05T21:28:53 :Changed by: Stanislas Rolland :Changed: 2012-04-23T21:24:09.400000000 :Email: typo3(arobas)sjbr.ca :Info 2: Stanislas Rolland :Info 3: :Info 4: EXT: htmlArea RTE .. _generated: ((generated)) ============= .. _Table-of-Contents: Table of Contents ----------------- **Copyright 2** **Credits 2** **License 2** **Sponsors 2** **Introduction 3** **What does it do? 3** **Requirements 3** **What's new in TYPO3 4.7 3** **Support 3** **Users Manual 4** **Text formating with inline elements 4** List of inline elements 4 Labels in the text formating drop-down list 4 Behavior of the text formating drop-down list and of the buttons 4 **Text styling with classes on inline elements 5** List of inline elements 5 Labels in the text styling drop-down list 6 Behavior of the text styling drop-down list 6 **Using definition lists 7** Buttons 7 Creating a definition list 7 Creating and remapping dt/dd elements 8 Nesting definition lists (Indent/TAB) 8 **Marking language 11** Drop-down list and button 11 Editing language marks 12 **Using hotkeys 14** **FAQ: How do I remove a link? 14** **FAQ: How do I delete a table? 14** **FAQ: How do I configure the editor to use my CSS styles? 15** **FAQ: Is it possible to style the appearance of links in the RTE itself? 15** **FAQ: How can I use a Bengali Open Type font in the editor? 15** **FAQ: How do I configure the RTE to keep my custom tag? 16** **FAQ: Why is the class attribute on table tags always rendered as contenttable in the front end? 16** **FAQ: Why are abbr and acronym tags not correctly rendered in the front end? 16** **FAQ: Why are popup windows too small when they open? 16** **FAQ: Why is the editor not displayed with full width when I use the full window wizard? 16** **FAQ: Why do style selector boxes remain disabled in IE? 17** **FAQ: Why can't I get all buttons to be displayed? 17** **FAQ: Why does it take so long to load the editor in Internet Explorer? 17** **Configuration 18** **Installing the RTE 18** **Extension configuration variables 18** **User TSConfig 18** **Page TSConfig 20** **Toolbar Elements 44** **Static Template: Clickenlarge Rendering 46** **Default Website Language 46** **Server Configuration 46** **Installing multiple RTE's 46** **Using htmlArea RTE in a front end plugin 47** **Configuring the anchor accessibility feature 47** **Default Configurations 48** **Default configuration of RTE content transformation 48** **Typical default configuration 50** **Minimal default configuration 53** **Demo default configuration 53** **Image default configuration 56** **Troubleshooting 58** **Internet Explorer caching problem with Apache mod\_gzip module 58** **Internet Explorer and HTML tag abbr 59** **Security error when accessing the stylesheets 59** **Issue with Firefox extension NoScript 60** .. _Copyright: Copyright ========= Extension Key: **rtehtmlarea** Copyright 2004-2012, Stanislas Rolland, This document is published under the Open Content License available from http://www.opencontent.org/opl.shtml The content of this document is related to TYPO3 a GNU/GPL CMS/Framework available from `www.typo3.com `_ .. _Credits: Credits ------- The open source htmlArea editor was originally developed by `Mihai Bazon `_ and sponsored by `interactivetools.com `_ . A number of htmlArea extensions were contributed by various authors. Both the base editor and the extensions have been substantially modified for the purpose of this extension. This extension is a continuation of the work initiated by Kasper Skårhøj and `Philipp Borgmann `_ who realized the initial integration using the RTE API introduced in TYPO3 3.6.0 as well as the initial integration of the TYPO3 image insertion and link insertion wizards. Thanks to Ursula Renziehausen from `Universität Erfurt `_ for her great ideas, advice and patient support in improving multiple aspects or the RTE. Thanks to `Jan Wulff `_ for analyzing the issues related to Internet Explorer and mod\_gzip on Apache servers. The icons of the anchor accessibility feature are provided by creator and copyright-owner Cornelia Lange ( `http://www.clkm.de/ `_ ). Thanks to `Pierre-Yves Gadina `_ for the improved icons of the Insert Image button and of the Table Operations tool bar and Ursula Renziehausen has further improved many of the icons. The initial toggleborders button logic and the automatic url and email recognition logic originate from Xinha, `http://xinha.gogo.co.nz/ `_ , a fork of htmlArea. Thanks to the people at `http:www.cablan.net `_ for their help and support in understanding and debugging the interfaces and configuration issues of the various versions of Aspell. When performing copy/cut/paste operations with Mozilla/Firefox, the extension may trigger the installation of Mozilla/Firefox extension `AllowClipboard Helper `_ developed by `Petr Simek `_ . Thanks to `Daniel Schwarzloh `_ for contributing the option for replacing typographical punctuation with ASCII characters in the format removal feature. .. _License: License ------- The original `htmlArea `_ editor was released under so-called `“modified BSD” license `_ . The original code was substantially modified. As permitted by the modified-BSD license, and with the permission of the original copyright holders, the modified version included in this extension is released, like all TYPO3 components, under the GNU General Public License. .. _Sponsors: Sponsors -------- Development of this extension was sponsored in part by the `TYPO3 Association `_ , by `Universität Erfurt `_ and `Technische Universität Ilmenau `_ , `Bundesanstalt für Landwirtschaft und Ernährung (BLE) `_ , as well as by:Otto van Bruggen, `Carla Froitzheim `_ , Matthias Kappenberg, `Ute Luft `_ , `Ralf Mertes `_ , `Peter Niederlag `_ , `Jost Reckmann `_ , `Pierre Rouwens `_ , `Krystian Szymukowicz `_ , `Veldhuizen Interactive `_ , `Sacha Vorbeck `_ , `Jan Wischnat `_ , Christian Oettinger, Peter Kraume, Sven Wolfermann. You may sponsor further development of this extension by sending your contribution tostanislas.rolland(at)sjbr.cathrough `moneybookers.com `_ or `PayPal `_ , or by contacting the `author `_ . .. _Introduction: Introduction ============ .. _What-does-it-do: What does it do? ---------------- The extension offers a Rich Text Editor or RTE with the following features: - Support for Firefox 1.5+, SeaMonkey 1.0+, Safari 3.0.4+, Google Chrome 1.0+ and Opera 9.62+ on all platforms, and for IE6.0+ on Windows platforms; - Based on the ExtJS JavaScript framework; - Integration of TYPO3 image insertion and link insertion browsers, configurable color selector and user element insertion dialog; - Configuration through TYPO3 Extension Manager, Page and User TSConfig RTE properties; three default sets of Page and User TSConfig configuration settings for typical situations, advanced users or demo environments; - Integration with the translation facilities of TYPO3; - Block and inline CSS style selector boxes with style descriptors imported from an external CSS file; - Integration of a spell checking feature providing server-side spell checking in many languages, with optional personal dictionaries for backend users; - Integration of ContextMenu, TableOperations, InsertSmiley, FindReplace, RemoveFormat, CharacterMap, QuickTag and Acronym htmlArea extensions; - Anchor accessibility feature; - Clean paste feature; - Hook on Lorem Ipsum wizard so that dummy content may be inserted when the editor is in wysiwyg mode; - Optional configurable server-side HTML cleaning when content is pasted into the editor; - A class that may be used in front end extensions to enable rich text editing of text fields. .. _Requirements: Requirements ------------ Starting with TYPO3 4.0, the extension is included as system extension. If spell checker feature is enabled in version 1.4.2+, then Static Info Tables version 2.0.0+ is required. If spell checker feature is enabled in versions before 1.4.2, version 1.1.0 (or more recent) of the Static Info Library extension (sr\_static\_info) is required. The spell checker feature requires `GNU Aspell 0.60+ `_ to be installed on the server. The spell checker requires PHP to be compiled with pspell. If PHP is not compiled with pspell, the spell checker will function in shell\_exec mode. The hook on the Lorem Ipsum wizard requires version 1.1.0+ of the Lorem Ipsum extension (lorem\_ipsum). .. _What-s-new-in-TYPO3-4-7: What's new in TYPO3 4.7 ----------------------- The following features have been added in TYPO3 4.7: - a new toolbar button (insertsofthyphen) allows to insert a soft hyphen into the text without opening the «Insert special character» dialogue. This feature was sponsored by Bundesanstalt für Landwirtschaft und Ernährung (BLE); - the following HTML5 block elements are enabled in the RTE: article, aside, footer, header, nav, section; - a new tab of the «Edit element» dialogue allows to edit microdata items using, by default, the voculary defined by `schema.org `_ ; a new button «Show microdata» allows to highlight the microdata items in the RTE editing area; - the click-enlarge feature now uses an HTML5-compliant custom attribute (data-htmlarea-clickenlarge); - the order of tabs of the Insert/modify image dialogue may be configured in Page TSConfig. .. _Support: Support ------- Please see/report problems on TYPO3 Forge `http://forge.typo3.org/projects/typo3v4-core/issues `_ under category rtehtmlarea. You may get support in the use of this extension by subscribing to `news://news.netfielders.de/typo3.projects.rte `_ . .. _Users-Manual: Users Manual ============ .. _Text-formating-with-inline-elements: Text formating with inline elements ----------------------------------- The overall idea behind this is to make it as comfortable as possible to write semantic inline markup without having to code. Buttons in general are very easy to access, but if there are too many of them, they are confusing. Now, which elements you need most often depends on the type of text you are writing. - If your site is about literature, you need a lot of q, cite, samp, dfn. - If your site is about typo3, what you need is a lot of code, var, kbd, samp, dfn and and ocassionally q and cite. - On a university website you have both subjects in different parts of the pagetree. Therefore the idea is to have those elements as buttons you need most often, and the complete list in a drop-down list. Which buttons are shown and which elements are shown are configurable via Page and/or User TSConfig. .. _List-of-inline-elements: List of inline elements ^^^^^^^^^^^^^^^^^^^^^^^ b, bdo, big, cite, code, del, dfn, em, i, ins, kbd, q, samp, small, span, strike, strong, sub, sup, tt, u, var .. _Labels-in-the-text-formating-drop-down-list: Labels in the text formating drop-down list ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ In the drop-down list, depending on RTE configuration, both, the label and the tagname may be shown. The label is important for those authors that do not know HTML, the tagname is convenient for the coders and also for the HTML novices, because this way they can learn their meanings and be enabled to use the status bar. For example, depending on configuration, we may have: q – Quotation or Quotation – q or Quotation Labels are always shown in the author's language regardless of the content's language. The default order is alphabetical but may be configured otherwise in Page TSConfig. .. _Behavior-of-the-text-formating-drop-down-list-and-of-the-buttons: Behavior of the text formating drop-down list and of the buttons ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ While in case of nested inline markup all buttons may be highlighted, only one of the options will be pre-selected in the drop-down list and therefore be shown in the collapsed drop-down list. .. _Legend: Legend: """"""" highlighted (selected) string:This is the string inside the textarea the author has selected using the mouse or keyboard. \|= cursor position inside the textarea. .. _Case-1-No-string-is-highlighted-and-the-cursor-is-outside-any-inline-element: Case 1: No string is highlighted and the cursor is outside any inline element: """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" a) the option shown in the collapsed drop-down list is 'No text format **';** b) the drop-down list and all buttons are disabled. .. _Case-2-No-string-is-highlighted-and-the-cursor-is-inside-an-inline-element: Case 2: No string is highlighted and the cursor is inside an inline element: """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" Example: :code:`wor` :code:`\|` :code:`d` a) the option shown in the collapsed drop-down list is the type of the inner inline element in which the cursor is positioned; b) the drop-down list and all buttons are enabled; c) the button corresponding to the type of the inner inline element in which the cursor is positioned is highlighted by means of a white background; if the cursor is positioned inside nested inline elements, all corresponding buttons are highlighted by means of a white background; d) if the author chooses a different markup in the drop-down list or clicks on a button that is not highlighted, the markup of the inner inline element is remapped; e) if the author chooses 'Remove text format', the markup of the inner inline element is removed; f) if the author clicks on an highlighted button, the markup of the innermost inline element of the corresponding type is removed; g) the position of the cursor is unchanged. .. _Case-3-A-string-is-highlighted-and-crosses-multiple-elements: Case 3: A string is highlighted and crosses multiple elements: """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" a) the option shown in the collapsed drop-down list is 'No text format' (first option); b) if the string crosses multiple block elements: the drop-down list is disabled; c) if the string crosses multiple inline elements: - the option shown in the collapsed drop-down list is 'No text format'; - the drop-down list is enabled; - if the author chooses a markup, the highlighted string is wrapped with the chosen markup; - the resulting marked up string is not highlighted; - the cursor is positioned at the end of the marked up string. .. _Case-4-The-highlighted-string-is-not-contained-in-any-inline-element: Case 4: The highlighted string is not contained in any inline element: """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" a) the option shown in the collapsed drop-down list is 'No text format'; b) if the author chooses a markup, the highlighted string is wrapped with the chosen markup; c) the resulting marked up string is not highlighted; d) the cursor is positioned at the end of the marked up string, so that This is great!becomes This is great!\|. .. _Case-5-The-highlighted-string-is-contained-in-an-inline-element: Case 5: The highlighted string is contained in an inline element: """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" a) the option shown in the collapsed drop-down list is 'No text format'; b) if the author chooses a markup, the highlighted string is wrapped with the chosen markup; c) the resulting marked up string is not highlighted; d) the cursor is positioned at the end of the marked up string. Example 1: This is a verygood question. becomes This is a very\|question.. Example 2: This is great!, he shouted. becomes This is great!\|, he shouted. .. _Case-6-The-highlighted-string-contains-exactly-the-complete-inline-element: Case 6: The highlighted string contains exactly the complete inline element: """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" Example of highlighted string:word a) The option shown in the collapsed drop-down list is the type of inline element corresponding to the highlighted string; b) if the author chooses 'Remove textformat', the inline markup gets removed:wordbecomesword\|; c) if the author chooses another markup, e.g. :code:`` , the markup wraps the highlighted node, so thatwordbecomes :code:`word` \| :code:`` . .. _Text-styling-with-classes-on-inline-elements: Text styling with classes on inline elements -------------------------------------------- The text styling drop-down list makes it possible to add a class to an inline element: - whenever the cursor is put somewhere inside the element; - when the element is completely selected. The classes allowed for each type of inline element are configurable. .. _List-of-inline-elements: List of inline elements ^^^^^^^^^^^^^^^^^^^^^^^ In addition to the inline elements listed under text formating above, classes may be assigned to abbr and acronym elements: abbr, acronym, b, bdo, big, cite, code, del, dfn, em, i, ins, kbd, q, samp, small, span, strike, strong, sub, sup, tt, u, var .. _Labels-in-the-text-styling-drop-down-list: Labels in the text styling drop-down list ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ In the selectlist, both, the label and the class selector or class name may be shown: label class name - label label - class name Labels are always shown in the author's language regardless of the content's language. The order is alphabetical. .. _Behavior-of-the-text-styling-drop-down-list: Behavior of the text styling drop-down list ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ Only one of the classes is pre-selected in the Text Style selectlist and therefore shown in the collapsed selectlist. At all times, only classes allowed by the configuration settings are presented in the selectlist. .. _Legend: Legend: """"""" highlighted (selected) string:This is the string inside the textarea the user has selected using the mouse or keyboard. \|= cursor position inside the textarea. .. _Case-1-No-string-is-highlighted-and-the-cursor-is-outside-any-inline-element: Case 1: No string is highlighted and the cursor is outside any inline element: """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" a) the option shown in the collapsed selectlist is 'No text style'; b) the selectlist is disabled. .. _Case-2-No-string-is-highlighted-and-the-cursor-is-inside-an-inline-element: Case 2: No string is highlighted and the cursor is inside an inline element: """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" Example: :code:`wor` :code:`\|` :code:`d` a) the option shown in the collapsed selectlist is the current value of the element's class attribute, or 'No text style' when the inline element bears no class attribute; b) the selectlist is enabled and contains the classes allowed for the type of inline element; c) if the author chooses a different class, the class attribute gets updated; the position of the cursor is unchanged; d) if the author chooses 'No text style', the current class is removed; if the element has no more class, the class attribute gets removed; if the element is a span element and it has no more attribute, the span element is removed;the position of the cursor is unchanged. .. _Case-3-A-string-is-highlighted-and-crosses-multiple-elements: Case 3: A string is highlighted and crosses multiple elements: """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" a) the option shown in the collapsed selectlist is 'No text style'; b) if the string crosses multiple block elements: the selectlist is disabled; c) if the string crosses multiple inline elements: - the selectlist is enabled and contains the classes allowed for the 'span' element; - if the author chooses a class, the highlighted string is wrapped with a 'span' element with the chosen class as value of its class attribute; - the resulting marked up string is not highlighted; - the cursor is positioned at the end of the string. .. _Case-4-The-highlighted-string-is-not-contained-in-any-inline-element: Case 4: The highlighted string is not contained in any inline element: """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" a) the option shown in the collapsed selectlist is 'No text style'; b) if the author chooses a class, the highlighted string is wrapped with a 'span' element with the chosen class as value of its class attribute; c) the resulting marked up string is not highlighted; d) the cursor is positioned at the end of the highlighted string. .. _Case-5-The-highlighted-string-is-contained-in-an-inline-element: Case 5: The highlighted string is contained in an inline element: """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" a) the option shown in the collapsed selectlist is 'No text style'; b) if the author chooses a class, the highlighted string is wrapped with a 'span' element with the chosen class as value of its class attribute; c) the resulting marked up string is not highlighted; d) the cursor is positioned at the end of the highlighted string. .. _Case-6-The-hightlighted-string-contains-exactly-the-complete-inline-element: Case 6: The hightlighted string contains exactly the complete inline element: """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" Example of hightlighted string:word a) the option shown in the collapsed selectlist is the current value of the element's class attribute, or 'No style' when the inline element bears no class attribute; b) the selectlist is enabled and contains the classes allowed for the type of inline element; c) if the author chooses a different class, the class attribute gets updated; the cursor is moved at the end of the highlighted string which gets de-highlighted; d)if the author chooses 'No style', the current class is removed; if the element has no more class, the class attribute gets removed;if the element is a span element and it has no more attribute, the span element is removed; the cursor is moved at the end of the highlighted string which gets de-highlighted. .. _Using-definition-lists: Using definition lists ---------------------- .. _Buttons: Buttons ^^^^^^^ The following buttons are used: a button allowing to create definition lists (dl); a button allowing to toggle between term (dt) and definition (dd) elements; indenting and outdenting of definition lists is done using the indent/outdent buttons or the TAB/SHIFT-TAB keys. In the toolbar, the definition list and definition item buttons are usually placed right after the unordered list (ul) and the ordered list (ol) buttons. .. _Creating-a-definition-list: Creating a definition list ^^^^^^^^^^^^^^^^^^^^^^^^^^ .. _Case-1-Nothing-is-highlighted-cursor-is-inside-p-or-hx: Case 1: Nothing is highlighted, cursor is inside p or hx. """"""""""""""""""""""""""""""""""""""""""""""""""""""""" Example:

Definition term\|

If dl-button is clicked, this becomes:
Some Text\|
.. _Case-2-Nothing-is-highlighted-cursor-is-inside-a-block-element-other-than-p-or-hx: Case 2: Nothing is highlighted, cursor is inside a block element other than p or hx. """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" Example:
Definition term\|
If dl-button is clicked, this becomes:
Definition term\|
.. _Case-3-Creating-a-dl-from-multiple-highlighted-paragraphs: Case 3: Creating a dl from multiple highlighted paragraphs """""""""""""""""""""""""""""""""""""""""""""""""""""""""" Let us say, we have the following code highlighted:

Definition term 1

Definition text 1

Definition term 2

Definition text 2

Klicking the dl-button results in alternating :code:`dt/dd` elements wrapped by :code:`dl` :
Definition term 1
Definition text 1
Definition term 2
Definition text 2\|
.. _Case-4-Creating-a-dl-from-a-highlighted-combination-of-hx-and-p: Case 4: Creating a dl from a highlighted combination of hx and p """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

headline 1

paragraph 1.1

paragraph 1.2

headline 2

paragraph 2.1

In this case - every :code:`hx` would become :code:`dt,` and - every :code:`p` would become :code:`dd.`
headline 1
paragraph 1.1
paragraph 1.2
headline 2
paragraph 2.1\|
.. _Creating-and-remapping-dt-dd-elements: Creating and remapping dt/dd elements ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ .. _Case-1-Behaviour-of-Enter-key-if-the-cursor-is-at-the-end-of-dt-dd: Case 1: Behaviour of Enter key if the cursor is at the end of dt/dd """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" - If the cursor is at the end of a :code:`dt` -element and Enter is pressed, a new :code:`dd` -Element will be created as next sibling. - If the cursor is at the end of a :code:`dd` -element and Enter is pressed, a new :code:`dt` -Element will be created as next sibling. .. _Case-2-Behaviour-of-Enter-key-if-the-cursor-is-at-the-beginning-of-dt-dd: Case 2: Behaviour of Enter key if the cursor is at the beginning of dt/dd """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" - If the cursor is at the beginning of a dt-Element and Enter is pressed, a new dt will be created as previous sibling. - If the cursor is at the beginning of a dd-Element and Enter is pressed, a new dd will be created. .. _Case-3-Remapping-dd-to-dt: Case 3: Remapping dd to dt """""""""""""""""""""""""" In order to remap the :code:`dt` to :code:`dd` , the cursor has to be somewhere inside a dt/dd. The remapping is done by clicking the dt/dd- toggle button. .. _Nesting-definition-lists-Indent-TAB: Nesting definition lists (Indent/TAB) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ While :code:`dt` does not allow any blockelements inside, :code:`dd` does, and you may also nest definition lists. This is usefull if you have a term that has different definitions in different contexts. The nesting can be achieved using indent/outdent buttons as for the other list types. .. _Case-1-Indenting-without-any-highlighted-text: Case 1: Indenting without any highlighted text """""""""""""""""""""""""""""""""""""""""""""" Let us say I want to talk about the Acronym PC in different context:
PC
The Acronym has different meanings in different contexts:\|
Now I press indent, with the result that a new combination of dl+dt is created at my cursor position and my cursor is inside the newly created dt:
PC
The Acronym has different meanings in different contexts:
\|
.. _Case-2-Indenting-highlighted-dt-dd-elements: Case 2: Indenting highlighted dt/dd elements """""""""""""""""""""""""""""""""""""""""""" This case is divided into two subcases. .. _Subcase-2a-We-have-a-dd-as-previous-sibling-of-the-hightlighted-elements: Subcase 2a: We have a dd as previous sibling of the hightlighted elements. """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" In this case the highlighted :code:`dt/dd` elements should be wrapped with :code:`
` and should be placed inside the :code:`dd` at cursor position. Example:
PC
The Abbreviation has different meaning in different contexts:
Information technology
Personal Computer
Social sciences
Political correctness
Latin Grammar
Participium coniunctum
Clicking indent results in:
PC
The Abbreviation has different meaning in different contexts:
Information technology
Personal Computer
Social sciences
Political correctness
Latin Grammar
Participium coniunctum\|
.. _Subcase-2b-We-have-a-dt-as-previous-sibling-of-the-highlighted-dt-dd-elements: Subcase 2b: We have a dt as previous sibling of the highlighted dt/dd elements. """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" In this subcase the highlighted elements will be wrapped by :code:`dd+dl` .
PC
Information technology
Personal Computer
Social sciences
Political correctness
Latin Grammar
Participium coniunctum
Clicking indent will result in:
PC
Information technology
Personal Computer
Social sciences
Political correctness
Latin Grammar
Participium coniunctum\|
.. _Case-3-Outdenting-without-any-highlighting: Case 3: Outdenting without any highlighting """"""""""""""""""""""""""""""""""""""""""" After having said all about PC, I want to talk about RTE on the outer level and therefore do the following: - I press Enter to create a new dt and perhaps klick dt/dd-toggler. - I click outdent or press Shift+TAB to outdent the newly created dt. As a result, my newly created dt/dd element is moved beneath the nested dl. Example:
PC
The Abbreviation has different meaning in different contexts:
Information technology
Personal Computer
Social sciences
Political correctness
Latin Grammar
Participium coniunctum
**\|**
Clicking outdent in this situation will result in:
PC
The Abbreviation has different meaning in different contexts:
Information technology
Personal Computer
Social sciences
Political correctness
Latin Grammar
Participium coniunctum
**\|**
.. _Case-4-Outdenting-a-highlighted-group-of-dt-dd-elements: Case 4: Outdenting a highlighted group of dt/dd-elements """""""""""""""""""""""""""""""""""""""""""""""""""""""" Outdenting of highlighted elements only works in a sensible way, if the highlighted elements are at the very end of an indented dl. If you want to move up or down elements at the beginning or in the middle, this can be achieved with cut and paste. Example: Highlighted elements are at the end of a nested dl
outer term 1
outer data 1
inner term 1
inner data 1
inner term 2
inner data 2
inner term 3
inner data 3
Clicking outdent will place the selected elements below the next outer dd:
outer term 1
outer data 1
inner term 1
inner data 1
inner term 2
inner data 2
**
inner term 3
** **
inner data 3** **\|** **
**
.. _Marking-language: Marking language ---------------- .. _Drop-down-list-and-button: Drop-down list and button ^^^^^^^^^^^^^^^^^^^^^^^^^ A drop-down list of languages is provided that allows authors: - to add the lang attribute, - to change the value of the lang attribute, - to remove the lang attribute. The name of the languages in the dorp-down list are shown in the author's BE language. The drop-down list uses ISO language codes and refers to the language table provided by extension Static Info Tables and its companion localization extensions. Additionally, the ISO code value may be shown before or after the natural name of the language. As the attribute values are not visible in WYSIWYG mode, a button is provided that allows to show/hide the presence of a lang attibute. For Internet Explorer, this feature will only work for versions >= 7 as version 6 is not capable of attribute selectors. In browsers other than Internet Expolorer, the value of the language attribute is also shown in front of the marked text. The language mark, if any, is also displayed in the status bar as: element[language-code]. Site developers/admins have the ability to configure: - wether lang or xml:lang or both are used as language attibute(s); - which languages are available in the drop-down list. .. _Editing-language-marks: Editing language marks ^^^^^^^^^^^^^^^^^^^^^^ .. _Case-1-The-author-highlights-a-part-of-a-text-node-and-selects-a-language: Case 1: The author highlights a part of a text node and selects a language """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" Highlighted area:

Semantisches Markupmindert Barrieren.

Result in markup with cursor position:

Semantisches Markup\|mindert Barrieren.

.. _Case-2-The-author-highlights-the-whole-text-node-inside-an-inline-element-and-selects-a-language: Case 2: The author highlights the whole text node inside an inline element and selects a language """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .. _a-to-add-the-lang-attribute: a) to add the lang attribute """""""""""""""""""""""""""" Highlighted area: New York Times Result in markup with cursor position: New York Times\| .. _b-to-change-the-value-of-the-lang-attribute: b) to change the value of the lang attribute """""""""""""""""""""""""""""""""""""""""""" Highlighted area: Le Monde Result in markup with cursor position: Le Monde\| .. _c-to-delete-the-lang-attribute-No-language: c) to delete the lang attribute (No language) """"""""""""""""""""""""""""""""""""""""""""" Highlighted area: Die Zeit Result in markup with cursor position: Le Monde\| In case the inline element in question isa span thatdoes not have any other attributes, the span element will be removed. .. _Case-3-The-author-highlights-a-complete-element-node-via-the-status-bar-and-selects-a-language: Case 3: The author highlights a complete element node via the status bar and selects a language """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" Highlighted area: New York Times Result in markup with cursor position: New York Times\| .. _Case-4-Nothing-is-highlighted-and-the-author-selects-a-language: Case 4: Nothing is highlighted and the author selects a language """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .. _a-to-add-the-lang-attribute: a) to add the lang attribute """""""""""""""""""""""""""" Cursor position:

Die New \|York Times titelte ….

The lang attribute is set in the direct parent element node.Result in markup with cursor position:

Die New\|York Times titelte ….

.. _b-to-change-the-attribute-value: b) to change the attribute value """""""""""""""""""""""""""""""" Cursor position:

New \|York Times titelte ….

Result in markup with cursor position:The value of the lang attribute of the direct parent element node is changed.

New \|York Times titelte ….

.. _c-to-remove-the-lang-attribute: c) to remove the lang attribute """"""""""""""""""""""""""""""" Cursor position:

Die \|Zeit titelte ….

Result in markup with cursor position:The lang attribute gets removed.

Die \|Zeit titelte ….

In case of a span element that has no other attributes the span element will be removed. .. _Case-5-Nothing-is-highlighted-the-cursor-is-directly-inside-a-block-element-and-the-author-selects-a-language: Case 5: Nothing is highlighted, the cursor is directly inside a block element and the author selects a language """""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

Beware \|the dog!

The lang attribute is set for the parent element:

Beware\|the dog!

.. _Case-6-The-author-selects-a-block-element-via-the-status-bar: Case 6: The author selects a block element via the status bar """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .. _a-to-add-the-lang-attribute: a) to add the lang attribute """""""""""""""""""""""""""" Highlighted block:

Did you ever experience a dejà vu effect?

Resulting markup with cursor position:

Have you ever had a dejà vu effect.

\| .. _b-to-change-the-value-of-the-lang-attribute: b) to change the value of the lang attribute """""""""""""""""""""""""""""""""""""""""""" Highlighted block:

Hattest du jemals einen dejà vu-Effekt?

Resulting markup with cursor position:

Hattest du je einen dejà vu-Effekt.

\| .. _c-to-remove-the-lang-attribute: c) to remove the lang attribute """"""""""""""""""""""""""""""" Highlighted block:

Hattest du jemals einen dejà vu-Effekt?

Resulting markup with cursor position:

Hattest du je einen dejà vu-Effekt.

\| .. _Case-7-The-author-highlights-multiple-block-elements-and-selects-a-language: Case 7: The author highlights multiple block elements and selects a language """"""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""

Rats!

They fought the dogs and killed the cats,

And bit the babies in the cradles,

And ate the cheeses out of the vats,

And licked the soup from the cooks' ownladles,

Resulting markup with cursor position: :code:`Rats!

` :code:`They fought the dogs and killed the cats,

` :code:`And bit the babies in the cradles,

` :code:`And ate the cheeses out of the vats,

` :code:`And licked the soup from the cooks' own` \|ladles,

.. _Using-hotkeys: Using hotkeys ------------- Hoykeys maybe be configured for most buttons in Page TSConfig. The following hotkeys are defined by default, but may be reconfigured: ctrl+l : Justify Left (if the corresponding button is configured in the toolbar of the RTE) ctrl+e : Justify Center (if the corresponding button is configured in the toolbar of the RTE) ctrl+r : Justify Right (if the corresponding button is configured in the toolbar of the RTE) ctrl+j : Justify Full (if the corresponding button is configured in the toolbar of the RTE) ctrl+n : Format block as Paragraph (if the corresponding select box is configured in the toolbar of the RTE) ctrl+1 : Format block as Heading 1 (if the corresponding select box is configured in the toolbar of the RTE) ctrl+2 : Format block as Heading 2 (if the corresponding select box is configured in the toolbar of the RTE) ctrl+3 : Format block as Heading 3 (if the corresponding select box is configured in the toolbar of the RTE) ctrl+4 : Format block as Heading 4 (if the corresponding select box is configured in the toolbar of the RTE) ctrl+5 : Format block as Heading 5 (if the corresponding select box is configured in the toolbar of the RTE) ctrl+6 : Format block as Heading 6 (if the corresponding select box is configured in the toolbar of the RTE) The following hotkeys are predefined and reserved: ctrl+a : Select all ctrl+z : Undo (if the corresponding button is configured in the toolbar of the RTE) ctrl+y : Redo (if the corresponding button is configured in the toolbar of the RTE) ctrl+x : Cut ctrl+c : Copy ctrl+v : Paste ctrl+0 : Clean Word ctrl+space: Insert a non-breaking space Using the Enter key inserts a paragraph (

, or 

). Using
shift-Enter will insert a line break (
).


.. _FAQ-How-do-I-remove-a-link:

FAQ: How do I remove a link?
----------------------------

To remove a link, select the link and click on the “Insert/Modify
link” button. At the top of the popup window, you have the option to
remove the link.


.. _FAQ-How-do-I-delete-a-table:

FAQ: How do I delete a table?
-----------------------------

You may proceed as follows:

- click in any cell in the table;

- in the editor status bar, displayed at the bottom of the editor frame,
  click on “table”;

- press the “Delete” key or the “Backspace” key.

You may also proceed as follows:

- click in any cell in the table;

- click on the right button of the mouse or pointing device;

- the context menu is displayed;

- at the bottom of the context menu, you have the option to delete the
  TABLE element.

In Internet Explorer, you may also proceed as follows:

- put the cursor just after the table and press the “Backspace” key;

- or click on the border of the table and press the “Delete” key.


.. _FAQ-How-do-I-configure-the-editor-to-use-my-CSS-styles:

FAQ: How do I configure the editor to use my CSS styles?
--------------------------------------------------------

The following style sheets apply to the contents of the editing area
and are linked in the following order:

the htmlarea-edited-content.css file from the skin in use; it contains
selectors for use in the editor, but not intended to be applied in the
frontend;

the css file specified by property contentCSS in Page TSConfig: you
may define the styles you want to use in an external CSS file and
assign the file name to this property.


.. _FAQ-Is-it-possible-to-style-the-appearance-of-links-in-the-RTE-itself:

FAQ: Is it possible to style the appearance of links in the RTE itself?
-----------------------------------------------------------------------

«In the front end, all links are rendered correctly, but in the RTE
itself the links are shown in standard color (blue) with underline,
except links I've already visited. These are in black with underline
and a hover effect. If I add new links, it's the same: Visited links
become black, unvisited blue. The rest of the style sheet is parsed
without problems. Any hints?»

This is a Mozilla/Firefox feature. In the editing area, the link
attributes defined in the browser user profile take precedence over
the corresponding attributes specified in your style sheet.
Apparently, these preferences cannot be neutral.

In an editing area displayed by Internet Explorer, the style sheet
specification is applied to the link.

You can force (not only) Firefox to take your style sheet rather than
the user preference settings via the !important rule. Check this out
for example:

::

   a:link, a:visited{
           text-decoration:none !important;
           color:#c00 !important;
   }

Now your links should turn red and the text-decoration should be gone.
If you are using the same style sheet in the frontend and in the RTE,
you can avoid forcing your link style on all frontend users by
restricting it to the RTE editing area. Using the same example as
above:

::

   .htmlarea-content-body a:link, .htmlarea-content-body a:visited {
           text-decoration:none !important;
           color:#c00 !important;
   }


.. _FAQ-How-can-I-use-a-Bengali-Open-Type-font-in-the-editor:

FAQ: How can I use a Bengali Open Type font in the editor?
----------------------------------------------------------

Since Bengali is not well supported by all browsers, the recommended
approach would be to add the Bengali font in the list of font families
specified on the body selector of the RTE.default.contentCSS
stylesheet. For example:

::

   body { font-family: Verdana, sans-serif, Likhan; }

For some reason, with some fonts, the lines may overlap when using
larger font sizes. It is the case with the Bengali Likhan font in
Firefox 1.0.2. This may also be corrected through the stylesheet. For
example:

::

   body { font-family: Verdana, sans-serif, Likhan; line-height: 1.4; }

Note that, when using the Bengali Likhan font, a line-height with em
or % unit may not produce any effect in Firefox 1.0.2.


.. _FAQ-How-do-I-configure-the-RTE-to-keep-my-custom-tag:

FAQ: How do I configure the RTE to keep my custom tag?
------------------------------------------------------

Add the following lines to your Page TSConfig:

::

   RTE.default.proc.allowTags = list-of-allowed-tags
   RTE.default.proc.HTMLparser_rte.tags.mycustomtag.protect =1

where

*list-of-allowed-tags* is the list of all allowed tags, including your
custom tag, and

*mycustomtag* is the name of your tag.


.. _FAQ-Why-is-the-class-attribute-on-table-tags-always-rendered-as-contenttable-in-the-front-end:

FAQ: Why is the class attribute on table tags always rendered as contenttable in the front end?
-----------------------------------------------------------------------------------------------

«Typo3 always replaces the class I selected in the RTE for a table
with the class "contenttable". Do you have an idea how to switch that
off?»

Assuming that you have installed extension CSS Styled Content
(css\_styled\_content), add the following line in your TS template
Setup field:

::

   lib.parseFunc_RTE.externalBlocks.table.stdWrap.HTMLparser.tags.table.fixAttrib.class.list >

The contenttable class will then be added only if no class is
specified for the table.


.. _FAQ-Why-are-abbr-and-acronym-tags-not-correctly-rendered-in-the-front-end:

FAQ: Why are abbr and acronym tags not correctly rendered in the front end?
---------------------------------------------------------------------------

Make sure that abbr and acronym are included in the list:

::

   styles.content.links.allowTags

in your TS template constants.


.. _FAQ-Why-are-popup-windows-too-small-when-they-open:

FAQ: Why are popup windows too small when they open?
----------------------------------------------------

We have tried to make sure that all popup windows open with usable
dimensions. Since the contents of the windows may be variable and may
be localized, it is difficult to ensure that all windows will open
with the correct size in all languages. Therefore, the editor will try
to adjust the width and height of the windows to their specific
contents and to center the windows on the screen.

In some OS/browser configurations, the editor may be prevented from
resizing and moving the windows due to lack of privileges:

- If you use a Firefox browser, select through the browser menu Tools ->
  Options -> Web Characteristics -> Javascript -> Advanced, and check
  the options that allows scripts to Hide the status bar and that allow
  scripts to resize and move windows. Popup windows should then open
  with the correct size.

- If you use IE6 on Windows XP SP2, select through the browser menu
  Tools -> Internet Options -> Security -> Trusted Sites, and add the
  url of TYPO3 site to the list of trusted sites. Popup windows should
  then open with the correct size.


.. _FAQ-Why-is-the-editor-not-displayed-with-full-width-when-I-use-the-full-window-wizard:

FAQ: Why is the editor not displayed with full width when I use the full window wizard?
---------------------------------------------------------------------------------------

If you are editing the most usual content element, that is the
bodytext column of tt\_content table, try to add the following line to
your Page TSConfig:

::

   TCEFORM.tt_content.bodytext.RTEfullScreenWidth= 100%

Note that this setting is now included in the default configuration of
the extension.

If editing some other column, use the same model:

::

   TCEFORM.my_table_name.my_column_name.RTEfullScreenWidth= 100%


.. _FAQ-Why-do-style-selector-boxes-remain-disabled-in-IE:

FAQ: Why do style selector boxes remain disabled in IE?
-------------------------------------------------------

When using IE, make sure that the browser cache setting is set to
Automatic.


.. _FAQ-Why-can-t-I-get-all-buttons-to-be-displayed:

FAQ: Why can't I get all buttons to be displayed?
-------------------------------------------------

User TSConfig restricts the user to a specified set of buttons;
therefore, for access to all buttons without restriction, in User
TSConfig, set: options.RTEkeyList = \*

Page TSConfig adds the buttons required to edit the table and field
you wish to edit; therefore, to add all buttons by default, in Page
TSConfig, set RTE.default.showButtons = \*

If you are trying to edit the bodytext field of a content element from
table tt\_content, then the TCA field types and palettes may specify a
list of buttons to add; this specification takes precedence over
RTE.default.showButtons; to override any such setting in TCA for the
bodytext field of table tt\_content, in Page TSConfig, set
RTE.config.tt\_content.bodytext.showButtons = \*

If you are trying to edit a text field from another table, then, in
Page TSConfig, set RTE.config.tableName.columnName.showButtons = \*

Buttons textcolor, bgcolor, fontstyle and fontsize are enabled only if
«Enable features that use the style attribute> is checked in the
extension manager.

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.

Safari does not support the paste button.

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


.. _FAQ-Why-does-it-take-so-long-to-load-the-editor-in-Internet-Explorer:

FAQ: Why does it take so long to load the editor in Internet Explorer?
----------------------------------------------------------------------

Try to adjust your IE browser cache settings:

From the IE main menu, navigate to: Tools -> Internet Options ->
General -> button: Configure... or in some other IE versions: Extras
-> Internet Options : Temporary Files -> button: Advanced

Select the radio button Automatic.

Some server configuration settings may also help working around
Internet Explorer caching problems. See the Server Configuration
section and the Tutorial section of this document.


.. _Configuration:

Configuration
=============


.. _Installing-the-RTE:

Installing the RTE
------------------

The extension is a system extension and is installed by default when
TYPO3 is installed.

Use the Extension Manager to un-install/re-install the extension.

The extension may be installed as a system, global or local extension.

You may be requested to uninstall the following extension: rte\_conf.

If you plan to use the spell checking feature, you should install
extension Static Info Tables (static\_info\_tables). The spell checker
feature requires `GNU Aspell 0.60+ `_ to be
installed on the server.

Custom elements presented by the User Elements feature may be
maintained with extension `Custom Tags
`_
(extension key: de\_custom\_tags).

Note that the installation dialog will request to create table
tx\_rtehtmlarea\_acronym; this table is used by theAcronym feature.

Upon installation directory uploads/tx\_rtehtmlarea will be created.
Personal dictionaries are stored in subdirectories of this directory.

Upon installation, if RTE has not yet been enabled with the TYPO3
Install tool, it will be automatically enabled:

::

   $TYPO3_CONF_VARS['BE']['RTEenabled'] = 1;


.. _Extension-configuration-variables:

Extension configuration variables
---------------------------------

The Extension Manager installation dialog allows to set the following
extension configuration variables:

- **Default configuration settings:** let you choose a set of default
  Page TSConfig and User TSConfig settings; select **Typical (Most
  commonly used features are enabled. Select this option if you are
  unsure which one to use.)** for the typical site requirements; select
  **Minimal (Most features disabled. Administrator needs to enable them
  using TypoScript. For advanced administrators only.)** for minimal
  settings; select **Demo (Show-off configuration. Includes pre-
  configured styles. Not for production environments.)** to explore some
  of the available features; default value is Typical;

- **Enable images in the RTE** : if this boolean variable is set, the
  use of images in the “Minimal” or the "Typical" default configuration
  of the RTE will be enabled; default value is 0;

- **Enable additional inline elements:** If set, the potential use of
  additional inline elements will be enabled; default value is 0;

- **Enable features that use the style attribute** : If set, the
  potential use of features that use the style attribute (color,
  fontstyle, fontsize) will be enabled; default value is 1;

- **Enable links accessibility icons** : if this boolean variable is
  set, accessibility icons may be added to links; default value is 0;
  see Page TSConfig property RTE.classesAnchor;

- **Enable compressed scripts:** if this boolean variable is set, editor
  scripts are compressed; default value is 1.

If the SpellChecker is not enabled, then the remaining configuration
variables are irrelevant; note that if extension static\_info\_tables
is not installed, SpellCheker will not be enabled.

- **No spell checking languages** : the list of languages for which
  Aspell does not provide spell checking (see `Unsupported Languages
  `_ ) and for
  which the Spell Checker feature will therefore be disabled (not shown
  in the RTE tool bar); default value is 'ja, km, ko, lo, th, zh, b5,
  gb';

- **Aspell directory:** the server directory in which Aspell is
  installed; default value is “/usr/bin/aspell”;

**Force Aspell command mode:** if this boolean variable is set,the
Aspell command interface will be used; this may be useful when PHP is
compiled with pspell, but with an old version of Aspell, and a newer
version is available in another directory; default value is 0.


.. _User-TSConfig:

User TSConfig
-------------

Upon installation, the extension will set default properties in User
TSConfig as specified by the extension configuration variable:
**Default configuration settings** . Three default configurations are
available: Minimal, Typical, and Demo. These default configurations
are documented in the next section of the present document.

These properties may be modified for any particular BE user or BE user
group, with the Typo3 User Admin Tool. Properties of User TSConfig are
documented in this document: http://typo3.org/documentation/document-
library/doc\_core\_tsconfig/User\_TSconfig/

.. ### BEGIN~OF~TABLE ###


.. _setup-default-edit-RTE:

setup.default.edit\_RTE
^^^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         setup.default.edit\_RTE
   
   Data type
         boolean
   
   Description
         Specifies that RTE editing should be enabled or disabled by default.



.. _setup-override-edit-RTE:

setup.override.edit\_RTE
^^^^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         setup.override.edit\_RTE
   
   Data type
         boolean
   
   Description
         Specifies that RTE editing should be enabled or disabled, the user not
         being allowed to change the setting.



.. _setup-default-rteWidth:

setup.default.rteWidth
^^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         setup.default.rteWidth
   
   Data type
         int+/%
   
   Description
         If set, specifies the default width of the RTE editing area. The
         specified value overrides 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.



.. _setup-override-rteWidth:

setup.override.rteWidth
^^^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         setup.override.rteWidth
   
   Data type
         int+/%
   
   Description
         If set, specifies the width of the RTE editing area, the user not
         being allowed to change the setting. The specified value overrides 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.



.. _setup-default-rteHeight:

setup.default.rteHeight
^^^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         setup.default.rteHeight
   
   Data type
         int+
   
   Description
         If set, specifies the default height of the RTE editing area. The
         specified value overrides the calculated height of the RTE editing
         area. This includes the height of the toolbar, of the editing area and
         of the status bar.



.. _setup-override-rteHeight:

setup.override.rteHeight
^^^^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         setup.override.rteHeight
   
   Data type
         int+
   
   Description
         If set, specifies the height of the RTE editing area, the user not
         being allowed to change the setting. The specified value overrides the
         calculated height of the RTE editing area. This includes the height of
         the toolbar, of the editing area and of the status bar.



.. _setup-default-rteResize:

setup.default.rteResize
^^^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         setup.default.rteResize
   
   Data type
         boolean
   
   Description
         Specifies whether or not the RTE is resizable by default.



.. _setup-override-rteResize:

setup.override.rteResize
^^^^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         setup.override.rteResize
   
   Data type
         boolean
   
   Description
         Specifies whether or not the RTE is resizable, the user not being
         allowed to change the setting.



.. _setup-default-rteMaxHeight:

setup.default.rteMaxHeight
^^^^^^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         setup.default.rteMaxHeight
   
   Data type
         int+
   
   Description
         If set, and if the RTE is resizable, specifies the default maximal
         height of the RTE, including the tool bar, the editing area and the
         status bar.



.. _setup-override-rteMaxHeight:

setup.override.rteMaxHeight
^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         setup.override.rteMaxHeight
   
   Data type
         int+
   
   Description
         If set, and if the RTE is resizable, specifies the default maximal
         height of the RTE, including the tool bar, the editing area and the
         status bar, the user not being allowed to change the setting.



.. _setup-default-rteCleanPasteBehaviour:

setup.default.rteCleanPasteBehaviour
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         setup.default.rteCleanPasteBehaviour
   
   Data type
         string
   
   Description
         If set, specifies the default clean paste behaviour when the
         pastetoggle button is ON.
         
         Possible values are: plainText, pasteStructure, pasteFormat.



.. _setup-override-rteCleanPasteBehaviour:

setup.override.rteCleanPasteBehaviour
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         setup.override.rteCleanPasteBehaviour
   
   Data type
         string
   
   Description
         If set, specifies the clean paste behaviour when the pastetoggle
         button is ON, the user not being allowed to change the setting
         
         Possible values are: plainText, pasteStructure, pasteFormat.



.. _options-RTEkeyList:

options.RTEkeyList
^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         options.RTEkeyList
   
   Data type
         list of id-strings
   
   Description
         Specifies the list of RTE buttons to which the BE user or BE user
         group is restricted.
         
         Default: \* (means all)
         
         Note: For the list of possible buttons, see property showButtons of
         Page TsConfig.



.. _options-HTMLAreaPspellMode:

options.HTMLAreaPspellMode
^^^^^^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         options.HTMLAreaPspellMode
   
   Data type
         string
   
   Description
         Specifies the mode of spelling suggestions. Possible values are:
         ultra, fast, normal or bad-spellers.
         
         Default: normal
         
         Note: For more information on spelling suggestions modes, see `Notes
         on the Different Suggestion Modes `_ ).



.. _options-enablePersonalDicts:

options.enablePersonalDicts
^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         options.enablePersonalDicts
   
   Data type
         boolean
   
   Description
         Enables the personal dictionaries feature for the user or user group,
         when the feature is enabled in Page TSConfig.
         
         Default: 0
         
         Note: The feature must also be enabled in Page TSConfig.



.. _options-uploadFieldsInTopOfEB:

options.uploadFieldsInTopOfEB
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         options.uploadFieldsInTopOfEB
   
   Data type
         boolean
   
   Description
         Inserts a file uploader on the 'file' tab of the Insert/Modify link
         dialogue as well as on the magic, plain and dragdrop tabs of the
         Insert/modify image dialogue.
         
         Note: This applies only when buttons.link.TYPO3Browser.disabled and/or
         buttons.image.TYPO3Browser.disabled is not set.
         
         Default: 0



.. _options-createFoldersInEB:

options.createFoldersInEB
^^^^^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         options.createFoldersInEB
   
   Data type
         boolean
   
   Description
         If set, a create folders option appears in the TYPO3 file browser.
         
         Note: This applies only when buttons.link.TYPO3Browser.disabled and/or
         buttons.image.TYPO3Browser.disabled is not set.
         
         Note: For admin-users this is always enabled.
         
         Default: 0



.. _options-noThumbsInRTEimageSelect:

options.noThumbsInRTEimageSelect
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         options.noThumbsInRTEimageSelect
   
   Data type
         boolean
   
   Description
         If set, then image thumbnails are not shown in the image selector.
         
         Default: 0



.. _options-RTESmallWidth:

options.RTESmallWidth
^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         options.RTESmallWidth
         
         options.RTESmallHeight
   
   Data type
         pixels
   
   Description
         Width and height of the editor area when edit\_wideDocument is NOT
         set.
         
         Default: RTESmallWidth = 530, RTESmallHeight = 380



.. _options-RTELargeWidthIncrement:

options.RTELargeWidthIncrement
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         options.RTELargeWidthIncrement
         
         options.RTELargeHeightIncrement
   
   Data type
         pixels
   
   Description
         Increments applied to the width and height of the editor area when
         edit\_wideDocument IS set.
         
         Default: RTELargeWidthIncrement= 150, RTELargeHeilghtIncrement = 0



.. _page-RTE-default-buttons-formatblock-restrictToItems:

page.RTE.default.buttons.formatblock.restrictToItems
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         page.RTE.default.buttons.formatblock.restrictToItems
   
   Data type
         list of id-strings
   
   Description
         List of options to which the user will be restricted in the block
         formating drop-down list.
         
         The available options are: p, h1, h2, h3, h4, h5, h6, pre, address,
         article, aside, blockquote, div, footer, header, nav, section



.. _page-RTE-default-buttons-formattext-restrictTo:

page.RTE.default.buttons.formattext.restrictTo
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Property
         page.RTE.default.buttons.formattext.restrictTo
   
   Data type
         list of id-strings
   
   Description
         Restricts the availability of options, or inline element types, in the
         text formating drop-down list.
         
         Default: \* (means all)


.. ###### END~OF~TABLE ######


.. _Page-TSConfig:

Page TSConfig
-------------

Upon installation, the extension will set default properties in Page
TSConfig as specified by the extension configuration variable:
**Default configuration settings** . Three default configurations are
available: Minimal, Typical, and Demo. These default configurations
are documented in the next section of the present document.

These properties may be modified in the PageTS Config of your page;
this is most often done on the root page of your site.


.. _generated:

((generated))
^^^^^^^^^^^^^

.. _classes:

classes:
""""""""

Properties of each class available in the RTE.

.. ### BEGIN~OF~TABLE ###


.. _classes-classname:

classes.[ *classname* ]
~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         classes.[ *classname* ]
   
   Description
         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
                    }
            }



.. _Unknown-Property:

((Unknown Property))
~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
   
   
   Description
         Example:
         
         ::
         
            # Hidding an allowed class in the class selector dropped downlist
            RTE.classes.class-name.value = display: none;
         
         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
                            }
                    }
            }
         
         Example:
         
         ::
         
            # Hidding an allowed counting class in the class selector dropped downlist
            # Note the ending hyphen « - »
            # The class name string should be as specified in the counting property
            RTE.classes.counting-class-name-.value = display: none;


.. ###### END~OF~TABLE ######

[page:RTE]


.. _mutuallyExclusiveClasses:

mutuallyExclusiveClasses:
"""""""""""""""""""""""""

Lists of mutually exclusive or incompatible classes.

.. ### BEGIN~OF~TABLE ###


.. _mutuallyExclusiveClasses-label:

mutuallyExclusiveClasses.[ *label* ]
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         mutuallyExclusiveClasses.[ *label* ]
   
   Data type
         list of id-strings
   
   Description
         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.


.. ###### END~OF~TABLE ######

[page:RTE]


.. _colors:

colors:
"""""""

Properties of each color available in the RTE.

.. ### BEGIN~OF~TABLE ###


.. _colors-id-string:

colors.[ *id-string* ]
~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         colors.[ *id-string* ]
   
   Description
         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


.. ###### END~OF~TABLE ######

[page:RTE]


.. _fonts:

fonts:
""""""

Properties of each font available in the RTE.

.. ### BEGIN~OF~TABLE ###


.. _fonts-id-string:

fonts.[ *id-string* ]
~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         fonts.[ *id-string* ]
   
   Description
         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


.. ###### END~OF~TABLE ######

[page:RTE]


.. _fontSizes:

fontSizes:
""""""""""

Properties of each font size available in the RTE.

.. ### BEGIN~OF~TABLE ###


.. _fontSizes-id-string:

fontSizes.[ *id-string* ]
~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         fontSizes.[ *id-string* ]
   
   Description
         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


.. ###### END~OF~TABLE ######

[page:RTE]


.. _RTE-interface-configuration-objects:

RTE interface configuration objects:
""""""""""""""""""""""""""""""""""""

These objects contain the actual configuration of the RTE interface.

.. ### BEGIN~OF~TABLE ###


.. _default:

default.[...]
~~~~~~~~~~~~~

.. container:: table-row

   Property
         default.[...]
         
         config.[ *tablename* ].[ *field* ].[...]
         
         config.[ *tablename* ].[ *field* ].types.[ *type* ].[...]
   
   Description
         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.


.. ###### END~OF~TABLE ######

[page:RTE]


.. _RTE-interface-configuration-properties:

RTE interface configuration properties:
"""""""""""""""""""""""""""""""""""""""

These properties may be set for each RTE interface configuration
object.

.. ### BEGIN~OF~TABLE ###


.. _disabled:

disabled
~~~~~~~~

.. container:: table-row

   Property
         disabled
   
   Data type
         boolean
   
   Description
         If set, the editor is disabled.



.. _showButtons:

showButtons
~~~~~~~~~~~

.. container:: table-row

   Property
         showButtons
   
   Data type
         list of id-strings
   
   Description
         List of buttons that should be enabled in the editor toolbar.
         
         Note: showButtons = \* shows all available buttons.
         
         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, editelement, showmicrodata, emoticon, insertcharacter,
         insertsofthyphen, line, link, unlink, image, table, user, acronym,
         findreplace, spellcheck, chMode, inserttag, removeformat, copy, cut,
         paste, pastetoggle, pastebehaviour, undo, redo, about, toggleborders,
         tableproperties, tablerestyle, rowproperties, rowinsertabove,
         rowinsertunder, rowdelete, rowsplit, columnproperties,
         columninsertbefore, columninsertafter, columndelete, columnsplit,
         cellproperties, cellinsertbefore, cellinsertafter, celldelete,
         cellsplit, cellmerge
         
         Note: Buttons textcolor, bgcolor, fontstyle and fontsize are enabled
         only if «Enable features that use the style attribute> is checked in
         the extension manager.
         
         Note: If extension static\_info\_tables is not installed, the
         spellcheck, language and acronym buttons are not enabled.
         
         Note: If the encoding of the content element is not either iso-8859-1
         or utf-8, the spellcheck button is not enabled.
         
         Note: Buttons user and acronym are never available in the front end.
         
         Note: Button unlink is not available if button link is not available.
         
         Note: None of the table operations buttons is available if the button
         table is not available.
         
         Note: Opera, Safari 5+ and Chrome 6+ do not support the copy, cut and
         paste buttons.



.. _hideButtons:

hideButtons
~~~~~~~~~~~

.. container:: table-row

   Property
         hideButtons
   
   Data type
         list of id-strings
   
   Description
         List of buttons that should not be enabled in the editor toolbar.



.. _toolbarOrder:

toolbarOrder
~~~~~~~~~~~~

.. container:: table-row

   Property
         toolbarOrder
   
   Data type
         list of id-strings
   
   Description
         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, editelement,
         showmicrodata, emoticon, insertcharacter, insertsofthyphen, line,
         link, unlink, image, table, user, acronym, bar, findreplace,
         spellcheck, bar, chMode, inserttag, removeformat, bar, copy, cut,
         paste, pastetoggle, pastebehaviour, bar, undo, redo, bar, 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:

keepButtonGroupTogether
~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         keepButtonGroupTogether
   
   Data type
         boolean
   
   Description
         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:

defaultContentLanguage
~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         defaultContentLanguage
   
   Data type
         string
   
   Description
         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.



.. _disableContextMenu:

disableContextMenu
~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         disableContextMenu
         
         DEPRECATED
   
   Data type
         boolean
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         contextMenu.disable instead.



.. _disableRightClick:

disableRightClick
~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         disableRightClick
         
         DEPRECATED
   
   Data type
         boolean
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         contextMenu.disable instead.



.. _contextMenu-disabled:

contextMenu.disabled
~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         contextMenu.disabled
   
   Data type
         boolean
   
   Description
         If set, the context menu of the RTE triggered by mouse right click is
         disabled.
         
         Default: 0
         
         Note: Context menu is not available in Opera.



.. _contextMenu-showButtons:

contextMenu.showButtons
~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         contextMenu.showButtons
   
   Data type
         list of id-strings
   
   Description
         List of buttons that should be shown in the context menu For the list
         of available buttons see property showButtons above.
         
         Default: If not specified, all buttons available in the editor toolbar
         will appear in the context menu, unless they are removed by property
         contextMenu.hideButtons.
         
         Note: Drop-down lists or select boxes will not be shown in the context
         menu.
         
         Note: The buttons must be enabled in the editor toolbar.
         
         Note: The buttons will appear in the same order as in the editor
         toolbar (see property toolbarOrderabove).



.. _contextmenu-hideButtons:

contextmenu.hideButtons
~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         contextmenu.hideButtons
   
   Data type
         list of id-strings
   
   Description
         List of buttons that should not be shown in the context menu.



.. _contextMenu-maxHeight:

contextMenu.maxHeight
~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         contextMenu.maxHeight
   
   Data type
         int+
   
   Description
         Maximum height of the context menu in pixels.
         
         Default: 300



.. _showStatusBar:

showStatusBar
~~~~~~~~~~~~~

.. container:: table-row

   Property
         showStatusBar
   
   Data type
         boolean
   
   Description
         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-editelement-removeFieldsets:

buttons.editelement.removeFieldsets
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.editelement.removeFieldsets
   
   Data type
         list of id-strings
   
   Description
         List of fieldsets to remove from the edit element dialogue.
         
         Possible string values are: identification, style, language,
         microdata, events.



.. _buttons-editelement-properties-removed:

buttons.editelement.properties.removed
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.editelement.properties.removed
   
   Data type
         list of id-strings
   
   Description
         List of fields to remove from the edit element dialogue.
         
         Possible string values are: id, title, language, direction, onkeydown,
         onkeypress, onkeyup, onclick, ondblclick, onmousedown, onmousemove,
         onmouseout, onmouseover, onmouseup.



.. _buttons-formatblock-orderItems:

buttons.formatblock.orderItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.formatblock.orderItems
   
   Data type
         list of id-strings
   
   Description
         Specifies the order in which the block element types are presented in
         the block formating drop-down list.
         
         The standard block element types are: p, h1, h2, h3, h4, h5, h6, pre,
         address, article, aside, blockquote, div, footer, header, nav, section
         
         The list may also contain custom items as specified by the
         buttons.formatblock.addItems property.
         
         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:

buttons.formatblock.removeItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.formatblock.removeItems
   
   Data type
         list of id-strings
   
   Description
         List of default items to be removed from the block formating drop-down
         list.
         
         The default items are: p, h1, h2, h3, h4, h5, h6, pre, address,
         article, aside, blockquote, div, footer, header, nav, section



.. _buttons-formatblock-addItems:

buttons.formatblock.addItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.formatblock.addItems
   
   Data type
         list of id-strings
   
   Description
         List of custom items to be added to the block formating drop-down
         list.
         
         Each of the added items should be configured.



.. _hidePStyleItems:

hidePStyleItems
~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         hidePStyleItems
         
         DEPRECATED
   
   Data type
         list of id-strings
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.formatblock.removeItems instead.



.. _buttons-formatblock-items-item-name-label:

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

.. container:: table-row

   Property
         buttons.formatblock.items.[ *item-name* ].label
   
   Data type
         string
   
   Description
         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-items-item-name-addClass:

buttons.formatblock.items.[ *item-name* ].addClass
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.formatblock.items.[ *item-name* ].addClass
   
   Data type
         string
   
   Description
         A class name to be assigned to the blocks whenever the item is applied
         to selected text.
         
         Note: The specified class should be allowed on elements of the block
         type (using property RTE.default.buttons.blockstyle.tags.[ *tagName*
         ].allowedClasses).



.. _buttons-formatblock-items-item-name-tagName:

buttons.formatblock.items.[ *item-name* ].tagName
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.formatblock.items.[ *item-name* ].tagName
   
   Data type
         string
   
   Description
         A tag name to be assigned to the block elements whenever the (custom)
         item is applied to selected text.
         
         The value of this property must be equal to one of the standard block
         element types.
         
         Note: [ *item-name* ] must not be a standard block tag name.
         
         Note: If [ *item-name* ] also has property addClass, then the
         specified class should be allowed on elements of block type tagName
         (using property RTE.default.buttons.blockstyle.tags.[ *tagName*
         ].allowedClasses).



.. _buttons-formatblock-prefixLabelWithTag:

buttons.formatblock.prefixLabelWithTag
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.formatblock.prefixLabelWithTag
   
   Data type
         boolean
   
   Description
         If set, the option label in the block formating drop-down list is
         prefixed with the tagname.
         
         Default: 0



.. _buttons-formatblock-postfixLabelWithTag:

buttons.formatblock.postfixLabelWithTag
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.formatblock.postfixLabelWithTag
   
   Data type
         boolean
   
   Description
         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:

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

.. container:: table-row

   Property
         buttons.formatblock.items.[ *item-name* ].hotKey
   
   Data type
         character
   
   Description
         A hotkey will be associated with the option of the block formating
         drop-down list identified by the item name.



.. _buttons-indent-useClass:

buttons.indent.useClass
~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.indent.useClass
   
   Data type
         string
   
   Description
         Class name to be used when indenting by means of div sections with
         class attribute.
         
         Default: indent



.. _buttons-indent-useBlockquote:

buttons.indent.useBlockquote
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.indent.useBlockquote
   
   Data type
         boolean
   
   Description
         If set, indentation will be produced by means of blockquote tags
         instead of div sections with class attribute.
         
         Default: 0



.. _buttons-left-useClass:

buttons.left.useClass
~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.left.useClass
   
   Data type
         string
   
   Description
         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:

buttons.center.useClass
~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.center.useClass
   
   Data type
         string
   
   Description
         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:

buttons.right.useClass
~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.right.useClass
   
   Data type
         string
   
   Description
         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:

buttons.justifyfull.useClass
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.justifyfull.useClass
   
   Data type
         string
   
   Description
         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.left.useAlignAttribute
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.left.useAlignAttribute
         
         buttons.center.useAlignAttribute
         
         buttons.right.useAlignAttribute
         
         buttons.justifyfull.useAlignAttribute
   
   Data type
         boolean
   
   Description
         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:

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

.. container:: table-row

   Property
         buttons.blockstyle.tags.[ *tag-name* ].allowedClasses
   
   Data type
         list of id-strings
   
   Description
         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, in
         the CSS file specified by the contentCSS property.
         
         If the property is empty for any tag, classes associated with the
         given tag 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-all-allowedClasses:

buttons.blockstyle.tags.all.allowedClasses
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.blockstyle.tags.all.allowedClasses
   
   Data type
         list of id-strings
   
   Description
         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, 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:

classesParagraph
~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         classesParagraph
         
         DEPRECATED
   
   Data type
         list of id-strings
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.blockstyle.tags.div.allowedClasses instead.



.. _classesTable:

classesTable
~~~~~~~~~~~~

.. container:: table-row

   Property
         classesTable
         
         DEPRECATED
   
   Data type
         list of id-strings
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.blockstyle.tags.table.allowedClasses instead.



.. _classesTD:

classesTD
~~~~~~~~~

.. container:: table-row

   Property
         classesTD
         
         DEPRECATED
   
   Data type
         list of id-strings
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.blockstyle.tags.td.allowedClasses instead.



.. _buttons-blockstyle-showTagFreeClasses:

buttons.blockstyle.showTagFreeClasses
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.blockstyle.showTagFreeClasses
   
   Data type
         boolean
   
   Description
         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



.. _buttons-blockstyle-prefixLabelWithClassName:

buttons.blockstyle.prefixLabelWithClassName
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.blockstyle.prefixLabelWithClassName
   
   Data type
         boolean
   
   Description
         If set, the option name in the block style drop-down list is prefixed
         with the class name.
         
         Default: 0



.. _buttons-blockstyle-postfixLabelWithClassName:

buttons.blockstyle.postfixLabelWithClassName
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.blockstyle.postfixLabelWithClassName
   
   Data type
         boolean
   
   Description
         If set, the option name e in the block style drop-down list is
         postfixed with the class name.
         
         Default: 0



.. _buttons-blocktstyle-disableStyleOnOptionLabel:

buttons.blocktstyle.disableStyleOnOptionLabel
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.blocktstyle.disableStyleOnOptionLabel
   
   Data type
         boolean
   
   Description
         If set, the styling is removed on the options block styling drop-down
         list.
         
         Default: 0
         
         See value property of RTE.classes array.



.. _buttons-formattext-orderItems:

buttons.formattext.orderItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.formattext.orderItems
   
   Data type
         list of id-strings
   
   Description
         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:

buttons.formattext.removeItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.formattext.removeItems
   
   Data type
         list of id-strings
   
   Description
         List of options to be removed from the text formating drop-down list
         using same names as toolbar elements.



.. _buttons-formattext-prefixLabelWithTag:

buttons.formattext.prefixLabelWithTag
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.formattext.prefixLabelWithTag
   
   Data type
         boolean
   
   Description
         If set, the option name in the text formating drop-down list is
         prefixed with the tagname.
         
         Default: 0



.. _buttons-formattext-postfixLabelWithTag:

buttons.formattext.postfixLabelWithTag
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.formattext.postfixLabelWithTag
   
   Data type
         boolean
   
   Description
         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:

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

.. container:: table-row

   Property
         buttons.textstyle.tags.[ *tag-name* ].allowedClasses
   
   Data type
         list of id-strings
   
   Description
         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 in the CSS file specified by
         contentCSS property.
         
         If the property is empty for any tag, classes associated with the
         given tag 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:

buttons.textstyle.tags.all.allowedClasses
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.textstyle.tags.all.allowedClasses
   
   Data type
         list of id-strings
   
   Description
         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 in the CSS file specified by
         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:

buttons.textstyle.showTagFreeClasses
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.textstyle.showTagFreeClasses
   
   Data type
         boolean
   
   Description
         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:

buttons.textstyle.prefixLabelWithClassName
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.textstyle.prefixLabelWithClassName
   
   Data type
         boolean
   
   Description
         If set, the option name in the text styling drop-down list is prefixed
         with the class name.
         
         Default: 0



.. _buttons-textstyle-postfixLabelWithClassName:

buttons.textstyle.postfixLabelWithClassName
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.textstyle.postfixLabelWithClassName
   
   Data type
         boolean
   
   Description
         If set, the option name e in the text styling drop-down list is
         postfixed with the class name.
         
         Default: 0



.. _buttons-textstyle-disableStyleOnOptionLabel:

buttons.textstyle.disableStyleOnOptionLabel
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.textstyle.disableStyleOnOptionLabel
   
   Data type
         boolean
   
   Description
         If set, the styling is removed on the options text styling drop-down
         list.
         
         Default: 0
         
         See value property of RTE.classes array.



.. _classesCharacter:

classesCharacter
~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         classesCharacter
         
         DEPRECATED
   
   Data type
         list of id-strings
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.textstyle.tags.span.allowedClasses instead.



.. _showTagFreeClasses:

showTagFreeClasses
~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         showTagFreeClasses
         
         DEPRECATED
   
   Data type
         boolean
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.blockstyle.showTagFreeClasses and
         buttons.textstyle.showTagFreeClasses instead.



.. _disablePCexamples:

disablePCexamples
~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         disablePCexamples
         
         DEPRECATED
   
   Data type
         boolean
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.blockstyle.disableStyleOnOptionLabel and/or
         buttons.textstyle.disableStyleOnOptionLabel instead.



.. _buttons-language-restrictToItems:

buttons.language.restrictToItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.language.restrictToItems
   
   Data type
         list of strings
   
   Description
         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:

buttons.language.useLangAttribute
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.language.useLangAttribute
   
   Data type
         boolean
   
   Description
         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:

buttons.language.useXmlLangAttribute
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.language.useXmlLangAttribute
   
   Data type
         boolean
   
   Description
         If set, the xml:lang attribute is used fro language marks.
         
         Default: 0



.. _buttons-language-prefixLabelWithCode:

buttons.language.prefixLabelWithCode
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.language.prefixLabelWithCode
   
   Data type
         boolean
   
   Description
         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:

buttons.language.postfixLabelWithCode
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.language.postfixLabelWithCode
   
   Data type
         boolean
   
   Description
         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:

buttons.spellcheck.enablePersonalDictionaries
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.spellcheck.enablePersonalDictionaries
   
   Data type
         boolean
   
   Description
         If set, personal dictionaries are enabled.
         
         Default: 0
         
         Note: The feature must also be enabled in User TSConfig.
         
         Note: Personal dictionaries are stored in subdirectories of
         uploads/tx\_rtehtmlarea



.. _buttons-spellcheck-dictionaries-restrictToItems:

buttons.spellcheck.dictionaries.restrictToItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.spellcheck.dictionaries.restrictToItems
   
   Data type
         list-of-id-strings
   
   Description
         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 will appear in
         the drop-down list.



.. _buttons-spellcheck-dictionaries-language-iso-code-defaultValue:

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

.. container:: table-row

   Property
         buttons.spellcheck.dictionaries.[ *language-iso-code* ].defaultValue
   
   Data type
         string
   
   Description
         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:

disableTYPO3Browsers
~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         disableTYPO3Browsers
         
         DEPRECATED
   
   Data type
         boolean
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.image.TYPO3Browser.disabled and
         buttons.link.TYPO3Browser.disabled instead.



.. _classesImage:

classesImage
~~~~~~~~~~~~

.. container:: table-row

   Property
         classesImage
         
         DEPRECATED
   
   Data type
         list of id-strings
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.image.properties.class.allowedClasses instead.



.. _buttons-image-TYPO3Browser-disabled:

buttons.image.TYPO3Browser.disabled
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.image.TYPO3Browser.disabled
   
   Data type
         boolean
   
   Description
         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:

blindImageOptions
~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         blindImageOptions
         
         DEPRECATED
   
   Data type
         list of strings
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.image.options.removeItems instead.



.. _buttons-image-options-removeItems:

buttons.image.options.removeItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.image.options.removeItems
   
   Data type
         list of strings
   
   Description
         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: More tabs may be provided by extensions such as DAM.
         
         Note: dragdrop is not available in Opera.



.. _buttons-image-options-orderItems:

buttons.image.options.orderItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.image.options.orderItems
   
   Data type
         list of strings
   
   Description
         List of tab items in the order in which they should appear in the
         dialogue window. Items not in the list will not be available.
         
         Note: Items that are removed will not be available (see
         buttons.image.options.removeItems).
         
         Note: The default order is: image, magic, plain, dragdrop.
         
         Note: The list may include items added by extensions such as DAM.
         
         Note: The default order may be modified by extensions such as DAM.



.. _buttons-image-options-magic-maxWidth:

buttons.image.options.magic.maxWidth
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.image.options.magic.maxWidth
   
   Data type
         int+
   
   Description
         Maximum width of a magic image in pixels at the time of its initial
         insertion.
         
         Default: 300
         
         Note: The width of the magic image may be made larger when updating
         the image properties. However, the image is not recreated, only its
         HTML width attribute is updated.



.. _buttons-image-options-magic-maxHeight:

buttons.image.options.magic.maxHeight
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.image.options.magic.maxHeight
   
   Data type
         int+
   
   Description
         Maximum height of a magic image in pixels at the time of its initial
         insertion.
         
         Default: 1000
         
         Note: By setting a large enough height, images should be resized based
         on their width.
         
         Note: The height of the magic image may be made larger when updating
         the image properties. However, the image is not recreated, only its
         HTML height attribute is updated.



.. _buttons-image-options-plain-maxWidth:

buttons.image.options.plain.maxWidth
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.image.options.plain.maxWidth
   
   Data type
         int+
   
   Description
         Maximum width of selectable plain images in pixels.
         
         Default: 640



.. _buttons-image-options-plain-maxHeight:

buttons.image.options.plain.maxHeight
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.image.options.plain.maxHeight
   
   Data type
         int+
   
   Description
         Maximum height of selectable plain images in pixels.
         
         Default: 680



.. _buttons-image-title-useDAMColumn:

buttons.image.title.useDAMColumn
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.image.title.useDAMColumn
   
   Data type
         string
   
   Description
         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 ignored if integration of DAM with the htmlArea
         RTE is not set in the DAM extension.



.. _buttons-image-properties-removeItems:

buttons.image.properties.removeItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.image.properties.removeItems
   
   Data type
         list of strings
   
   Description
         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-allowedClasses:

buttons.image.properties.class.allowedClasses
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.image.properties.class.allowedClasses
   
   Data type
         list of id-strings
   
   Description
         Classes available in the Insert/Modify image dialogue.
         
         Each of the listed classes must be defined in the CSS file specified
         by the contentCSS property.



.. _buttons-image-properties-class-default:

buttons.image.properties.class.default
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.image.properties.class.default
   
   Data type
         string
   
   Description
         Class to be assigned by default to an image when it is inserted in the
         RTE.



.. _classesLinks:

classesLinks
~~~~~~~~~~~~

.. container:: table-row

   Property
         classesLinks
         
         DEPRECATED
   
   Data type
         list of id-strings
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.link.properties.class.allowedClasses instead.



.. _classesAnchor:

classesAnchor
~~~~~~~~~~~~~

.. container:: table-row

   Property
         classesAnchor
         
         DEPRECATED
   
   Data type
         list of id-strings
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.link.properties.class.allowedClasses instead.



.. _classesAnchor-default-page:

classesAnchor.default.page
~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         classesAnchor.default.page
         
         DEPRECATED
   
   Data type
         string
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.link.page.properties.class.default instead.



.. _classesAnchor-default-url:

classesAnchor.default.url
~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         classesAnchor.default.url
         
         DEPRECATED
   
   Data type
         string
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.link.url.properties.class.default instead.



.. _classesAnchor-default-file:

classesAnchor.default.file
~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         classesAnchor.default.file
         
         DEPRECATED
   
   Data type
         string
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.link.file.properties.class.default instead.



.. _classesAnchor-default-mail:

classesAnchor.default.mail
~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         classesAnchor.default.mail
         
         DEPRECATED
   
   Data type
         string
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.link.mail.properties.class.default instead.



.. _buttons-link-TYPO3Browser-disabled:

buttons.link.TYPO3Browser.disabled
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.link.TYPO3Browser.disabled
   
   Data type
         boolean
   
   Description
         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:

defaultLinkTarget
~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         defaultLinkTarget
         
         DEPRECATED
   
   Data type
         string
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.link.properties.target.default instead.



.. _blindLinkOptions:

blindLinkOptions
~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         blindLinkOptions
         
         DEPRECATED
   
   Data type
         list of strings
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.link.options.removeItems instead.



.. _buttons-link-options-removeItems:

buttons.link.options.removeItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.link.options.removeItems
   
   Data type
         list of strings
   
   Description
         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.



.. _buttons-link-targetSelector-disabled:

buttons.link.targetSelector.disabled
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.link.targetSelector.disabled
   
   Data type
         boolean
   
   Description
         If set, the selection of link target is removed from the link
         insertion/update dialog.
         
         Default : 0



.. _buttons-link-popupSelector-disabled:

buttons.link.popupSelector.disabled
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.link.popupSelector.disabled
   
   Data type
         boolean
   
   Description
         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:

buttons.link.pageIdSelector.enabled
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.link.pageIdSelector.enabled
   
   Data type
         boolean
   
   Description
         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:

buttons.link.queryParametersSelector.enabled
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.link.queryParametersSelector.enabled
   
   Data type
         boolean
   
   Description
         If set, an additional field is enabbled in the link insertion/update
         dialogue allowing authors to specify query parameters to be added on
         the link
         
         Default: 0



.. _buttons-link-relAttribute-enabled:

buttons.link.relAttribute.enabled
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.link.relAttribute.enabled
   
   Data type
         boolean
   
   Description
         If set, an additional field is enabled in the link insertion/update
         dialogue allowing authors to specify a rel attribute to be added to
         the link.
         
         Default: 0



.. _buttons-link-properties-class-allowedClasses:

buttons.link.properties.class.allowedClasses
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.link.properties.class.allowedClasses
   
   Data type
         list of id-strings
   
   Description
         Classes available in the Insert/Modify link dialogue.
         
         These classes may be defined by the RTE.classesAnchor property.



.. _buttons-link-properties-class-default:

buttons.link.properties.class.default
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.link.properties.class.default
   
   Data type
         string
   
   Description
         Class to be assigned by default to a link when it is inserted in the
         RTE. See also buttons.link.[ *type* ].properties.class.default.



.. _buttons-link-type-properties-class-default:

buttons.link.[ *type* ].properties.class.default
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.link.[ *type* ].properties.class.default
   
   Data type
         string
   
   Description
         The name of the default class selector for links of the given type.
         Possible types are: page, file, url, mail, spec. More types may be
         provided by extensions such as DAM.



.. _buttons-link-properties-class-required:

buttons.link.properties.class.required
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.link.properties.class.required
   
   Data type
         boolean
   
   Description
         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:

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

.. container:: table-row

   Property
         buttons.link.[ *type* ].properties.class.required
   
   Data type
         boolean
   
   Description
         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:

buttons.link.properties.title.readOnly
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.link.properties.title.readOnly
   
   Data type
         boolean
   
   Description
         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:

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

.. container:: table-row

   Property
         buttons.link.[ *type* ].properties.title.readOnly
   
   Data type
         boolean
   
   Description
         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-link-properties-target-default:

buttons.link.properties.target.default
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.link.properties.target.default
   
   Data type
         string
   
   Description
         This sets the default target for new links in the RTE.
         
         Note: See also the classesAnchor configuration.



.. _buttons-acronym-pages:

buttons.acronym.pages
~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.acronym.pages
   
   Data type
         list of page id's
   
   Description
         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:

buttons.acronym.recursive
~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.acronym.recursive
   
   Data type
         int
   
   Description
         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:

buttons.acronym. lockBeUserToDBmounts
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.acronym. lockBeUserToDBmounts
   
   Data type
         boolean
   
   Description
         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:

colors
~~~~~~

.. container:: table-row

   Property
         colors
   
   Data type
         list of id-strings
   
   Description
         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:

disableColorPicker
~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         disableColorPicker
   
   Data type
         boolean
   
   Description
         Disables the color picker matrix in all color dialogs. The color
         picker lets you select web-colors.



.. _hideFontFaces:

hideFontFaces
~~~~~~~~~~~~~

.. container:: table-row

   Property
         hideFontFaces
         
         DEPRECATED
   
   Data type
         list of id-numbers,
         
         \* removes all
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.fontstyle.removeItems instead.



.. _fontFace:

fontFace
~~~~~~~~

.. container:: table-row

   Property
         fontFace
         
         DEPRECATED
   
   Data type
         list of id-strings
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.fontstyle.addItems instead.



.. _buttons-fontstyle-removeItems:

buttons.fontstyle.removeItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.fontstyle.removeItems
   
   Data type
         list of id-numbers,
         
         \* removes all
   
   Description
         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



.. _buttons-fontstyle-addItems:

buttons.fontstyle.addItems
~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.fontstyle.addItems
   
   Data type
         list of id-strings
   
   Description
         Defines additional fonts available in the font selector. The id-
         strings must be configured in the RTE.fonts array (see description
         earlier).



.. _buttons-fontstyle-defaultItem:

buttons.fontstyle.defaultItem
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.fontstyle.defaultItem
   
   Data type
         string
   
   Description
         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:

hideFontSizes
~~~~~~~~~~~~~

.. container:: table-row

   Property
         hideFontSizes
         
         DEPRECATED
   
   Data type
         list of size-numbers,
         
         \* removes all
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.fontsize.removeItems instead.



.. _fontSize:

fontSize
~~~~~~~~

.. container:: table-row

   Property
         fontSize
         
         DEPRECATED
   
   Data type
         list of id-strings
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         buttons.fontsize.addItems instead.



.. _buttons-fontsize-removeItems:

buttons.fontsize.removeItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.fontsize.removeItems
   
   Data type
         list of size-numbers,
         
         \* removes all
   
   Description
         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



.. _buttons-fontsize-addItems:

buttons.fontsize.addItems
~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.fontsize.addItems
   
   Data type
         list of id-strings
   
   Description
         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-defaultItem:

buttons.fontsize.defaultItem
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.fontsize.defaultItem
   
   Data type
         string
   
   Description
         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:

hideTableOperationsInToolbar
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         hideTableOperationsInToolbar
   
   Data type
         boolean
   
   Description
         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.



.. _buttons-toggleborders-keepInToolbar:

buttons.toggleborders.keepInToolbar
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.toggleborders.keepInToolbar
   
   Data type
         boolean
   
   Description
         If set, the toggleborders button will be kept in the tool bar even if
         property hideTableOperationsInToolbar is set.
         
         Default: 0



.. _buttons-toggleborders-setOnTableCreation:

buttons.toggleborders.setOnTableCreation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.toggleborders.setOnTableCreation
   
   Data type
         boolean
   
   Description
         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:

buttons.toggleborders.setOnRTEOpen
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.toggleborders.setOnRTEOpen
   
   Data type
         boolean
   
   Description
         If set, and if the toggleborders button is enabled, the table borders
         will be toggled on when the RTE opens.
         
         Default : 0



.. _buttons-button-name-hotKey:

buttons.[ *button-name* ].hotKey
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.[ *button-name* ].hotKey
   
   Data type
         character
   
   Description
         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-width:

buttons.[ *button-name* ].width
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.[ *button-name* ].width
   
   Data type
         int+
   
   Description
         The width of the field in the toolbar when the button is a dropdown
         list.



.. _buttons-button-name-listWidth:

buttons.[ *button-name* ].listWidth
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.[ *button-name* ].listWidth
   
   Data type
         int+
   
   Description
         The width of the dropdown list when the button is a dropdown list.
         
         Defauls to the width of the field in the toolbar.



.. _buttons-button-name-maxHeight:

buttons.[ *button-name* ].maxHeight
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.[ *button-name* ].maxHeight
   
   Data type
         int+
   
   Description
         The maximum height of the dropdown list when the button is a dropdown
         list.



.. _buttons-button-name-dialogueWindow-width:

buttons.[ *button-name* ].dialogueWindow.width
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.[ *button-name* ].dialogueWindow.width
   
   Data type
         int+
   
   Description
         The opening width of the dialogue window opened when the button is
         pressed.



.. _buttons-button-name-dialogueWindow-height:

buttons.[ *button-name* ].dialogueWindow.height
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.[ *button-name* ].dialogueWindow.height
   
   Data type
         int+
   
   Description
         The opening height of the dialogue window opened when the button is
         pressed.



.. _buttons-button-name-dialogueWindow-positionFromTop:

buttons.[ *button-name* ].dialogueWindow.positionFromTop
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.[ *button-name* ].dialogueWindow.positionFromTop
   
   Data type
         int+
   
   Description
         The opening position from the top of the screen of the dialogue window
         opened when the button is pressed.



.. _buttons-button-name-dialogueWindow-positionFromLeft:

buttons.[ *button-name* ].dialogueWindow.positionFromLeft
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.[ *button-name* ].dialogueWindow.positionFromLeft
   
   Data type
         int+
   
   Description
         The opening position from the left of the screen of the dialogue
         window opened when the button is pressed.



.. _buttons-button-name-dialogueWindow-doNotResize:

buttons.[ *button-name* ].dialogueWindow.doNotResize
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.[ *button-name* ].dialogueWindow.doNotResize
   
   Data type
         boolean
   
   Description
         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:

buttons.[ *button-name* ].dialogueWindow.doNotCenter
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.[ *button-name* ].dialogueWindow.doNotCenter
   
   Data type
         boolean
   
   Description
         If set, the window that is opened when the button is pressed will not
         be centered in the parent window.
         
         Default: 0



.. _mainStyleOverride:

mainStyleOverride
~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         mainStyleOverride
         
         DEPRECATED
   
   Data type
         string
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         contentCSS instead.
         
         By default the editor style section is set with the CSS-code below.
         However you may override this by this option.
         
         Default:
         
         ::
         
            body.htmlarea-content-body {
                    font-family: Verdana,sans-serif; 
                    font-size: 12px;
                    color: black;
                    background-color: white;
            }
            td { }
            div { }
            pre { }
            ol { }
            ul { }
            blockquote { }
         
         Note: See also property ignoreMainStyleOverride.



.. _mainStyleOverride-add-key:

mainStyleOverride\_add.[ *key* ]
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         mainStyleOverride\_add.[ *key* ]
         
         DEPRECATED
   
   Data type
         string (css-style)
   
   Description
         This property is DEPRECATED and will be removed in TYPO3 4.8. Use
         contentCSS instead.
         
         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: See also property ignoreMainStyleOverride.



.. _mainStyle-font:

mainStyle\_font
~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         mainStyle\_font
         
         mainStyle\_size
         
         mainStyle\_color
         
         mainStyle\_bgcolor
         
         DEPRECATED
   
   Data type
         string
   
   Description
         These properties are DEPRECATED and will be removed in TYPO3 4.8. Use
         contentCSS instead.
         
         Setting the default font-family (verdana) , font-size (10px), font-
         color (black) and background color (white)
         
         The default is shown in “.mainStyleOverride” above.
         
         Note: See also property ignoreMainStyleOverride.



.. _inlineStyle-any-keystring:

inlineStyle.[ *any-keystring* ]
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         inlineStyle.[ *any-keystring* ]
         
         DEPRECATED
   
   Data type
         string
   
   Description
         These properties are DEPRECATED and will be removed in TYPO3 4.8. Use
         contentCSS instead.
         
         CSS code to be included in the editor style section. This will be
         included  *after* the default code.
         
         Note: See also property ignoreMainStyleOverride.



.. _skin:

skin
~~~~

.. container:: table-row

   Property
         skin
   
   Data type
         resource
   
   Description
         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:

contentCSS
~~~~~~~~~~

.. container:: table-row

   Property
         contentCSS
   
   Data type
         resource
   
   Description
         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:

ignoreMainStyleOverride
~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         ignoreMainStyleOverride
         
         DEPRECATED
   
   Data type
         boolean
   
   Description
         These properties are DEPRECATED and will be removed in TYPO3 4.8. Use
         contentCSS instead.
         
         If set, properties mainStyleOverride and inlineStyle are ignored.
         
         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
~~~~

.. container:: table-row

   Property
         proc
   
   Data type
         ->PROC
   
   Description
         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:

enableWordClean
~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         enableWordClean
   
   Data type
         boolean/
         
         ->HTMLparser
   
   Description
         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: If an HTMLparser configuration is specified, care should be
         taken that span tags with id attribute are not removed by the cleaning
         operation. If they are removed, the cursor position will not be
         restored in non-IE browsers after the paste operation, and the cursor
         will then be positionned at the start of the text.
         
         Note: Additional cleanup may be performed by the user when the
         removeformat button is enabled.
         
         Note: Cleaning on paste cannot be performed in Opera.
         
         Note: The same cleaning operation is performed with hotkey CTRL+0,
         including in Opera.



.. _enableWordClean-hotKey:

enableWordClean.hotKey
~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         enableWordClean.hotKey
   
   Data type
         character
   
   Description
         The default hotkey of the cleaning operation, CTRL+0, is replaced by
         CTRL+the specified character.



.. _removeComments:

removeComments
~~~~~~~~~~~~~~

.. container:: table-row

   Property
         removeComments
   
   Data type
         boolean
   
   Description
         Specifies that html comments should be removed or not by the editor on
         save and on toggle to HTML source mode.
         
         Default: 0



.. _removeTags:

removeTags
~~~~~~~~~~

.. container:: table-row

   Property
         removeTags
   
   Data type
         list of tags
   
   Description
         List of tags that should be removed by the editor on save and on
         toggle to HTML source mode.



.. _removeTagsAndContents:

removeTagsAndContents
~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         removeTagsAndContents
   
   Data type
         list of tags
   
   Description
         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:

useCSS
~~~~~~

.. container:: table-row

   Property
         useCSS
   
   Data type
         boolean
   
   Description
         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:

disableEnterParagraphs
~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         disableEnterParagraphs
   
   Data type
         boolean
   
   Description
         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:

disableObjectResizing
~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         disableObjectResizing
   
   Data type
         boolean
   
   Description
         Specifies that Mozilla/Firefox should not provide handles for resizing
         objects such as images and tables.
         
         Default: 0



.. _removeTrailingBR:

removeTrailingBR
~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         removeTrailingBR
   
   Data type
         boolean
   
   Description
         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.



.. _buttons-inserttag-denyTags:

buttons.inserttag.denyTags
~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.inserttag.denyTags
   
   Data type
         list of tags
   
   Description
         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:

buttons.inserttag.allowedAttribs
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.inserttag.allowedAttribs
   
   Data type
         list of attributes
   
   Description
         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:

buttons.inserttag.tags. *[tagname]* .allowedAttribs
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.inserttag.tags. *[tagname]* .allowedAttribs
   
   Data type
         list of attributes
   
   Description
         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:

buttons.table.disableEnterParagraphs
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.disableEnterParagraphs
   
   Data type
         boolean
   
   Description
         If set, this property will prevent the insertion of paragraphs in
         table cells when the enter key is pressed.
         
         Default: 0



.. _buttons-table-enableHandles:

buttons.table.enableHandles
~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.enableHandles
   
   Data type
         boolean
   
   Description
         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:

disableAlignmentFieldsetInTableOperations
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         disableAlignmentFieldsetInTableOperations
         
         disableSpacingFieldsetInTableOperations
         
         disableColorFieldsetInTableOperations
         
         disableLayoutFieldsetInTableOperations
         
         disableBordersFieldsetInTableOperations
   
   Data type
         boolean
   
   Description
         Disables the corresponding fieldset in all table operations dialogues.
         
         Default: 0



.. _buttons-table-removeFieldsets:

buttons.table.removeFieldsets
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.removeFieldsets
   
   Data type
         list of strings
   
   Description
         List of fieldsets to remove from the table creation dialogue. Key list
         is alignment, borders, color, description, language, layout, spacing,
         style



.. _buttons-tableproperties-removeFieldsets:

buttons.tableproperties.removeFieldsets
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.tableproperties.removeFieldsets
   
   Data type
         list of strings
   
   Description
         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:

buttons.table.properties.required
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.required
   
   Data type
         list of strings
   
   Description
         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:

buttons.table.properties.removed
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.removed
   
   Data type
         list of strings
   
   Description
         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:

buttons.table.properties.numberOfRows.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.numberOfRows.defaultValue
   
   Data type
         int+
   
   Description
         Default value for the number of rows to include in a table on
         creation.
         
         Default: 2



.. _buttons-table-properties-numberOfColumns-defaultValue:

buttons.table.properties.numberOfColumns.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.numberOfColumns.defaultValue
   
   Data type
         int+
   
   Description
         Default value for the number of columns to include in a table on
         creation.
         
         Default: 4



.. _buttons-table-properties-headers-defaultValue:

buttons.table.properties.headers.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.headers.defaultValue
   
   Data type
         string
   
   Description
         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:

buttons.table.properties.headers.removeItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.headers.removeItems
   
   Data type
         list of strings
   
   Description
         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:

buttons.table.properties.headers.both.useHeaderClass
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.headers.both.useHeaderClass
   
   Data type
         list of strings
   
   Description
         A class to be assigned to the top row when the headers property
         specifies both.
         
         Default: thead



.. _buttons-table-properties-tableClass-defaultValue:

buttons.table.properties.tableClass.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.tableClass.defaultValue
   
   Data type
         string
   
   Description
         Default selected class in the table class selector in the table
         creation dialogue.
         
         Default: void



.. _buttons-table-properties-width-defaultValue:

buttons.table.properties.width.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.width.defaultValue
   
   Data type
         +int
   
   Description
         Default value of the table wdth in the table creation dialogue.
         
         Default: void



.. _buttons-table-properties-widthUnit-defaultValue:

buttons.table.properties.widthUnit.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.widthUnit.defaultValue
   
   Data type
         string
   
   Description
         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:

buttons.table.properties.widthUnit.removeItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.widthUnit.removeItems
   
   Data type
         list of strings
   
   Description
         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:

buttons.table.properties.height.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.height.defaultValue
   
   Data type
         +int
   
   Description
         Default value of the table height in the table creation dialogue.
         
         Default: void



.. _buttons-table-properties-heightUnit-defaultValue:

buttons.table.properties.heightUnit.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.heightUnit.defaultValue
   
   Data type
         string
   
   Description
         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:

buttons.table.properties.heightUnit.removeItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.heightUnit.removeItems
   
   Data type
         list of strings
   
   Description
         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:

buttons.table.properties.float.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.float.defaultValue
   
   Data type
         string
   
   Description
         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:

buttons.table.properties.float.left.useClass
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.float.left.useClass
   
   Data type
         string
   
   Description
         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:

buttons.table.properties.float.right.useClass
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.float.right.useClass
   
   Data type
         string
   
   Description
         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:

buttons.table.properties.float.removeItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.float.removeItems
   
   Data type
         list of strings
   
   Description
         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:

buttons.table.properties.cellpadding.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.cellpadding.defaultValue
   
   Data type
         +int
   
   Description
         Default value of the table cellpadding attribute in the table creation
         and properties edition dialogues
         
         Default: void



.. _buttons-table-properties-cellspacing-defaultValue:

buttons.table.properties.cellspacing.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.cellspacing.defaultValue
   
   Data type
         +int
   
   Description
         Default value of the table cellspacing attribute in the table creation
         and properties edition dialogues .
         
         Default: void



.. _buttons-table-properties-borderWidth-defaultValue:

buttons.table.properties.borderWidth.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.borderWidth.defaultValue
   
   Data type
         +int
   
   Description
         Default value of the table border width attribute in the table
         creation and properties edition dialogues
         
         Default: void



.. _buttons-table-properties-borderStyle-defaultValue:

buttons.table.properties.borderStyle.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.borderStyle.defaultValue
   
   Data type
         string
   
   Description
         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:

buttons.table.properties.borderStyle.removeItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.table.properties.borderStyle.removeItems
   
   Data type
         list of strings
   
   Description
         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:

buttons.rowproperties.removeFieldsets
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.rowproperties.removeFieldsets
   
   Data type
         list of strings
   
   Description
         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:

buttons.rowproperties.properties.removed
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.rowproperties.properties.removed
   
   Data type
         list of strings
   
   Description
         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:

buttons.rowproperties.properties.width.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.rowproperties.properties.width.defaultValue
   
   Data type
         +int
   
   Description
         Default value of the row wdth in the table row properties edition
         dialogue.
         
         Default: void



.. _buttons-rowproperties-properties-widthUnit-defaultValue:

buttons.rowproperties.properties.widthUnit.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.rowproperties.properties.widthUnit.defaultValue
   
   Data type
         string
   
   Description
         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:

buttons.rowproperties.properties.widthUnit.removeItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.rowproperties.properties.widthUnit.removeItems
   
   Data type
         list of strings
   
   Description
         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:

buttons.rowproperties.properties.height.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.rowproperties.properties.height.defaultValue
   
   Data type
         +int
   
   Description
         Default value of the row height in the table row properties edition
         dialogue.
         
         Default: void



.. _buttons-rowproperties-properties-heightUnit-defaultValue:

buttons.rowproperties.properties.heightUnit.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.rowproperties.properties.heightUnit.defaultValue
   
   Data type
         string
   
   Description
         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:

buttons.rowproperties.properties.heightUnit.removeItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.rowproperties.properties.heightUnit.removeItems
   
   Data type
         list of strings
   
   Description
         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:

buttons.rowproperties.properties.borderStyle.removeItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.rowproperties.properties.borderStyle.removeItems
   
   Data type
         list of strings
   
   Description
         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:

buttons.columnproperties.removeFieldsets
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.columnproperties.removeFieldsets
   
   Data type
         list of strings
   
   Description
         List of fieldsets to remove from the column cells properties edition
         dialogue. Key list is alignment, borders, color, language, layout,
         style



.. _buttons-cellproperties-removeFieldsets:

buttons.cellproperties.removeFieldsets
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.cellproperties.removeFieldsets
   
   Data type
         list of strings
   
   Description
         List of fieldsets to remove from the cell properties edition dialogue.
         Key list is alignment, borders, color, language, layout, style



.. _buttons-cellproperties-properties-removed:

buttons.cellproperties.properties.removed
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.cellproperties.properties.removed
   
   Data type
         list of strings
   
   Description
         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:

buttons.cellproperties.properties.width.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.cellproperties.properties.width.defaultValue
   
   Data type
         +int
   
   Description
         Default value of the row wdth in the cell properties and column cells
         properties edition dialogues.
         
         Default: void



.. _buttons-cellproperties-properties-widthUnit-defaultValue:

buttons.cellproperties.properties.widthUnit.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.cellproperties.properties.widthUnit.defaultValue
   
   Data type
         string
   
   Description
         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:

buttons.cellproperties.properties.widthUnit.removeItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.cellproperties.properties.widthUnit.removeItems
   
   Data type
         list of strings
   
   Description
         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:

buttons.cellproperties.properties.height.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.cellproperties.properties.height.defaultValue
   
   Data type
         +int
   
   Description
         Default value of the row height in the cell properties and column
         cells properties edition dialogues.
         
         Default: void



.. _buttons-cellproperties-properties-heightUnit-defaultValue:

buttons.cellproperties.properties.heightUnit.defaultValue
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.cellproperties.properties.heightUnit.defaultValue
   
   Data type
         string
   
   Description
         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:

buttons.cellproperties.properties.heightUnit.removeItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.cellproperties.properties.heightUnit.removeItems
   
   Data type
         list of strings
   
   Description
         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:

buttons.cellproperties.properties.borderStyle.removeItems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.cellproperties.properties.borderStyle.removeItems
   
   Data type
         list of strings
   
   Description
         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:

buttons.paste.mozillaAllowClipboardUrl
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.paste.mozillaAllowClipboardUrl
   
   Data type
         url
   
   Description
         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



.. _buttons-pastetoggle-setActiveOnRteOpen:

buttons.pastetoggle.setActiveOnRteOpen
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.pastetoggle.setActiveOnRteOpen
   
   Data type
         boolean
   
   Description
         If set, and if the pastetoggle button is enabled, the button is
         toggled to ON when the RTE opens.
         
         Default : 0



.. _buttons-pastetoggle-hidden:

buttons.pastetoggle.hidden
~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         buttons.pastetoggle.hidden
   
   Data type
         boolean
   
   Description
         If set, and if the pastetoggle button is enabled, the button is hidden
         in both the toolbar and the context menu. Hence, if
         buttons.pastetoggle.setActiveOnRteOpen is also set, all paste
         operations will be performed using the set clean paste behaviour.
         
         Default : 0
         
         Note: For BE operations, the default or overriding clean paste
         behaviour may be set in User TSConfig.



.. _RTEHeightOverride:

RTEHeightOverride
~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         RTEHeightOverride
   
   Data type
         int+
   
   Description
         If set, the specified value will override the calculated height of the
         RTE. This includes the height of the toolbar, of the editing area and
         of the status bar.
         
         See also User TSConfig options.RTESmallHeight and
         options.RTELargeHeightIncrement
         
         Note: This property may be overridden by the BE user configuration.
         See User TSConfig



.. _RTEWidthOverride:

RTEWidthOverride
~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         RTEWidthOverride
   
   Data type
         int+/%
   
   Description
         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.
         
         Note: This property may be overridden by the BE user configuration.
         See User TSConfig.



.. _rteResize:

rteResize
~~~~~~~~~

.. container:: table-row

   Property
         rteResize
   
   Data type
         boolean
   
   Description
         If set, the RTE is resizable.
         
         Default: 0
         
         Note: This property may be overridden by the BE user configuration.
         See User TSConfig.



.. _rteMaxHeight:

rteMaxHeight
~~~~~~~~~~~~

.. container:: table-row

   Property
         rteMaxHeight
   
   Data type
         int+
   
   Description
         If the RTE is resizable, this is the maximal height of the RTE,
         including the tool bar, the editing area and the status bar.
         
         Default: 2000
         
         Note: This property may be overridden by the BE user configuration.
         See User TSConfig.



.. _dialogueWindows-defaultPositionFromTop:

dialogueWindows.defaultPositionFromTop
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         dialogueWindows.defaultPositionFromTop
   
   Data type
         int+
   
   Description
         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:

dialogueWindows.defaultPositionFromLeft
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         dialogueWindows.defaultPositionFromLeft
   
   Data type
         int+
   
   Description
         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:

dialogueWindows.doNotResize
~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         dialogueWindows.doNotResize
   
   Data type
         boolean
   
   Description
         If set, the window that is opened when any button is pressed will not
         be resized to its contents.
         
         Default: 0



.. _dialogueWindows-doNotCenter:

dialogueWindows.doNotCenter
~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         dialogueWindows.doNotCenter
   
   Data type
         boolean
   
   Description
         If set, the window that is opened when any button is pressed will not
         be centered in the parent window.
         
         Default: 0



.. _userElements:

userElements.[#]
~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         userElements.[#]
   
   Data type
         string/->userCategory
   
   Description
         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:

userLinks.[#]
~~~~~~~~~~~~~

.. container:: table-row

   Property
         userLinks.[#]
   
   Data type
         string/->userLinks
   
   Description
         Configuration of user defined links.
         
         The string value sets the name of the category. Value is language-
         splitted (by \|) to allow for multiple languages.



.. _logDeprecatedProperties-disabled:

logDeprecatedProperties.disabled
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         logDeprecatedProperties.disabled
   
   Data type
         boolean
   
   Description
         If set, usage of deprecated Page TS Config properties is not logged to
         the deprecation log.
         
         Default: 0



.. _logDeprecatedProperties-logAlsoToBELog:

logDeprecatedProperties.logAlsoToBELog
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         logDeprecatedProperties.logAlsoToBELog
   
   Data type
         boolean
   
   Description
         If set, usage of deprecated Page TS Config properties is also logged
         to the BE log.
         
         Default: 0



.. _schema-sources:

schema.sources.[#]
~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         schema.sources.[#]
   
   Data type
         array
   
   Description
         An array of filenames containing vocabulary definitions inXML/RDF
         format.
         
         Default: schemaOrg =
         EXT:rtehtmlarea/extensions/MicrodataSchema/res/schemaOrgAll.rdf


.. ###### END~OF~TABLE ######

[page:RTE.default/RTE.default.FE/RTE.config.(table).(field)/RTE.config
.(table).(field).types.(type)]


.. _classesAnchor:

classesAnchor:
""""""""""""""

The following property allows to configure the anchor accessibility
feature:

.. ### BEGIN~OF~TABLE ###


.. _classesAnchor-id-string:

classesAnchor.[ *id-string* ]
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         classesAnchor.[ *id-string* ]
   
   Description
         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.


.. ###### END~OF~TABLE ######

[page:RTE]


.. _userCategory:

userCategory:
"""""""""""""

Properties of each user element category.

.. ### BEGIN~OF~TABLE ###


.. _load:

load
~~~~

.. container:: table-row

   Property
         load
   
   Data type
         string
   
   Description
         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:

merge
~~~~~

.. container:: table-row

   Property
         merge
   
   Data type
         Boolean
   
   Description
         If set, then any manually configured user elements are merged onto the
         ones loaded by the .load operation.



.. _path:

path
~~~~

.. container:: table-row

   Property
         path
   
   Data type
         String
   
   Description
         *(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/



.. _:

[#]
~~~

.. container:: table-row

   Property
         [#]
   
   Data type
         string/->userElements
   
   Description
         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 = 
            
                  # The text-selection is wrapped with  tags.
                2 = Subscript
                2.description = Selected text is wrapped in -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


.. ###### END~OF~TABLE ######

[page:->userCategory]


.. _userElements:

userElements:
"""""""""""""

Properties of each user elements setup.

.. ### BEGIN~OF~TABLE ###


.. _mode:

mode
~~~~

.. container:: table-row

   Property
         mode
   
   Data type
         string
   
   Description
         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:

description
~~~~~~~~~~~

.. container:: table-row

   Property
         description
   
   Data type
         string
   
   Description
         A short description shown beneath the user element title (which is in
         bold)



.. _content:

content
~~~~~~~

.. container:: table-row

   Property
         content
   
   Data type
         string
   
   Description
         The content inserted/wrapped into the RTE



.. _submitToScript:

submitToScript
~~~~~~~~~~~~~~

.. container:: table-row

   Property
         submitToScript
   
   Data type
         string
   
   Description
         *(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:

dontInsertSiteUrl
~~~~~~~~~~~~~~~~~

.. container:: table-row

   Property
         dontInsertSiteUrl
   
   Data type
         boolean
   
   Description
         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!


.. ###### END~OF~TABLE ######

[page:->userElements]


.. _userLinks:

userLinks:
""""""""""

Properties of user links

.. ### BEGIN~OF~TABLE ###


.. _url:

url
~~~

.. container:: table-row

   Property
         url
   
   Data type
         string
   
   Description
         The url.
         
         If set, the marker ###\_URL### in the content property's content is
         substituted by the current site url.



.. _description:

description
~~~~~~~~~~~

.. container:: table-row

   Property
         description
   
   Data type
         string
   
   Description
         A short description shown beneath the link title (which is in bold)



.. _target:

target
~~~~~~

.. container:: table-row

   Property
         target
   
   Data type
         string
   
   Description
         Default target (if isset())


.. ###### END~OF~TABLE ######

[page:->userLinks]


.. _Toolbar-Elements:

Toolbar Elements
----------------

The following GUI elements may be configured in the RTE toolbar:

.. ### BEGIN~OF~TABLE ###


.. _space:

space
^^^^^

.. container:: table-row

   Name
         space
   
   Type
         Control
   
   Descripton
         Insert a space between two toolbar elements



.. _bar:

bar
^^^

.. container:: table-row

   Name
         bar
   
   Type
         Control
   
   Descripton
         Insert a vertical bar in the toolbar, elements between bars being
         grouped



.. _linebreak:

linebreak
^^^^^^^^^

.. container:: table-row

   Name
         linebreak
   
   Type
         Control
   
   Descripton
         Insert a new line in the toolbar



.. _blockstylelabel:

blockstylelabel
^^^^^^^^^^^^^^^

.. container:: table-row

   Name
         blockstylelabel
   
   Type
         Label
   
   Descripton
         Label for drop-down with CSS styles for block elements



.. _blockstyle:

blockstyle
^^^^^^^^^^

.. container:: table-row

   Name
         blockstyle
   
   Type
         Drop-down
   
   Descripton
         Selection of CSS styles for block elements



.. _textstylelabel:

textstylelabel
^^^^^^^^^^^^^^

.. container:: table-row

   Name
         textstylelabel
   
   Type
         Label
   
   Descripton
         Label for drop-down with CSS styles inline elements



.. _textstyle:

textstyle
^^^^^^^^^

.. container:: table-row

   Name
         textstyle
   
   Type
         Drop-down
   
   Descripton
         Selection CSS styles for inline elements



.. _fontstyle:

fontstyle
^^^^^^^^^

.. container:: table-row

   Name
         fontstyle
   
   Type
         Drop-down
   
   Descripton
         Selection of font family



.. _fontsize:

fontsize
^^^^^^^^

.. container:: table-row

   Name
         fontsize
   
   Type
         Drop-down
   
   Descripton
         Selection of relative font size (very small, small, normal, etc.)



.. _formatblock:

formatblock
^^^^^^^^^^^

.. container:: table-row

   Name
         formatblock
   
   Type
         Drop-down
   
   Descripton
         Selection of block element (paragraph, heading, preformatted text,
         blockquote, etc.)



.. _blockquote:

blockquote
^^^^^^^^^^

.. container:: table-row

   Name
         blockquote
   
   Type
         Button
   
   Descripton
         Insert/make current block element a blockquote



.. _insertparagraphbefore:

insertparagraphbefore
^^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Name
         insertparagraphbefore
   
   Type
         Button
   
   Descripton
         Insert a paragraph before the current block element



.. _Insertparagraphafter:

Insertparagraphafter
^^^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Name
         Insertparagraphafter
   
   Type
         Button
   
   Descripton
         Insert a paragraph after the current block element



.. _lefttoright:

lefttoright
^^^^^^^^^^^

.. container:: table-row

   Name
         lefttoright
   
   Type
         Button
   
   Descripton
         Set writing direction of current block element to left to right



.. _righttoleft:

righttoleft
^^^^^^^^^^^

.. container:: table-row

   Name
         righttoleft
   
   Type
         Button
   
   Descripton
         Set writing direction of current block element to right to left



.. _language:

language
^^^^^^^^

.. container:: table-row

   Name
         language
   
   Type
         Button
   
   Descripton
         Mark selected text as the selected language



.. _showlanguagemarks:

showlanguagemarks
^^^^^^^^^^^^^^^^^

.. container:: table-row

   Name
         showlanguagemarks
   
   Type
         Toggle button
   
   Descripton
         Show/hide language markup of elements with language attribute



.. _left:

left
^^^^

.. container:: table-row

   Name
         left
   
   Type
         Button
   
   Descripton
         Left-justify current block element



.. _center:

center
^^^^^^

.. container:: table-row

   Name
         center
   
   Type
         Button
   
   Descripton
         Center current block element



.. _right:

right
^^^^^

.. container:: table-row

   Name
         right
   
   Type
         Button
   
   Descripton
         Right-justify current block element



.. _justifyfull:

justifyfull
^^^^^^^^^^^

.. container:: table-row

   Name
         justifyfull
   
   Type
         Button
   
   Descripton
         Fully justify current block element



.. _orderedlist:

orderedlist
^^^^^^^^^^^

.. container:: table-row

   Name
         orderedlist
   
   Type
         Button
   
   Descripton
         Insert/make current block element an ordered list (ol, li)



.. _unorderedlist:

unorderedlist
^^^^^^^^^^^^^

.. container:: table-row

   Name
         unorderedlist
   
   Type
         Button
   
   Descripton
         Insert/make current block element an unordered list (ul, li)



.. _definitionlist:

definitionlist
^^^^^^^^^^^^^^

.. container:: table-row

   Name
         definitionlist
   
   Type
         Button
   
   Descripton
         Insert/make current block element a definition list (dl)



.. _definitionitem:

definitionitem
^^^^^^^^^^^^^^

.. container:: table-row

   Name
         definitionitem
   
   Type
         Toggle button
   
   Descripton
         Toggle current definition list element between definition and
         explaination (dt, dd)



.. _outdent:

outdent
^^^^^^^

.. container:: table-row

   Name
         outdent
   
   Type
         Button
   
   Descripton
         Decrease indentation of current block element



.. _indent:

indent
^^^^^^

.. container:: table-row

   Name
         indent
   
   Type
         Button
   
   Descripton
         Increase indentation of current block element



.. _formattext:

formattext
^^^^^^^^^^

.. container:: table-row

   Name
         formattext
   
   Type
         Drop-down
   
   Descripton
         Selection of inline element



.. _bidioverride:

bidioverride
^^^^^^^^^^^^

.. container:: table-row

   Name
         bidioverride
   
   Type
         Button
   
   Descripton
         Change direction for marked text (bdo)



.. _big:

big
^^^

.. container:: table-row

   Name
         big
   
   Type
         Button
   
   Descripton
         Set font size of marked text to big (big)



.. _bold:

bold
^^^^

.. container:: table-row

   Name
         bold
   
   Type
         Button
   
   Descripton
         Set font style of marked text to bold (b)



.. _citation:

citation
^^^^^^^^

.. container:: table-row

   Name
         citation
   
   Type
         Button
   
   Descripton
         Mark text as citation (cite)



.. _code:

code
^^^^

.. container:: table-row

   Name
         code
   
   Type
         Button
   
   Descripton
         Mark text as code (code)



.. _definition:

definition
^^^^^^^^^^

.. container:: table-row

   Name
         definition
   
   Type
         Button
   
   Descripton
         Mark text as definition (dfn)



.. _deletedtext:

deletedtext
^^^^^^^^^^^

.. container:: table-row

   Name
         deletedtext
   
   Type
         Button
   
   Descripton
         Mark text as deleted (del)



.. _emphasis:

emphasis
^^^^^^^^

.. container:: table-row

   Name
         emphasis
   
   Type
         Button
   
   Descripton
         Mark text as emphasized (em)



.. _insertedtext:

insertedtext
^^^^^^^^^^^^

.. container:: table-row

   Name
         insertedtext
   
   Type
         Button
   
   Descripton
         Mark text as inserted (ins)



.. _italic:

italic
^^^^^^

.. container:: table-row

   Name
         italic
   
   Type
         Button
   
   Descripton
         Set font style of marked text to italic (i)



.. _keyboard:

keyboard
^^^^^^^^

.. container:: table-row

   Name
         keyboard
   
   Type
         Button
   
   Descripton
         Mark text as keyboard input (kbd)



.. _monospaced:

monospaced
^^^^^^^^^^

.. container:: table-row

   Name
         monospaced
   
   Type
         Button
   
   Descripton
         Set font of marked text to non-proportional (tt)



.. _quotation:

quotation
^^^^^^^^^

.. container:: table-row

   Name
         quotation
   
   Type
         Button
   
   Descripton
         Mark text as small quote (q)



.. _sample:

sample
^^^^^^

.. container:: table-row

   Name
         sample
   
   Type
         Button
   
   Descripton
         Mark text as example (samp)



.. _small:

small
^^^^^

.. container:: table-row

   Name
         small
   
   Type
         Button
   
   Descripton
         Set font size of marked text to small (small)



.. _span:

span
^^^^

.. container:: table-row

   Name
         span
   
   Type
         Button
   
   Descripton
         Enclose marked text in generic span (span)



.. _strikethrough:

strikethrough
^^^^^^^^^^^^^

.. container:: table-row

   Name
         strikethrough
   
   Type
         Button
   
   Descripton
         Set font style of marked text to strike-through (strike)



.. _strong:

strong
^^^^^^

.. container:: table-row

   Name
         strong
   
   Type
         Button
   
   Descripton
         Mark text as strongly emphasized (strong)



.. _subscript:

subscript
^^^^^^^^^

.. container:: table-row

   Name
         subscript
   
   Type
         Button
   
   Descripton
         Set font style of marked text to subscript (sub)



.. _superscript:

superscript
^^^^^^^^^^^

.. container:: table-row

   Name
         superscript
   
   Type
         Button
   
   Descripton
         Set font style of marked text to superscript (sup)



.. _underline:

underline
^^^^^^^^^

.. container:: table-row

   Name
         underline
   
   Type
         Button
   
   Descripton
         Set font style of marked text to underlined (u)



.. _variable:

variable
^^^^^^^^

.. container:: table-row

   Name
         variable
   
   Type
         Button
   
   Descripton
         Mark text as variable (var)



.. _textcolor:

textcolor
^^^^^^^^^

.. container:: table-row

   Name
         textcolor
   
   Type
         Button
   
   Descripton
         Set font color of marked text or of element at cursor position



.. _bgcolor:

bgcolor
^^^^^^^

.. container:: table-row

   Name
         bgcolor
   
   Type
         Button
   
   Descripton
         Set background color of marked text or of element at cursor position



.. _textindicator:

textindicator
^^^^^^^^^^^^^

.. container:: table-row

   Name
         textindicator
   
   Type
         Indicator
   
   Descripton
         Show font and background color of text at cursor position



.. _editelement:

editelement
^^^^^^^^^^^

.. container:: table-row

   Name
         editelement
   
   Type
         Button
   
   Descripton
         Edit general attributes such as "id", "name", "lang" and other
         universal attributes on any element of the content



.. _emoticon:

emoticon
^^^^^^^^

.. container:: table-row

   Name
         emoticon
   
   Type
         Button
   
   Descripton
         Insert an emoticon



.. _insertcharacter:

insertcharacter
^^^^^^^^^^^^^^^

.. container:: table-row

   Name
         insertcharacter
   
   Type
         Button
   
   Descripton
         Insert a special character



.. _insertsofthyphen:

insertsofthyphen
^^^^^^^^^^^^^^^^

.. container:: table-row

   Name
         insertsofthyphen
   
   Type
         Button
   
   Descripton
         Insert a soft hyphen



.. _line:

line
^^^^

.. container:: table-row

   Name
         line
   
   Type
         Button
   
   Descripton
         Insert an horizontal line (hr)



.. _link:

link
^^^^

.. container:: table-row

   Name
         link
   
   Type
         Button
   
   Descripton
         Create/edit an hyperlink for the marked text (a)



.. _unlink:

unlink
^^^^^^

.. container:: table-row

   Name
         unlink
   
   Type
         Button
   
   Descripton
         Remove the hyperlink around the cursor position



.. _image:

image
^^^^^

.. container:: table-row

   Name
         image
   
   Type
         Button
   
   Descripton
         Insert an image at the cursor position (img)



.. _table:

table
^^^^^

.. container:: table-row

   Name
         table
   
   Type
         Button
   
   Descripton
         Insert a table at the cursor position (table)



.. _user:

user
^^^^

.. container:: table-row

   Name
         user
   
   Type
         Button
   
   Descripton
         Insert a customized tag at the cursor position



.. _acronym:

acronym
^^^^^^^

.. container:: table-row

   Name
         acronym
   
   Type
         Button
   
   Descripton
         Mark the text as acronym or abbreviation (acronym, abbr)



.. _findreplace:

findreplace
^^^^^^^^^^^

.. container:: table-row

   Name
         findreplace
   
   Type
         Button
   
   Descripton
         Open search and replace tool



.. _spellcheck:

spellcheck
^^^^^^^^^^

.. container:: table-row

   Name
         spellcheck
   
   Type
         Button
   
   Descripton
         Open spellchecker



.. _chMode:

chMode
^^^^^^

.. container:: table-row

   Name
         chMode
   
   Type
         Button
   
   Descripton
         Switch between WYSIWYG and HTML code view



.. _inserttag:

inserttag
^^^^^^^^^

.. container:: table-row

   Name
         inserttag
   
   Type
         Button
   
   Descripton
         Insert a tag



.. _removeformat:

removeformat
^^^^^^^^^^^^

.. container:: table-row

   Name
         removeformat
   
   Type
         Button
   
   Descripton
         Open the text cleaning tool



.. _copy:

copy
^^^^

.. container:: table-row

   Name
         copy
   
   Type
         Button
   
   Descripton
         Copy marked content to the clipboard



.. _cut:

cut
^^^

.. container:: table-row

   Name
         cut
   
   Type
         Button
   
   Descripton
         Copy marked content to the clipboard and delete marked text



.. _paste:

paste
^^^^^

.. container:: table-row

   Name
         paste
   
   Type
         Button
   
   Descripton
         Paste content of the clipboard at cursor position



.. _pastetoggle:

pastetoggle
^^^^^^^^^^^

.. container:: table-row

   Name
         pastetoggle
   
   Type
         Toggle button
   
   Descripton
         Toggle between normal paste behaviour and alternative paste behaviour



.. _pastebehaviour:

pastebehaviour
^^^^^^^^^^^^^^

.. container:: table-row

   Name
         pastebehaviour
   
   Type
         Button
   
   Descripton
         Select alternative paste behaviour



.. _undo:

undo
^^^^

.. container:: table-row

   Name
         undo
   
   Type
         Button
   
   Descripton
         Undo a change



.. _redo:

redo
^^^^

.. container:: table-row

   Name
         redo
   
   Type
         Button
   
   Descripton
         Redo an undone change



.. _about:

about
^^^^^

.. container:: table-row

   Name
         about
   
   Type
         Button
   
   Descripton
         Show info about the RTE



.. _toggleborders:

toggleborders
^^^^^^^^^^^^^

.. container:: table-row

   Name
         toggleborders
   
   Type
         Toggle button
   
   Descripton
         Show/hide table borders



.. _tableproperties:

tableproperties
^^^^^^^^^^^^^^^

.. container:: table-row

   Name
         tableproperties
   
   Type
         Button
   
   Descripton
         Open table properties dialogue



.. _tablerestyle:

tablerestyle
^^^^^^^^^^^^

.. container:: table-row

   Name
         tablerestyle
   
   Type
         Button
   
   Descripton
         Re-apply alternating/numbering styles to all rows, columns and cells



.. _rowproperties:

rowproperties
^^^^^^^^^^^^^

.. container:: table-row

   Name
         rowproperties
   
   Type
         Button
   
   Descripton
         Open table row properties dialogue



.. _rowinsertabove:

rowinsertabove
^^^^^^^^^^^^^^

.. container:: table-row

   Name
         rowinsertabove
   
   Type
         Button
   
   Descripton
         Insert a table row above the current one



.. _rowinsertunder:

rowinsertunder
^^^^^^^^^^^^^^

.. container:: table-row

   Name
         rowinsertunder
   
   Type
         Button
   
   Descripton
         Insert a table row below the current one



.. _rowdelete:

rowdelete
^^^^^^^^^

.. container:: table-row

   Name
         rowdelete
   
   Type
         Button
   
   Descripton
         Delete the current row



.. _rowsplit:

rowsplit
^^^^^^^^

.. container:: table-row

   Name
         rowsplit
   
   Type
         Button
   
   Descripton
         Divide the current table row



.. _columnproperties:

columnproperties
^^^^^^^^^^^^^^^^

.. container:: table-row

   Name
         columnproperties
   
   Type
         Button
   
   Descripton
         Open table column properties dialogue



.. _columninsertbefore:

columninsertbefore
^^^^^^^^^^^^^^^^^^

.. container:: table-row

   Name
         columninsertbefore
   
   Type
         Button
   
   Descripton
         Insert a table column before the current one



.. _columninsertafter:

columninsertafter
^^^^^^^^^^^^^^^^^

.. container:: table-row

   Name
         columninsertafter
   
   Type
         Button
   
   Descripton
         Insert a table column after the current one



.. _columndelete:

columndelete
^^^^^^^^^^^^

.. container:: table-row

   Name
         columndelete
   
   Type
         Button
   
   Descripton
         Delete the current table column



.. _columnsplit:

columnsplit
^^^^^^^^^^^

.. container:: table-row

   Name
         columnsplit
   
   Type
         Button
   
   Descripton
         Split the current table column into



.. _cellproperties:

cellproperties
^^^^^^^^^^^^^^

.. container:: table-row

   Name
         cellproperties
   
   Type
         Button
   
   Descripton
         Open table cell properties dialog



.. _cellinsertbefore:

cellinsertbefore
^^^^^^^^^^^^^^^^

.. container:: table-row

   Name
         cellinsertbefore
   
   Type
         Button
   
   Descripton
         Insert a table cell before the current one



.. _cellinsertafter:

cellinsertafter
^^^^^^^^^^^^^^^

.. container:: table-row

   Name
         cellinsertafter
   
   Type
         Button
   
   Descripton
         Insert a table cell after the current one



.. _celldelete:

celldelete
^^^^^^^^^^

.. container:: table-row

   Name
         celldelete
   
   Type
         Button
   
   Descripton
         Delete the current table cell



.. _cellsplit:

cellsplit
^^^^^^^^^

.. container:: table-row

   Name
         cellsplit
   
   Type
         Button
   
   Descripton
         Split the current table cell into



.. _cellmerge:

cellmerge
^^^^^^^^^

.. container:: table-row

   Name
         cellmerge
   
   Type
         Button
   
   Descripton
         Merge the selected table cells


.. ###### END~OF~TABLE ######


.. _Static-Template-Clickenlarge-Rendering:

Static Template: Clickenlarge Rendering
---------------------------------------

In order for the click-enlarge property of images inserted in the RTE
to be rendered on the frontend, static template «Clickenlarge
Rendering (rtehtmlarea)» must be included in the TypoScript template.
This static template must be included after static template CSS Styled
Content (css\_styled\_content).

Note that stdWrap property may be applied to the generated link tag by
configuring the property in TS template setup:

lib.parseFunc\_RTE.tags.img.postUserFunc.stdWrap.

This may be used, for examble, to add additional attributes to the
generated link tag.


.. _Default-Website-Language:

Default Website Language
------------------------

If you enable the Spell Checker feature, make sure you have created a
Website Language record for the default language of your site, even if
your TypoScript template does not refer to it.


.. _Server-Configuration:

Server Configuration
--------------------

Internet Explorer has caching problems that may affect the performance
of the htmlArea RTE. These problems may be worked around with the
following server configuration recommendations.


.. _generated:

((generated))
^^^^^^^^^^^^^

.. _Apache-configuration:

Apache configuration:
"""""""""""""""""""""

Add the following lines to your Apache httpd.conf file or in the
.htaccess file of the root directory of your site:

::

   BrowserMatch "MSIE" brokenvary=1
   BrowserMatch "Mozilla/4.[0-9]{2}" brokenvary=1
   BrowserMatch "Opera" !brokenvary
   SetEnvIf brokenvary 1 force-no-vary
   
   ExpiresActive On
   ExpiresByType image/gif "access plus 1 month"
   ExpiresByType image/png "access plus 1 month"

The last two statements require the  **mod\_expires** Apache module to
be installed. For information on this module, see:

`http://httpd.apache.org/docs/1.3/mod/mod\_expires.html
`_


.. _Microsoft-IIS-configuration:

Microsoft IIS configuration:
""""""""""""""""""""""""""""

See:
`http://www.aspnetresources.com/blog/cache\_control\_extensions.aspx
`_


.. _More-information:

More information:
"""""""""""""""""

For more information on this subject, see the following articles:

`http://dean.edwards.name/my/flicker.html
`_

`http://httpd.apache.org/docs/1.3/mod/mod\_expires.html
`_

`http://fivesevensix.com/studies/ie6flicker/
`_

See also the Troubleshooting section of the present document for
information on IE caching problems in relation with the Apache
mod\_gzip module.


.. _Installing-multiple-RTE-s:

Installing multiple RTE's
-------------------------

You can install as many RTE's has you wish. Their availability will be
checked in the order in which they are loaded, that is in the order
they are installed.


.. _Using-htmlArea-RTE-in-a-front-end-plugin:

Using htmlArea RTE in a front end plugin
----------------------------------------

If you are a TYPO3 front end extension developer, your extensions may
use the htmlArea RTE API to enable rich text editing of text fields.
You will find the the htmlArea RTE API Manual on the TYPO3 Extension
Repository (extension key: rtehtmlarea\_api\_manual)

Note that the TYPO3 Image, TYPO3 Link , User Elements and Acronym
features are not available when the RTE is used in the TYPO3 front
end.


.. _Configuring-the-anchor-accessibility-feature:

Configuring the anchor accessibility feature
--------------------------------------------

The anchor accessibility feature allows to attach special
accessibility features to CSS classes when they are applied to links
with the TYPO3 element browser. For example, icons may be inserted in
front or at the end of links when configured classes are assigned to
the links.

The Extension Manager must be used to enable the feature.

The TYPO3 element browser must be enabled in the 'Insert/Modify link'
dialogue by setting property buttons.link.TYPO3Browser.disabled to 0
in Page TSConfig. The TYPO3 element browser is enabled by default in
the backend, but never available in the frontend.

The classes should first be defined in the CSS file specified by
RTE.default.contentCSS.

The classes should be part of the list specified by property
RTE.default.classesAnchor.

The accessibility features attached to the classes are specified by
property RTE.classesAnchor.


.. _Default-Configurations:

Default Configurations
======================

htmlArea RTE offers four default configurations:

- Typical: sets Page TSConfig and User TSConfig with most commonly used
  features representing a good start for typical sites and for most
  situations;

- Minimal: sets Page TSConfig and User TSConfig with minimal features;
  this is for advanced administrators who are familiar with the features
  of the RTE and understand well how to configure the RTE using Page
  TSConfig;

- Demo: sets Page TSConfig and User TSConfig with as many features as
  possible for users who want to explore the features of the RTE; this
  is  **not** recommended for a production environment;

- Image: adds support for images to the Typical default configuration.

The default configuration may be chosen in the installation dialog of
the htmlArea RTE extension presented by the Extension Manager. If not
otherwise specified, the Typical default configuration will be used.

All default configurations share the same default configuration of RTE
content transformation.


.. _Default-configuration-of-RTE-content-transformation:

Default configuration of RTE content transformation
---------------------------------------------------

This default configuration establishes default settings in Page
TSConfig for RTE content transformation.

For documentation of RTE tranformations, see:
`http://typo3.org/documentation/document-library/core-
documentation/doc\_core\_api/4.1.0/view/5/2/
`_

For documentation of Page TSConfig configuration of RTE processing,
see: `http://typo3.org/documentation/document-
library/references/doc\_core\_tsconfig/current/view/1/3/
`_

For documentation of the HTMLparser, see:
`http://typo3.org/documentation/document-
library/references/doc\_core\_tsref/current/view/5/17/
`_

For documentation of RTE settings in TCA, see:
`http://typo3.org/documentation/document-library/core-
documentation/doc\_core\_api/4.1.0/view/4/3/#id3665895
`_


.. _generated:

((generated))
^^^^^^^^^^^^^

.. _The-following-is-inserted-in-Page-TSConfig:

The following is inserted in Page TSConfig:
"""""""""""""""""""""""""""""""""""""""""""

## Default RTE processing rules

::

   RTE.default.proc {

## TRANSFORMATION METHOD

## We assume that CSS Styled Content is used.

::

      overruleMode = ts_css

## DO NOT CONVERT BR TAGS INTO LINEBREAKS

## br tags in the content are assumed to be intentional.

::

      dontConvBRtoParagraph = 1

## PRESERVE DIV SECTIONS - DO NOT REMAP TO P

::

      preserveDIVSections = 1

## TAGS ALLOWED OUTSIDE P & DIV

::

      allowTagsOutside = address, article, aside, blockquote, footer, header, hr, nav, section

## TAGS ALLOWED

## Added to the default internal list: b,i,u,a,img,br,div,center,pre,f
ont,hr,sub,sup,p,strong,em,li,ul,ol,blockquote,strike,span

## But, for the sake of clarity, we use a complete list in alphabetic
order.

## center, font, link, meta, o:p, strike, sdfield, style, title and u
will be removed on entry (see below).

## b and i will be remapped on exit (see below).

## Note that the link accessibility feature of htmlArea RTE does
insert img tags.

::

      allowTags (
                   a, abbr, acronym, address, article, aside, b, bdo, big, blockquote, br, caption, center, cite, code, col, colgroup, dd, del, dfn, dl, div, dt, em, font, footer,
                   header, h1, h2, h3, h4, h5, h6, hr, i, img, ins, kbd, label, li, link, meta, nav, ol, p, pre, q, samp, sdfield, section, small,
                   span, strike, strong, style, sub, sup, table, thead, tbody, tfoot, td, th, tr, title, tt, u, ul, var
                   )

## TAGS DENIED

## Make sure we can set rules on any tag listed in allowTags.

::

      denyTags >

## ALLOWED P & DIV ATTRIBUTES

## Attributes class and align are always preserved

## Align attribute will be unset on entry (see below)

## This is a list of additional attributes to keep

::

      keepPDIVattribs = id, title, dir, lang, xml:lang, itemscope, itemtype, itemprop

## ALLOW TO WRITE ABOUT HTML

::

      dontUndoHSC_db = 1
           dontHSC_rte = 1

## CONTENT TO DATABASE

::

      entryHTMLparser_db = 1
           entryHTMLparser_db {

## TAGS ALLOWED

## Always use the same list of allowed tags.

::

              allowTags < RTE.default.proc.allowTags

## TAGS DENIED

## Make sure we can set rules on any tag listed in allowTags.

::

              denyTags >

## AVOID CONTENT BEING HSC'ed TWICE

::

              htmlSpecialChars = 0

::

              tags {

## REMOVE IMG TAGS

::

                      img.allowedAttribs = 0
                           img.rmTagIfNoAttrib = 1

## CLEAN ATTRIBUTES ON THE FOLLOWING TAGS

::

                      span.fixAttrib.style.unset = 1
                           span.allowedAttribs = id, title, dir, lang, xml:lang, class, itemscope, itemtype, itemprop
                           span.rmTagIfNoAttrib = 1
                           p {
                                   allowedAttribs = id, title, dir, lang, xml:lang, class, itemscope, itemtype, itemprop
                                   fixAttrib.align.unset = 1
                           }
                           div < .p
                           hr.allowedAttribs = class
                           b.allowedAttribs  < .span.allowedAttribs
                           bdo.allowedAttribs  < .span.allowedAttribs
                           big.allowedAttribs  < .span.allowedAttribs
                           blockquote.allowedAttribs  < .span.allowedAttribs
                           cite.allowedAttribs  < .span.allowedAttribs
                           code.allowedAttribs  < .span.allowedAttribs
                           del.allowedAttribs  < .span.allowedAttribs
                           dfn.allowedAttribs  < .span.allowedAttribs
                           em.allowedAttribs  < .span.allowedAttribs
                           i.allowedAttribs  < .span.allowedAttribs
                           ins.allowedAttribs  < .span.allowedAttribs
                           kbd.allowedAttribs  < .span.allowedAttribs
                           label.allowedAttribs  < .span.allowedAttribs
                           q.allowedAttribs  < .span.allowedAttribs
                           samp.allowedAttribs  < .span.allowedAttribs
                           small.allowedAttribs  < .span.allowedAttribs
                           strike.allowedAttribs  < .span.allowedAttribs
                           strong.allowedAttribs  < .span.allowedAttribs
                           sub.allowedAttribs  < .span.allowedAttribs
                           sup.allowedAttribs  < .span.allowedAttribs
                           tt.allowedAttribs  < .span.allowedAttribs
                           u.allowedAttribs  < .span.allowedAttribs
                           var.allowedAttribs  < .span.allowedAttribs
                   }

## REMOVE OPEN OFFICE META DATA TAGS, WORD 2003 TAGS, LINK, META,
STYLE AND TITLE TAGS, AND DEPRECATED HTML TAGS

## We use this rule instead of the denyTags rule so that we can
protect custom tags without protecting these unwanted tags.

::

              removeTags = center, font, link, o:p, sdfield, meta, style, title, strike, u

## PROTECT CUSTOM TAGS

::

              keepNonMatchedTags = protect
           }

::

      HTMLparser_db {

## STRIP ALL ATTRIBUTES FROM THESE TAGS

## If this list of tags is not set, it will default to:
b,i,u,br,center,hr,sub,sup,strong,em,li,ul,ol,blockquote,strike.

## However, we want to keep xml:lang attribute on most tags and tags
from the default list where cleaned on entry.

::

              noAttrib = br

## XHTML COMPLIANCE

## Note that applying xhtml\_cleaning on exit would break non-standard
attributes of typolink tags

::

              xhtml_cleaning = 1
           }

::

      exitHTMLparser_db = 1
           exitHTMLparser_db {

## KEEP ALL TAGS

## Unwanted tags were removed on entry.

## Without this rule, the parser will remove all tags! Presumably,
this rule will be more efficient than repeating the allowTags rule

::

              keepNonMatchedTags = 1

## AVOID CONTENT BEING HSC'ed TWICE

::

              htmlSpecialChars = 0
           }
   }

## Use same RTE processing rules in FE

::

   RTE.default.FE.proc < RTE.default.proc

## RTE processing rules for bodytext column of tt\_content table

## Erase settings from other extensions

::

   RTE.config.tt_content.bodytext >

## Make sure we use ts\_css transformation

::

   RTE.config.tt_content.bodytext.proc.overruleMode = ts_css
   RTE.config.tt_content.bodytext.types.text.proc.overruleMode = ts_css
   RTE.config.tt_content.bodytext.types.textpic.proc.overruleMode = ts_css


.. _Typical-default-configuration:

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.


.. _generated:

((generated))
^^^^^^^^^^^^^

.. _The-following-is-inserted-in-Page-TSConfig:

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/htmlarea/locallang_tooltips.xml:justifyleft
                   value = text-align: left;
           }
           align-center {
                   name = LLL:EXT:rtehtmlarea/htmlarea/locallang_tooltips.xml:justifycenter
                   value = text-align: center;
           }
           align-right {
                   name = LLL:EXT:rtehtmlarea/htmlarea/locallang_tooltips.xml:justifyright
                   value = text-align: right;
           }
           csc-frame-frame1 {
                   name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:frame-frame1
                   value = background-color: #EDEBF1; border: 1px solid #333333;
           }
           csc-frame-frame2 {
                   name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:frame-frame2
                   value = background-color: #F5FFAA; border: 1px solid #333333;
           }
           important {
                   name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:important
                   value = color: #8A0020;
           }
           name-of-person {
                   name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:name-of-person
                   value = color: #10007B;
           }
           detail {
                   name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:detail
                   value = color: #186900;
           }
           component-items {
                   name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:component-items
                   value = color: #186900;
           }
           action-items {
                   name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:action-items
                   value = color: #8A0020;
           }
           component-items-ordered {
                   name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:component-items
                   value = color: #186900;
           }
           action-items-ordered {
                   name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml: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/res/accessibilityicons/locallang.xml:external_link_titleText
           }
           externalLinkInNewWindow {
                   class = external-link-new-window
                   type = url
                   titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:external_link_new_window_titleText
           }
           internalLink {
                   class = internal-link
                   type = page
                   titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:internal_link_titleText
           }
           internalLinkInNewWindow {
                   class = internal-link-new-window
                   type = page
                   titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:internal_link_new_window_titleText
           }
           download {
                   class = download
                   type = file
                   titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:download_titleText
           }
           mail {
                   class = mail
                   type = mail
                   titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml: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,
                   formatblock, bold, italic, subscript, superscript,
                   orderedlist, unorderedlist, outdent, indent, textindicator,
                   insertcharacter, link, table, findreplace, chMode, removeformat, undo, redo, about,
                   toggleborders, tableproperties,
                   rowproperties, rowinsertabove, rowinsertunder, rowdelete, rowsplit,
                   columninsertbefore, columninsertafter, columndelete, columnsplit,
                   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

## Property ignoreMainStyleOverride is DEPRECATED as of TYPO3 4.6 and
will be removed in TYPO3 4.8

## Use stylesheet file rather than mainStyleOverride and inlineStyle
properties to style the contents

## When RTE.default.contentCSS is not specified, file
EXT:rtehtmlarea/res/contentcsss/default.css is used.

::

      ignoreMainStyleOverride = 1

## 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,
                   align-left, align-center, align-right, align-justify,
                   csc-frame-frame1, csc-frame-frame2,
                   component-items, action-items,
                   component-items-ordered, action-items-ordered,
                   important, name-of-person, detail,
                   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, 
                   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 >
   RTE.default.FE.userLinks >

## 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:

The following is inserted in User TSConfig:
"""""""""""""""""""""""""""""""""""""""""""

## Enable the RTE by default for all users

::

   setup.default.edit_RTE = 1


.. _Minimal-default-configuration:

Minimal default configuration
-----------------------------

This default configuration establishes default settings in Page
TSConfig and User TSConfig with minimal features. This is for advanced
administrators with good knowledge of RTE configuration in Page
TSConfig.


.. _generated:

((generated))
^^^^^^^^^^^^^

.. _The-following-is-inserted-in-Page-TSConfig:

The following is inserted in Page TSConfig:
"""""""""""""""""""""""""""""""""""""""""""

## Default RTE configuration

::

   RTE.default {

## Toolbar options applicable to all RTE's

## The TCA configuration may add buttons to the toolbar

::

      showButtons =  bold,italic,undo,redo,about
   }

## front end RTE configuration for the general public

::

   RTE.default.FE < RTE.default


.. _The-following-is-inserted-in-User-TSConfig:

The following is inserted in User TSConfig:
"""""""""""""""""""""""""""""""""""""""""""

## Enable the RTE by default for all users

::

   setup.default.edit_RTE = 1


.. _Demo-default-configuration:

Demo default configuration
--------------------------

This default configuration sets Page TSConfig and User TSConfig with
as many features as possible for users who want to explore the
features of the RTE. This is  **not** recommended for production
environments.


.. _generated:

((generated))
^^^^^^^^^^^^^

.. _The-following-is-inserted-in-Page-TSConfig:

The following is inserted in Page TSConfig:
"""""""""""""""""""""""""""""""""""""""""""

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

## Partial re-use of color scheme and frame scheme from CSS Styled
Content extension

::

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

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

::

   RTE.classesAnchor {
           externalLink {
                   class = external-link
                   type = url
                   image = EXT:rtehtmlarea/res/accessibilityicons/img/external_link.gif
                   altText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:external_link_altText
                   titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:external_link_titleText
           }
           externalLinkInNewWindow {
                   class = external-link-new-window
                   type = url
                   image = EXT:rtehtmlarea/res/accessibilityicons/img/external_link_new_window.gif
                   altText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:external_link_new_window_altText
                   titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:external_link_new_window_titleText
           }
           internalLink {
                   class = internal-link
                   type = page
                   image = EXT:rtehtmlarea/res/accessibilityicons/img/internal_link.gif
                   altText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:internal_link_altText
                   titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:internal_link_titleText
           }
           internalLinkInNewWindow {
                   class = internal-link-new-window
                   type = page
                   image = EXT:rtehtmlarea/res/accessibilityicons/img/internal_link_new_window.gif
                   altText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:internal_link_new_window_altText
                   titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:internal_link_new_window_titleText
           }
           download {
                   class = download
                   type = file
                   image = EXT:rtehtmlarea/res/accessibilityicons/img/download.gif
                   altText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:download_altText
                   titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:download_titleText
           }
           mail {
                   class = mail
                   type = mail
                   image = EXT:rtehtmlarea/res/accessibilityicons/img/mail.gif
                   altText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:mail_altText
                   titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:mail_titleText
           }
   }

## Default RTE configuration

::

   RTE.default {

## Markup options

::

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

## Allow img tags

::

      proc.entryHTMLparser_db.tags.img >

## Allow style attributes on p and span tags

::

      proc.entryHTMLparser_db.tags {
                   p.allowedAttribs := addToList(style)
                   span.fixAttrib.style.unset >
           }

## Toolbar options

::

      showButtons = *

## More toolbar options

::

      keepButtonGroupTogether = 1

## Enable status bar

::

      showStatusBar =  1
   
           )

## Property ignoreMainStyleOverride is DEPRECATED as of TYPO3 4.6 and
will be removed in TYPO3 4.8

## Use stylesheet file rather than mainStyleOverride and inlineStyle
properties to style the contents

## When RTE.default.contentCSS is not specified, file
EXT:rtehtmlarea/res/contentcsss/default.css is used.

::

      ignoreMainStyleOverride = 1

## For this demo, do not remove font, strike and u tags

::

      proc.entryHTMLparser_db.removeTags := removeFromList(font,strike,u)
           

## 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,
                   align-left, align-center, align-right, align-justify,
                   csc-frame-frame1, csc-frame-frame2,
                   component-items, action-items,
                   component-items-ordered, action-items-ordered,
                   important, name-of-person, detail,
                   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, 
                   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

## Show all applicable class selectors available in the style sheet
file

::

      buttons.blockstyle.showTagFreeClasses = 1
           buttons.textstyle.showTagFreeClasses = 1

## Configuration specific to the table button or TableOperations
feature

## Use the context menu instead of the toolbar for table operations,
but keep toggleborders button in toolbar

## Show borders on table creation

::

      hideTableOperationsInToolbar = 1
           buttons.toggleborders.keepInToolbar = 1
           buttons.toggleborders.setOnTableCreation = 1

## Configuration specific to the inserttag button or QuickTag feature

## Do not allow insertion of the following tags

::

      buttons.inserttag.denyTags = font, underline, strike, table

## Configuration specific to the bold and italic buttons

## Add hotkeys associated with bold, italic, strikethrough and
underline buttons

::

      buttons.bold.hotKey = b
           buttons.italic.hotKey = i
           buttons.strikethrough.hotKey = s
           buttons.underline.hotkey = u

## Configuration specific to the spellcheck button or SpellCheck
feature

## Enable the use of personal dictionaries

::

      buttons.spellcheck.enablePersonalDictionaries = 1

## Configuration of microdata schema

::

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

## Use same processing as on entry to database to clean content pasted
into the editor

::

   RTE.default.enableWordClean.HTMLparser < RTE.default.proc.entryHTMLparser_db

## front end RTE configuration

::

   RTE.default.FE < RTE.default
   RTE.default.FE.userElements >
   RTE.default.FE.userLinks >

## 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:

The following is inserted in User TSConfig:
"""""""""""""""""""""""""""""""""""""""""""

## Enable the RTE by default for all users

::

   setup.default.edit_RTE = 1

## Enable the file upload feature of the element browser by default
for all users

::

   options.uploadFieldsInTopOfEB = 1

## Set the default spelling ability of the check speller for all users

::

   options.HTMLAreaPspellMode = bad-spellers

## Enable the personal dictionary feature of the check speller by
default for all users

::

   options.enablePersonalDicts = 1


.. _Image-default-configuration:

Image default configuration
---------------------------

This default configuration establishes support for images in Page
TSConfig. This is for use in addition to the Typical default
configuration.


.. _generated:

((generated))
^^^^^^^^^^^^^

.. _The-following-is-inserted-in-Page-TSConfig:

The following is inserted in Page TSConfig:
"""""""""""""""""""""""""""""""""""""""""""

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

## Add inline icons to the links

::

   RTE.classesAnchor {
           externalLink {
                   image = EXT:rtehtmlarea/res/accessibilityicons/img/external_link.gif
                   altText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:external_link_altText
           }
           externalLinkInNewWindow {
                   image = EXT:rtehtmlarea/res/accessibilityicons/img/external_link_new_window.gif
                   altText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:external_link_new_window_altText
           }
           internalLink {
                   image = EXT:rtehtmlarea/res/accessibilityicons/img/internal_link.gif
                   altText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:internal_link_altText
           }
           internalLinkInNewWindow {
                   image = EXT:rtehtmlarea/res/accessibilityicons/img/internal_link_new_window.gif
                   altText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:internal_link_new_window_altText
           }
           download {
                   image = EXT:rtehtmlarea/res/accessibilityicons/img/download.gif
                   altText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:download_altText
           }
           mail {
                   image = EXT:rtehtmlarea/res/accessibilityicons/img/mail.gif
                   altText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:mail_altText
           }
   }

## Default RTE configuration

::

   RTE.default {
           
                   ## Enable the image button
           showButtons := addToList(image)
           
                   ## Tags allowed outside p and div
                   ## Adding img tag to the default list
           proc.allowTagsOutside := addToList(img)
           
                   ## Do not remove img tags
           proc.entryHTMLparser_db.tags.img >
   }
   
   RTE.default.FE.showButtons < RTE.default.showButtons
   RTE.default.FE.proc.allowTagsOutside < RTE.default.proc.allowTagsOutside
   RTE.default.FE.proc.entryHTMLparser_db.tags.img >


.. _Troubleshooting:

Troubleshooting
===============


.. _Internet-Explorer-caching-problem-with-Apache-mod-gzip-module:

Internet Explorer caching problem with Apache mod\_gzip module
--------------------------------------------------------------

This article by `Jan Wulff `_ describes
the problems encountered with Internet Explorer 4/5/6 and the Apache
server with mod\_gzip activated. It describes how to work around these
problems.


.. _generated:

((generated))
^^^^^^^^^^^^^

.. _Problem:

Problem:
""""""""

If the Apache module mod\_gzip is activated on your server, you may
encounter the problem that Internet Explorer denies any caching for
the whole site, thus stopping the block style and text style selctor
lists of htmlArea RTE to work correctly. Besides, it may even slow
down some other features of TYPO3, like graphical JavaScript menus.
This effect does not depend on the gzip compression itself. Internet
Explorer is indeed able to handle compressed files. The problem is
IE's handling of one of the HTTP response headers sent with every
served document.


.. _Background:

Background:
"""""""""""

The HTTP Vary response header indicates whether a cache is permitted
to use the response to reply to a subsequent request without re-
validating the document. This is necessary if a document is not
suitable for all clients and is served in multiple different versions
according to the HTTP headers the client sends with his request.

For example, with activated mod\_gzip, every document is at least
available in two versions, compressed and uncompressed. If a browser
with gzip support requests such a document, it will receive the
compressed version. A proxy between the client and the server may
cache this file. Now, another browser without gzip support requests
the same document via the same proxy. Without the Vary header the
proxy would not know if the compressed document may be delivered to
the new client, because it can't compare the HTTP headers of the
second browser with the Vary header. If it would nevertheless serve
it, the client would receive a bunch of data, without any idea, how to
process it. Therefore mod\_gzip sends a Vary header with each response
with at least 'Accept-Encoding' as content.

The problems arise when the Internet Explorer enters the stage. IE 4,
5 and 6 recognizes only one kind of Vary header: 'User-agent', used to
distinguish between versions for different browsers. Every other Vary
header will be interpreted as it would have a single '\*' as content.
Because this does not compare with the headers send by any client, it
forbids any caching of documents received with this header.


.. _Solution:

Solution:
"""""""""

There is more than one approach to handle this problem. The following
configuration directives all have to be set in the Apache
configuration file or in a .htaccess file which has to be located in
your TYPO3 root.

**Easy going:**

So, you have no need for any gzip support? Fine, just deactivate the
module and your problems are gone. Use this directive:

::

   mod_gzip_on No

**Complex approach:**

You do have a lot of big code or text files, or you have to save as
much transfer bandwidth as possible? Anyway, deactivating mod\_gzip is
no option for you? Then, you should first check what release of
mod\_gzip your server is using. If you don't know how, ask your
provider, or just use the solution for releases from 1.3.19.2a till
1.3.26.1a.

mod\_gzip release < 1.3.19.2a

Releases before this version didn't send Vary headers, so there
shouldn't be any problem. But because you're reading this, you most
probably don't use these versions.

mod\_gzip release 1.3.19.2a <> 1.3.26.1a

These releases all use Vary headers. However, they send these headers
without verifying if the document is really checked for compression.
The only recommended way to get around this, is to deactivate
mod\_gzip. But thanks to Apache, you can deactivate mod\_gzip
separately for chosen files, and let it do it's work for the rest. You
could use this to deactivate mod\_gzip for all css files:

::

   
   mod_gzip_on No
   

Or going even further, you could also include image files:

::

   
   mod_gzip_on No
   

By the way, there is another possibility. You could deactivate Vary
headers in mod\_gzip with this:

::

   mod_gzip_send_vary Off

But there is a reason why mod\_gzip, since 1.3.19.2a, uses Vary
headers. As described above, you could badly mess up proxy servers, by
serving compressed files without Vary headers. Therefore, I strongly
discourage this approach.

mod\_gzip release > 1.3.26.1a

Since release 1.3.26.1a, mod\_gzip is a bit more discriminate. It only
sends Vary headers with documents which were checked for compression.
So you can tell mod\_gzip to exclude some files. This approach is not
so much different from the former solution, but it is cleaner because
it addresses mod\_gzip firsthand. To exclude CSS files from
compression, use this directive:

::

   mod_gzip_item_exclude file \.css$

If you would like to add images and Javascript files, you could use
this:

::

   mod_gzip_item_exclude file \.css$
   mod_gzip_item_exclude file \.png$
   mod_gzip_item_exclude file \.gif$
   mod_gzip_item_exclude file \.jpg$
   mod_gzip_item_exclude file \.jpeg$
   mod_gzip_item_exclude file \.js$

This is just a short survey of the caching problems with Internet
Explorer and mod\_gzip. I wrote it with best intent and hope it may be
helpful. If you find any mistakes, please let me know at
. I'm in no way responsible for any consequences
that may come forth by the use of this information.


.. _Internet-Explorer-and-HTML-tag-abbr:

Internet Explorer and HTML tag abbr
-----------------------------------

Before IE7, Internet Explorer did not support HTML tag abbr. If a
content element containing this tag is edited with htmlArea RTE in
IE6, the tag may be broken. Therefore, abbr tags are transformed to
acronym tags if IE6 is used.


.. _Security-error-when-accessing-the-stylesheets:

Security error when accessing the stylesheets
---------------------------------------------

This article by Carsten Emde describes a problem taht may arise when
the RTE tries to access the stylesheets.


.. _generated:

((generated))
^^^^^^^^^^^^^

.. _Problem:

Problem:
""""""""

In Firefox, the following error message is written to the JavaScript
console:

"[A security error occurred. Make sure all stylesheets are accessed
from the same domain/subdomain and using the same protocol as the
current script."


.. _Background:

Background:
"""""""""""

In order to prevent the error, everything of a web page needs to be in
the same domain, in the same subdomain and, more importantly, be
transmitted with the same protocol. This is not a special feature of
Firefox; IE8, Safari, Chrome, Opera and friends are behaving
similarly.

Initially, a user is connecting to our Web site
"http://www.mydomain.org", and the content of the Web site including
CSS files is loaded. In order to use the calendar and trouble ticket
extensions, the user needs to login. As required for this purpose, the
login page is accessed via https and some content is then transmitted
using this protocol. Any further attempt to run RTE in this situation,
irrespective of whether subsequent content is transmitted via http or
https, crashes with the security error. This is the result of the
browser storing the transmission protocol and the domain of the
content, so it can refuse to load dynamic pages, if they do not match
the available content, or if there is no coherent origin and protocol
of the content.


.. _Solution:

Solution:
"""""""""

I therefore changed the baseURL of the page to
"https://www.mydomain.org" to force a coherent protocol throughout an
entire session - even when it is not needed. Unfortunately, it still
did not work, because I simply forgot to flush the browser cache. Of
course, I flushed the server caches (as always), but in this special
case, it is important that the browser cache be flushed as well to
remove any non-https content at the client site. Only if the entire
content of a Web page has been transmitted using the same protocol, it
is considered safe. After I flushed the browser cache, RTE popped up
and started to work as I was used to it from the backend experience.


.. _Issue-with-Firefox-extension-NoScript:

Issue with Firefox extension NoScript
-------------------------------------


.. _generated:

((generated))
^^^^^^^^^^^^^

.. _Problem:

Problem:
""""""""

When the Firefox extension NoScript is installed, images served by a
server on localhost may not be displayed in the RTE.


.. _Solution:

Solution:
"""""""""

The problem may be solved by modifying the ABE configuration of the
NoScript extension.

Go to NoScript Options -> Advanced -> ABE -> SYSTEM .

Modify the existing ruleset so that it looks as follows:

Site LOCAL

Accept from LOCAL about:blank

Deny

|img-1| TSComnfig EXT: htmlArea RTE - 60


.. ######CUTTER_MARK_IMAGES######

.. |img-1| image:: img-1.png
.. :align: left
.. :border: 0
.. :height: 32
.. :id: Graphic1
.. :name: Graphic1
.. :width: 102