Dossier des fichiers médias
From Joomla! Documentation
Introduction
Depuis Joomla 5.3, un nouveau dossier racine nommé "files" a été introduit dans le Gestionnaire de médias. Ce dossier est destiné aux fichiers autres que les images, tels que les documents PDF, les fichiers texte, les tableurs, etc. Il permet de séparer proprement les médias visuels (stockés dans images) des fichiers téléchargeables ou joints.
Ce nouveau dossier est pris en charge par l’adaptateur de système de fichiers local par défaut de Joomla.
Pourquoi un nouveau dossier ?
Historiquement, tous les fichiers médias étaient enregistrés dans le dossier images, qu’il s’agisse d’images ou d’autres types de fichiers. Cela pouvait entraîner une certaine confusion et compliquer l’organisation.
Le dossier files permet une séparation claire et logique, en particulier pour les champs personnalisés de type fichier (file) ou média (media), ou encore pour les extensions tierces qui gèrent des fichiers à télécharger.
Fonctionnement
Dans le gestionnaire des médias :
Le dossier files est désormais visible dans le Gestionnaire de médias comme répertoire racine, au même titre que images.
Vous pouvez y télécharger des fichiers, créer des sous-dossiers et les utiliser dans des articles, des champs ou des extensions tierces.
Comportement des champs personnalisés
Les champs personnalisés de type « media » ou « file » utilisent désormais le dossier « files » comme emplacement de stockage par défaut, sauf si un autre chemin est défini manuellement dans la configuration du champ.
Après une mise à jour à partir d'une ancienne version
Si vous mettez à jour un site Joomla existant vers la version 5.3, le dossier « files » sera créé automatiquement, mais sera vide par défaut.
Pour commencer à l'utiliser, suivez les étapes suivantes :
- Dans le composant Media, définissez l'option de Chemin d'accès au dossier des fichiers sur files (Fichiers).
- Allez dans Système → Plugins → Système de fichiers - Local et ajoutez les fichiers à la liste des répertoires autorisés (par défaut, seules les images sont listées).
Cela permet à Joomla de gérer correctement les téléchargements dans le dossier « files ».
Qu’est-ce que l’adaptateur de système de fichiers local ?
Joomla utilise un système d'« adaptateurs » pour définir comment et où les fichiers sont stockés. Par défaut, Joomla utilise l'adaptateur Local FileSystem, qui stocke simplement les fichiers sur le serveur où votre site est hébergé.
D'autres adaptateurs (tels que Amazon S3 ou Dropbox) peuvent être configurés, mais l'adaptateur local est utilisé par la plupart des installations.
Le nouveau dossier « files » est entièrement pris en charge par ce système de stockage local.
Autoriser des types de fichiers supplémentaires
Pour des raisons de sécurité, Joomla n'autorise par défaut que le téléchargement de certains types de fichiers. Si vous souhaitez télécharger des fichiers tels que .zip ou .docx, vous devez autoriser leurs types MIME dans les paramètres médias de Joomla.
Comment configurer
Pour autoriser le téléchargement d'un type de fichier spécifique, vous devez configurer les deux :
son extension de fichier (par exemple docx)
son type MIME (par exemple application/vnd.openxmlformats-officedocument.wordprocessingml.document)
Allez dans Système → Configuration globale → Média
Localisez le champ Legal MIME Types
Ajoutez les types requis. Par exemple :
For .zip: application/zip
For .docx: application/vnd.openxmlformats-officedocument.wordprocessingml.document
Also make sure the file extension is listed in the Legal Document Extensions (File Types).
== Use cases ==
Uploading downloadable documents for users (PDF, DOCX, etc.)
Managing file attachments in custom fields or third-party extensions
Keeping documents separated from visual media assets
== See also ==
Joomla Community Magazine – December 2024: "Document uploads on your Joomla website"
== Feature origin == This improvement was introduced in Joomla 5.3 via Pull Request #43532.