---
title: "Installation"
manual: "Academic Contacts for Pages"
version: "2.4"
permalink: "https://docs.typo3.org/permalink/fgtclb/academic-contacts4pages:installation@2.4"
source: "Installation/Index.rst"
rendered: "2026-10-26T16:43:59+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.

**Composer**

**Install the stable release**

```bash
composer require 'fgtclb/academic-contacts4pages':'^2'
```

> [!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-contacts4pages':'~2.4.0@dev'
> ```

**Extension Manager**

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

**Upload ZIP (TER)**

1.  Get the current version from [TER](https://extensions.typo3.org/extension/academic_contacts4pages) by downloading the ZIP version.
    Alternatively, get the ZIP from the [GitHub Releases](https://github.com/fgtclb/academic-contact4pages/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.

## Upgrading from version 1.x {#installation-upgrade-from-version-1}

Version 1.x stored its plugin content elements under a content element type
that 2.0.0 renamed. Run the upgrade wizard
`academicContacts4pages_pluginUpgradeWizard` after the update, in
**Admin Tools > Upgrade > Upgrade Wizard** or on the command line:

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

It also gives every backend user group that was allowed the old type the
permission for the new one. It is offered while a content element of version
1.x or a group with the old permission is left, also where the wizard an
earlier 2.x release shipped for this purpose is marked as done. See
[Important: A new upgrade wizard migrates the plugins of version 1.x](https://docs.typo3.org/permalink/fgtclb/academic-contacts4pages:important-ace-897-academic-contacts4pages@2.4).