[TASK] Merge properties to text - rte page (#1138)

Releases: main, 12.4

Documentation/ColumnsConfig/Type/Text/Default/Index.rst

@@ -2,20 +2,115 @@
 
 ..  _columns-text-renderType-default:
 
-==============
-text (default)
-==============
+================
+text (multiline)
+================
+
+This page describes the :ref:`text <columns-text>` type with no renderType (default).
+
+`type='text'` without a given specific renderType either renders a simple
+`<textarea>` or a :ref:`Rich Text field <rich-text-editor-examples>` if
+:confval:`text-enableRichtext` is enabled in TCA and
+:ref:`page TSconfig <t3tsconfig:pageTsRte>`.
 
 ..  contents:: Table of contents:
-    :local:
-    :depth: 1
 
-This page describes the :ref:`text <columns-text>` type with no renderType (default).
+..  _columns-text-examples:
+
+Examples for multiline text fields
+==================================
+
+..  _tca_example_text_4:
+
+Multiline plain text area
+-------------------------
+
+..  include:: /Images/Rst/Text4.rst.txt
+
+..  include:: /CodeSnippets/Text4.rst.txt
+
+..  _tca_example_rte_1:
+
+Rich text editor field
+----------------------
+
+..  include:: /Images/Rst/Rte1.rst.txt
+
+..  include:: /CodeSnippets/Rte1.rst.txt
+
+..  _columns-text-properties:
+..  _columns-text-properties-default:
+
+Properties of the TCA column type `text` with or without enabled rich text
+==========================================================================
+
+..  confval-menu::
+    :display: table
+    :type:
+    :Scope:
+
+    ..  include:: _Properties/_AllowLanguageSynchronization.rst.txt
+        :show-buttons:
+
+    ..  include:: _Properties/_Cols.rst.txt
+        :show-buttons:
+
+    ..  include:: _Properties/_Default.rst.txt
+        :show-buttons:
+
+    ..  include:: _Properties/_EnableRichtext.rst.txt
+        :show-buttons:
+
+    ..  include:: _Properties/_EnableTabulator.rst.txt
+        :show-buttons:
+
+    ..  include:: _Properties/_Eval.rst.txt
+        :show-buttons:
+
+    ..  include:: _Properties/_FieldControl.rst.txt
+        :show-buttons:
+
+    ..  include:: _Properties/_FieldInformation.rst.txt
+        :show-buttons:
+
+    ..  include:: _Properties/_FieldWizard.rst.txt
+        :show-buttons:
+
+    ..  include:: _Properties/_FixedFont.rst.txt
+        :show-buttons:
+
+    ..  include:: _Properties/_IsIn.rst.txt
+        :show-buttons:
+
+    ..  include:: _Properties/_Max.rst.txt
+        :show-buttons:
+
+    ..  include:: _Properties/_Min.rst.txt
+        :show-buttons:
+
+    ..  include:: _Properties/_Nullable.rst.txt
+        :show-buttons:
+
+    ..  include:: _Properties/_Placeholder.rst.txt
+        :show-buttons:
+
+    ..  include:: _Properties/_ReadOnly.rst.txt
+        :show-buttons:
+
+    ..  include:: _Properties/_Required.rst.txt
+        :show-buttons:
+
+    ..  include:: _Properties/_RichtextConfiguration.rst.txt
+        :show-buttons:
+
+    ..  include:: _Properties/_Rows.rst.txt
+        :show-buttons:
 
-type='text' without a given specific renderType either renders a simple :code:`<textarea>` or a Rich Text
-field if Rich Text Editor is enabled in the configuration and for the user.
+    ..  include:: _Properties/_Search.rst.txt
+        :show-buttons:
 
-..  toctree::
+    ..  include:: _Properties/_Softref.rst.txt
+        :show-buttons:
 
-    Examples
-    Properties
+    ..  include:: _Properties/_Wrap.rst.txt
+        :show-buttons:

Documentation/ColumnsConfig/Type/Text/Default/_Properties/_AllowLanguageSynchronization.rst.txt

@@ -0,0 +1,22 @@
+..  confval:: behaviour
+    :name: text-behaviour
+
+    ..  confval:: allowLanguageSynchronization
+        :type: boolean
+        :name: text-behaviour-allowLanguageSynchronization
+        :Path: $GLOBALS['TCA'][$table]['columns'][$field]['config']['behaviour']['allowLanguageSynchronization']
+        :Scope: Proc.
+        :default: false
+
+        Allows an editor to select in a localized record whether the value is copied
+        over from default or source language record, or if the field has an own value
+        in the localization. If set to true and if the table supports localization
+        and if a localized record is edited, this setting enables FieldWizard
+        :ref:`LocalizationStateSelector <columns-input-properties-fieldWizard-localizationStateSelector>`:
+        Two or three radio buttons shown below the field input. The state of this is
+        stored in a json encoded array in the database table called :code:`l10n_state`.
+        It tells the DataHandler which fields of the localization records should be kept
+        in sync if the underlying default or source record changes.
+
+        ..  literalinclude:: _Snippets/_AllowLanguageSynchronization.php
+            :caption: EXT:my_extension/Configuration/TCA/Overrides/someTable.php

Documentation/ColumnsConfig/Type/Text/Properties/Cols.rst → Documentation/ColumnsConfig/Type/Text/Default/_Properties/_Cols.rst.txt

@@ -1,27 +1,17 @@
-..  include:: /Includes.rst.txt
 ..  _columns-text-properties-cols:
 
-====
-cols
-====
-
 ..  confval:: cols
     :name: text-cols
     :Path: $GLOBALS['TCA'][$table]['columns'][$field]['config']
     :type: integer
     :Scope: Display
 
-
-    :RenderType: :ref:`textTable <columns-text-renderType-textTable>`,
-        :ref:`default <columns-text-renderType-default>`
-
-    Abstract value for the width of the :code:`<textarea>` field. To set the textarea to the full width
-    of the form area, use the value 50. Default is 30.
+    Abstract value for the width of the :code:`<textarea>` field. To set
+    the textarea to the full width of the form area, use the value 50. Default is 30.
 
     Does not apply to RTE fields.
 
-A simple text editor with 20 width
-==================================
+..  rubric:: Example: A simple text editor with 20 width
 
 ..  include:: /Images/Rst/Text4.rst.txt
 

Documentation/ColumnsConfig/Type/Text/Default/_Properties/_Default.rst.txt

@@ -0,0 +1,7 @@
+..  confval:: default
+    :name: text-default
+    :Path: $GLOBALS['TCA'][$table]['columns'][$field]['config']['default']
+    :type: string
+    :Scope: Display  / Proc.
+
+    Default value set if a new record is created.

Documentation/ColumnsConfig/Type/Text/Properties/EnableRichtext.rst → Documentation/ColumnsConfig/Type/Text/Default/_Properties/_EnableRichtext.rst.txt

@@ -1,25 +1,17 @@
-..  include:: /Includes.rst.txt
 ..  _columns-text-properties-enableRichtext:
 
-==============
-enableRichtext
-==============
-
 ..  confval:: enableRichtext
     :name: text-enableRichtext
     :Path: $GLOBALS['TCA'][$table]['columns'][$field]['config']
     :type: boolean
     :Scope: Display  / Proc.
-    :RenderType: :ref:`default <columns-text-renderType-default>`
 
     If set to true, the system renders a Rich Text Editor if that is enabled for the editor (default: yes),
     and if a suitable editor extension is loaded (default: rteckeditor).
 
     If either of these requirements is not met, the system falls back to a :code:`<textarea>` field.
 
-
-Rich text editor (RTE)
-======================
+..  rubric:: Example: Rich text editor (RTE)
 
 ..  include:: /Images/Rst/Rte1.rst.txt
 

Documentation/ColumnsConfig/Type/Text/Properties/EnableTabulator.rst → Documentation/ColumnsConfig/Type/Text/Default/_Properties/_EnableTabulator.rst.txt

@@ -1,29 +1,20 @@
-..  include:: /Includes.rst.txt
 ..  _columns-text-properties-enableTabulator:
 
-===============
-enableTabulator
-===============
-
 ..  confval:: enableTabulator
     :name: text-enableTabulator
     :Path: $GLOBALS['TCA'][$table]['columns'][$field]['config']
     :type: boolean
     :Scope: Display
-    :RenderType: :ref:`default <columns-text-renderType-default>`, :ref:`textTable <columns-text-renderType-textTable>`
 
     Enabling this allows to use tabs in a text field. This works well together with
-    :ref:`fixed-width fonts <columns-text-properties-fixedFont>` (monospace) for code editing.
+    :ref:`fixed-width fonts <columns-text-properties-fixedFont>` (monospace)
+    for code editing.
 
     Does not apply to RTE fields.
 
-Examples
-========
-
 ..  _tca_example_text_15:
 
-Fixed font field with tabulators enabled
-----------------------------------------
+..  rubric:: Example: Fixed font field with tabulators enabled
 
 ..  include:: /Images/Rst/Text15.rst.txt