Installation

Requirements

TYPO3 13.4 LTS ( typo3/cms-core 13.4.34 or higher)
PHP 8.2 or higher with the PHP extension intl
friendsoftypo3/tt-address : job locations are addresses (required dependency, installed automatically)
bithost-gmbh/pdfviewhelpers : renders the PDF version of a job (required dependency, installed automatically)
Optional: jweiland/maps2 shows the job locations on a map

The extension can only be installed with Composer.

Install the extension with Composer

Install the development version

composer require jweiland/jobboard:dev-main

Note

There is no tagged release of the extension yet. Until the first release, install the branch dev-main. As soon as a release is available, use composer require jweiland/jobboard.

Then set up the extension. This creates the database tables of the job board and adds the column import_key to the table tt_address:

Set up the extension and its database tables

vendor/bin/typo3 extension:setup

Add the site sets

The extension does not provide static TypoScript templates. Add the site set Jobboard - Main (jweiland/jobboard) to your site, either in the backend module Site Management > Sites (tab Sets) or in the site configuration file.

The PDF export of a job uses the TypoScript of EXT:pdfviewhelpers. Add its site set EXT:pdfviewhelpers (bithost/pdfviewhelpers) as well:

config/sites/<site-identifier>/config.yaml

base: 'https://example.org/'
dependencies:
  - jweiland/jobboard
  - bithost/pdfviewhelpers

The set jweiland/jobboard loads the set jweiland/jobboard-pdf automatically. See Site sets for details.

Create a storage folder

Create a page of type Folder in the page tree, for example "Job board". All records of the job board are stored here: jobs, occupational fields, positions, salary grades, benefits and the addresses of the job locations.
Set the site setting jobboard.storagePid to the UID of this folder (Site Management > Settings, category Jobboard > Pages):

config/sites/<site-identifier>/settings.yaml
```
jobboard:
  storagePid: '23'
  pidOfApplicationForm: 51
```
Copied!
The default value '0' means that no jobs are found.

Import the route enhancer

For speaking URLs of the detail view, import the shipped route enhancer in your site configuration. See Speaking URLs (route enhancer).

Optional: show job locations on a map

The map is optional. If you want to show the job locations on a map, install EXT:maps2:

Install EXT:maps2

composer require jweiland/maps2
vendor/bin/typo3 extension:setup

If EXT:maps2 is installed, the site set jweiland/jobboard automatically loads the sets jweiland/maps2-default and jweiland/maps2-googlemaps. The address records of the job locations get an additional field for the map location. The map is shown as soon as at least one listed job has an address with a map location. Configure EXT:maps2 as described in its documentation.

Attention

With EXT:maps2, the job board uses Google Maps. You need a Google Maps API key, and visitors' browsers load the map from Google. Check the privacy information and the consent handling of your site.

Without EXT:maps2, the job board works the same, but shows no map and the addresses have no map location field.

First steps

Flush all caches: vendor/bin/typo3 cache:flush.
Create the records in the storage folder, see For editors.
Insert the content element "Job board" on a page, see Insert the content element "Job board".
If you migrate from EXT:jobfair2, run the upgrade wizards, see Upgrade wizards.