---
title: "Upgrading from 2.3 to 3.0"
manual: "Academic Bite Jobs"
version: "main"
permalink: "https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:upgrade-from-2-3-to-3-0@main"
source: "Upgrade/From23To30.rst"
rendered: "2026-10-26T19:20:41+00:00"
---

# Upgrading from 2.3 to 3.0 {#upgrade-from-2-3-to-3-0}

This page takes an installation of **academic_bite_jobs** 2.3 straight
to 3.0, without the step to 2.4. Version 3.0 drops TYPO3 12, makes the
controller of the job list final, renders the job list with speaking classes
and gives the content element a new icon. From 2.4 it takes over the
configuration per component, the content element that stays hidden until a site
enables it, and the upgrade wizard for the stored plugin settings of older job
lists. It changes no database table of this extension. Version 3.0 replaces no
step of 2.4 for this extension, so the page leaves none out. Work through the
sections in order. Skip a step that does not apply to the installation.

## Before you start {#upgrade-from-2-3-to-3-0-before-you-start}

Version 3.0 runs on TYPO3 13.4 from 13.4.35 on and on TYPO3 14.3 from 14.3.7
on, with PHP 8.2 or later.

**academic_bite_jobs** 3.0 needs these packages. Upgrade them first or
in the same deployment, in this order:

