Skip to content

Commit a7a2566

Browse files
froemkenlinawolffe-hicking
authored
Add section about Template naming and locations to PAGEVIEW (#1546)
* Update Index.rst I just try to get PAGEVIEW running and get errors like: Tried resolving a template file for controller action "Default->Pages/Default" in format ".html", but none of the paths contained the expected template file (Default/Pages/Default.html). That's why I would prefer to provide a running example in first section, before we start explaining the containing variables for Fluid templating. * Apply suggestions from code review Co-authored-by: Garvin Hicking <38074677+fe-hicking@users.noreply.github.com> * Improve content * Update Documentation/ContentObjects/Pageview/Index.rst * Update Documentation/ContentObjects/Pageview/Index.rst --------- Co-authored-by: Lina Wolf <48202465+linawolf@users.noreply.github.com> Co-authored-by: Garvin Hicking <38074677+fe-hicking@users.noreply.github.com>
1 parent a8798d2 commit a7a2566

File tree

1 file changed

+36
-0
lines changed
  • Documentation/ContentObjects/Pageview

1 file changed

+36
-0
lines changed

Documentation/ContentObjects/Pageview/Index.rst

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,42 @@ Example: Display a page with Fluid templates
4040
:language: typoscript
4141
:caption: EXT:my_sitepackage/Configuration/TypoScript/setup.typoscript
4242

43+
.. _cobj-pageview-template-naming:
44+
45+
Template naming and locations
46+
=============================
47+
48+
To ensure proper rendering, the following requirements and
49+
fallback mechanisms apply:
50+
51+
.. _cobj-pageview-template-naming-path:
52+
53+
Target path structure
54+
---------------------
55+
56+
* The target directory **must contain a folder named :directory:`Pages/`**.
57+
* This folder must contain Fluid templates in :file`*.html` format.
58+
59+
.. _cobj-pageview-template-naming-conventions:
60+
61+
Template naming convention
62+
--------------------------
63+
64+
* The Fluid template file **must** match the name of the selected backend layout
65+
of your current page.
66+
* The first letter of the Fluid template file must be **uppercase**.
67+
68+
.. _cobj-pageview-template-naming-fallback:
69+
70+
Fallback behavior when no backend layout is defined
71+
----------------------------------------------------
72+
73+
* If the page record does not specify a backend layout, TYPO3 tries to detect
74+
next-level backend layouts by traversing up the page rootline.
75+
* If still no backend layout could be found, TYPO3 falls back to `Default.html`.
76+
* If you explicitly set the backend layout to `none`, a Fluid template
77+
with name :file:`None.html` will be used.
78+
4379
.. _cobj-pageview-data:
4480

4581
Default variables in Fluid templates

0 commit comments

Comments
 (0)