Allow to implement custom templates working with files, e.g. providing a thumbnail, link to full file, etc.
2.1 KiB
TYPO3 Extension Form File Collection
Adds new EXT:form element used to render a file collection allowing the visitor to choose files.
Concept
The form element will fetch the configured file collection and assign proper options based on the contained files. That allows using existing templates that allow to select a single or multiple options.
EXT:form integration
The provided Configuration needs to be loaded via TypoScript. Use a free identifier:
plugin.tx_form.settings.yamlConfigurations {
80 = EXT:form_file_collection/Configuration/Form/Setup.yaml
}
No template is configured by default, choose one of the existing ones or provide your own:
TYPO3:
CMS:
Form:
prototypes:
standard:
formElementsDefinition:
FileCollection:
renderingOptions:
# Allows to switch between different rendering like "Checkbox", "MultiCheckbox" or "RadioButton", etc.
templateName: 'MultiCheckbox'
The existing templates will work out of the box. An additional variable files is added for usage within custom templates.
This will register a new form element type
FileCollection
that can be used like this:
-
type: FileCollection
identifier: file-collection-1
label: 'File Collection'
properties:
fileCollection:
# UID of the sys_file_collection to use
uid: 1
# Optional, default is identifier
# Defines the property to use as value for form element.
valueProperty: 'identifier'
# Optional, default is identifier
# Defines the property to use as label for form element.
labelProperty: 'identifier'
The two options valueProperty and labelProperty are used to prepare the options variable used by the available default templates.
Example
A concrete example can be found within
Tests/Fixtures/form_file_collection_example
.