TYPO3 v15 dev-main snapshot ()

2026-08-10 22:31:09 +02:00
commit af8cc155b5
6818 changed files with 642608 additions and 0 deletions
@@ -0,0 +1,48 @@
+
+.. include:: /Includes.rst.txt
+
+.. _feature-57632:
+
+=====================================================================
+Feature: #57632 - Include inline language label files with TypoScript
+=====================================================================
+
+See :issue:`57632`
+
+Description
+===========
+
+It is now possible to add inline language label files with TypoScript.
+
+Usage
+-----
+If you want to include inline labels from a XLF file, you have to specify that
+file in your TypoScript with a custom key in the new `inlineLanguageLabelFiles`
+section. In addition to the file you can configure three optional parameters:
+
+* `selectionPrefix`: Only label keys that start with this prefix will be included (default: '')
+* `stripFromSelectionName`: A string that will be removed from any included label key (default: '')
+* `errorMode`: Error mode if the file could not be found: 0 - syslog entry, 1 - do nothing, 2 - throw an exception (default: 0)
+
+Example
+-------
+
+.. code-block:: typoscript
+
+	page = PAGE
+	page.inlineLanguageLabelFiles {
+		someLabels = EXT:myExt/Resources/Private/Language/locallang.xlf
+		someLabels.selectionPrefix = idPrefix
+		someLabels.stripFromSelectionName = strip_me
+		someLabels.errorMode = 2
+	}
+
+Output in the HTML head:
+
+.. code-block:: javascript
+
+	var TYPO3 = TYPO3 || {};
+	TYPO3.lang = {"firstLabel":[{"source":"first Label","target":"erstes Label"}],"secondLabel":[{"source":"second Label","target":"zweites Label"}]};
+
+
+.. index:: TypoScript, JavaScript, Frontend