Download the PHP package ichhabrecht/filefill without Composer
On this page you can find all versions of the php package ichhabrecht/filefill. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download ichhabrecht/filefill
More information about ichhabrecht/filefill
Files in ichhabrecht/filefill
Package filefill
Short Description Find and fetch missing local files from different remotes
License GPL-2.0-or-later
Homepage https://github.com/IchHabRecht/filefill
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package filefill
TYPO3 Extension filefill
Find and fetch missing local files from different remotes.
Ever tried to set up a new system as copy from an existing one? Wondered if all the files (in fileadmin) are really needed? Ever run into the problem that a local file was missing?
Filefill fetches missing files from one or multiple remote servers to ensure you have all the files you need for the new system.
Once the configuration is set up, fetching can be triggered by loading a page with missing files in the frontend.
The extension requires the usage of FAL api to fetch missing files. Files are stored directly in the (local) storage folder (e.g. fileadmin). You can re-run filefill at any time by deleting the local files in the storage folder.
Installation
Simply install the extension with Composer or the Extension Manager.
composer require ichhabrecht/filefill
Usage
You need to configure resources for one or more existing file storages.
Prerequisite: Only storages with a "Local filesystem" driver are currently supported.
Resources for file storages can be configured using one of the two following options where the database record configuration is preferred if set. If not set, the TYPO3_CONF_VARS configuration is used.
Database record configuration
- go to the root of your TYPO3 page tree (id=0)
- change to the list module (Web -> List on the left side)
- find the "File Storage" section and edit a record
- change to the tab "File Fill" and select the enable checkbox
- define the resource chain that should be used to fetch missing files
TYPO3_CONF_VARS configuration
-
given a file storage with uid 1, the configuration might look like this
- you don't need to configure resources that you don't want to use
- the ordering in your configuration defines the ordering of processing
Resources
Resources define the places (url / services) where filefill tries to fetch missing files from. You can use multiple resources to build some kind of fallback chain.
Single domain
Fetch missing files from a fixed url.
Configuration:
- Url: Enter a valid url (incl http/https scheme)
You can use multiple single domains within one resources configuration.
Domain records
Fetch missing files from all available site configurations. Filefill runs through all base and variant urls as long as the file can be fetched or all domains are processed.
Configuration:
- no configuration required (the checkbox is just a field placeholder)
There is no need for multiple usage. All domains are used by default.
Placeholder.com
Fetch a missing image from the placeholder.com service. This fetches an image with the correct resolution of the original file.
Configuration:
- no configuration required (the checkbox is just a field placeholder)
There is no need for multiple usage. This resource can be the last one in the chain but can handle image files only.
Image builder
Create an empty image with the correct resolution of the original file. The height and width is added as a text layer.
Configuration:
- Background color: Enter a valid hex code as background color
- Text color: Enter a valid hex code as text color
Static file
Ensure missing files will be available. By default, an empty file will be created.
Configuration:
- You can configure the content of a file by its path or extension
Please use TypoScript syntax for record configuration.
Additional resources
You can add own resource handlers to fetch files from additional services.
Registration
- title: name of the resource that is taken as backend (flex) button label
- handler: name of the class that handels the actual implementation
- config: TCA configuration for the backend (flex) field
Handler
The handler needs to implement the interface \IchHabRecht\Filefill\Resource\RemoteResourceInterface and therefore has to
add both functions hasFile and getFile.
Debugging
You can enable additional log information by configuring a filefill logger.
Known issues
1509741907 TYPO3Fluid\Fluid\Core\ViewHelper\Exception
Folder "[...]" does not exist.
Filefill tries to fetch the existing file from any resource. However, due to the FAL api the exception cannot be prevented nor handled by filefill. Try to reload the page again, the exception (for this specific file) should not occur anymore. Please note that there might be a new exception for a new file. In this case you need to reload your page until all files were properly created on your current system.
Community
- Thanks to b13 that sponsored the maintenance of this extension with a sponsorship
- Thanks to Wolfgang Wagner who sponsored the maintenance of this extension with a sponsorship
- Thanks to Marcus Schwemer who wrote about filefill in his blog TYPO3worx
- Thanks to Thomas Löffler for his ongoing support as Patron
