From 5142f30dac1fe6377a374a77adcd105aa3b660d7 Mon Sep 17 00:00:00 2001 From: Sarah McCarthy Date: Wed, 27 Nov 2024 15:48:57 +0100 Subject: [PATCH 1/3] [TASK] Add description of page TSconfig and user TSconfig in TYPO3 Concepts #481 Releases: main, 13.4, 12.4 --- Documentation/Concepts/Index.rst | 9 +++++ Documentation/Concepts/TSconfig/Index.rst | 48 +++++++++++++++++++++++ 2 files changed, 57 insertions(+) create mode 100644 Documentation/Concepts/TSconfig/Index.rst diff --git a/Documentation/Concepts/Index.rst b/Documentation/Concepts/Index.rst index 50b8d86e..e12322a7 100644 --- a/Documentation/Concepts/Index.rst +++ b/Documentation/Concepts/Index.rst @@ -66,6 +66,14 @@ TYPO3 Concepts .. card-footer:: :ref:`Create a minimal page created by pure TypoScript ` :button-style: btn btn-secondary stretched-link + .. card:: TSconfig + + TSconfig is a configuration language used to configure the + TYPO3 backend. It has the same syntax as TypoScript. + + .. card-footer:: :ref:`TSconfig ` + :button-style: btn btn-secondary stretched-link + .. card:: Fluid templating Fluid is the standard templating engine that is used with TYPO3. @@ -104,6 +112,7 @@ TYPO3 Concepts Extensions/Index Cache/Index TypoScript/Index + TSconfig/Index Fluid/Index TCA/Index Assets/Index diff --git a/Documentation/Concepts/TSconfig/Index.rst b/Documentation/Concepts/TSconfig/Index.rst new file mode 100644 index 00000000..0f9d2e04 --- /dev/null +++ b/Documentation/Concepts/TSconfig/Index.rst @@ -0,0 +1,48 @@ +:navigation-title: TSconfig +.. include:: /Includes.rst.txt + +.. _tsconfig: + +===== +TSConfig +===== + +There are two types of TSconfig: user TSconfig and page TSconfig. + +.. _concepts_user_tsconfig: + +===== +User TSconfig +===== + +User TSconfig is a set of configuration values that affect backend users. They can +be set at the user level or at the backend user group level (then affecting all +users in that group). Things that can be configured are generally related to +permissions for basic functionality, for example, whether a user can clear the cache. + +There are also configuration values for the admin panel (which is shown in the +frontend and not the backend). + + +.. _concepts_page_tsconfig: + +===== +Page TSconfig +===== + +Page TSconfig is a set of configuration values that affect pages. It is set at +the page level and affects that page and all the pages below it in the tree. The +things that can be configured mainly affect the look and feel of the backend, +such as which fields are available when editing a content element. In general, +page TSconfig dictates what a user sees when they click on modules in the +left-hand module bar, e.g. Page, View, List. + +.. _tsconfig-more-information: + +Where to find more information +============================== + +To learn more about TSconfig and how to use it in your TYPO3 projects, refer to the official +TYPO3 documentation: + +* `Using and setting TSconfig `_ From 37eaaca6fff292196616e117086e71274fa8b513 Mon Sep 17 00:00:00 2001 From: Lina Wolf <48202465+linawolf@users.noreply.github.com> Date: Thu, 28 Nov 2024 13:51:12 +0100 Subject: [PATCH 2/3] Correct headline levels --- Documentation/Concepts/TSconfig/Index.rst | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/Documentation/Concepts/TSconfig/Index.rst b/Documentation/Concepts/TSconfig/Index.rst index 0f9d2e04..78e6ba8d 100644 --- a/Documentation/Concepts/TSconfig/Index.rst +++ b/Documentation/Concepts/TSconfig/Index.rst @@ -3,17 +3,16 @@ .. _tsconfig: -===== +======== TSConfig -===== +======== There are two types of TSconfig: user TSconfig and page TSconfig. .. _concepts_user_tsconfig: -===== User TSconfig -===== +============= User TSconfig is a set of configuration values that affect backend users. They can be set at the user level or at the backend user group level (then affecting all @@ -26,9 +25,8 @@ frontend and not the backend). .. _concepts_page_tsconfig: -===== Page TSconfig -===== +============= Page TSconfig is a set of configuration values that affect pages. It is set at the page level and affects that page and all the pages below it in the tree. The From 0ac581b5117666e79dfae510f0f42c6cc1ad4c18 Mon Sep 17 00:00:00 2001 From: Lina Wolf <48202465+linawolf@users.noreply.github.com> Date: Thu, 28 Nov 2024 13:51:12 +0100 Subject: [PATCH 3/3] Make corrections --- Documentation/Concepts/TSconfig/Index.rst | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) diff --git a/Documentation/Concepts/TSconfig/Index.rst b/Documentation/Concepts/TSconfig/Index.rst index 78e6ba8d..24a19e6e 100644 --- a/Documentation/Concepts/TSconfig/Index.rst +++ b/Documentation/Concepts/TSconfig/Index.rst @@ -14,13 +14,14 @@ There are two types of TSconfig: user TSconfig and page TSconfig. User TSconfig ============= -User TSconfig is a set of configuration values that affect backend users. They can -be set at the user level or at the backend user group level (then affecting all +User TSconfig is a set of configuration values that affect backend users. Best +practice is to set them globally (in a site package TSconfig file) but they can +also be set at the backend user or group level (then affecting all users in that group). Things that can be configured are generally related to permissions for basic functionality, for example, whether a user can clear the cache. -There are also configuration values for the admin panel (which is shown in the -frontend and not the backend). +There are also configuration values for the :ref:`TYPO3 Admin Panel ` +(which is shown in the frontend and not the backend). .. _concepts_page_tsconfig: @@ -28,12 +29,13 @@ frontend and not the backend). Page TSconfig ============= -Page TSconfig is a set of configuration values that affect pages. It is set at -the page level and affects that page and all the pages below it in the tree. The -things that can be configured mainly affect the look and feel of the backend, +Page TSconfig is a set of configuration values that affect pages. It is often +set globally at the site level (in a site package TSconfig file) but can also be +set at the page level and then affects that page and all the pages below it in +the tree. The things that can be configured mainly affect the look and feel of the backend, such as which fields are available when editing a content element. In general, -page TSconfig dictates what a user sees when they click on modules in the -left-hand module bar, e.g. Page, View, List. +page TSconfig dictates what a user sees when they click on modules under `Web` in the +left-hand module bar that open a pagetree, e.g. Page, View, List. .. _tsconfig-more-information: