TYPO3 Configuration Basics

Just in case you are not familiar with how to configure TYPO3, we will give you a very brief introduction. Otherwise, you can safely skip this part and continue reading Configuration Concepts.

We only cover configuration methods that are used to configure rte_ckeditor.

Page TSconfig

Relevant Settings for rte_ckeditor

Page TSconfig can be used to change:

  1. Default preset:

    RTE.default.preset = full
    
  2. Override for one field (RTE.config.[tableName].[fieldName].preset):

    RTE.config.tt_content.bodytext.preset = myCustomPreset
    RTE.config.tx_news_domain_model_news.bodytext.preset = minimal
    
  3. Override for one field defined in flexform (RTE.config.[tableName].[flexForm.field.name].preset):

    RTE.config.tt_content.settings.notifications.emailText.preset = myCustomPreset
    
  4. Override for one field, if type matches (RTE.config.[tableName].[fieldName].types.[type].preset):

    RTE.config.tt_content.bodytext.types.textmedia.preset = minimal
    

For more examples, see RTE in “TSconfig Reference”.

How to change values

As Page TSconfig always applies to a page and its subpages, you can modify it by editing a page.

  1. Go to the Web > Page module.

  2. Select a page in the page tree (usually your root page).

  3. Click on the button to Edit page properties

    ../_images/edit_page_properties.png
  4. Select the Resources tab

  5. Enter the Page TSconfig in the field “Page TSconfig”

Additionally, you can add Page TSconfig in an extension: Configuration/TSconfig/Page, see Use a Sitepackage extension.

How to view settings

Go to the module Web > Info and select Page TSconfig.

Global Configuration

Global Configuration is a system-wide general configuration.

Relevant Settings for rte_ckeditor

The setting $GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets'] is used to configure the available presets for rich text editing.

By default, the presets “minimal”, “default” and “full” are defined.

If you add a new preset, you must add it to this array.

How to change values

Usually, Global Configuration can be configured in the backend in Admin Tools > Settings > Configure Installation-Wide Options.

However, the settings relevant for rich text editing, $GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets'] cannot be configured in the backend.

You must either configure this in:

  1. The file typo3conf/AdditionalConfiguration.php
  2. Or in an extension in the file EXT:<extkey>/ext_localconf.php
if (empty($GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets']['myCustomPreset'])) {
    $GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets']['myCustomPreset'] = 'EXT:<extkey>/Configuration/RTE/MyCustomPreset.yaml';
}

How to view settings

You can view the Global Configuration in System > Configuration > $GLOBAL[‘TYPO3_CONF_VARS’] (Global Configuration) > RTE.

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

Global Configuration: RTE > Presets

YAML

Most of the configuration of rte_ckeditor will be done in a YAML file.

Relevant Settings for rte_ckeditor

See Configuration Reference

How to change values

This is done directly in the file. The YAML file should be included in a sitepackage extension, see Use a Sitepackage extension.