Labels

The labels this extension shows in the frontend come from EXT:academic_programs/Resources/Private/Language/locallang.xlf and its translations; the table below names the ones that come from another file. A site changes a label without copying a template, in TypoScript: under plugin.tx_academicprograms._LOCAL_LANG for every content element of the extension, or under plugin.tx_academicprograms_<plugin>._LOCAL_LANG for one of them. A label set for the plugin wins over one set for the extension.

EXT:my_sitepackage/Configuration/TypoScript/setup.typoscript

plugin.tx_academicprograms._LOCAL_LANG {
  default.page.backToList = All study programs
  de.page.backToList = Alle Studiengänge
}

# Only in one content element:
plugin.tx_academicprograms_programlist._LOCAL_LANG.default.page.backToList = All study programs

The dots of a key need no escaping: TypoScript reads them as levels of its tree, and TYPO3 joins the levels to the key again. A label of another language goes under its language key, de for German.

Content element	Path
Course List (`academicprograms_programlist`)	`plugin.tx_academicprograms_programlist._LOCAL_LANG`
Course Data (`academicprograms_programdetails`)	`plugin.tx_academicprograms_programdetails._LOCAL_LANG`
Course Finder (`academicprograms_programfinder`)	`plugin.tx_academicprograms_programfinder._LOCAL_LANG`

The page template of a program page is not rendered by a plugin: a site sets its labels, the facts it shows among them, under the path of the extension.

A language file override works as well, and replaces the label of the file itself: $GLOBALS['TYPO3_CONF_VARS']['SYS']['locallangXMLOverride'] on TYPO3 v13, $GLOBALS['TYPO3_CONF_VARS']['LANG']['resourceOverrides'] on TYPO3 v14.

Earlier versions of this extension read these overrides on TYPO3 v13 from plugin.tx_academic_programs instead, see the changelog.

Category types of a project

A category type is named by the label sys_category.programs.<type>. The language file of this extension has one for each type it ships. A type a project registers for the group programs has none, and is named by the title it is registered with in Configuration/CategoryTypes.yaml instead, translated into the language of the page when the title is an LLL: reference. A label set under plugin.tx_academicprograms._LOCAL_LANG, or under the path of one content element, wins over the title:

EXT:my_sitepackage/Configuration/TypoScript/setup.typoscript

plugin.tx_academicprograms._LOCAL_LANG {
  default.sys_category.programs.teaching_form = Mode of study
  de.sys_category.programs.teaching_form = Studienform
}

A template override hands the label to the title view helper, see the changelog.

Where the labels are shown

Placeholders in angle brackets stand for a part of the key that the template or the code fills in, a category type or a field name for example.

Key	Shown by
`filter.activeFilters.label`, `filter.activeFilters.remove`, `filter.reset`	`Partials/Program/ActiveFilters.html`
`filter.moreFilters`	`Partials/Program/DemandCategories.html`
`finder.submit`	`Templates/Program/Finder.html`
`list.noProgramsFound`	`Partials/Program/ItemList.html`
`list.resultCount.singular`, `list.resultCount.plural`	`Partials/Program/ResultCount.html`, and the announcement after an update in place, `Templates/Program/List.html`
`list.submit`	`Partials/Program/SortingAndFilters.html`, the submit button for a visitor without JavaScript
`page.applicationLink.defaultLabel`	`Partials/Program/Page/CallToAction.html`
`page.backToList`	`Partials/Program/Page/Header.html`
`sorting.direction.label`	`Partials/Program/DemandSorting.html`
`sorting.field.label`	`Partials/Program/DemandSorting.html`
`sys_category.programs.<type>`	`Partials/Program/DemandCategories.html`, `Templates/Program/Finder.html`
`sys_category.programs.allOptions`	`Partials/Program/DemandCategories.html`, `Templates/Program/Finder.html`
`sys_category.programs.allOptions.<type>`	`Partials/Program/DemandCategories.html`, `Templates/Program/Finder.html`
`sorting.field.<field>`, `sorting.direction.<direction>`	The options of the sorting select, translated by its view helper
`sys_category.programs.<type>`, `program.<field>`	The labels of the program facts, `Partials/Program/Facts/Item.html`; the key is built from the configured fact