Breaking: Site sets and static templates have been restructured 

Description 

The TypoScript and the page TSconfig of this extension were shipped twice: the static template read Configuration/TypoScript/, and the site set fgtclb/academic-bite-jobs shipped its own constants.typoscript and setup.typoscript, each of them a single @import of that folder. The page TSconfig existed only as the wizard file Configuration/TSconfig/Wizards/NewContentElement.tsconfig and was not selectable on a page at all.

Both mechanisms now read one physical copy of every file, and both of them deliver the extension per component instead of as one block:

  • Configuration/TypoScript/List/ holds the TypoScript of the Job list content element and is what the static template registers and what the set points its typoscript key at.
  • Configuration/TSconfig/List/page.tsconfig holds its page TSconfig and is what the page field Page TSconfig offers and what the set points its pagets key at.
  • Configuration/TypoScript/Full/ and Configuration/TSconfig/Full/page.tsconfig are the aggregates for installations that do not use site sets.

The content element is now hidden by default. The always-included Configuration/page.tsconfig removes academicbitejobs_list from the selectable content element types, and the page TSconfig of the component adds it back — so the element is offered where it is wanted instead of on every page of every installation. The TCA registration itself did not move, so the frontend renders existing records exactly as before. Editing such a record in the backend is a different matter — read the warning below before upgrading.

Impact 

A sys_template record that selected the old static template keeps its stored value, and that value now points at a folder holding no constants.typoscript and no setup.typoscript. It is not an error — the frontend simply loses the plugin configuration, and the plugin renders with no template paths.

A site package that imported one of the shipped files by path fails to resolve it. @import of a missing file is silent, so this also shows up as missing configuration rather than as an error message.

The Job list content element is no longer offered in the backend until the page TSconfig of the component is included, through the site set or through the page field Page TSconfig.

The set fgtclb/academic-bite-jobs keeps its name and keeps delivering everything, so a site configuration that depends on it needs no change.

Affected Installations 

Installations that select the static template of this extension in a sys_template record, that import one of the shipped files from an own site package, or that use the content element without including the page TSconfig of this extension.

Migration 

Replace the static template entry in the sys_template record:

Old entry New entry
Academic Bite Jobs (academic_bite_jobs), stored as EXT:academic_bite_jobs/Configuration/TypoScript Academic Bite Jobs: All components (academic_bite_jobs), stored as EXT:academic_bite_jobs/Configuration/TypoScript/Full — or Academic Bite Jobs: Job list (academic_bite_jobs), stored as EXT:academic_bite_jobs/Configuration/TypoScript/List

Add the page TSconfig entry, which did not exist before, in the page record of the site root, tab Resources, field Page TSconfig: Academic Bite Jobs: All components (academic_bite_jobs), stored as EXT:academic_bite_jobs/Configuration/TSconfig/Full/page.tsconfig. Without it the content element is not selectable any more, and existing records of it lose their CType when they are saved from the backend form.

Sites that use the site set instead need no migration — but they must not use both mechanisms at once, see the Configuration chapter.

Adjust every @import in an own site package:

Old path New path
EXT:academic_bite_jobs/Configuration/TypoScript/constants.typoscript EXT:academic_bite_jobs/Configuration/TypoScript/List/constants.typoscript
EXT:academic_bite_jobs/Configuration/TypoScript/setup.typoscript EXT:academic_bite_jobs/Configuration/TypoScript/List/setup.typoscript
EXT:academic_bite_jobs/Configuration/TSconfig/Wizards/NewContentElement.tsconfig EXT:academic_bite_jobs/Configuration/TSconfig/List/page.tsconfig
EXT:academic_bite_jobs/Configuration/TSconfig/Wizards/*.tsconfig EXT:academic_bite_jobs/Configuration/TSconfig/Full/page.tsconfig

A site configuration may name the new component set instead of the aggregate:

Set Delivers
fgtclb/academic-bite-jobs Unchanged in name, now delivers through the component set below.
fgtclb/academic-bite-jobs-list The Job list content element only.