Documentation
Academic Bite Jobs

Academic Bite Jobs 

Extension key

academic_bite_jobs

Package name

fgtclb/academic-bite-jobs

Version

main

Language

en

Author

FGTCLB

License

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

Rendered

Mon, 13 Jul 2026 11:19:04 +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.

Introduction 

What the extension does and the main concepts behind it.

Installation 

Install academic_bite_jobs via Composer, the Extension Manager or a TER upload.

Configuration 

Configure the extension and its plugins for your installation.

Templates 

Override and customise the frontend templates.

Known problems 

Known issues and information about them.

Changelog 

Learn about what has changed and which actions are required to upgrade.

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 

The extension has to be installed like any other TYPO3 CMS extension. You can download and install it using one of the following methods.

Install the stable release 
composer require 'fgtclb/academic-bite-jobs':'^2'
Copied!
  1. Switch to the module Admin Tools > Extensions.
  2. Switch to Get Extensions.
  3. Search for the extension key academic_bite_jobs.
  4. Import the extension from the repository.
  1. Get the current version from TER by downloading the ZIP version. Alternatively, get the ZIP from the GitHub Releases page.
  2. Switch to the module Admin Tools > Extensions.
  3. Enable Upload Extension.
  4. Select or drag the extension ZIP archive and upload the file.

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: Removed TYPO3 v12 support 

Description 

Support for TYPO3 v12 has been removed for the 3.x version line, based on the dual TYPO3 core version support per major version of the academic extensions support matrix.

This includes removing build, test and configuration parts only required for TYPO3 v12. Version specific code paths are dropped in a dedicated step.

Impact 

TYPO3 v12 or older instances can no longer install or update to the 3.x version of the academic extensions and are required to upgrade TYPO3 first.

The extension cannot be installed on TYPO3 v12 anymore but does not break otherwise.

Affected installations 

All installations using an academic extension on TYPO3 v12 that want to upgrade to the 3.x version line.

Migration 

Upgrade the TYPO3 installation to a supported version (TYPO3 v13) beforehand or within the same upgrade step.

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?

Sitemap