---
title: "For integrators"
manual: "Academic Profiles"
version: "main"
permalink: "https://docs.typo3.org/permalink/fgtclb/academic-persons:integrator@main"
source: "Integrator/Index.rst"
rendered: "2026-10-15T10:24:29+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@main). 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@main).

## 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**, **Sort by** or **Pagination | Results
per page** 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.

Four 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@main). |
| **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@main). |

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

| Icon | Content element | CType | What it shows |
| --- | --- | --- | --- |
| <!-- TODO: no Markdown rendering for "Directive" --> | [Person List](https://docs.typo3.org/permalink/fgtclb/academic-persons:integrator-person-list@main) | `academicpersons_list` | A directory of profiles, with grouping, letter navigation, pagination, visitor filters and view modes. The names link to a detail page. |
| <!-- TODO: no Markdown rendering for "Directive" --> | [Person List and Details](https://docs.typo3.org/permalink/fgtclb/academic-persons:integrator-person-list-and-details@main) | `academicpersons_listanddetail` | The same directory, and the profile a visitor opens from it on the same page. |
| <!-- TODO: no Markdown rendering for "Directive" --> | [Person Details](https://docs.typo3.org/permalink/fgtclb/academic-persons:integrator-person-details@main) | `academicpersons_detail` | The public profile of one person, on the detail page the other elements link to. |
| <!-- TODO: no Markdown rendering for "Directive" --> | [Person Contact Card](https://docs.typo3.org/permalink/fgtclb/academic-persons:integrator-person-contact-card@main) | `academicpersons_card` | Contact cards of a few profiles an editor picks, for a sidebar or a contact box. |
| <!-- TODO: no Markdown rendering for "Directive" --> | [Selected Person’s Profiles](https://docs.typo3.org/permalink/fgtclb/academic-persons:integrator-selected-profiles@main) | `academicpersons_selectedprofiles` | Profiles an editor picks, as tiles or a table, with their contracts. |
| <!-- TODO: no Markdown rendering for "Directive" --> | [Selected Person’s Contracts](https://docs.typo3.org/permalink/fgtclb/academic-persons:integrator-selected-contracts@main) | `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@main), and
the classes of their markup, see [Styling](https://docs.typo3.org/permalink/fgtclb/academic-persons:styling@main).