---
title: "Installation"
manual: "Academic Profiles Edit"
version: "3.0"
permalink: "https://docs.typo3.org/permalink/fgtclb/academic-persons-edit:installation@3.0"
source: "Installation/Index.rst"
rendered: "2026-10-26T17:55:31+00:00"
---

# Installation {#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 {#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](https://docs.typo3.org/permalink/fgtclb/academic-persons-edit:upgrade-from-2-4-to-3-0@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](https://docs.typo3.org/permalink/fgtclb/academic-persons-edit:styling-rich-text-editor@3.0).
-   `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.

**Composer**

**Install the stable release**

```bash
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:
>
> ```bash
> composer require 'fgtclb/academic-persons-edit':'~3.0.0@dev'
> ```

**Extension Manager**

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

**Upload ZIP (TER)**

1.  Get the current version from [TER](https://extensions.typo3.org/extension/academic_persons_edit) by downloading the ZIP version.
    Alternatively, get the ZIP from the [GitHub Releases](https://github.com/fgtclb/academic-persons-edit/releases) page.
1.  Switch to the module **Admin Tools > Extensions**.
1.  Enable **Upload Extension**.
1.  Select or drag the extension ZIP archive and upload the file.