sitegeist/csv-labels

Use CSV files to provide translation labels to TYPO3

1.0.4 2024-07-15 14:00 UTC

Requires

• typo3/cms-core: ^13.1 || ^12.2 || ^11.5 || ^10.4 || ^9.5

Requires (Dev)

• editorconfig-checker/editorconfig-checker: ^10.0
• squizlabs/php_codesniffer: ^3.0

GPL-2.0-or-later

• Ulrich Mathes
• Simon Praetorius

README

This utility extension extends the language handling of TYPO3 to be able to use a simple CSV file format to specify language labels. While the XLIFF file format is a widely used standard and is more powerful, CSV files can be a pragmatic approach for language files that only contain a handful of entries.

This extension does not remove or disable XLIFF files, it merely provides another file format to choose from. We at sitegeist use the CSV file format to define language labels for Fluid Components.

Getting started

Install the extension either from TER or via composer:

composer require sitegeist/csv-labels

File format

locallang.csv:

"id","description","default","de"
"Actions","","Actions","Aktionen"
"ConfirmDelete","Message in the delete user dialog","Should the following user be deleted?","Soll der folgende Nutzer gelöscht werden?"

Rules:

• The column id represents the label identifier
• The column description represents the label description (for documentation purposes)
• All other columns are treated as a translation for the locale from the header line
• The csv files use , as delimiter and " as text delimiters (default configuration of fgetcsv)

Usage

<!-- either explicitly -->
<f:translate key="EXT:my_extension/Resources/Private/Language/locallang.csv:Actions" />
<!-- or as a fallback, in case the xlf file doesn't exist -->
<f:translate key="EXT:my_extension/Resources/Private/Language/locallang.xlf:Actions" />
<!-- this means that it can also be used in extbase context without the full path -->
<f:translate key="Actions" />

Authors & Sponsors

• Ulrich Mathes - [e-mail]
• Simon Praetorius - [e-mail]
• All contributors

The development and the public-releases of this package is generously sponsored by my employer https://sitegeist.de.