v:iterator.first() * -> v:variable.set(name: 'settings.files')} * * And now the example how to get the first file reference from a fluidpages template, for the flux field * named "settings.files": * * {v:page.resources.fal(field: 'settings.files') * -> v:iterator.first() * -> v:variable.set(name: 'settings.files')} * * ### Usage warning * * Due to [TYPO3 core bug #71239](https://forge.typo3.org/issues/71239), using * FAL references within sections (``) in content elements * or within the page configuration does not work. * * When choosing a file in one section element, you will see it in all sections. * When choosing a file in a page configuration, it will be visible in the subpages * configuration, too. * * This issue will most likely not be fixed before TYPO3 8, so do not use it. * * Alternatively, you could use ``. * * ### Selecting and rendering an image * * #### Selecting a single image * * * * #### Define crop variants * * * * The crop configuration can now be passed to the image viewhelper: * * * * * * * * #### Rendering the image * * {v:content.resources.fal(field: 'settings.image') -> v:iterator.first() -> v:variable.set(name: 'image')} *
* * #### Rendering multiple images * * *
* */ class FalViewHelper extends AbstractInlineFieldViewHelper { public function initializeArguments(): void { parent::initializeArguments(); $this->overrideArgument( 'table', 'string', 'Define foreign table name to turn selector into a record selector for that table', false, Fal::DEFAULT_TABLE ); $this->overrideArgument( 'foreignField', 'string', 'The foreign_field is the field of the child record pointing to the parent record. This defines where to ' . 'store the uid of the parent record.', false, Fal::DEFAULT_FOREIGN_FIELD ); $this->overrideArgument( 'foreignLabel', 'string', "If set, it overrides the label set in TCA[foreign_table]['ctrl']['label'] for the inline-view.", false, Fal::DEFAULT_FOREIGN_LABEL ); $this->overrideArgument( 'foreignSelector', 'string', 'A selector is used to show all possible child records that could be used to create a relation with the ' . 'parent record. It will be rendered as a multi-select-box. On clicking on an item inside the ' . 'selector a new relation is created. The foreign_selector points to a field of the foreign_table that ' . 'is responsible for providing a selector-box – this field on the foreign_table usually has the type ' . '"select" and also has a "foreign_table" defined.', false, Fal::DEFAULT_FOREIGN_SELECTOR ); $this->overrideArgument( 'foreignSortby', 'string', 'Field on the child record (or on the intermediate table) that stores the manual sorting information.', false, Fal::DEFAULT_FOREIGN_SORTBY ); $this->overrideArgument( 'foreignTableField', 'string', 'The field of the child record pointing to the parent record. This defines where to store the table ' . 'name of the parent record. On setting this configuration key together with foreign_field, the child ' . 'record knows what its parent record is - so the child record could also be used on other parent tables.', false, Fal::DEFAULT_FOREIGN_TABLE_FIELD ); $this->overrideArgument( 'localizationMode', 'string', "Set whether children can be localizable ('select') or just inherit from default language ('keep').", false, Fal::DEFAULT_LOCALIZATION_MODE ); $this->overrideArgument( 'newRecordLinkAddTitle', 'boolean', "Add the foreign table's title to the 'Add new' link (ie. 'Add new (sometable)')", false, Fal::DEFAULT_NEW_RECORD_LINK_ADD_TITLE ); $this->overrideArgument( 'useSortable', 'boolean', 'Allow manual sorting of records.', false, Fal::DEFAULT_USE_SORTABLE ); $this->overrideArgument( 'levelLinksPosition', 'string', 'Level links position.', false, Fal::DEFAULT_LEVEL_LINKS_POSITION ); $this->registerArgument( 'allowedExtensions', 'string', 'Allowed File Extensions .', false, $GLOBALS['TYPO3_CONF_VARS']['GFX']['imagefile_ext'] ?? '' ); $this->registerArgument('disallowedExtensions', 'string', 'Disallowed File Extensions .', false, ''); $this->registerArgument( 'createNewRelationLinkTitle', 'string', 'Override label of "Create new relation" button.', false, Fal::DEFAULT_CREATE_NEW_RELATION_LINK_TITLE ); $this->registerArgument( 'cropVariants', 'array', 'Add one or multiple crop variants for uploaded images' ); } public static function getComponent(RenderingContextInterface $renderingContext, iterable $arguments): Fal { /** @var array $arguments */ $allowedExtensions = $arguments['allowedExtensions']; $disallowedExtensions = $arguments['disallowedExtensions']; $createNewRelationLinkTitle = $arguments['createNewRelationLinkTitle']; $cropVariants = $arguments['cropVariants']; /** @var Fal $component */ $component = static::getPreparedComponent(Fal::class, $renderingContext, $arguments); if (!is_array($arguments['foreignMatchFields'])) { $component->setForeignMatchFields([ 'fieldname' => $arguments['name'] ]); } $component->setOverrideChildTca([ 'columns' => [ 'uid_local' => [ 'config' => [ 'appearance' => [ 'elementBrowserType' => 'file', 'elementBrowserAllowed' => $allowedExtensions ] ] ] ] ]); $component->setFilter([[ 'userFunc' => FileExtensionFilter::class . '->filterInlineChildren', 'parameters' => [ 'allowedFileExtensions' => $allowedExtensions, 'disallowedFileExtensions' => $disallowedExtensions ] ]]); if (!isset($arguments['foreignTypes'])) { $component->setForeignTypes([ '0' => [ 'showitem' => '--palette--;LLL:EXT:lang/locallang_tca.xlf:sys_file_reference.' . 'imageoverlayPalette;imageoverlayPalette,--palette--;;filePalette' ], File::FILETYPE_IMAGE => [ 'showitem' => '--palette--;LLL:EXT:lang/locallang_tca.xlf:sys_file_reference.' . 'imageoverlayPalette;imageoverlayPalette,--palette--;;filePalette' ], ]); } if (!empty($cropVariants)) { $component->setCropVariants($cropVariants); } $component->setCreateNewRelationLinkTitle($createNewRelationLinkTitle); return $component; } }