diff --git a/Documentation/PageTsconfig/Rte.rst b/Documentation/PageTsconfig/Rte.rst index 65de758e..7500e420 100644 --- a/Documentation/PageTsconfig/Rte.rst +++ b/Documentation/PageTsconfig/Rte.rst @@ -13,12 +13,15 @@ The `RTE` prefix key is used for configuration of the Rich Text Editor. Please refer to the :ref:`RTE chapter ` in Core API document for more general information on RTE configuration and data processing. -The order in which configuration for the RTE is loaded is: +The order in which the configuration for the RTE is loaded is (the first one which +is set will be used, see :ref:`example ` below): -1. preset defined for a specific field via PageTS -2. richtextConfiguration defined for a specific field via TCA -3. general preset defined via PageTS -4. default +1. preset defined for a specific field via page TSconfig +2. :ref:`richtextConfiguration ` + defined for a specific field via TCA +3. general preset defined via page TSconfig (:typoscript:`RTE.default.preset`) +4. default (the preset "default", e.g. as defined by EXT:rte_ckeditor or overridden + in :file:`ext_localconf.php`) The full property path building is a bit more complex than for other property segments. The goal is that global options can be set that can @@ -33,7 +36,17 @@ Configure RTE for a specific field in a table Configure RTE for a specific field in a table for a specific :ref:`record type ` `RTE.config.[tableName].[fieldName].types.[type]` -Consider the following Page TSconfig examples: +Configuring RTE via page TSconfig is general and not specific to a +particular rich-text editor. However, TYPO3 comes with EXT:rte_ckeditor, so this one +will usually be used. This page covers only the general configuration, for +more information about configuring EXT:rte_ckeditor, see the +:ref:`rte_ckeditor configuration `. + +Examples +======== + +Example: Disable RTE +-------------------- .. code-block:: typoscript :caption: EXT:site_package/Configuration/page.tsconfig @@ -59,6 +72,30 @@ Consider the following Page TSconfig examples: # But disable RTE for tt_content bodytext again if the record type is "text" RTE.config.tt_content.bodytext.types.text.disabled = 1 +.. _pageTsRteOverridePreset: + +Example: Override preset +------------------------ + +Refer to the description of the order above for details of which setting has priority over which. + +Summary: + +* Setting the preset via page TSconfig *for a specific field* overrides all, + else +* TCA richtextConfiguration (for a specific field) overrides the page TSconfig + default preset (:typoscript:`RTE.default.preset`) + +.. code-block:: typoscript + :caption: EXT:site_package/Configuration/page.tsconfig + + # set a default preset to use as fallback + RTE.default.preset = custom_preset_default + + # Override preset for field "description" in table "tt_address" + RTE.config.tt_address.description.preset = custom_preset_fancy + + Properties ========== diff --git a/Documentation/Settings.cfg b/Documentation/Settings.cfg index d251de4e..29004ca7 100644 --- a/Documentation/Settings.cfg +++ b/Documentation/Settings.cfg @@ -58,7 +58,7 @@ ext_lowlevel = https://docs.typo3.org/c/typo3/cms-lowlevel/main/en-us/ # ext_recycler = https://docs.typo3.org/c/typo3/cms-recycler/main/en-us/ # ext_redirects = https://docs.typo3.org/c/typo3/cms-redirects/main/en-us/ # ext_reports = https://docs.typo3.org/c/typo3/cms-reports/main/en-us/ -# ext_rte_ckeditor = https://docs.typo3.org/c/typo3/cms-rte-ckeditor/main/en-us/ +ext_rte_ckeditor = https://docs.typo3.org/c/typo3/cms-rte-ckeditor/main/en-us/ # ext_scheduler = https://docs.typo3.org/c/typo3/cms-scheduler/main/en-us/ # ext_seo = https://docs.typo3.org/c/typo3/cms-seo/main/en-us/ # ext_t3editor = https://docs.typo3.org/c/typo3/cms-t3editor/main/en-us/