Upgrading from 2.3 to 2.4 

Version 2.4 of this extension changes no configuration, no database column and no API. The upgrade is the package update, made together with the extensions it depends on. Work through the sections in order. Skip a step that does not apply to the installation.

Before you start 

Version 2.4 runs on TYPO3 12.4 from 12.4.22 on and on TYPO3 13.4, with PHP 8.1 or later. That is the same as for 2.3, so the TYPO3 core does not have to change for this upgrade.

academic_persons_sync 2.4 declares no new dependency of its own. It needs these packages. Upgrade them first or in the same deployment, in this order, as their own upgrade chapters describe:

Update the package 

composer require -W \
    'fgtclb/academic-base':'~2.4.0' \
    'fgtclb/academic-persons':'~2.4.0' \
    'fgtclb/academic-persons-edit':'~2.4.0' \
    'fgtclb/academic-persons-sync':'~2.4.0'
Copied!

A project that requires branch 2 as 2.x-dev keeps an inline alias such as 2.x-dev as 2.4.x-dev working, see Important: The development branch installs as 2.4.x-dev.

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

vendor/bin/typo3 cache:flush
Copied!

Check the result 

  • Open a frontend user of the type Academic Persons: External User. The tab with the assigned profiles is labelled Profiles. Version 2.3 read its label from a file that does not exist, so the tab had no label.