For integrators

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. 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.

Plugin options and site 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.
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.

The content elements

Content element	CType	What it shows
Person List	`academicpersons_list`	A directory of profiles, with grouping, letter navigation, pagination, visitor filters and view modes. The names link to a detail page.
Person List and Details	`academicpersons_listanddetail`	The same directory, and the profile a visitor opens from it on the same page.
Person Details	`academicpersons_detail`	The public profile of one person, on the detail page the other elements link to.
Person Contact Card	`academicpersons_card`	Contact cards of a few profiles an editor picks, for a sidebar or a contact box.
Selected Person’s Profiles	`academicpersons_selectedprofiles`	Profiles an editor picks, as tiles or a table, with their contracts.
Selected Person’s Contracts	`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, and the classes of their markup, see Styling.