Documentation
Academic Contacts 4 Pages

Academic Contacts 4 Pages 

Extension key

academic_contacts4pages

Package name

fgtclb/academic-contacts4pages

Version

main

Language

en

Author

FGTCLB

License

This document is published under the Creative Commons BY 4.0 license.

Rendered

Mon, 13 Jul 2026 11:19:13 +0000

TYPO3 extension that assigns contact records to pages and displays them in the frontend, for example project managers, research participants or cooperation partners alongside the page content.

Introduction 

What the extension does and the main concepts behind it.

Installation 

Install academic_contacts4pages via Composer, the Extension Manager or a TER upload.

Known problems 

Known issues and information about them.

Changelog 

Learn about what has changed and which actions are required to upgrade.

What does it do? 

...

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.

Install the stable release 
composer require 'fgtclb/academic-contacts4pages':'^2'
Copied!
  1. Switch to the module Admin Tools > Extensions.
  2. Switch to Get Extensions.
  3. Search for the extension key academic_contacts4pages.
  4. Import the extension from the repository.
  1. Get the current version from TER by downloading the ZIP version. Alternatively, get the ZIP from the GitHub Releases page.
  2. Switch to the module Admin Tools > Extensions.
  3. Enable Upload Extension.
  4. Select or drag the extension ZIP archive and upload the file.

Known problems 

Please note that this extension is still in development. Changes to existing code may appear in upcoming versions.

If you run into a bug or a feature that would be helpful, please use the issue tracker.

Breaking: Removed TYPO3 v12 support 

Description 

Support for TYPO3 v12 has been removed for the 3.x version line, based on the dual TYPO3 core version support per major version of the academic extensions support matrix.

This includes removing build, test and configuration parts only required for TYPO3 v12. Version specific code paths are dropped in a dedicated step.

Impact 

TYPO3 v12 or older instances can no longer install or update to the 3.x version of the academic extensions and are required to upgrade TYPO3 first.

The extension cannot be installed on TYPO3 v12 anymore but does not break otherwise.

Affected installations 

All installations using an academic extension on TYPO3 v12 that want to upgrade to the 3.x version line.

Migration 

Upgrade the TYPO3 installation to a supported version (TYPO3 v13) beforehand or within the same upgrade step.

Breaking: Removed duplicated ContractItemsProcFunc in EXT:academic_contacts4pages 

Description 

EXT:academic_contacts4pages shipped its own \FGTCLB\AcademicContacts4pages\Backend\FormEngine\ContractItemsProcFunc, which basically duplicated the contract itemsProcFunc of the hard-depended EXT:academic_persons.

The duplicated class has been removed. The contract selection field now uses the itemsProcFunc shipped by EXT:academic_persons, \FGTCLB\AcademicPersons\Backend\FormEngine\ContractItems, which is easier to maintain, especially when changes to the itemsProcFunc are made.

Impact 

Referencing the removed class throws a PHP error. The shipped TCA of tx_academiccontacts4pages_domain_model_contact has been switched to the EXT:academic_persons handler.

Affected Installations 

Installations that reference \FGTCLB\AcademicContacts4pages\Backend\FormEngine\ContractItemsProcFunc in own TCA/FlexForm configuration, extend or replace it, or call it directly.

Migration 

Use the itemsProcFunc provided by EXT:academic_persons instead:

FGTCLB\AcademicContacts4pages\Backend\FormEngine\ContractItemsProcFunc->itemsProcFunc
=> FGTCLB\AcademicPersons\Backend\FormEngine\ContractItems->itemsProcFunc
Copied!

Projects that need to adjust the available contract items should use the \FGTCLB\AcademicBase\Event\ModifyTcaSelectFieldItemsEvent event listener instead of a custom itemsProcFunc.

Feature: "Show hidden records" plugin option for the contacts list 

Description 

A new boolean plugin option Show hidden records ( settings.showHiddenRecords, checkbox/toggle, default off) was added to the following plugin:

  • Contacts for this page ( academiccontacts4pages_list)

This plugin previously had no flexform at all. A new Configuration/FlexForms/ContactsList.xml data structure is introduced and registered for the plugin (a "Configuration" tab with the pi_flexform field is added to the content element), so the option can be configured per plugin instance.

When the option is enabled, the frontend contacts listing includes hidden (disabled) records, independent of the Context API visibility settings. Only the hidden enable column (disabled) is ignored; the deleted restriction stays in effect.

Impact 

Editors can now opt in per plugin instance to display hidden contacts in the frontend, for example to preview intentionally hidden records without changing the global preview settings. The option is off by default, so existing plugin instances keep their current behaviour.

Affected Installations 

All installations using the EXT:academic_contacts4pages extension starting with version 2.4. No action is required for existing installations.

Important: Extended ContactRepository::findByPid() signature 

Description 

To support the new "Show hidden records" plugin option, the \FGTCLB\AcademicContacts4pages\Domain\Repository\ContactRepository gained an extended method:

  • findByPid(int $pid, bool $showHidden = false): QueryResultInterface — the new optional $showHidden parameter was appended.

When $showHidden is true, the query ignores only the disabled (hidden) enable field via the Extbase query settings. The \FGTCLB\AcademicContacts4pages\Controller\ContactsController reads $this->settings['showHiddenRecords'] and passes it to the repository.

Impact 

The change is non-breaking: the new parameter has a default value, so existing calls keep working unchanged. Projects that extend or replace ContactRepository should adopt the same signature when overriding findByPid().

Affected Installations 

Only installations that extend or override \FGTCLB\AcademicContacts4pages\Domain\Repository\ContactRepository need to take the extended signature into account. All other installations are unaffected.

Breaking: Removed partials 

Description 

Some partials got removed as the templating structure has changed.

Impact 

Those partials include:

  • Resources/Private/Partials/Contacts/ContactWidget.html
  • Resources/Private/Partials/Contacts/ContactWidgetAddress.html

This extension now reuses the partials of the academic-persons extension.

Affected Installations 

EXT:academic_contact4pages installations overriding those partials.

Migration 

Adapt overrides accordingly to the partials provided by EXT:academic-persons.

Important: Basic bootstrap styling 

Description 

The default templating now supports basic bootstrap styling and is semantically optimized to also not lack any major accessibility.

Sitemap