Upgrading from 2.3 to 2.4 

Page TSconfig of the content element 

The content element is hidden for the whole installation, as it was in 2.3, and the page TSconfig of its component brings it back. The file version 2.3 registered for the page field Include static Page TSconfig (from extensions) is gone, and the value a page record stored for it is not rewritten. It simply stops resolving, without a message, and the content element is no longer offered on that page tree.

On TYPO3 12, and on TYPO3 13 for a site that does not depend on the site set of this extension, edit the page record of every site root that selected Academic StudyPlan (Default) (academic_study_plan), tab Resources, field Include static Page TSconfig (from extensions). Remove the old entry and select Academic Study Plan: All components (academic_study_plan) instead. This query lists the page records that still store the old value:

SELECT uid, pid, title FROM pages
WHERE tsconfig_includes LIKE '%academic_study_plan/Configuration/TsConfig/Default.tsconfig%';

See Important: The page TSconfig directory is now spelled TSconfig as well.

An existing study plan opened on a page where the content element is not enabled keeps its type. The field Type shows it followed by (not enabled on this page), and saving the record keeps it, as long as academic_base 2.4 is installed. The warning of the Breaking entry linked above, that saving such a record writes another type, no longer applies. A study plan whose type was rewritten that way before the update is not repaired. Its record history shows the change, and the type is corrected by hand there.

Static template 

A sys_template record that selected Academic StudyPlan (Default) in its field Include TypoScript sets on the tab Advanced Options keeps delivering the content element. The entry is listed as Academic Study Plan: Path up to 2.3 (deprecated, use All components) (academic_study_plan) now and is removed in version 4.0. Replace it with Academic Study Plan: All components (academic_study_plan). On TYPO3 12 the static template is the only way to deliver the TypoScript of the content element.

Site sets 

On TYPO3 13, a site that depends on fgtclb/academic-study-plan-default needs no change. The set is an alias of the new aggregate fgtclb/academic-study-plan now, which can be named instead.

A site uses the site set or the static template, not both. With both, the static template sets the three new template path constants back to their defaults after the site settings, see Do not combine both.

Imports in a site package 

An @import of a file that moved loads nothing and reports no error. Replace the old paths:

The file Configuration/TypoScript/Default/setup.typoscript still exists. It is deprecated, keeps delivering the content element and is removed in version 4.0. Replace an import of it with EXT:academic_study_plan/Configuration/TypoScript/ContentElement/setup.typoscript, see Deprecation: The static template path of version 2.3.

The setup reads constants now. Import EXT:academic_study_plan/Configuration/TypoScript/ContentElement/constants.typoscript into the constants of the same template, or the content element cannot find its template. That also applies to a site package that keeps importing the deprecated Configuration/TypoScript/Default/setup.typoscript: it imports the constants.typoscript of that folder as well.

Template paths 

The Fluid root paths of the content element are constants now: plugin.tx_academicstudyplan.view.templateRootPath , partialRootPath and layoutRootPath . An override of tt_content.academic_study_plan.templateRootPaths keeps working. Setting the constants is the shorter way.

Label overrides 

Label overrides are read from plugin.tx_academicstudyplan now, no longer from plugin.tx_academic_study_plan . Move them:

# Before
plugin.tx_academic_study_plan._LOCAL_LANG.default.credits = ECTS

# After
plugin.tx_academicstudyplan._LOCAL_LANG.default.credits = ECTS

See Important: Label overrides are read from the documented path and the list of labels in Labels.

Asset paths 

The stylesheet and the script of the content element moved into a frontend/ folder. The extension loads them from there itself. Only own TypoScript, a site package or a template override that names one of the files has to add the folder:

See Breaking: The frontend assets are built and moved.

The template 

One template file changed in 2.4, Resources/Private/Frontend/Default/Templates/AcademicStudyPlan.html. No partial or layout of the extension changed, and none was removed. A copy of the template in a site package keeps rendering, but misses these changes. Compare it with the 2.4 file and take them over. The paths below are relative to Resources/Private/:

Site stylesheets 

• The header of the content element sits above the .academic-study-plan wrapper now, inside the frame of the layout. A selector such as .academic-study-plan header becomes .frame-type-academic_study_plan header .
• The icon markup carries the classes .icon-academic-study-plan-plus and .icon-academic-study-plan-minus instead of .icon-plus and .icon-minus . A site package that registered icons named plus, minus or close-button for this element can drop them.
• A category title is rendered as text. A site that put markup into a category title to style its filter button styles .filter button instead, see Important: A study plan category title is text, not markup.