numero2/contao-proper-filenames

Replaces special characters in filenames right after upload

v2.2.1 2025-01-20 08:02 UTC

Requires

• php: >=8.0
• contao/core-bundle: ^4.13 || ^5.0

Requires (Dev)

• contao/manager-plugin: ^2.0

Conflicts

• contao/core: *
• contao/manager-plugin: <2.0 || >=3.0

LGPL-3.0-or-later

• numero2 - Agentur für digitales Marketing GbR

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.