---
title: "For integrators"
manual: "Academic Profiles"
version: "3.0"
permalink: "https://docs.typo3.org/permalink/fgtclb/academic-persons:integrator@3.0"
source: "Integrator/Index.rst"
rendered: "2026-10-26T17:55:22+00:00"
---

# For integrators {#integrator}

This extension ships six content elements. All six are driven by one Extbase
plugin, so they share the TypoScript block
`plugin.tx_academicpersons` and the site settings of the set
`fgtclb/academic-persons`, see [Configuration](https://docs.typo3.org/permalink/fgtclb/academic-persons:configuration@3.0). What differs per element
is its plugin options: the fields an editor fills in on the tab
**Configuration** of the content element. This chapter describes them,
one page per content element, and what each value does in the frontend.

Which of the elements the backend offers is decided by the sets or the page
TSconfig a site includes, see [What the sets contain](https://docs.typo3.org/permalink/fgtclb/academic-persons:configuration-components@3.0).

## Plugin options and site settings {#integrator-flexform-and-settings}

A plugin option the editor saved wins over the site setting or the TypoScript
setting of the same name, and that includes an empty value: a field that was
saved empty replaces the default of the site. A site setting such as
**Group by** or **Sort by** therefore only reaches a content
element whose stored options lack the key: one saved before the field existed,
one whose form hides the field through page TSconfig, or one written without
the backend form, by an import for example. An element that leaves
**Group By** out that way is grouped by the first letter of the last
name, the default of the site setting.

Six options are the exception. While they are empty, the value of the site
applies:

| Option | While it is empty |
| --- | --- |
| **Detail Page** | The site setting `plugin.tx_academicpersons.detailPid`, `0` by default, which links to the page of the element. |
| **Link the names to the detail view** | The site setting `plugin.tx_academicpersons.detailLink`, see [Names without a detail link](https://docs.typo3.org/permalink/fgtclb/academic-persons:configuration-detail-link@3.0). |
| **PageTitle display format** | `plugin.tx_academicpersons.settings.pageTitleFormat` when a site sets it in TypoScript. None is shipped, so the built-in format applies. |
| **Show only selected Fields** | `plugin.tx_academicpersons.settings.showFields` when a site sets it in TypoScript, a comma separated list of the field values. None is shipped, so the shipped selection of fields is shown, see [Show only selected Fields](https://docs.typo3.org/permalink/fgtclb/academic-persons:confval-person-list-show-fields@3.0). |
| **Results per Page**, also while it is `0` | The site setting `plugin.tx_academicpersons.pagination.resultsPerPage`, `10` by default, see [Results per Page](https://docs.typo3.org/permalink/fgtclb/academic-persons:confval-person-list-results-per-page@3.0). |
| **Number of Links**, also while it is `0` | The site setting `plugin.tx_academicpersons.pagination.numberOfLinks`, `5` by default, see [Number of Links](https://docs.typo3.org/permalink/fgtclb/academic-persons:confval-person-list-number-of-links@3.0). |

## The content elements {#integrator-content-elements}

| Icon | Content element | CType | What it shows |
| --- | --- | --- | --- |
| ![Icon of the profile list](../Images/Icons/persons.svg) | [Person List](https://docs.typo3.org/permalink/fgtclb/academic-persons:integrator-person-list@3.0) | `academicpersons_list` | A directory of profiles, with grouping, letter navigation, pagination, visitor filters and view modes. The names link to a detail page. |
| ![Icon of the profile list and detail](../Images/Icons/persons.svg) | [Person List and Details](https://docs.typo3.org/permalink/fgtclb/academic-persons:integrator-person-list-and-details@3.0) | `academicpersons_listanddetail` | The same directory, and the profile a visitor opens from it on the same page. |
| ![Icon of the profile detail](../Images/Icons/persons.svg) | [Person Details](https://docs.typo3.org/permalink/fgtclb/academic-persons:integrator-person-details@3.0) | `academicpersons_detail` | The public profile of one person, on the detail page the other elements link to. |
| ![Icon of the contact card](../Images/Icons/card.svg) | [Person Contact Card](https://docs.typo3.org/permalink/fgtclb/academic-persons:integrator-person-contact-card@3.0) | `academicpersons_card` | Contact cards of a few profiles an editor picks, for a sidebar or a contact box. |
| ![Icon of the selected profiles](../Images/Icons/selected-profiles.svg) | [Selected Person’s Profiles](https://docs.typo3.org/permalink/fgtclb/academic-persons:integrator-selected-profiles@3.0) | `academicpersons_selectedprofiles` | Profiles an editor picks, as tiles or a table, with their contracts. |
| ![Icon of the selected contracts](../Images/Icons/selected-profiles.svg) | [Selected Person’s Contracts](https://docs.typo3.org/permalink/fgtclb/academic-persons:integrator-selected-contracts@3.0) | `academicpersons_selectedcontracts` | Contracts an editor picks, one item per contract, for a person who should appear in one role only. |

The elements share their templates and partials, see [Templates](https://docs.typo3.org/permalink/fgtclb/academic-persons:templates@3.0), and
the classes of their markup, see [Styling](https://docs.typo3.org/permalink/fgtclb/academic-persons:styling@3.0).