Skip to content

[BUGFIX] Show the language fields of the TCA with an example extension - #225

Merged
linawolf merged 2 commits into
mainfrom
task/fix-facts
Nov 3, 2026
Merged

linawolf merged 2 commits into
mainfrom
task/fix-facts

Conversation

@linawolf

@linawolf linawolf commented Oct 29, 2026 •

Copy link
Copy Markdown
Member

TYPO3 adds the TCA columns and the database columns of the language
fields since v13.3, so an integrator sets only the properties in the
ctrl section and places the fields in the form. The page taught how to
define the columns, with examples that claimed to come from the TCA of
tt_content, which no longer defines them. A link to
transOrigDiffSourceField read languageField, and the section about
transOrigPointerField called it the first field.

The example now comes from the conference extension of the TCA
Reference. A copy of its conference table is in
Documentation/CodeSnippets, which the screenshot instance installs, so
that the example is tested on every run. A screenshot shows the form of
a Spanish conference with the English title below the field.

A functional test installs the extension, and checks that its TCA needs
no migration and that its labels exist. make test-extension runs it,
and CI runs it on every push. The test found that TYPO3 v15 requires
the version and providesPackages in the composer.json of an extension.

The title "TCA, DataHandler, and FormEngine" named three parts of
TYPO3 that a new reader does not know. The page is now named after its
task, and it explains the TCA and the DataHandler where it uses them.

The option of the page properties is named "Hide default language of
page", not "Hide default translation of the page". The global setting
hidePagesIfNotTranslatedByDefault belongs to the configuration of the
installation, not to the ext_localconf.php of a site package.

Releases: main, 14.3
Assisted-by: Claude Opus 5.5 noreply@anthropic.com
Signed-off-by: Lina Wolf

@linawolf linawolf changed the title [BUGFIX] Correct the facts about the TCA and hiding languages [BUGFIX] Show the language fields of the TCA with an example extension Oct 30, 2026
@linawolf
linawolf force-pushed the task/fix-facts branch 2 times, most recently from 2c64660 to 884c50d Compare October 30, 2026 13:20
TYPO3 adds the TCA columns and the database columns of the language
fields since v13.3, so an integrator sets only the properties in the
ctrl section and places the fields in the form. The page taught how to
define the columns, with examples that claimed to come from the TCA of
tt_content, which no longer defines them. A link to
transOrigDiffSourceField read languageField, and the section about
transOrigPointerField called it the first field.

The example now comes from the conference extension of the TCA
Reference. A copy of its conference table is in
Documentation/CodeSnippets, which the screenshot instance installs, so
that the example is tested on every run. A screenshot shows the form of
a Spanish conference with the English title below the field.

A functional test installs the extension, and checks that its TCA needs
no migration and that its labels exist. make test-extension runs it,
and CI runs it on every push. The test found that TYPO3 v15 requires
the version and providesPackages in the composer.json of an extension.

The title "TCA, DataHandler, and FormEngine" named three parts of
TYPO3 that a new reader does not know. The page is now named after its
task, and it explains the TCA and the DataHandler where it uses them.

The option of the page properties is named "Hide default language of
page", not "Hide default translation of the page". The global setting
hidePagesIfNotTranslatedByDefault belongs to the configuration of the
installation, not to the ext_localconf.php of a site package.

Releases: main, 14.3
Assisted-by: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Lina Wolf

@sarahmccarthy123 sarahmccarthy123 left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good :-)

@linawolf
linawolf merged commit 846bb68 into main Nov 3, 2026
4 checks passed
@linawolf
linawolf deleted the task/fix-facts branch November 3, 2026 13:22
@typo3-docs-backport-bot

Copy link
Copy Markdown

Backport failed for 14.3, because it was unable to cherry-pick the commit(s).

Please cherry-pick the changes locally and resolve any conflicts.

git fetch origin 14.3
git worktree add -d .worktree/backport-225-to-14.3 origin/14.3
cd .worktree/backport-225-to-14.3
git switch --create backport-225-to-14.3
git cherry-pick -x 846bb68efe6f778623c9b909ed5d341413340075

@typo3-docs-backport-bot typo3-docs-backport-bot Bot added the backport-failed Backport failed or needs manual intervention label Nov 3, 2026
@typo3-docs-backport-bot

Copy link
Copy Markdown

Backport failed or needs manual intervention.

Backport action outcome: success
Backport success output: false
Per target: 14.3=false
Created backport PRs: none

Workflow run: https://github.com/TYPO3-Documentation/TYPO3CMS-Guide-FrontendLocalization/actions/runs/41643812381

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport 14.3 backport-failed Backport failed or needs manual intervention

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants