General configuration
Extension configuration There are some options for global extension configuration:
-
- 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. and
profile.. 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/, which the editing forms
read directly.
Consequences worth knowing before reporting a problem:
- A field configured
disabled,readonlyorfrontendreadonlyis 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 ignoresreadonlyon 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.
frontendreadonlylocks 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:
plugin.tx_academicpersonsedit.renderContentElementHeader = 1
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.,
which is mapped from the constant
styles.
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. 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:
return [
'GFX' => [
'imagefile_ext' => 'gif,jpg,jpeg,tif,tiff,bmp,pcx,tga,png,pdf,ai,svg,webp',
],
];
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.
Note
Before version 2.4.0 the partial requested WebP unconditionally, and a
profile with an image failed to render where the list lacked webp. A
partial overridden from that version still does so, see
Important: Profile image keeps its own format where WebP is not allowed.