https://github.com/numero2/contao-proper-filenames

Replaces special characters in filenames right after upload.
https://github.com/numero2/contao-proper-filenames

contao4 contao5

Last synced: 3 months ago
JSON representation

Replaces special characters in filenames right after upload.

• Host: GitHub
• URL: https://github.com/numero2/contao-proper-filenames
• Owner: numero2
• License: lgpl-3.0
• Created: 2015-09-21T07:31:42.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2025-01-20T08:03:17.000Z (4 months ago)
• Last Synced: 2025-01-28T13:54:50.890Z (3 months ago)
• Topics: contao4, contao5
• Language: PHP
• Homepage: https://www.numero2.de/contao/erweiterungen/proper-filenames.html
• Size: 77.1 KB
• Stars: 14
• Watchers: 6
• Forks: 5
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-contao - proper-filenames - Replaces special characters in filenames right after upload. (Extensions / English)

README

        
Contao Proper Filenames

=======================

[![](https://img.shields.io/packagist/v/numero2/contao-proper-filenames.svg?style=flat-square)](https://packagist.org/packages/numero2/contao-proper-filenames) [![](https://img.shields.io/badge/License-LGPL%20v3-blue.svg?style=flat-square)](http://www.gnu.org/licenses/lgpl-3.0)

About

--

Sanitizes the filenames of files uploaded via the Contao file manager or Contao form. [Read more](https://www.numero2.de/contao/erweiterungen/proper-filenames.html)

System requirements

--

* [Contao 4.13 or newer](https://github.com/contao/contao)

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.

```sh

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:

```sh

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`.