Configuration
This extension ships its frontend TypoScript and its backend page TSconfig in two forms: as TYPO3 site sets, and as classic static templates plus page TSconfig files that are selected on a page. Both forms read the very same files, so they configure an installation identically.
Pick one of them per site and stay with it — see Do not combine both for what happens otherwise.
What the sets contain
This extension ships three content elements, so it ships three component sets and one aggregate set that depends on all of them.
All three are driven by one Extbase plugin, so they share one TypoScript block,
plugin.. That block is shipped once, in
Configuration/, and every component includes it. Which
component sets a site names therefore decides which content elements the backend
offers, not how much TypoScript is loaded.
| Set | Delivers |
|---|---|
fgtclb/ | The Job Form content element, the frontend form a job offer is entered with. |
fgtclb/ | The Job List content element. |
fgtclb/ | The Job Details content element. |
fgtclb/ | Everything above. This is the set to use unless you deliberately want a subset, and it is the name this extension published before the sets were cut per component — a site configuration that depends on it needs no change. |
Every component set depends on fgtclb/, the set of
EXT:academic_base that labels the content element group all academic
extensions sort their elements into.
The site settings of this extension are declared with the aggregate set: the
storage, detail, list and redirect pages, the notification e-mail, the job
avatar upload, the content element header switch and the page links of the
list pagination. A site that depends on
a single component set still gets the shipped defaults, but can only override
them in Site Settings when it depends on fgtclb/.
Include the site set
Add the set to the config. of the site that should offer the content
elements:
base: 'https://example.com/'
rootPageId: 1
+dependencies:
+ - fgtclb/academic-jobs
See also TYPO3 Explained, Using a site set as dependency in a site.
Include static templates
For an installation that still configures its frontend through
sys_ records, the same files are registered as static templates
and as selectable page TSconfig files.
Tip
On TYPO3 v13 and v14 we recommend the site set — and if you use it, do not
press the backend button Create a root TypoScript record on that
site. The
sys_ record it creates carries the flag
Clear for constants and setup, and that flag discards everything
the site sets contributed. An installation that is already in that state
gets its configuration back by selecting the static templates below in that
very record.
Include static TypoScript
Edit the
sys_ record of the site root and add the entry to
Include static (from extensions):
| Entry | Delivers |
|---|---|
| Academic Jobs: Jobs New (academic_jobs) | The TypoScript of the Job Form content element. |
| Academic Jobs: Jobs List (academic_jobs) | The TypoScript of the Job List content element. |
| Academic Jobs: Jobs Detail (academic_jobs) | The TypoScript of the Job Details content element. |
| Academic Jobs: All components (academic_jobs) | Every component this extension ships, in one entry. |
| Academic Jobs: Shared plugin settings (academic_jobs) | The shared
plugin. block on its own.
This is the entry an installation stored before the configuration
was cut per component, and it keeps working — but it does not make
any content element selectable, which the page TSconfig below does. |
Include static page TSconfig
Edit the page record of the site root, tab Resources, field Page TSconfig, and add the entry:
| Entry | Delivers |
|---|---|
| Academic Jobs: Jobs New (academic_jobs) | Makes the Job Form content element selectable, and configures its entry in the new content element wizard. |
| Academic Jobs: Jobs List (academic_jobs) | The same for Job List. |
| Academic Jobs: Jobs Detail (academic_jobs) | The same for Job Details. |
| Academic Jobs: All components (academic_jobs) | Every component this extension ships, in one entry. |
The setting is inherited by every page below the one it is set on.
Pagination of the job list
The Job List content element can split its jobs into pages. Whether it does, and how many jobs a page holds, is set on each content element, tab Pagination:
| Field | Default | Meaning |
|---|---|---|
| Enable pagination | off | Off, the list renders every job of its job type. |
| Results per page | 10 | The number of jobs on one page. |
How many page numbers the navigation links at once is one value for the whole site:
| Site setting and constant | Default | Meaning |
|---|---|---|
plugin. | 5 | The most page numbers the navigation links around the current page.
Read with georgringer/ only. Without it, the
core pagination links every page. |
The site setting is declared by the aggregate set fgtclb/, like
every other setting of this extension. A site configured through static
templates sets the constant instead.
Load the script or bring your own
The Jobs New content element loads two scripts on the page that
carries it: CKEditor 4 from its content delivery network, and the module
@fgtclb/, which turns the description
fields of the form into rich text editors. No other content element of this
extension loads a script.
Both are switched off together, per site, for an installation that brings its own editor or wants none:
| Site setting and constant | Default | Off means |
|---|---|---|
plugin. |
true
| The page loads neither the editor nor the module. |
With the site set, it is a site setting of fgtclb/, like every
other setting of this extension:
plugin.tx_academicjobs.assets.js: false
With the static template, it is the TypoScript constant of the same name:
plugin.tx_academicjobs.assets.js = 0
The form keeps working without the scripts. The description fields are
plain text areas, marked with the class
ace-, and a visitor
submits the text as it is. A script of your own finds the fields by that class.
A project that overrides Templates/ keeps whatever its copy
loads, until it wraps its own
<f: and
<f: in
<f:.
Do not combine both
A site that uses the site set and the static template reads the shipped
files twice. The site set is applied before the
sys_ record, so
the second read happens after the site settings and after
config/ — and it resets every constant
the extension ships a default for back to that default. For this extension that
is the whole
plugin. constants block: the Fluid
root paths, the storage and target page ids, the notification e-mail, the job
avatar upload settings, the content element header switch and the
script switch, among others.
Nothing else is damaged: the Constants and Setup fields
of the
sys_ record, the page TSconfig of a page and the page
TSconfig files selected on a page are all applied afterwards and still win. Use
one mechanism per site and the question does not arise.