From 2df7505f9f6fd227f49dc4754e58ecfe1771705f Mon Sep 17 00:00:00 2001 From: Garvin Hicking Date: Wed, 10 Apr 2024 10:40:03 +0200 Subject: [PATCH 1/2] [TASK] Improve details of overriding TCEFORM field config --- Documentation/PageTsconfig/TceForm.rst | 40 ++++++++++++++++++++++---- 1 file changed, 35 insertions(+), 5 deletions(-) diff --git a/Documentation/PageTsconfig/TceForm.rst b/Documentation/PageTsconfig/TceForm.rst index 16b65bfb..c03a361f 100644 --- a/Documentation/PageTsconfig/TceForm.rst +++ b/Documentation/PageTsconfig/TceForm.rst @@ -294,7 +294,7 @@ config :php:`$GLOBALS['TCA'][]['columns'][]['config'][]`, see :ref:`TCA reference ` for details. - Not all configuration options can be overriden, the properties are restricted and depend on the + Not all configuration options can be overridden, the properties are restricted and depend on the :ref:`field type `. The array :code:`typo3/sysext/backend/Classes/Form/Utility/FormEngineUtility.php->$allowOverrideMatrix` within :ref:`FormEngine code ` defines details: @@ -320,7 +320,24 @@ config 'file' => ['appearance', 'behaviour', 'maxitems', 'minitems', 'readOnly'], 'imageManipulation' => ['ratios', 'cropVariants'], - This property is available for various levels: + The reason that not all properties can be changed is that + internally, the :ref:`DataHandler ` performs database + operations which require finalized :ref:`TCA ` definitions + that are accessed without this TSconfig getting interpreted. This mismatch + would then lead to inconsistencies. + + An `input` or `text` TCA field can *not* enable the + :ref:`RTE ` via the + :typoscript:`config.enableRichtext` option due to similar reasons in respect + to the DataHandler. + + Also, if for example the :typoscript:`max` definition of a field is made + larger than the TCA definition of that field, you may need to to change + the file :file:`ext_tables.sql` (see :ref:`t3coreapi:ext_tables-sql`) + to adjust column definitions, especially when otherwise using the + :ref:`Auto-generated structure `. + + The property :typoscript:`config` is available for these levels: table level, example: :typoscript:`TCEFORM.tt_content.header.config.max` @@ -329,10 +346,16 @@ config :typoscript:`TCEFORM.tt_content.header.types.textpic.config.max` Flex form field level, example: - :typoscript:`TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.myInputField.config.max` + No current TYPO3 version allows to override the configuration of + Flex form fields, even though this was previously documented here. + This may change in future versions. - Where :typoscript:`sDEF` is the sheet name. + .. todo: Removed, because this is broken in every known TYPO3 version. + .. todo: Maybe re-enable this, if it gets fixed in a future release + :typoscript:`TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.myInputField.config.max` + Where :typoscript:`sDEF` is the sheet name and :typoscript:`myext_pi1` the name + of the plugin. .. index:: Records; tree configuration @@ -367,9 +390,16 @@ config.treeConfig `TCEFORM.tt_content.header.types.config.treeConfig.startingPoints` Flex form field level, example: + No current TYPO3 version allows to override the configuration of + Flex form fields, even though this was previously documented here. + This may change in future versions. + + .. todo: Removed, because this is broken in every known TYPO3 version. + .. todo: Maybe re-enable this, if it gets fixed in a future release `TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.settings\.myfield.config.treeConfig.startingPoints` - Where `sDEF` is the sheet name. For a description + Where `sDEF` is the sheet name and :typoscript:`myext_pi1` the name + of the plugin. For a description see the section :ref:`tceformApplyPropertiesFlexForm` on this page. From f266a5589e9dd46adb5a64e1df690b37d0f82db2 Mon Sep 17 00:00:00 2001 From: Garvin Hicking Date: Thu, 11 Apr 2024 09:56:35 +0200 Subject: [PATCH 2/2] Update Documentation/PageTsconfig/TceForm.rst --- Documentation/PageTsconfig/TceForm.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Documentation/PageTsconfig/TceForm.rst b/Documentation/PageTsconfig/TceForm.rst index c03a361f..98f47b87 100644 --- a/Documentation/PageTsconfig/TceForm.rst +++ b/Documentation/PageTsconfig/TceForm.rst @@ -334,7 +334,7 @@ config Also, if for example the :typoscript:`max` definition of a field is made larger than the TCA definition of that field, you may need to to change the file :file:`ext_tables.sql` (see :ref:`t3coreapi:ext_tables-sql`) - to adjust column definitions, especially when otherwise using the + to adjust column definitions, especially when using the :ref:`Auto-generated structure `. The property :typoscript:`config` is available for these levels: