Manage files and folders

This article is machine translated.

The file manager displays the directory structure in a hierarchical tree. Each subfolder is a separate node that you can expand and collapse with the Plus symbol plus and Minus symbol minus symbol. Within each subfolder, the files contained therein are listed. If they are pictures, a preview is automatically displayed. If you have a large number of pictures, you can disable the preview in your user profile to speed up the page loading.

The navigation icons

Navigation is done like everywhere else in Contao using navigation icons. The options are different for folders and files.

The file management

Edit file or directory Edit: Opens an input mask for renaming a file or folder. You can also add metadata of files in the appropriate language or publish folders or exclude them before synchronization.

Duplicate file or directory Duplicate: Copies a file or folder.

Move file or directory Move: Moves a file or folder.

Delete file or directory Delete: Deletes a file or folder.

Show details of the file or folder information: Show details of the file or folder.

Upload files to the folder Upload: Upload files to the folder.

Edit file Edit file: Opens a form to edit the contents of a file with a text editor. Which files may be edited can and be defined in the configuration file config/config.yml under the key editable_files 1.

1Until version 4.6 of Contao, this could be set in the system settings under “Files and Images-> Editable files”.

Move file or directory Move: Move a file or folder using drag and drop.

Transfer files

Go to the File Manager and click the Upload files to the server File Upload link to transfer files to the server. Use the navigation icon Add to the folder Insertin to select the destination directory. Alternatively, you can click the navigation icon Upload files to the server directly at the desired folder.

You can also activate DropZone in the user settings.

Transferring files

In both cases, the file manager checks the size of the file to be transferred during upload, and - if it is an image - also its dimensions. By default, files up to 2 MB and images up to 3000x3000 pixels are accepted. If a file is too large or an image is too wide or too high, Contao automatically refuses the upload or reduces the image to the maximum allowed dimensions.

Note that you can only upload the file types that you have specified in the back end settings under “Allowed upload file types”.

Transfer files via FTP

Contao can process files that have been transferred to the server with the file manager as well as files or folders that you have uploaded with an FTP program. To make sure that the resources are stored in the database-driven file system of Contao, you have to click on the Synchronize file system and database Synchronize link.

When uploading via FTP, there is a small restriction: The file names should not contain special characters. Many servers or FTP programs use a different character encoding than Contao internally, so there may be problems when uploading files with special characters in the file name. Therefore, you should not name your files like this:

Wies'n-Festzug München (Sonnenstraße).jpg

Hend'l + Maß im Schützenfestzelt.jpg

For the Web, it is generally better to avoid using special characters in file names altogether. This avoids possible compatibility problems as well as unsightly encoded URLs and cryptic file names. The following names are optimal:

Wiesn-Festzug-Muenchen-Sonnenstrasse.jpg

Hendl-und-Mass-im-Schuetzenfestzelt.jpg

When uploading files via the file manager, Contao checks the file names and adjusts them automatically if necessary to avoid problems with incorrectly encoded special characters in the name.