[TASK] Remove old language labels in EXT:setup
[Packages/TYPO3.CMS.git] / typo3 / sysext / form / Documentation / Configuration / Layout / LayoutWholeForm / Index.rst
1 .. include:: ../../../Includes.txt
2
3
4 .. _change-layout-of-whole-form:
5
6 ===================================
7 Change the layout of the whole form
8 ===================================
9
10 .. attention::
11
12     It is not recommended to change the layout globally for the whole form.
13     Unfortunately, using view specific layout settings did not work for a
14     long time and is now widely used by integrators.
15
16     There are several reasons for not to use global layout settings:
17
18     - Some objects cannot be changed globally.
19     - Changing some objects will cause problems which lead to failures in
20       the processing. The code will die with PHP errors.
21     - Quite often it does not make sense to do these changes globally.
22
23     Instead change the layout for a :ref:`specific view <change-layout-specific-view>`!
24
25 Apart from the above mentioned problems one could change the layout globally
26 using the following TypoScript setup. Using :ts:`tt_content.mailform.20`
27 registers the chances for all forms of the below the page tree. If one wants
28 to change the layout only for a specific form, a TypoScript library could be
29 build as shown :ref:`here <reference-form-example>`.
30
31 .. code-block:: typoscript
32
33   tt_content.mailform.20 {
34     layout {
35       # changing the layout of the form object globally
36       form (
37         <form class="form-class">
38           <containerWrap />
39         </form>
40       )
41     }
42   }
43
44 As one can see, an (X)HTML kind of markup is used. Actually it is XML, with
45 some extra tags like the :ts:`containerWrap`.
46