Configuration Quickstart

Here we explain, how to modify the existing configuration in a few simple steps.

View Existing Configuration

To familiarize yourself with the configuration, look at the existing configuration in your TYPO3 website:

To view the existing RTE presets in the "Global Configuration", go to System > Configuration in the backend, choose $GLOBALS['TYPO3_CONF_VARS'] (Global Configuration) and select RTE:

../_images/global-configuration-rte.png

Global Configuration: RTE > Presets

By default, TYPO3 is shipped with three configuration presets:

  • default

  • full

  • minimal

Minimal Example

Here is a very minimal example of changing the default configuration. All configuration is done in a custom sitepackage extension, see also Use a Sitepackage extension.

Override the configuration preset "default" by adding this in <my_extension>/ext_localconf.php (replace my_extension with your extension key):

$GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets']['default'] = 'EXT:my_extension/Configuration/RTE/Default.yaml';

Add the file Configuration/RTE/Default.yaml to your extension, use the file EXT:rte_ckeditor/Configuration/RTE/Full.yaml as example (see latest Full.yaml)

We explain the example Minimal.yaml from the Core:

 1# Load default processing options
 2imports:
 3    - { resource: "EXT:rte_ckeditor/Configuration/RTE/Processing.yaml" }
 4    - { resource: "EXT:rte_ckeditor/Configuration/RTE/Editor/Base.yaml" }
 5
 6# Minimal configuration for the editor
 7editor:
 8  config:
 9    toolbarGroups:
10      - { name: basicstyles, groups: [ basicstyles] }
11      - { name: clipboard, groups: [clipboard, undo] }
12    removeButtons:
13      - Anchor
14      - Superscript
15      - Subscript
16      - Underline
17      - Strike
line #2

Imports existing files to make basic parts reusable and improve structure of configuration

line #9 toolbarGroups

See toolbarGroups and Understanding CKEditor Toolbar Concepts

line #12 removeButtons

This deactivates default buttons rendered in the toolbar, see removeButtons