[!!!][TASK] RTE: locallang inferno
[Packages/TYPO3.CMS.git] / typo3 / sysext / rtehtmlarea / Documentation / DefaultConfigurations / Typical / Index.rst
1 .. ==================================================
2 .. FOR YOUR INFORMATION
3 .. --------------------------------------------------
4 .. -*- coding: utf-8 -*- with BOM.
5
6 .. include:: ../../Includes.txt
7
8
9
10 .. _typical-configuration:
11
12 Typical default configuration
13 -----------------------------
14
15 This default configuration establishes default settings in Page
16 TSconfig and User TSconfig with most commonly used features
17 representing a good start for typical sites.
18
19
20 .. _typical-page-tsconfig:
21
22 The following is inserted in Page TSconfig:
23 """""""""""""""""""""""""""""""""""""""""""
24
25 ## Define labels and styles to be applied to class selectors in the
26 interface of the RTE
27
28 ## The examples included here make partial re-use of color scheme and
29 frame scheme from CSS Styled Content extension
30
31 ::
32
33    RTE.classes {
34            align-left {
35                    name = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_tooltips.xlf:justifyleft
36                    value = text-align: left;
37            }
38            align-center {
39                    name = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_tooltips.xlf:justifycenter
40                    value = text-align: center;
41            }
42            align-right {
43                    name = LLL:EXT:rtehtmlarea/Resources/Private/Language/locallang_tooltips.xlf:justifyright
44                    value = text-align: right;
45            }
46            csc-frame-frame1 {
47                    name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xlf:frame-frame1
48                    value = background-color: #EDEBF1; border: 1px solid #333333;
49            }
50            csc-frame-frame2 {
51                    name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xlf:frame-frame2
52                    value = background-color: #F5FFAA; border: 1px solid #333333;
53            }
54            important {
55                    name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xlf:important
56                    value = color: #8A0020;
57            }
58            name-of-person {
59                    name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xlf:name-of-person
60                    value = color: #10007B;
61            }
62            detail {
63                    name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xlf:detail
64                    value = color: #186900;
65            }
66            component-items {
67                    name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xlf:component-items
68                    value = color: #186900;
69            }
70            action-items {
71                    name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xlf:action-items
72                    value = color: #8A0020;
73            }
74            component-items-ordered {
75                    name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xlf:component-items
76                    value = color: #186900;
77            }
78            action-items-ordered {
79                    name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xlf:action-items
80                    value = color: #8A0020;
81            }
82    }
83
84 ## Anchor classes configuration for use by the anchor accesibility
85 feature
86
87 ::
88
89    RTE.classesAnchor {
90            externalLink {
91                    class = external-link
92                    type = url
93                    titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xlf:external_link_titleText
94            }
95            externalLinkInNewWindow {
96                    class = external-link-new-window
97                    type = url
98                    titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xlf:external_link_new_window_titleText
99            }
100            internalLink {
101                    class = internal-link
102                    type = page
103                    titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xlf:internal_link_titleText
104            }
105            internalLinkInNewWindow {
106                    class = internal-link-new-window
107                    type = page
108                    titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xlf:internal_link_new_window_titleText
109            }
110            download {
111                    class = download
112                    type = file
113                    titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xlf:download_titleText
114            }
115            mail {
116                    class = mail
117                    type = mail
118                    titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xlf:mail_titleText
119            }
120    }
121
122 ## Default RTE configuration
123
124 ::
125
126    RTE.default {
127
128 ## Markup options
129
130 ::
131
132       enableWordClean = 1
133       removeTrailingBR = 1
134       removeComments = 1
135       removeTags = center, font, o:p, sdfield, strike, u
136       removeTagsAndContents = link, meta, script, style, title
137
138 ## Toolbar options
139
140 ## The TCA configuration may add buttons to the toolbar
141
142 ::
143
144       showButtons = blockstylelabel, blockstyle, textstylelabel, textstyle
145       showButtons := addToList(formatblock, bold, italic, subscript, superscript)
146       showButtons := addToList(orderedlist, unorderedlist, outdent, indent, textindicator)
147       showButtons := addToList(insertcharacter, link, table, findreplace, chMode, removeformat, undo, redo, about)
148       showButtons := addToList(toggleborders, tableproperties)
149       showButtons := addToList(rowproperties, rowinsertabove, rowinsertunder, rowdelete, rowsplit)
150       showButtons := addToList(columninsertbefore, columninsertafter, columndelete, columnsplit)
151       showButtons := addToList(cellproperties, cellinsertbefore, cellinsertafter, celldelete, cellsplit, cellmerge)
152
153 ## More toolbar options
154
155 ::
156
157       keepButtonGroupTogether = 1
158
159 ## Enable status bar
160
161 ::
162
163       showStatusBar =  1
164
165 ## Hide infrequently used block types in the block formatting selector
166
167 ::
168
169       buttons.formatblock.removeItems = pre,address
170
171 ## List all class selectors that are allowed on the way to the
172 database
173
174 ::
175
176       proc.allowedClasses = external-link, external-link-new-window, internal-link, internal-link-new-window, download, mail
177       proc.allowedClasses := addToList(align-left, align-center, align-right, align-justify)
178       proc.allowedClasses := addToList(csc-frame-frame1, csc-frame-frame2)
179       proc.allowedClasses := addToList(component-items, action-items)
180       proc.allowedClasses := addToList(component-items-ordered, action-items-ordered)
181       proc.allowedClasses := addToList(important, name-of-person, detail)
182       proc.allowedClasses := addToList(indent)
183
184 ## Restrict the list of class selectors presented by the RTE to the
185 following for the specified tags:
186
187 ::
188
189       buttons.blockstyle.tags.div.allowedClasses = align-left, align-center, align-right
190       buttons.blockstyle.tags.div.allowedClasses := addToList(csc-frame-frame1, csc-frame-frame2)
191       buttons.blockstyle.tags.table.allowedClasses = csc-frame-frame1, csc-frame-frame2
192       buttons.blockstyle.tags.td.allowedClasses = align-left, align-center, align-right
193       buttons.textstyle.tags.span.allowedClasses = important, name-of-person, detail
194
195 ## Configuration of classes for links
196
197 ## These classes should also be in the list proc.allowedClasses
198
199 ::
200
201       buttons.link.properties.class.allowedClasses = external-link, external-link-new-window, internal-link, internal-link-new-window, download, mail
202       buttons.link.page.properties.class.default = internal-link
203       buttons.link.url.properties.class.default = external-link-new-window
204       buttons.link.file.properties.class.default = download
205       buttons.link.mail.properties.class.default = mail
206
207 ## Configuration specific to the TableOperations feature
208
209 ## Remove the following fieldsets from the properties popups
210
211 ::
212
213       disableAlignmentFieldsetInTableOperations = 1
214       disableSpacingFieldsetInTableOperations = 1
215       disableColorFieldsetInTableOperations = 1
216       disableLayoutFieldsetInTableOperations = 1
217
218 ## Show borders on table creation
219
220 ::
221
222       buttons.toggleborders.setOnTableCreation = 1
223
224 ## Configuration specific to the bold and italic buttons
225
226 ## Add hotkeys associated with bold and italic buttons
227
228 ::
229
230       buttons.bold.hotKey = b
231       buttons.italic.hotKey = i
232
233 ## Configuration of microdata schema
234
235 ::
236
237       schema {
238                    sources {
239                            schemaOrg = EXT:rtehtmlarea/extensions/MicrodataSchema/res/schemaOrgAll.rdf
240                    }
241            }
242    }
243
244 ## front end RTE configuration for the general public
245
246 ::
247
248    RTE.default.FE < RTE.default
249    RTE.default.FE.showStatusBar = 0
250    RTE.default.FE.hideButtons = chMode, blockstyle, textstyle, underline, strikethrough, subscript, superscript, lefttoright, righttoleft, left, center, right, justifyfull, table, inserttag, findreplace, removeformat, copy, cut, paste
251    RTE.default.FE.userElements >
252    RTE.default.FE.userLinks >
253
254 ## tt\_content TCEFORM configuration
255
256 ## Let use all the space available for more comfort.
257
258 ::
259
260    TCEFORM.tt_content.bodytext.RTEfullScreenWidth = 100%
261
262
263 .. _typical-user-tsconfig:
264
265 The following is inserted in User TSconfig:
266 """""""""""""""""""""""""""""""""""""""""""
267
268 ## Enable the RTE by default for all users
269
270 ::
271
272    setup.default.edit_RTE = 1
273
274
275