Page TSConfig Setup
Configuration of page TSConfig settings for image handling, upload folders, and permissions.
Table of Contents
Page TSConfig
Magic Image Configuration
Configure maximum image dimensions for automatic image processing:
RTE.default.buttons.image.options.magic.maxWidth
-
- type
-
integer
- Default
-
300
Maximum width in pixels for images inserted through the RTE.
Images larger than this value will be automatically resized during processing.
RTE.default.buttons.image.options.magic.maxHeight
-
- type
-
integer
- Default
-
1000
Maximum height in pixels for images inserted through the RTE.
Images taller than this value will be automatically resized during processing.
Example:
RTE.default.buttons.image.options.magic {
maxWidth = 1920
maxHeight = 9999
}Warning
Due to TYPO3 bug #87068, you may need to add these settings to root page config instead of custom template extensions.
Processing Modes
RTE.default.proc.overruleMode := addToList(default)
RTE.default.proc.overruleMode := addToList(rtehtmlarea_images_db)Upload Folder Configuration
RTE.default.buttons.image.options.defaultUploadFolder
-
- type
-
string
- Default
-
(empty)
Default upload folder for images inserted through the RTE.
Format:
<storage_uid>:<folder_path>Example:
1:rte_uploads/uses storage 1 and uploads torte_uploads/directory.
RTE.default.buttons.image.options.createUploadFolderIfNeeded
-
- type
-
boolean
- Default
-
false
Automatically creates the upload folder if it doesn't exist.
Recommended to set to
1(true) to avoid upload errors.
Example:
RTE.default.buttons.image.options {
defaultUploadFolder = 1:rte_uploads/
createUploadFolderIfNeeded = 1
}Content Element Configuration
Enable for Specific Content Types
# Only enable for tt_content bodytext
RTE.config.tt_content.bodytext {
preset = default
buttons.image.options.magic {
maxWidth = 1200
maxHeight = 800
}
}Disable for Specific Fields
# Disable RTE entirely for specific field
RTE.config.tt_content.header.disabled = 1Backend User Permissions
File Mounts
Ensure backend users have appropriate file mounts:
options.defaultUploadFolder = 1:user_uploads/rte/Access Restrictions
# Allow only specific file extensions
options.file_list.validFileExtensions = jpg,jpeg,png,gif,webpMulti-Language Configuration
Language-Specific Presets
[siteLanguage("locale") == "de_DE"]
RTE.default.preset = german
[END]
[siteLanguage("locale") == "en_US"]
RTE.default.preset = english
[END]Troubleshooting Configuration
Debug RTE Configuration
Enable RTE debugging:
RTE.default.showButtons = *
RTE.default.hideButtons =Verify Configuration Loading
Check active RTE configuration in backend:
- Edit content element
- Open browser console
- Check
CKEDITOR.configobject
Configuration Priority
Configuration precedence (highest to lowest):
- Field-specific config:
RTE.config.tt_content.bodytext - Type-specific config:
RTE.config.tt_content - Default config:
RTE.default - Extension defaults