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/, and the site set
fgtclb/ shipped its own constants.
and setup., each of them a single
@import
of
that folder. The page TSconfig existed only as the wizard file
Configuration/ 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/holds the TypoScript of the Job list content element and is what the static template registers and what the set points itsTypo Script/ List/ typoscriptkey at.Configuration/holds its page TSconfig and is what the page field Page TSconfig offers and what the set points itsTSconfig/ List/ page. tsconfig pagetskey at.Configuration/andTypo Script/ Full/ Configuration/are the aggregates for installations that do not use site sets.TSconfig/ Full/ page. tsconfig
The content element is now hidden by default. The always-included
Configuration/ removes
academicbitejobs_
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_ record that selected the old static template keeps its
stored value, and that value now points at a folder holding no
constants. and no setup.. 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.
Warning
Do not open an existing Job list record in the backend form on a
page that does not include that page TSconfig. An item removed through
TCEFORM. is excluded from the
[ invalid value ] fallback TYPO3 otherwise adds for a stored
value it does not know, and the stored value is dropped from the form data
as well. The field Type therefore comes up with nothing
selected, and saving the record writes whatever the browser preselected
into
CType
— the record silently becomes another content element.
The frontend keeps rendering it correctly until that happens.
Include the page TSconfig of the component on every page tree that holds such records, and do it before editing them.
The set
fgtclb/ 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_ 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_ record:
| Old entry | New entry |
|---|---|
Academic Bite Jobs (academic_bite_jobs),
stored as EXT: | Academic Bite Jobs: All components (academic_bite_jobs),
stored as EXT: —
or Academic Bite Jobs: Job list (academic_bite_jobs),
stored as EXT: |
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:. 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: | EXT: |
EXT: | EXT: |
EXT: | EXT: |
EXT: | EXT: |
A site configuration may name the new component set instead of the aggregate:
| Set | Delivers |
|---|---|
fgtclb/ | Unchanged in name, now delivers through the component set below. |
fgtclb/ | The Job list content element only. |