General configuration 

Extension configuration There are some options for global extension configuration:

profile.allowedLanguages
type

string

Default
 

A comma-separated list of language IDs. These IDs configure in which languages a persons profile can be translated by a frontend user.

Deprecated: automatic profile creation 

The extension configuration still lists profile.autoCreateProfiles and profile.createProfileForUserGroups. Both have no effect. The profile creation moved to academic_persons in version 2.1, together with these two options, so that it works without this extension. Set them in the extension configuration of academic_persons instead, where its manual describes them under Configuration > General configuration.

The upgrade wizard Migrate profile auto create options from "EXT:academic_persons_edit" to "EXT:academic_persons" copies a value set here over to academic_persons, as long as the option there still has its default.

Which fields can be edited 

Which profile fields the editing forms offer, which are mandatory and which are locked is not configured in this extension. It comes from the validation settings shipped by academic_persons, in Configuration/AcademicPersons/Settings.yaml, which the editing forms read directly.

Consequences worth knowing before reporting a problem:

  • A field configured disabled , readonly or frontendreadonly is rendered locked, and a value submitted for it anyway is discarded rather than stored. This is deliberate and protects already stored data. A select or checkbox stays operable in the browser, which ignores readonly on those controls, but a changed value is discarded the same way.
  • First name, Middle name and Last name are locked by default, because profile names are usually owned by the connected frontend user record and synchronised from elsewhere. They are therefore not editable in the frontend form — and, since the same configuration also drives the backend, not in the TYPO3 record editor either.
  • Because both editing contexts share one configuration, unlocking a field for the frontend form also unlocks it in the backend. frontendreadonly locks a field for the frontend form only and keeps it editable in the record editor.

See Validation settings in the academic_persons manual for the available flags, the shipped defaults and how to override them.

The header of the content element 

The header and the subheader an editor enters on a Profiles: Profile Editing content element are rendered by the content element layout of the site, as for any other content element. The layouts of EXT:fluid_styled_content and of the bootstrap package do that, and the plugin renders no header of its own.

A site whose content element layout renders no header, because its element templates render it instead, lets the plugin render it on every one of its views:

TypoScript constants
plugin.tx_academicpersonsedit.renderContentElementHeader = 1
Copied!

The layout of the plugin then renders the header partial of EXT:fluid_styled_content above the view, so the switch needs that extension installed. This extension does not require it. Do not switch it on where the content element layout renders the header: the header then appears twice.

For the header layout Default, the partial takes the heading level from plugin.tx_academicpersonsedit.settings.defaultHeaderType , which is mapped from the constant styles.content.defaultHeaderType of EXT:fluid_styled_content. A site that does not include the TypoScript of EXT:fluid_styled_content sets the setting itself. Without it, such a header renders as an empty <header> element.

Image processing: WebP where allowed 

The profile detail view of the profile editing plugin renders the profile image as WebP when the installation allows TYPO3 to produce that format, that is when webp is listed in $GLOBALS['TYPO3_CONF_VARS']['GFX']['imagefile_ext'] . Otherwise it renders the image in its own format, or as PNG for a format a browser cannot show, which is what TYPO3 does for any processed image without a file extension given.

On TYPO3 v13 webp is part of the default value of that list.

On TYPO3 v12 it is not, so the image is rendered without WebP unless the installation adds it, either in Admin Tools > Settings > Configure Installation-Wide Options > [GFX][imagefile_ext] or in config/system/settings.php:

config/system/settings.php
return [
    'GFX' => [
        'imagefile_ext' => 'gif,jpg,jpeg,tif,tiff,bmp,pcx,tga,png,pdf,ai,svg,webp',
    ],
];
Copied!

Adding the extension to that list only permits the format. Whether the images can actually be produced depends on the configured image processor - GraphicsMagick or ImageMagick have to be built with WebP support.