Skip to content

[TASK] Revise the second half of the page about translatable tables - #234

Open
linawolf wants to merge 2 commits into
mainfrom
task/style-tca
Open

linawolf wants to merge 2 commits into
mainfrom
task/style-tca

Conversation

@linawolf

@linawolf linawolf commented Nov 1, 2026

Copy link
Copy Markdown
Member

The page said that the localize command translates only records in the
default language or in "All". It also translates a translation in
another language, and refuses only a record that has a translation in
the target language already. The diff source field is written each
time a translation is saved, not only when it is made. The page now
also names copyToLanguage, the command of the mode Copy, and the field
names of tt_content, and links with permalinks.

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

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
The page said that the localize command translates only records in the
default language or in "All". It also translates a translation in
another language, and refuses only a record that has a translation in
the target language already. The diff source field is written each
time a translation is saved, not only when it is made. The page now
also names copyToLanguage, the command of the mode Copy, and the field
names of tt_content, and links with permalinks.

Releases: main, 14.3
Assisted-by: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Lina Wolf
Base automatically changed from task/fix-facts to main November 3, 2026 13:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant