Academic Bite Jobs 

Extension key

academic_bite_jobs

Package name

fgtclb/academic-bite-jobs

Version

2.3

Language

en

Author

FGTCLB

License

This document is published under the Creative Commons BY 4.0 license.

Rendered

Sun, 26 Apr 2026 17:08:16 +0000


The TYPO3 extension Academic Jobs with b-ite displays jobs from the b-Ite eRecruiting platform embedded in the TYPO3 website. All you need to use it is the b-ite key, which can usually be read from existing b-Ite job advertisements in the browser.

The job offers are displayed as tiles, lists and tables. The detailed display of individual job advertisements is automatically linked to the b-ite platform. The b-ite key can be entered in the extension plugin. Custom assignment allows groupings such as appointment procedures, academic staff, non-scientific staff or training positions to be selected.

Further settings for grouping, sorting, display mode and limiting the job advertisements are also available in the plugin.


Table of Contents:

What does it do? 

The TYPO3 extension Academic Jobs with b-ite displays jobs from the b-Ite eRecruiting platform embedded in the TYPO3 website. All you need to use it is the b-ite key, which can usually be read from existing b-Ite job advertisements in the browser.

As part of the bundling of requirements for the FGTCLB Academic Extensions, the TYPO3 extension "Academic Jobs b-ite" was created, which only requires the b-ite key to seamlessly display job adverts from the b-ite platform on a TYPO3 website.

The developed plug-in currently supports different categorisations, which are read from b-ite, e.g. appointment procedures, academic staff, non-scientific staff and training positions.

List view, tile view and table view are currently available as display modes. There are also options for grouping and sorting as well as a limit for the number of job adverts to be displayed.

Installation 

This extension can be installed using the TYPO3 extension manager or by composer.

composer install 'fgtclbfgtclb/academic-bite-jobs':'^2'
Copied!

Testing 2.x.x extension version in projects (composer mode) 

It is already possible to use and test the 2.x version in composer based instances, which is encouraged and feedback of issues not detected by us (or pull-requests).

Your project should configure minimum-stabilty: dev and prefer-stable to allow requiring each extension but still use stable versions over development versions:

composer config minimum-stability "dev" \
&& composer config "prefer-stable" true
Copied!

and installed with:

composer require \
    'fgtclb/academic-bite-jobs':'2.*.*@dev'
Copied!

General configuration 

...

Overriding templates 

EXT:academic_bite_jobs is using Fluid as template engine.

This documentation won't bring you all information about Fluid but only the most important things you need for using it. You can get more information in the section Fluid templates of the Sitepackage tutorial. A complete reference of Fluid ViewHelpers provided by TYPO3 can be found in the ViewHelper Reference

Change the templates using TypoScript constants 

As any Extbase based extension, you can find the templates in the directory Resources/Private/.

If you want to change a template, copy the desired files to the directory where you store the templates.

We suggest that you use a sitepackage extension. Learn how to Create a sitepackage extension.

# TypoScript constants
plugin.tx_academicjobs {
    view {
        templateRootPath = EXT:mysitepackage/Resources/Private/Extensions/myextension/Templates/
        partialRootPath = EXT:mysitepackage/Resources/Private/Extensions/myextension/Partials/
        layoutRootPath = EXT:mysitepackage/Resources/Private/Extensions/myextension/Layouts/
    }
}
Copied!

Known problems 

Please note that this extension is still in development. Changes to existing code may appear in upcoming versions.

If you run into a bug or a feature that would be helpful, please use the issue tracker.

Breaking: Remove project specific custom fields 

Description 

EXT:academic_bite_jobs provides flexform options and filters based on custom project specific fields and options not interchangeable with other projects and not making sense being provided by default.

These custom fields needs to be setup the same way on the external bite-job system and is mosts likely not the way to go.

Mangling around with the current implementation even if only the options are removed is not suitable and the internal implementation needs to be streamlined first before adding customization endpoints in a reasonable way as public API.

Based on aforementioned background project specific implementation and options are now removed to clean up the code base as preparation to streamline first the internal implementation with dedicated changes, re-introducing the feature with a new API at a later point.

This is technically breaking, at least for the one specific project and is handled as breaking for it, albeit it should not target any other project at all.

Reducing the feature set to the bare minimum simply displaying only the single job detail page without related jobs is the mostly used base ground and the essential base feature to start fresh from.

Additionally, fluid template structure is streamlined in the same step to follow the restructure epic for all academic extensions.

Impact 

Following removals are included:

  • flexform options settings.jobs.custom.zuordnung and

settings.jobs.groupBy are removed. `BiteFieldsHelper` is removed being unused and an empty class anyway. BiteJobsService->fetchBiteJobs() handling code for removed flexform setting options is removed from method. `public BiteJobsService->findCustomJobRelations()` is removed. public BiteJobsService->findCustomBiteFieldLabelsFromOptions() is removed. `public BiteJobsService->groupByRelations()` is removed. public BiteJobsService->mapFieldsToJobs() is removed.

Affected Installations 

EXT:academic_bite_jobs before v2.1 installations using custom project specific fields and options

Migration 

[TODO] How to migrate the breaking change?