Skip to main content

Selecting a Content Type

When the New Content Element wizard is opened, each Flux Content Element is presented as a separate content type. Selecting one determines both the backend form used to edit the record and the Fluid template used to render it.

The technical content type is generated from the provider extension and the Flux Form identifier. Editors should not need to know that identifier; they choose the element from its title, description, icon and wizard group. These editor-facing values should describe the purpose of the element rather than its visual appearance alone. A name such as Feature list is normally more useful than Three blue columns, since the presentation may change while the purpose remains the same.

TYPO3 may allow the type of an existing record to be changed. This should be done with some care for Flux Content Elements. The new type can define an entirely different set of fields and Flux does not automatically translate old field values into the new structure. Values which are not used by the new form may remain stored in the record even though they are no longer visible to the editor.

Changing the type is useful when one element is a compatible replacement for another. If the two elements represent different kinds of content, creating a new record and copying the relevant values is usually clearer and less surprising.

If the desired type is missing, first check that the template is registered and that its Configuration section contains a unique Flux Form id. Then verify the backend user's permissions and clear TYPO3's system caches. An element which is not available in the wizard cannot be selected for new records, even if its Fluid template exists on disk.

Note: Keep identifiers stable once an element has been used on a site. The label, description and icon can be changed to improve the editor experience without changing the stored content type.