TYPO3 Connect (FAL)
For the most up-to-date documentation, please visit docs.brix.ch
celum_connect_fal is a Typo3 FAL (file abstraction layer) implementation which allows to browse the files stored in Celum directly in Typo3.
- Rest-API (CORA) v3.2 or higher has to be installed.
- Either all assets intended for the usage in Typo3 need a public URL or the direct download plugin has to be installed in Celum as it is the fallback.
The extension can be installed either though composer or through the backend:
Through the backend
- Login into the Typo3 backend as an administrator
- Go to ADMIN TOOLS and select Extensions
- From the store: Select get extensions, search for celum:connect (FAL) and install it
- Manual installation: Click on Upload Extension and upload the celum_connect_fal.zip file or choose Get Extension in the dropdown, search the «celum:connect» Extension in the repository and click on Import and Install
- Activate the extension in the extension overview
- Go to WEB and select List
- Scroll down to File Storage and add a new entry
- Select celum:connect (FAL) and enter a name, e.g. Celum
- Specify license key (obtained through brix)
- Enter the Celum API key for CORA
- Choose the locale in which the folders will be displayed, e.g. de
- Specify a default locale (used when the name isn't available in the language chosen above), e.g. en
- List your root node Ids as comma separated list (all those nodes and their children (recursive) will be shown in your celum drive)
- Add your directDownload secret, if your directDownload plugin is using this feature (recommended)
- Enter the provider and description of the public URL for images and videos (not required, fallback is direct download), e.g.
- Specify a writable folder for manipulated and temporary files, e.g.
- Go to Access capabilities and uncheck Is writable?
- Save your configuration
- Go to FILE Filelist and you should see your Celum drive
The folder for manipulated and temporary files is required by Typo3 FAL but will not be visible.
1:_processed_ should always work. The storage 1 is the file storage which is automatically created by Typo3. _processed_ is the identifier of the processed folder in any storage.
Same as the File Storage.
4. Known Issues
- Original file size and not the one of the actual file is displayed (depends on public url and download format)
- Same for the file extension, creation date and modification date
- On Windows installations TYPO3 may convert the filenames internally to lower case which leads to them not being found in CELUM (no thumbnails, no editing possible), so this has to be corrected in TYPO3
|TYPO3 Connect (FAL)
|1.0 and above
||5.13.3 and above
||8.7.0 and above
|1.1.4 and above
||5.13.4 and above (tested with 6.4)
||8.7.0 and above
Attention: public urls provider cannot have a space or CORA fails (tested with REST 5.0, bug reported)
Initial version of the CELUM FAL driver
Fixed size of image in the info view for version 9+ (scale to max 1024px as we cannot know what the download size will be, only the size of the original is known) and no more floating point pixel values.
Increased security by adding the new secret feature of the directDownload plugin.
Linux path fix. On Linux systems Typo3 sometimes requests the "//" or "" folder when it wants to get the root "/" which lead to errors on previous versions.
Add file extension to name, otherwise the thumbnail isn't displayed in the backend. Read width and height from the cache in the extractor, so that the image is editable in the backend.
Switched to guzzle. Better bug fix for invalid identifiers.
Several improvements, tested and working version for composer, configurable download format. Removed file logger for productive environment (standard error logger still active).
Bug fix, Typo3 is creating driver instances before the configuration is entered leading to an "invalid license" error.
Bug fix in public URLs.
© brix IT Solutions