typo3-documentation / typo3cms-reference-tsconfig Goto Github PK
View Code? Open in Web Editor NEWPage TSconfig and User TSconfig reference.
Home Page: https://docs.typo3.org/m/typo3/reference-tsconfig/master/en-us/
Page TSconfig and User TSconfig reference.
Home Page: https://docs.typo3.org/m/typo3/reference-tsconfig/master/en-us/
TYPO3CMS-Reference-TSconfig/Documentation/UsingSetting/PageTSconfig.rst
I think this example is outdated:
RTE.default.showButtons = bold
Copy to clipboard
Static page TSconfig included on the parent page
RTE.default.showButtons := addToList(italic)
Copy to clipboard
Finally you get the value “bold,italic”.
It is possible to override the "treeConfig" section of TCA type=select, renderType=selectTree via pagets.
This was probably possible since "ever". The patch that re-implemented that feature in v7: https://review.typo3.org/#/c/47083/
This should be documented in the TCEFORM section.
Crossposting from a report over here:
FriendsOfTYPO3/rtehtmlarea#54 (comment)
Just to be sure we do not forget it
There is a property additionalSearchFields
in TCEFORM.suggest.$tablename
that allows one to specify additional database table fields to search in when typing something in the suggest wizard. This is not documented.
Since the introduction of the site configuration these options can only be used in very rare cases. They all bear a warning:
.. warning::
Note that this option has largely been superseded by site configuration since TYPO3 10 and will only
work in the Backend for a "NullSite". For instance a global sysfolder in the page tree without an
attached site configuration. Once a page tree has a site configuration, the default language icon is
set from the site configuration's language settings and this option will have no effect at all.
So maybe we could remove them. These are rare edge cases
https://docs.typo3.org/m/typo3/reference-tsconfig/master/en-us/PageTsconfig/TceMain.html
The problem is you have to add these TSconfig on every page with records manually.
For some of the removed options, there is nothing to be found in the changelog. So it should be checked for each option, which TYPO3 version they were last present and if they should be removed or just get a notice, that they are no longer present in the current version.
https://docs.typo3.org/m/typo3/reference-tsconfig/master/en-us/UsingSetting/Index.html
https://docs.typo3.org/m/typo3/reference-tsconfig/master/en-us/PageTsconfig/Mod.html
https://docs.typo3.org/m/typo3/reference-tsconfig/master/en-us/PageTsconfig/Rte.html
https://docs.typo3.org/m/typo3/reference-tsconfig/master/en-us/UserTsconfig/AdmPanel.html
https://docs.typo3.org/m/typo3/reference-tsconfig/master/en-us/UserTsconfig/Options.html
https://docs.typo3.org/m/typo3/reference-tsconfig/master/en-us/UserTsconfig/Setup.html
Hello Doc Team,
I miss the markers for foreign_table_where. Last time I have seen them was in TYPO3 7.6 docu:
https://docs.typo3.org/m/typo3/reference-tsconfig/7.6/en-us/PageTsconfig/TCEform/Index.html
Would be cool to have them back in all Docs > 7.6, too.
Stefan
Reading BackendUserAuthentication::class, there seems to be an undocumented (? or maybe documented elsewhere, maybe in fal section of core api?) property permissions.file.default and permissions.file.storage.*
This should be checked and end up in user TSconfig
https://docs.typo3.org/m/typo3/reference-tsconfig/master/en-us/PageTsconfig/Mod.html#shared
Maybe add a short description.
https://docs.typo3.org/m/typo3/reference-tsconfig/master/en-us/PageTsconfig/Mod.html
There are only very simple examples on this page which use mod.web_info
etc. If you created your own be modules in an extension, it is not so intuitive, what is to be used here.
How is this key constructed, e.g.
MAINMODULEKEY UNDERLINE SUBMODULEKEY
), e.g. 'web_info', 'web_layout', 'site_configuration', 'system.config'\TYPO3\CMS\Extbase\Utility\ExtensionUtility::registerModule(
'TYPO3.CMS.Form',
'web',
'formbuilder',
So in this example, the lowercase 'formbuilder' is converted to CamelCase 'Formbuilder' and the extension key is also converted to CamelCase and directly prepended before the submodule key.
It's weird that in the examples 1️⃣ after the underline, it is all-lowercase, while in 2️⃣, it is CamelCase, this makes it not so intuitive.
I would assume, that the modules for the first case are created with addModule()
, while the ones for the second are created with registerModule()
(Extbase)
Possibly link to "Naming conventions" and add the information there.
The solution suggested here doesn't work for me:
use TYPO3\CMS\Core\Utility\ExtensionManagementUtility;
$versionInformation = GeneralUtility::makeInstance(Typo3Version::class);
// Only include page.tsconfig if TYPO3 version is below 12 so that it is not imported twice.
if ($versionInformation->getMajorVersion() < 12) {
ExtensionManagementUtility::addPageTSConfig('
"@import 'EXT:myexample/Configuration/page.tsconfig'"
');
}
Before addPageTSConfig
is called I get an exception caused by line 3 (version information assignment)
Stack trace:
#0 /home/default/mysite/var/cache/code/di/DependencyInjectionContainer_f20ac9260e6dd54040f800c5ba672a4cc1c3df5f.php(5797): TYPO3\\CMS\\Core\\ServiceProvider::getCacheManager()
#1 /home/default/mysite/vendor/symfony/dependency-injection/Container.php(239): DependencyInjectionContainer_f20ac9260e6dd54040f800c5ba672a4cc1c3df5f->getCacheManagerService()
#2 /home/default/mysite/vendor/symfony/dependency-injection/Container.php(219): Symfony\\Component\\DependencyInjection\\Container->make()
#3 /home/default/mysite/public/typo3/sysext/core/Classes/ServiceProvider.php(352): Symfony\\Component\\DependencyInjection\\Container->get()
#4 /home/default/mysite/var/cache/code/di/DependencyInjectionContainer_f20ac9260e6dd54040f800c5ba672a4cc1c
...', referer: http://mysite.wsl.local:1234/typo3/login?redirect=record_edit&redirectParams=edit%255Btt_content%255D%255B13%255D%3Dedit
Also there are unexpected quote characters in lines 6 and 8. Correct code:
...
ExtensionManagementUtility::addPageTSConfig(
"@import 'EXT:myexample/Configuration/page.tsconfig'"
);
...
Some images are still outdated and should be updates with current LTS version.
Feature https://review.typo3.org/#/c/22067/ was never documented in page ts config.
As raised by Brian Bendtsen ins Slack
(https://typo3.slack.com/archives/C028JEPJL/p1651041143891719)
Hi - I don't know if this is the place, but I have found an error on this page: https://docs.typo3.org/m/typo3/reference-tsconfig/main/en-us/UsingSetting/Index.html - The "Setting Page TSconfig" and "Setting User TSconfig" both link to the latter.
I would break it up in parts that deal with
to create shorter pages and make it easier to find thins
I made some tests today with this option because its functionality would be just perfect to my current project.
The problem is that this option is not generic. It works only with the "pages" table and not with any other table what the documentation suggest.
It seems that it was maybe planned as a generic solution, but it is not implemented in the current latest.
I think that the [table] should simply be "pages" as in the example; otherwise it is not correct atm.
The nesting is only clear from the header levels but this is not clearly visible on the rendered page
For example "allowedClasses" is a subproperty of "proc".
For allowTagsOutside there is an example, where this is clear.
https://docs.typo3.org/m/typo3/reference-tsconfig/main/en-us/PageTsconfig/Rte.html#allowtags
one or more of these could be applied:
levels:
https://docs.typo3.org/m/typo3/reference-tsconfig/9.5/en-us/PageTsconfig/TceForm.html#disabled
Quoting the intro:
If set, the field is rendered, but not editable by the user.
Quoting the code example:
# The title field of the pages table is not editable
However, in reality, TYPO3 returns early without rendering the field, instead of rendering it as readOnly
:
It would be nice if videos from the TYPO3 youtube channel regarding TS config were integrated with docs, e.g. with TSCOnfig introduction page.
https://www.youtube.com/watch?v=xJtsLlEtY5U
https://www.youtube.com/watch?v=HnAdDHkes5A
https://www.youtube.com/watch?v=B3IQq7pIJ_o
Can we update the page and remove these warnings?
Some explanations and descriptions may contain slightly obsolete references. The principles are still valid though.
https://docs.typo3.org/m/typo3/reference-tsconfig/master/en-us/PageTsconfig/Rte.html
This information is outdated, the default list depends on the used rte_ckeditor YAML configuraton.
https://docs.typo3.org/m/typo3/reference-tsconfig/main/en-us/PageTsconfig/Rte.html#allowtags
Check if the following examples still work or need to be changed:
There might be several examples, but I am referring to the example for altLabels, might need to check for more
In the altLabels flexform example, there is most likely an error:
TCEFORM.tt_content.pi_flexform.my_ext_pi1.sDEF.myField.altLabels
should be:
TCEFORM.tt_content.pi_flexform.myext_pi1.sDEF.myField.altLabels
where the "plugin signature" is myext_pi1
and not my_ext_pi1
.
I tested this, but in v11. Can verify for v13 as well.
my_ext_pi1 is most likely the "plugin signature" and this is all lowercase with no underscore except for the one underscore separating extension key and plugin name
See above
Should check if there are more examples.
Some TCEMAIN options such as disablePrependAtCopy are documented with an example using table, e.g.
TCEMAIN.table.pages.disablePrependAtCopy = 1
But it is also possible to configure this in general using default:
TCEMAIN.default.disablePrependAtCopy = 1
However I did not find this information anywhere on that page or any examples with default.
There is also a general section for table https://docs.typo3.org/m/typo3/reference-tsconfig/main/en-us/PageTsconfig/TceMain.html#pagetcemain-table-table-name where this is not mentioned either
see above:
I wanted to create a link to a specific option on On https://docs.typo3.org/typo3cms/TSconfigReference/UserTsconfig/Options/Index.html, createFoldersInEB
- but it does not have an ID that I could use to link to.
The following content is on the page:
This only works, if there is no hook registered for this content type, you may want to check this section in the System
Configuration module:
Search for registrations of this hook
$GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['cms/layout/class.tx_cms_layout.php']
['tt_content_drawItem']['content_element_xy'];
This references the removed hook (in v12): $GLOBALS['TYPO3_CONF_VARS']['SC_OPTIONS']['cms/layout/class.tx_cms_layout.php']['tt_content_drawItem']
Remove that part or mention the event (and System | Configuration | Event Listeners (PSR-14)
The TSConfig option "proc.allowAttributes" is missing in the list on https://docs.typo3.org/m/typo3/reference-tsconfig/main/en-us/PageTsconfig/Rte.html#htmlparser-db
The functionality is contained in typo3/sysext/core/Classes/Html/RteHtmlParser.php
of the core.
Got introduced a long time ago in https://review.typo3.org/50919
I realized that the style for defenitionlist with the class .docutils do not render like "tables" (div class t3-row) for "propertys", "Data type" and "examples".
So please add this CSS to the "theme.css"
dl.docutils{
background-color: #f2ebe3;
border: 1px none #888;
border-top: 2px solid #988d81;
clear: both;
margin-bottom: 30px;
margin-top: 30px;
position:relative;
}
dl.docutils dt{
padding: 12px 8px;
color: #b34700;
font-size: 9px;
font-weight: 400;
}
dl.docutils dd{
padding: 12px 8px;
margin:0;
}
dl.docutils dt:nth-of-type(1){
font-weight: 700;
margin-right: 8px;
min-width: 30%;
margin: 0;
position:absolute;
}
dl.docutils dd:nth-of-type(1){
font-weight:700;
position:absolute;
margin-top:20px;
}
dl.docutils dt:nth-of-type(2){
border-left: 4px solid #fff;
position:relative;
left:30%;
top:0;
}
dl.docutils dd:nth-of-type(2){
border-left: 4px solid #fff;
position:relative;
left:30%;
top:0;
max-width:70%;
}
dl.docutils dt:nth-of-type(3){
border-top: 4px solid #fff;
}
The page is extremely long and it is hard to find something.
I would suggest to break it up into single sub pages for each module, the shared and the wizards parts
Note: will be adding PR, but needs some more research.
For overriding Flexform, there is an example, for example for altLabels:
Flex form field level, example:
TCEFORM.tt_content.pi_flexform.my_ext_pi1.sDEF.myField.altLabels
For example, it could look like this:
Flex form field level, example:
# TCEFORM.<table>.pi_flexform.<plugin signature>.<sheet><field name with escaped dots>.altLabels
TCEFORM.tt_content.pi_flexform.my_ext_pi1.sDEF.settings\.myfield.altLabels
See above
The section Verifying the final configuration tells me to view the user's TSconfig in the "Tools -> User Admin" module.
In TYPO3 6.2 and 7.6 the "compare" view does not show the typoscript configuration.
Currently it's hard to get an overview on the possible options for web_layout - you can only browser-search the ->MOD
page.
There should be subpages for each module.
https://docs.typo3.org/m/typo3/reference-tsconfig/9.5/en-us/PageTsconfig/Tsfe.html
In any case, either the page should be available or a deprecation notice should be displayed in older versions. I would prefer to actually still have the page in the next version with a notice (but I think this is not current best practice).
The problem is, when searching for example for TSFE (e.g. on external search engines) you get this old v9 page as one of the first hits. There should be at least a notice there and ideally some links. Since TSFE has several context, and probably the least relevant is TSconfig it might also be helpful to link to other places in the documentation with more relevant information on TSFE, like in the disambiguation page on Wikipedia.
If you use the version selector to switch to v10 this page is displayed: https://docs.typo3.org/m/typo3/reference-tsconfig/10.4/en-us/PageTsconfig/
Here, TSFE is not listed.
Is this TSFE configuration still available in v10?
There is a changelog, that TSFE.constants was removed (in v10), but not TSFE itself. (however, TSFE seems to only contain the constants)
Feature: #91080 - Site settings as TypoScript constants and in TSconfig added the possibility to define constants in the YAML file of the site configuration. This feature should be added to the Page TSconfig section.
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.