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.

Requirements

Version 3 requires TYPO3 13.4.35 or TYPO3 14.3.7 at least, and PHP 8.2 or newer.

Updating an existing installation from 2.4 is a sequence of schema update, upgrade wizards, settings migration and template work, and the order of it matters. It is described in Upgrading from 2.4 to 3.0, and the steps of academic_persons in the upgrade chapter of its manual.

Two dependencies are new in this version:

typo3/cms-rte-ckeditor, a system extension. The profile editing frontend loads CKEditor 5 from it for its rich text fields: the rich text module imports six bundles, and Configuration/JavaScriptModules.php maps those six and every bundle they import from each other, twenty-one in all. The map serves every supported patch level, so on TYPO3 13.4.35 and 14.3.7 two of them are never loaded. The system extension has to be installed and active for the bundles to resolve. This extension uses none of its backend rich text configuration, only the shipped JavaScript. Composer resolves it, in a classic installation activate it in the Extension Manager. On TYPO3 13.4.36, 14.3.8 and later the site also links the interface stylesheet of CKEditor 5 from it, see The rich text editor.
typo3/html-sanitizer, a Composer library the TYPO3 core already ships with - not an extension, so there is nothing to activate. Every rich text value is sanitized against an allow list on the server before it is stored, and the extension extends the builder of that package to declare it.

Install the stable release

composer require 'fgtclb/academic-persons-edit':'^3'

Tip

We recommend to pin academic extensions on minor level to mitigate possible issues in projects in case composer update is used based on the fact that projects commonly tends to override fluid templates and changes for otherwise non-breaking changes are possible promoted to be breaking in case template changes are not adopted why it has been considered to mark template changes as breaking changes on minor version updates. That means, we suggest to use for example following command to ensure that we stay in the minor version range but have the hightest patchlevel enforced for it and keep possible bugfix releases for that minor version possible to install:

composer require 'fgtclb/academic-persons-edit':'~3.0.0@dev'

Switch to the module Admin Tools > Extensions.
Switch to Get Extensions.
Search for the extension key academic_persons_edit.
Import the extension from the repository.

Get the current version from TER by downloading the ZIP version. Alternatively, get the ZIP from the GitHub Releases page.
Switch to the module Admin Tools > Extensions.
Enable Upload Extension.
Select or drag the extension ZIP archive and upload the file.