Content element "Job board"

The extension registers one content element (CType jobboard_jobboard, plugin namespace tx_jobboard_jobboard) with three actions:

list: Default action. Shows the search form, the map and all current jobs.
search: Shows the jobs matching the submitted search form. Not cached.
detail: Shows one job. The shipped templates render the detail view on the same page as the list.

The options of the content element are in the tab Configuration. See Insert the content element "Job board" for the editor's view.

Sheet "General"

Name	Type	Default
Job areas	occupational field records	empty
Max entries to show (0 for all)	integer	`0`

Job areas

Type: occupational field records
Default: empty

FlexForm field settings.jobAreas. Shows only jobs that have at least one of the selected occupational fields. Empty: jobs of all occupational fields are shown.

The restriction applies to the list and to the search result. The select box of occupational fields in the search form and the number of jobs per occupational field only consider the selected fields. A submitted occupational field outside of the selection is ignored.

Max entries to show (0 for all)

Type: integer
Default: 0

FlexForm field settings.maxEntries. Maximum number of jobs in the list and in the search result. Jobs without salary information are removed before the limit applies, so visitors always get up to this number of jobs. 0 shows all jobs.

Sheet "Search"

Name	Type	Default
Show Search	boolean	`1`
Address search field	`zipCity` or `jobLocation`	`zipCity`
Show free text search	boolean	`1`
Show number of jobs per job area	`''`, `1` or `-1`	`''` (Use value from TypoScript)

Show Search

Type: boolean
Default: 1

FlexForm field settings.showSearch. Shows the search form. The map is shown independent of this option.

Address search field

Type: zipCity or jobLocation
Default: zipCity

FlexForm field settings.addressSearchMode.

zipCity (Search field with suggestions): A text field for a ZIP code or city. After three characters, up to five suggestions in the format "12345 - Sample Town" are shown, see Suggestions for the location field.
jobLocation (Job location select box): A select box with the cities of all listed jobs.

Show free text search

Type: boolean
Default: 1

FlexForm field settings.showFreeTextSearch. Shows the keyword field.

Show number of jobs per job area

Type: '', 1 or -1
Default: '' (Use value from TypoScript)

FlexForm field settings.showJobAreaCount. "Use value from TypoScript" uses the site setting jobboard.showJobAreaCount. "Show" (1) and "Hide" (-1) override it for this content element.

How the search works

A job is part of the search result if it is currently open (see Why is my job not shown?) and matches all filled fields of the search form:

Occupational field: The job has this occupational field among its occupational fields. If the content element restricts the occupational fields (see Job areas), only jobs of these fields are found, and a submitted field outside of them is ignored.
Position, employment scope: The job has exactly this position or employment scope.
Location: An input like "12345 - Sample Town" is split at the hyphen. Jobs match if the ZIP code of their address is "12345" or the city contains "Sample Town". A number only is searched as ZIP code, other input as part of the city.
Keyword: The input is split at spaces. Every word must be found (AND). Each word may be found in the title, description, offer, requirements, further information, application guidelines, or the street or city of the address.

The search result is sorted by application deadline, jobs without an application deadline first. The table layout can be sorted by the visitor afterwards.

The search form sends these arguments to the action search, which you can also use in own forms:

tx_jobboard_jobboard[jobArea] (UID of an occupational field)
tx_jobboard_jobboard[jobRole] (UID of a position)
tx_jobboard_jobboard[jobType] (UID of an employment scope)
tx_jobboard_jobboard[address] (ZIP code and/or city)
tx_jobboard_jobboard[searchWord] (keywords)