Site settings 

The site set jweiland/jobboard defines the following settings. Edit them in the backend module Site Management > Settings (category Jobboard) or in the file config/sites/<site-identifier>/settings.yaml.

Site settings of the category Jobboard

The settings of the job board in the module Site Management > Settings

config/sites/<site-identifier>/settings.yaml
jobboard:
  storagePid: '23'
  pidOfApplicationForm: 51
Copied!
Name Type Default
string EXT:jobboard/Resources/Private/Templates/
string EXT:jobboard/Resources/Private/Partials/
string EXT:jobboard/Resources/Private/Layouts/
string (comma-separated list of page UIDs) '0'
page 0
page 0
bool false
bool true
int 15
bool true
string 'EUR'
string ''
string 'download'
jobboard.templateRootPath
Type
string
Default
EXT:jobboard/Resources/Private/Templates/

Path to an additional template root of the plugin. It is added as plugin.tx_jobboard.view.templateRootPaths.1 , see Templates and frontend assets.

jobboard.partialRootPath
Type
string
Default
EXT:jobboard/Resources/Private/Partials/

Path to an additional partial root of the plugin. It is added as plugin.tx_jobboard.view.partialRootPaths.1 .

jobboard.layoutRootPath
Type
string
Default
EXT:jobboard/Resources/Private/Layouts/

Path to an additional layout root of the plugin. It is added as plugin.tx_jobboard.view.layoutRootPaths.1 .

jobboard.storagePid
Type
string (comma-separated list of page UIDs)
Default
'0'

Comma-separated list of page UIDs that store all jobs, for example '23' or '23,24' . Jobs are also found in up to three levels of subpages of these pages. With the default '0' , no jobs are found.

If the addresses ( tt_address ) of the job locations live in additional folders, add these folders here too. The suggestions of the location field in the search form (see Suggestions for the location field) only search in the pages listed here.

Mapped to plugin.tx_jobboard.persistence.storagePid .

jobboard.pidOfDetailPage
Type
page
Default
0

Page with a "Job board" content element for the detail view. The shipped templates render the detail view on the same page as the list. The value is available as {settings.pidOfDetailPage} in Fluid, for own templates that link to a separate detail page.

jobboard.pidOfApplicationForm
Type
page
Default
0

Page with the online application form. If set to a value greater than 0 , the detail view shows an "Apply online" link to this page (only for jobs with a contact email address), and the card layout shows it for each job. The link adds the query parameter jobuid=<uid of the job>, which your form can evaluate.

With 0 , no "Apply online" link is rendered.

jobboard.showJobAreaCount
Type
bool
Default
false

Appends the number of jobs to each occupational field in the search form, for example "IT (3)". The number only counts jobs of the current list. A job with several occupational fields is counted for each of them, so the sum can be higher than the number of jobs.

Can be overridden per content element, see Show number of jobs per job area.

jobboard.pageBrowser.enable
Type
bool
Default
true

Splits the list and the search result into pages of jobboard.pageBrowser.itemsPerPage jobs and shows the page browser, see Page browser. With false , the list and the search result show all jobs on one page.

Can be overridden per content element, see Show page browser. A content element with Max entries to show (0 for all) greater than 0 never shows the page browser, independent of this setting.

Mapped to plugin.tx_jobboard.settings.pageBrowser.enable .

jobboard.pageBrowser.itemsPerPage
Type
int
Default
15

Number of jobs on one page of the list and of the search result. Further jobs are reached with the page browser, see Page browser. Has no effect, if the page browser is disabled, see jobboard.pageBrowser.enable.

Mapped to plugin.tx_jobboard.settings.pageBrowser.itemsPerPage .

jobboard.salary.required
Type
bool
Default
true

With true , only jobs with salary information are shown: the job needs an effective salary (minimum or maximum greater than 0, see Update the effective salary of the jobs). Jobs without salary information are hidden in the list, the search result, the detail view (HTTP status 404), the remembered jobs and the map. The detail view does not link related jobs without salary information. This is the default.

With false , jobs without salary information are shown like any other open job. All other conditions still apply, for example title, application deadline, end of employment and the publish and expiration date of the job, see Why is my job not shown?. The salary is shown for jobs that have one. The effective salary is calculated in both cases, so switching the setting later does not require a recalculation.

The EU pay transparency directive (EU) 2023/970 requires that applicants receive information about the initial pay or its range. Whether and from when this applies to your job offers depends on the national transposition of the directive. This documentation is no legal advice. Clarify with your legal department which value is right for your site.

config/sites/<site-identifier>/settings.yaml
jobboard:
  salary:
    required: false
Copied!

The setting can also be changed in the backend module Site Management > Settings, category Salary. Flush the frontend caches after changing it, cached pages still show the jobs of the previous value.

jobboard.salary.currency
Type
string
Default
'EUR'

ISO 4217 code of the currency of the salary amounts, for example 'EUR' , 'CHF' or 'USD' . Change it in the backend module Site Management > Settings, category Salary.

The detail view (salary range and salary steps) formats every amount with \NumberFormatter of the PHP extension intl and the locale of the site language ( locale in the site configuration). Separators, decimal places and the currency sign and its position follow the locale, for example:

Locale Currency Display
de_DE EUR 1.234,56 €
en_US EUR €1,234.56
nl_NL EUR € 1.234,56
de_CH CHF CHF 1'234.56
fr_FR EUR 1 234,56 €

The structured data for search engines (see Structured data (JSON-LD)) uses the same code and keeps the plain numbers. A value that is not three uppercase letters is replaced by 'EUR' . For another format, override the template, see ViewHelper for salary amounts.

config/sites/<site-identifier>/settings.yaml
jobboard:
  salary:
    # Swiss francs, e.g. CHF 1'234.50 on a de_CH site language
    currency: CHF
Copied!

Flush the frontend caches after changing the currency.

jobboard.pdf.linkMode
Type
string
Default
'download'

How the PDF link of the detail view opens the PDF version of a job, see PDF export. Defined by the site set jweiland/jobboard-pdf .

download
The PDF is sent as file download. Link label "Download PDF file of the job offer".
newTab
The PDF is shown in the browser in a new tab ( target="_blank" ). Link label "Show rendered PDF in new tab".
sameTab
The PDF is shown in the browser in the same tab. Link label "Show PDF".

Mapped to plugin.tx_jobboard.settings.pdfLinkMode on all pages, as the detail view and the PDF page type both use it.