Jobcenter

Introduction

The Jobcenter extension provides a flexible way to manage and display contact persons for various social services based on visitor filters such as age, location (PID), disability, or self-reliance. It is primarily designed for German Jobcenter use cases and integrates seamlessly with TYPO3's Extbase & Fluid framework.

This extension is compatible with TYPO3 v12 LTS and follows best practices using dependency injection, clean controller logic, and SOLID principles.

Main features

  • Show contacts filtered by:

    • Age group (e.g., 15–24 or 25–49)
    • ZIP code for employer contacts
    • Self-reliance and handicap status
    • Service-related queries (Leistungsgewährung)
  • Backend support for managing contact data
  • Separate handling of citizen and employer contact listings
  • Flash messages when no responsible contact is found
  • Reusable services for getting page titles
  • Fallback logic for missing data
  • Fully templated output via Fluid

Target audience

This extension is built for:

  • Public Jobcenters in Germany
  • TYPO3 integrators building Jobcenter-specific platforms
  • Developers who want a modular and extensible contact filtering system

Installation

Composer

If your TYPO3 installation works in composer mode, please execute following command:

composer req jweiland/jobcenter
vendor/bin/typo3 extension:setup --extension=jobcenter
Copied!

If you work with DDEV please execute this command:

ddev composer req jweiland/jobcenter
ddev exec vendor/bin/typo3 extension:setup --extension=jobcenter
Copied!

ExtensionManager

On non composer based TYPO3 installations you can install jobcenter still over the ExtensionManager:

  1. Login

    Login to backend of your TYPO3 installation as an administrator or system maintainer.

  2. Open ExtensionManager

    Click on Extensions from the left menu to open the ExtensionManager.

  3. Update Extensions

    Choose Get Extensions from the upper selectbox and click on the Update now button at the upper right.

  4. Install jobcenter

    Use the search field to find jobcenter. Choose the jobcenter line from the search result and click on the cloud icon to install jobcenter.

Next step

Configure jobcenter.

TypoScript

jobcenter needs some basic TypoScript configuration. To do so you have to add an +ext template to either the root page of your website or to a specific page which contains the jobcenter plugin.

  1. Locate page

    You have to decide where you want to insert the TypoScript template. Either root page or page with jobcenter plugin is OK.

  2. Create TypoScript template

    Switch to template module and choose the specific page from above in the pagetree. Choose Click here to create an extension template from the right frame. In the TYPO3 community it is also known as "+ext template".

  3. Add static template

    Choose Info/Modify from the upper selectbox and then click on Edit the whole template record button below the little table. On tab Includes locate the section Include static (from extension). Use the search above Available items to search for jobcenter. Hopefully just one record is visible below. Choose it, to move that record to the left.

  4. Save

    If you want you can give that template a name on tab "General", save and close it.

  5. Constants Editor

    Choose Constant Editor from the upper selectbox.

  6. jobcenter constants

    Choose PLUGIN.TX_JOBCENTER from the category selectbox to show just jobcenter related constants

  7. Configure constants

    Adapt the constants to your needs.

  8. Configure TypoScript

    As constants will only allow modifiying a fixed selection of TypoScript you also switch to Info/Modify again and click on Setup. Here you have the possibility to configure all jobcenter related configuration.

View

view.templateRootPaths

Default: Value from Constants EXT:jobcenter/Resources/Private/Templates/

You can override our Templates with your own SitePackage extension. We prefer to change this value in TS Constants.

view.partialRootPaths

Default: Value from Constants EXT:jobcenter/Resources/Private/Partials/

You can override our Partials with your own SitePackage extension. We prefer to change this value in TS Constants.

view.layoutsRootPaths

Default: Value from Constants EXT:jobcenter/Resources/Layouts/Templates/

You can override our Layouts with your own SitePackage extension. We prefer to change this value in TS Constants.

Persistence

persistence.storagePid

Set this value to a Storage Folder (PID) where you have stored the records.

Example: plugin.tx_jobcenter.settings.storagePid = 21,45,3234

Settings

settings.pidForManagement15_24

Default: Value from Constants 0

Example: plugin.tx_jobcenter.settings.pidForManagement15_24 = 52

Define the PID of a storage folder which contains the records for employees which are responsible for people whose age is between 15 and 24.

settings.pidForManagement25_49

Default: Value from Constants 0

Example: plugin.tx_jobcenter.settings.pidForManagement25_49 = 53

Define the PID of a storage folder which contains the records for employees which are responsible for people whose age is between 25 and 49.

settings.pidForService

Default: Value from Constants 0

Example: plugin.tx_jobcenter.settings.pidForService = 54

Define the PID of a storage folder which contains the records for services.

Change log

Version 4.0.0

  • TYPO3 Version compatibility for 12 LTS
  • Test Cases rewrites to TYPO3 Testing Framework
  • Removed compatibility for TYPO3 11 and lower versions
  • All deprecated calls replaced

Version 3.2.1

  • [BUGFIX] Cast PID of TypoScript to INT for ContactRepository

Version 3.2.0

  • [FEATURE] Add selfreliance as checkbox to search form
  • [TASK] ContactRepository finds fallback itself
  • [TASK] Show FlashMessage, if a contact person could not be found
  • [TASK] Add func tests

Version 3.1.0

  • Add Plugin Preview

Version 3.0.1

  • [BUGFIX] Wrong extension name in documentation

Version 3.0.0

  • Add TYPO3 11 compatibility
  • Remove TYPO3 9 compatibility

Version 2.0.0

  • Now compatible with TYPO3 9.5 and 10.4
  • Remove TYPO3 8 compatibility

Sitemap

Index