From 725ad65894c8473307f12912328acd9fcb423da6 Mon Sep 17 00:00:00 2001 From: Lina Wolf <48202465+linawolf@users.noreply.github.com> Date: Sun, 23 Jun 2024 08:41:53 +0200 Subject: [PATCH] [DOCS] Improve Backend layout documentation (#532) * [DOCS] Improve Backend layout documentation In preparation for documenting https://github.com/TYPO3-Documentation/Changelog-To-Doc/issues/922 Releases: main, 12.4 * Update Documentation/PageTsconfig/Mod/WebLayout/BackendLayout.rst --- .../BackendLayouts/PageModule.png | Bin 0 -> 15403 bytes .../BackendLayouts/PageProperties.png | Bin 0 -> 3771 bytes Documentation/PageTsconfig/Mod/WebLayout.rst | 16 ++- .../Mod/WebLayout/BackendLayout.rst | 99 ++++++++++++++++++ .../_backendLayouts-example.tsconfig | 1 + 5 files changed, 113 insertions(+), 3 deletions(-) create mode 100644 Documentation/Images/ManualScreenshots/BackendLayouts/PageModule.png create mode 100644 Documentation/Images/ManualScreenshots/BackendLayouts/PageProperties.png create mode 100644 Documentation/PageTsconfig/Mod/WebLayout/BackendLayout.rst rename Documentation/PageTsconfig/Mod/{ => WebLayout}/_backendLayouts-example.tsconfig (95%) diff --git a/Documentation/Images/ManualScreenshots/BackendLayouts/PageModule.png b/Documentation/Images/ManualScreenshots/BackendLayouts/PageModule.png new file mode 100644 index 0000000000000000000000000000000000000000..b0341d07e733901743242cb635654fc93ba827d1 GIT binary patch literal 15403 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 J=;j|!{~PNiA$R}) literal 0 HcmV?d00001 diff --git a/Documentation/Images/ManualScreenshots/BackendLayouts/PageProperties.png b/Documentation/Images/ManualScreenshots/BackendLayouts/PageProperties.png new file mode 100644 index 0000000000000000000000000000000000000000..99aa03d5c6d44234e12a5d65a0b892311439b67a GIT binary patch literal 3771 zcmb_fX;c$PwgwTfgMe*IKtLjPH)ywl2*^&r4Ru&l5K$tlEXo=}!jcV9N!u)uK?MbZ z+6^d65@ZnwB!dVM!304F5<iNPuh;Xa2k&@0~MmW`0zCwSC{cRj2CSQ#Vif z`{)Bq0U8<_`X`PbIisPmL8xv+HtDEqNBH{(YSv zc>b+u8tp!rqaNIvel#RKFeNrUBQh;U!zV2!CK(o=k{)(;lbT`xK5@i5C^Kwf$|HHU zADB1uZdCaEswBb$@n_8L(St3TeT)V>^Mvn$-+L9?<>({#N8dmCRLO8T8l2Hwy=zU! zP?TP>7bxHh{l(#wm3gjWb8C-CFA+X{PuuOb zSaOYfPX7Ly)QcEO=W_ZwF!y*yLWEryj4>&zzK985G@E(WcCsf~aT1)kd|iHX@7}Kw zU151g+-=)PM86F`hpD!#*8v_5^QW?UEWjqaur%ked9lnhPx{8EG_0qN^R4OgE#l$X!m|5Gss-$r*T@t~ooHy*VkYyi<)3D`_q z7jQuj>ir;k0|eAT#1BrTw%r!2HN8y*-{Gv^1Jd0u^Q_Fj+*qtIJN)jL4HD=AeCHfe zr8)1cXAj#-U*pt+BofsyQRqj7Y~ zD)c0&ccoFLPuZSbM77eZNoBOR3x`L_Pv-p&xVOh-q|hO8qfyZKu~+-R(Yso}EAPOE zCw^06Mip~wMv6dQttfI)ymJF==lbn#KD$tC@;pe=S_cYCq&bv!%)x^Q2`+6=j~M^5 z{E@Pko{w7tKVQSrt_X7+=et`gvIb?vkN^hhQXf8>LaIwZ`$`CA^*&}#Nu$CXvbVM11`1f=dJ8ouDP+#sjD^hXLR8<_HVPtjLed* z3|?{L?(W3)#WesB3D*SB#!k|vt0uq9H5H`G(rh@$8N$s)6eljL+aeUrd}|7ONa(>A zV?AEqQF@h45-JbBH+=~gWKJGyse~A!kBh#4yupU3S>;y;UNRlagT9_JspFTRe*H%BCXS2QZ)ARU=1vE*eo0*2>B78lYr5reP{eN$ReHBqeO(g%(CsVSuJscd!@Wx@ z72#0lKoZx5bgl?j5B=1c9#V6(w$_$BjFn4MF~UB{1y zB$4rP_p8crxW(*xure!_zolI#tvl0q1^Sl`!k~!sF>oj&4f6@#6&vfJr(nmx^=F}oc$|fES>5~T(<`!w$p4%pf6S$<@yvz z+1!mfV|)S&FnvD(nGE$OjX}Q`er|;t4orT!y7}xF^#}Uvf#+UHL0pjP0)Fj-J#dvj z9C@kGyKkcY)X6>!d&Zhw%ACiSju$6mT^xJ@GJ>(ld{~pam1~GtFp>~B*P%)Di}TG= z-I4rJYka`=oZQR*a&ggR$%D(!kAy?^F+ z+z2vg%rrzNxzntchXlxK?GV>+4lI+YDvYHrMw#{JZ7yg3z`w-1cl_X)aot~s%&{Or zCc@BZ+{o<0^)utR6E3S!vOcjftC(}l)kfkH)m;qc)BX{B zfHPg{gF=)=$2B~>>2VIhtt`hh;3Oq$PuVZ&gYMSn@ry36(0%ZV(_|jRvi)hFN`eB% zYR&t7`XD{C;9l;a^4@Z2sgk9WGivV2I(s^MkLn&d7%6**+1VacMi~WsL4c#B_*_L} zgGFL#2c<~AUXY?yU!)n&dIM8@;6KAOA8tzS=!(D#eso>1k6Qtmrf&Ur zQ|tc!F0m3q#wz6K7 zB919}Tqh@K7Yknq(Vfgl>k(m0RRR*N6RTXSl}Wi+=+0yY=YPl;cNir0p4XrF=3phXnzThFxx$G zx=_9L=0Df!01!bxPFzK+?dL;u+pgyB7~6!1sCv1=+r_$?^dQ2=QBAe}zo>Jq$S%bM z$CGMGFZw2Wxx7O;#lgxaIN(q^<131bmS=K3Lg|PCwf2l30AXAQ(j%TX0dw0pd<@-%YE8Gu5dFf}r-klr-UxyS| z87WD4PEtHFn}E!qJ=vEbO7&lIrL9g|X-o4%a7WH43mPXK0P6o%8CXcenn6k?# za$~uA;?#SaZ-7X%K8iz4)0_vI_vqn#{iXw&QG36F=(dnN-XrwA;`tT(wRxEQjcOe3 zY9$+q>hULPrA~K5fbyeN+43KNpy7GDML)*2q07UycWGny622_wdQ2x|?_d}+-8epk zs%afq6zNn`6=wa!j(TshmMlGtIM_9s4&-+n1P(PFXMnXX zDT|~f;U89qQ0OjvpW=4w;zURp9krkjKJ^oLi-TO>t;66wNA*+erV-0wPLpS+rsNi9!b`O*zQU{Ug6n9%T1%z-J^rhh6wg#>IqnlfZ# zpMR85%}uif3NHhVmz>%t5Hh_%dSp2dM}0p`yl6kw zELnO`YUz0$mDwHJGySY}35PS3Iv(Qu<97bax=6TLaA$iQcBc5!`&+O(+LR&o%;cfu z06xP=D1JAsex}YfIsnNY-_ctZhc4>yGaFU0-ffZFwVaE!5l=j}%d_01_{-c`G2{#x zuaZayl+llmZ4v&>v$9lhpt)h{WE$cXcW-G*O0#c;?L;k0IVqF5V@IRW<ZSB?W+m?=Mzcfx9^*=&96p{OPZ@qA# literal 0 HcmV?d00001 diff --git a/Documentation/PageTsconfig/Mod/WebLayout.rst b/Documentation/PageTsconfig/Mod/WebLayout.rst index c357f064..a1c0bb45 100644 --- a/Documentation/PageTsconfig/Mod/WebLayout.rst +++ b/Documentation/PageTsconfig/Mod/WebLayout.rst @@ -55,17 +55,22 @@ BackendLayouts ============== .. confval:: BackendLayouts - :name: mod-web-layout-BackendLayouts :type: array + :no-index: - Allows to define backend layouts via Page TSconfig directly, without using database records. + Backend Layouts were initially introduced in order to customize the view of + the :guilabel:`Page` module in TYPO3 Backend for a page, but has then since grown also in + Frontend rendering to select for example Fluid template files via TypoScript for a page, + commonly used via :confval:`data:pagelayout `. + + See also the dedicated chapter :ref:`backend-layouts`. .. _mod-web-layout-backendLayouts-example: Example: Define a backend layout -------------------------------- -.. literalinclude:: _backendLayouts-example.tsconfig +.. literalinclude:: WebLayout/_backendLayouts-example.tsconfig :language: typoscript :caption: EXT:site_package/Configuration/page.tsconfig @@ -316,3 +321,8 @@ Example: Define previews for custom content elements preview.table = EXT:site_mysite/Resources/Private/Templates/Preview/Table.html preview.list.tx_news = EXT:site_mysite/Resources/Private/Templates/Preview/TxNews.html } + +.. toctree:: + :glob: + + WebLayout/* diff --git a/Documentation/PageTsconfig/Mod/WebLayout/BackendLayout.rst b/Documentation/PageTsconfig/Mod/WebLayout/BackendLayout.rst new file mode 100644 index 00000000..63978ee7 --- /dev/null +++ b/Documentation/PageTsconfig/Mod/WebLayout/BackendLayout.rst @@ -0,0 +1,99 @@ +.. include:: /Includes.rst.txt + +.. _backend-layouts: + +=============== +Backend layouts +=============== + +Backend layouts were initially introduced in order to customize the view of +the :guilabel:`Page` module in TYPO3 Backend for a page, but has then since grown also in +Frontend rendering to select for example Fluid template files via TypoScript for a page, +commonly used via :confval:`data:pagelayout `. + +.. figure:: /Images/ManualScreenshots/BackendLayouts/PageModule.png + + A page module with a backend layout that has 3 content areas. + +Backend layouts are organized in rows and columns. Content areas can span +multiple rows and or columns. They cannot be nested. For nested layouts in the +backend use an extension like :composer:`b13/container`. + +The page TSconfig for the backend layout above can be found in the site package +tutorial: :ref:`Create the backend page layouts `. + +For extended examples have a look at the predefined `backend layouts of the bootstrap +package (GitHub) `__. + +.. confval-menu:: + +.. confval:: BackendLayouts.[backendLayout] + :name: mod-web-layout-BackendLayouts + :type: array + :Path: mod.web_layout.BackendLayouts + + .. confval:: title + :name: mod-web-layout-BackendLayouts-backendLayout-title + :type: string or language identifier + + The title of the backend layout. It will be displayed in the page + properties in the backend. + + .. figure:: /Images/ManualScreenshots/BackendLayouts/PageProperties.png + :caption: Choose the backend layout in the page properties + + .. confval:: icon + :name: mod-web-layout-BackendLayouts-backendLayout-icon + :type: string, extension path to an image file + + The icon to be displayed in the page properties. + + .. code-block:: tsconfig + :caption: EXT:bootstrap_package/Configuration/TsConfig/Page/Mod/WebLayout/BackendLayouts/subnavigation_right_2_columns.tsconfig + + mod.web_layout.BackendLayouts.subnavigation_right_2_columns { + icon = EXT:bootstrap_package/Resources/Public/Icons/BackendLayouts/subnavigation_right_2_columns.svg + } + + .. confval:: config.backend_layout + + .. confval:: colCount + :name: mod-web-layout-BackendLayouts-backendLayout-title-config-backend_layout.colCount + :type: integer + + Total number of columns in the backend layout. + + .. confval:: rowCount + :name: mod-web-layout-BackendLayouts-backendLayout-title-config-backend_layout.rowCount + :type: integer + + Total number of rows in the backend layout. + + .. confval:: rows.[row].columns.[col] + + .. confval:: name + :name: mod-web-layout-BackendLayouts-backendLayout-title-config-backend_layout-rows-row-columns-col-name + :type: string or language identifier + + Name of the input area where content elements can be added. Will be + displayed in the :guilabel:`Page` module. + + .. confval:: colPos + :name: mod-web-layout-BackendLayouts-backendLayout-title-config-backend_layout-rows-row-columns-col-colPos + :type: integer, 0 - maxInt + + When content elements are added to this area, the value of `colPos` + + .. confval:: colspan + :name: mod-web-layout-BackendLayouts-backendLayout-title-config-backend_layout-rows-row-columns-col-colspan + :type: integer, 1 - :confval:`mod-web-layout-BackendLayouts-backendLayout-title-config-backend_layout.colCount` + + Can be used if the content element area should span multiple + columns as for the "Jumbotron" example in the example above. + + .. confval:: rowspan + :name: mod-web-layout-BackendLayouts-backendLayout-title-config-backend_layout-rows-row-columns-col-rowspan + :type: integer, 1 - :confval:`mod-web-layout-BackendLayouts-backendLayout-title-config-backend_layout.rowCount` + + Can be used if the content element area should span multiple + rows. diff --git a/Documentation/PageTsconfig/Mod/_backendLayouts-example.tsconfig b/Documentation/PageTsconfig/Mod/WebLayout/_backendLayouts-example.tsconfig similarity index 95% rename from Documentation/PageTsconfig/Mod/_backendLayouts-example.tsconfig rename to Documentation/PageTsconfig/Mod/WebLayout/_backendLayouts-example.tsconfig index 46ed1d57..547f5f8c 100644 --- a/Documentation/PageTsconfig/Mod/_backendLayouts-example.tsconfig +++ b/Documentation/PageTsconfig/Mod/WebLayout/_backendLayouts-example.tsconfig @@ -22,6 +22,7 @@ mod.web_layout.BackendLayouts { name = Main colPos = 0 colspan = 1 + identifier = main } } }