README

About

Sanitizes the filenames of files uploaded via the Contao file manager or Contao form. Read more

System requirements

• Contao 4.13 or newer

Installation & Configuration

• Install via Contao Manager or Composer (composer require numero2/contao-proper-filenames)
• In the Backend go to System Settings and click Check filenames under Upload settings
• Configure how the filenames should be renamed by choosing an option from Valid filename characters

Commands

Recursively sanitize all files and folders in a given directory.

contao-console contao:proper-filenames:sanitize myfolder -r

The extension only analyzes files that are stored in Contao's DBAFS (tl_files). The DBAFS should be synchronized before the call - either via the File manager in the Backend or with the following console call:

contao-console contao:filesync

To get a preview of how everything will be renamed there is also a --dry-run flag. For all available flags and options see the help using contao-console contao:proper-filenames:sanitize --help.