-   [`fgtclb/environment-state-manager`](https://packagist.org/packages/fgtclb/environment-state-manager) 2.x, new since 2.4, which
    **academic_base** 3.0 requires. Composer installs it on its own. A
    classic installation installs **environment_state_manager** 2.x
    before it activates **academic_base** 3.0.
-   [`fgtclb/academic-base`](https://packagist.org/packages/fgtclb/academic-base) 3.0, the same release as this extension.

The extension declares the system extension **install** as a
dependency since 2.4, for its upgrade wizard. TYPO3 keeps that extension
active in every installation, so this needs no action.

These changes have to ship in the same deployment as the update:

-   A subclass of the controller of the job list goes, or the site fails with
    a fatal error as soon as the update is deployed, see
    [Adapt your code](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:upgrade-from-2-3-to-3-0-code@main).
-   A site without the site set includes the page TSconfig of the component,
    or the content element is not offered for new content, see
    [Include the components](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:upgrade-from-2-3-to-3-0-components@main).

The module paths on this page are those of TYPO3 13, where the upgrade runs.

## Update TYPO3 first {#upgrade-from-2-3-to-3-0-typo3}

Update TYPO3 to 13.4.35 or later while the site still runs 2.3, which supports
TYPO3 13.4. Version 3.0 no longer installs on TYPO3 12, and Composer and the
Extension Manager refuse it next to an older patch release of TYPO3 13.

Stay on TYPO3 13 until the upgrade is complete when the installation also has
**academic_jobs**, **academic_persons**,
**academic_persons_edit** or **academic_projects**. Their
content element wizards read the column `tt_content.list_type`, which
TYPO3 14 removes, so they only run on TYPO3 13. Move to TYPO3 14.3.7 or later
once they have run.

See [Breaking: Removed TYPO3 v12 support](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:breaking-removed-typo3-v12-support@main) and
[Important: TYPO3 13.4.35 or 14.3.7 is required](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:important-minimum-typo3-versions@main).

## Update the package {#upgrade-from-2-3-to-3-0-package}

```bash
composer require -W \
    'fgtclb/academic-base':'~3.0.0' \
    'fgtclb/academic-bite-jobs':'~3.0.0'
```

On a classic installation, install **environment_state_manager** 2.x
from the TER in **Admin Tools > Extensions** first, then update
**academic_base** and **academic_bite_jobs** there, in this
order. Run the commands of this page with `typo3/sysext/core/bin/typo3`
instead of `vendor/bin/typo3`.

```bash
vendor/bin/typo3 cache:flush
```

## Update the database {#upgrade-from-2-3-to-3-0-database}

```bash
vendor/bin/typo3 extension:setup
```

Or apply the changes in **Admin Tools > Maintenance > Analyze
Database Structure**.

The comparison changes no table of this extension. It applies the changes of
the index definitions TYPO3 13.4.35 and 14.3.7 bring, and the columns other
academic extensions add since 2.4. The upgrade wizard of the next section needs
them.

## Run the upgrade wizards {#upgrade-from-2-3-to-3-0-wizards}

1.  `academicBiteJobs_listViewFlexFormUpgradeWizard`, **Migrate the
    plugin settings of academic_bite_jobs job lists stored before 2.1.**, is new
    since 2.4. It rewrites the stored view of every job list content element,
    hidden ones included, from `ListView`, `CardView` or `TableView`, or an
    empty or unknown value, to `List`, `Card` or `Table`. It also removes the
    settings `settings.jobs.groupBy` and `settings.jobs.custom.zuordnung`,
    which version 2.1 dropped from the plugin but left in the stored records.
    A stored grouping setting keeps a list grouped by a field the job postings
    no longer carry until the wizard has run. Run it in
    **Admin Tools > Upgrade > Upgrade Wizard** or on the command line:

    ```bash
    vendor/bin/typo3 upgrade:run academicBiteJobs_listViewFlexFormUpgradeWizard
    ```

    Content elements created with version 1.x are plugins stored with the
    content type `list`. Neither this version nor the wizard renders or
    migrates them. See [Important: The job list groups only on request and reads old view values](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:important-1789660801@main).

A wizard that TYPO3 recorded as done is offered again once it is marked
undone. TYPO3 13 marks a wizard undone with
`vendor/bin/typo3 upgrade:mark:undone <identifier>`.

## Adapt the configuration {#upgrade-from-2-3-to-3-0-configuration}

The TypoScript and the page TSconfig are delivered per content element since
2.4, and the job list content element is hidden in the whole installation until
the page TSconfig of its component is included. See
[Breaking: Site sets and static templates have been restructured](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:breaking-site-sets-and-static-templates-restructured@main).

### The upgrade check {#upgrade-from-2-3-to-3-0-upgrade-check}

The console command `academic:upgrade:check` of **academic_base**
reads the stored configuration of the installation and reports the static
templates, page TSconfig imports and site sets that no longer reach an academic
extension, and an XCLASS of the controller. Run it on the staging copy right
after the package update, and again once the steps of this section are done:

```bash
vendor/bin/typo3 academic:upgrade:check
```

With the extension key and a site it also compares the template overrides of
the site with the templates this extension ships:

```bash
vendor/bin/typo3 academic:upgrade:check academic_bite_jobs --site=<site identifier>
```

Each finding, and what to do about it, is described in the upgrade check
of **academic_base**.

### Include the components {#upgrade-from-2-3-to-3-0-components}

-   **Site set.** A site that depends on the set `fgtclb/academic-bite-jobs`
    needs no change. The set keeps its name and brings the page TSconfig
    along.
-   **Static template.** The stored entry of 2.3 keeps working as
    **Academic Bite Jobs: Path up to 2.3 (deprecated, use All
    components) (academic_bite_jobs)**, which is removed in version 4.0. Replace
    it with **Academic Bite Jobs: All components (academic_bite_jobs)**
    in the field **Include TypoScript sets** on the tab
    **Advanced Options** of the template record, see
    [Deprecation: The static template path of version 2.3](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:deprecation-legacy-static-template-path@main).
-   **Page TSconfig.** A site without the site set adds
    **Academic Bite Jobs: All components (academic_bite_jobs)** in the
    field **Include static Page TSconfig (from extensions)** on the tab
    **Resources** of its root page, see [Include static page TSconfig](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:static-pagetsconfig@main).
    Without it the content element is not offered for new content.
-   Use one of the two mechanisms per site, see
    [Do not combine both](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:one-mechanism-per-site@main).

Until a component is included, an existing content element of it keeps
rendering and keeps its type: **academic_base** shows the stored type
in the field **Type** followed by
**(not enabled on this page)**, and saving keeps it. The warning of the
2.4 changelog entry that saving such a record rewrites its type describes the
state before a fix that **academic_base** 2.4 carries as well, see
its changelog entry.
A content element that a page TSconfig of your own already turned into another
type is not repaired. Correct it by hand from its record history.

### Adjust your own configuration {#upgrade-from-2-3-to-3-0-own-configuration}

-   The page TSconfig directory is `Configuration/TSconfig/` now, and the
    TypoScript moved into `Configuration/TypoScript/List/`. Take the new
    path of every `@import` from the table of the changelog entry
    linked above. An import of a missing file fails silently.
-   A site whose content element layout renders no header sets
    `plugin.tx_academicbitejobs.renderContentElementHeader = 1`.
    The plugin no longer renders the header itself, see
    [Important: The job list leaves the content element header to the layout](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:important-1790323401@main).
-   The job list is grouped only when TypoScript names a field of the job
    postings in `plugin.tx_academicbitejobs.settings.jobs.groupBy`.
    Set it where a list has to stay grouped, see
    [Grouping the jobs](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:configuration-general-group-by@main).
-   Label overrides move from
    `plugin.tx_academic_bite_jobs._LOCAL_LANG` to
    `plugin.tx_academicbitejobs._LOCAL_LANG`, see
    [Important: Label overrides are read from the documented path](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:important-label-overrides-use-the-documented-path@main).

## Adapt templates and assets {#upgrade-from-2-3-to-3-0-templates}

### Classes and styles {#upgrade-from-2-3-to-3-0-classes}

The templates render speaking classes now, shared by all academic extensions,
and no classes of the theme they were developed with. The extension ships no
stylesheet, so a site that relied on the card, list group and table classes of
a Bootstrap theme styles the new classes itself. Move the selectors of the
site stylesheet to the classes in the table of
[Breaking: B-ITE job templates carry speaking classes](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:breaking-bite-jobs-speaking-frontend-classes@main). The chapter
[Styling](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:styling@main) describes the markup, and [An example](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:styling-example@main) shows rules to
start from.

### Icons {#upgrade-from-2-3-to-3-0-icons}

The content element has a new icon, registered as
`tx-academicbitejobs-plugin-bite-jobs` in [`Configuration/Icons.php`](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ExtensionArchitecture/FileStructure/Configuration/Icons.html#file-extension-configuration-icons-php).
The identifier `bitejobs_list` and the file
`Resources/Public/Icons/jobs_bite_icon.svg` are removed. Replace the
identifier in TCA, page TSconfig and templates, and register a replacement
icon under the new identifier in the [`Configuration/Icons.php`](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ExtensionArchitecture/FileStructure/Configuration/Icons.html#file-extension-configuration-icons-php) of a site
package that depends on **academic_bite_jobs**. See
[Breaking: The content element icon has a new identifier](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:breaking-bite-jobs-plugin-icon-renamed@main).

### Template overrides {#upgrade-from-2-3-to-3-0-overrides}

Versions 2.4 and 3.0 change these templates and partials. A copy of one of them
in a site package keeps rendering the copy, so compare each copy with the
shipped file of 3.0 and take over the changes. The paths below are relative to
`Resources/Private/`:

| File | What changed | Entry |
| --- | --- | --- |
| `Templates/BiteJobs/List.html` | The header renders only with `settings.renderContentElementHeader`, the list is grouped only by the field `settings.jobs.groupBy` names, and the message for an empty list carries a speaking class. | [Important: The job list leaves the content element header to the layout](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:important-1790323401@main), [Important: The job list groups only on request and reads old view values](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:important-1789660801@main), [Classes and styles](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:upgrade-from-2-3-to-3-0-classes@main) |
| `Partials/BiteJobs/View/List.html`, `Partials/BiteJobs/View/Card.html`, `Partials/BiteJobs/View/Table.html` | Speaking classes instead of the card, list group and table classes, and the translations pass the extension name `AcademicBiteJobs`. | [Classes and styles](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:upgrade-from-2-3-to-3-0-classes@main), [Important: Label overrides are read from the documented path](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:important-label-overrides-use-the-documented-path@main) |
| `Partials/BiteJobs/Header.html` | It takes the class of the heading as `class` instead of `positionClass`, and the heading carries `ace-title`. A copy of a view that renders it with `positionClass` renders the heading without that class. | [Classes and styles](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:upgrade-from-2-3-to-3-0-classes@main) |

## Adapt your code {#upgrade-from-2-3-to-3-0-code}

`\FGTCLB\AcademicBiteJobs\Controller\BiteJobsController` is final. A class
that extends it stops loading with a fatal error. Remove the subclass, and the
`configurePlugin()` call or the XCLASS registration that points at it, in
the same deployment as the update, and move each override to an event. The
two events of the job list are new since 2.4, see [Feature: Request and result events for the B-ITE job list](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:feature-1790774401@main):

-   The request to B-ITE: a listener of
    `\FGTCLB\AcademicBiteJobs\Event\ModifyBiteJobPostingsRequestEvent`,
    see [ModifyBiteJobPostingsRequestEvent](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:developers-event-modify-bite-job-postings-request-event@main).
-   The postings it returns: a listener of
    `\FGTCLB\AcademicBiteJobs\Event\ModifyBiteJobPostingsEvent`, see
    [ModifyBiteJobPostingsEvent](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:developers-event-modify-bite-job-postings-event@main).
-   Additional view variables: a listener of
    `\FGTCLB\AcademicBase\Event\ModifyPluginViewEvent`, see
    [Feature: The plugin dispatches the plugin view event](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:feature-plugin-view-event@main) and
    [ModifyPluginViewEvent](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:developers-event-modify-plugin-view-event@main).

See [Breaking: The B-ITE jobs controller is final](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:breaking-1791043409@main).

The FlexForm file moved from `Configuration/FlexForms/Core12/` and
`Configuration/FlexForms/Core13/` to
`Configuration/FlexForms/AcademicBiteJobsList.xml`. Own TCA that names
the data structure of this extension by its path takes over the new one, see
[Important: The FlexForm file moved to Configuration/FlexForms/](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:important-bite-jobs-flexform-file-moved@main).

## Check the result {#upgrade-from-2-3-to-3-0-check}

-   The upgrade check exits with `0`, without and with the extension key,
    see [The upgrade check](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:upgrade-from-2-3-to-3-0-upgrade-check@main).
-   The content element, called **Job List b-ite** now, is offered for
    new content on the pages that should have it, and existing ones keep their
    type. See [Important: Content elements have new titles and descriptions](https://docs.typo3.org/permalink/fgtclb/academic-bite-jobs:important-content-element-titles-and-descriptions@main).
-   Content elements saved with version 2.0 render, and their backend form shows
    the view the frontend renders.
-   Job titles of an ungrouped list moved up one heading level, an
    `<h2>` instead of an `<h3>` for header layout 1. Check the
    styles of the job list, or override `Partials/BiteJobs/Header.html`.
-   The header of the content element appears once.