> For the complete documentation index, see [llms.txt](https://docs.chamilo.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chamilo.org/3.x/fr/guide-dadministration/admin-guide/platform-settings/document-settings.md).

# Documents

Comportement de l’outil **Documents** du cours — téléversements, extensions autorisées, partage et modèles.

Accédez à ces paramètres sous **Administration > Paramètres de configuration > Documents**. Cette catégorie contient **29 paramètres**, listés ci-dessous avec le titre et le commentaire fournis dans les fixtures de paramètres de la plateforme (`SettingsCurrentFixtures.php`).

> Le nom de la variable dans le code est indiqué en monospace. Utilisez-le lors d’un script via l’API ou lorsque vous devez modifier ces paramètres au niveau global en éditant [`config/settings_override.yaml`](https://github.com/chamilo/chamilo-lms/wiki/Configurations#configsettings_overridesyaml).

## Paramètres

### `access_url_specific_files`

**Activer les fichiers spécifiques à l’URL**

Lorsque cette fonctionnalité est activée dans une configuration multi-URL, vous pouvez vous rendre sur l’URL principale et fournir des versions spécifiques à l’URL de n’importe quel fichier (dans l’outil documents). Le fichier d’origine sera remplacé par la version alternative lorsqu’il est consulté depuis une URL différente. Cela vous permet de personnaliser davantage chaque URL, tout en bénéficiant de l’avantage de réutiliser les mêmes cours à plusieurs reprises.

*Par défaut : `false`*

### `default_document_quotum`

**Espace disque dur par défaut**

Quel est l’espace disque disponible pour un cours ? Vous pouvez remplacer le quota pour un cours spécifique via : administration de la plateforme > Cours > modifier

*Par défaut : `1000`*

### `default_group_quotum`

**Espace disque disponible pour les groupes**

Quel est l’espace disque dur par défaut disponible pour l’outil documents d’un groupe ?

*Par défaut : `250`*

### `documents_custom_cloud_link_list`

**Définir une liste stricte d’hôtes pour les liens cloud**

L’outil documents peut intégrer des liens vers des fichiers dans le cloud. La liste des services cloud est limitée à une liste codée en dur, mais vous pouvez définir le tableau « links » qui contiendra une liste de vos propres services/URL. La liste définie ici remplacera la liste par défaut.

### `documents_default_visibility_defined_in_course`

**Visibilité des documents définie dans le cours**

La visibilité par défaut des documents pour tous les cours

*Par défaut : `false`*

### `documents_hide_download_icon`

**Masquer l’icône de téléchargement des documents**

Dans l’outil documents, masquer l’icône de téléchargement pour les utilisateurs.

*Par défaut : `false`*

### `enable_x_sendfile_headers`

**Activer les en-têtes X-sendfile**

Activez cette option si X-sendfile est activé au niveau du serveur web et que vous souhaitez ajouter les en-têtes requis pour que les navigateurs les prennent en compte.

*Par défaut : `false`*

### `group_category_document_access`

**Activer les options de partage pour les documents dans une catégorie de groupe**

Lorsqu’elle est activée, les administrateurs peuvent définir l’accès aux documents et les permissions de partage pour les groupes de documents par catégorie.

*Par défaut : `false`*

### `group_document_access`

**Activer les options de partage pour les documents de groupe**

Lorsqu’elle est activée, le partage des documents et les permissions d’accès peuvent être configurés au niveau du groupe.

*Par défaut : `false`*

### `pdf_export_watermark_by_course`

**Activer la définition du filigrane par cours**

Lorsque cette option est activée, les enseignants peuvent définir leur propre filigrane pour les documents de leurs cours.

*Par défaut : `false`*

### `pdf_export_watermark_enable`

**Activer le filigrane dans l’export PDF**

En activant cette option, vous pouvez téléverser une image ou un texte qui sera automatiquement ajouté comme filigrane à tous les exports PDF de documents sur le système.

*Par défaut : `false`*

### `pdf_export_watermark_text`

**Texte du filigrane PDF**

Ce texte sera ajouté comme filigrane aux exports de documents au format PDF.

### `permanently_remove_deleted_files`

**Les fichiers supprimés ne peuvent pas être restaurés**

La suppression d’un fichier dans l’outil documents le supprime définitivement. Le fichier ne peut pas être restauré

*Par défaut : `false`*

### `permissions_for_new_directories`

**Permissions pour les nouveaux répertoires**

La possibilité de définir les paramètres de permissions à attribuer à chaque répertoire nouvellement créé vous permet d’améliorer la sécurité contre les attaques de pirates téléversant du contenu dangereux sur votre portail. Le paramètre par défaut (0770) devrait suffire à offrir à votre serveur un niveau de protection raisonnable. Le format donné utilise la terminologie UNIX Propriétaire-Groupe-Autres avec les permissions Lecture-Écriture-Exécution.

*Par défaut : `0770`*

### `permissions_for_new_files`

**Permissions pour les nouveaux fichiers**

La possibilité de définir les paramètres de permissions à attribuer à chaque fichier nouvellement créé vous permet d’améliorer la sécurité contre les attaques de pirates téléversant du contenu dangereux sur votre portail. Le paramètre par défaut (0550) devrait suffire à offrir à votre serveur un niveau de protection raisonnable. Le format donné utilise la terminologie UNIX Propriétaire-Groupe-Autres avec les permissions Lecture-Écriture-Exécution. Si vous utilisez Oogie, veillez à ce que l’utilisateur qui lance LibreOffice puisse écrire des fichiers dans le dossier du cours.

*Par défaut : `0660`*

### `send_notification_when_document_added`

**Envoyer une notification aux étudiants lorsqu’un document est ajouté**

Chaque fois que quelqu’un crée un nouvel élément dans l’outil documents, envoyer une notification aux utilisateurs.

*Par défaut : `false`*

### `show_default_folders`

**Afficher dans l’outil Documents tous les dossiers contenant des ressources multimédias fournies par défaut**

Dossiers de fichiers multimédias contenant des fichiers fournis par défaut, organisés en catégories vidéo, audio, image et animations Flash, à utiliser dans les cours. Même si vous les rendez invisibles dans l’outil Documents, vous pouvez toujours utiliser ces ressources dans l’éditeur web de la plateforme.

*Par défaut : `true`*

### `show_documents_preview`

**Afficher l’aperçu des documents**

L’affichage d’aperçus des documents dans l’outil Documents évite de charger une nouvelle page uniquement pour montrer un document, mais peut s’avérer instable avec certains navigateurs plus anciens ou des écrans de faible largeur.

*Par défaut : `false`*

### `show_users_folders`

**Afficher les dossiers des utilisateurs dans l’outil Documents**

Cette option vous permet d’afficher ou de masquer aux enseignants les dossiers que le système génère pour chaque utilisateur qui visite l’outil Documents ou envoie un fichier via l’éditeur web. Si vous affichez ces dossiers aux enseignants, ils pourront les rendre visibles ou non aux apprenants et permettre à chaque apprenant de disposer d’un espace spécifique dans le cours où non seulement stocker des documents, mais aussi créer et modifier des pages web et les exporter en PDF, réaliser des dessins, créer des modèles web personnels, envoyer des fichiers, ainsi que créer, déplacer et supprimer des répertoires et des fichiers et effectuer des copies de sécurité de leurs dossiers. Chaque utilisateur du cours dispose ainsi d’un gestionnaire de documents complet. Rappelez-vous également que tout utilisateur peut copier un fichier visible depuis n’importe quel dossier de l’outil Documents (qu’il en soit ou non le propriétaire) vers son portfolio ou sa zone de documents personnels du réseau social, qui sera alors disponible pour qu’il puisse l’utiliser dans d’autres cours.

*Par défaut : `true`*

### `students_download_folders`

**Autoriser les apprenants à télécharger des répertoires**

Autoriser les apprenants à compresser et télécharger un répertoire complet depuis l’outil Documents

*Par défaut : `true`*

### `students_export2pdf`

**Autoriser les apprenants à exporter des documents web au format PDF dans les outils Documents et Wiki**

Cette fonctionnalité est activée par défaut, mais en cas d’abus entraînant une surcharge du serveur, ou dans des environnements d’apprentissage spécifiques, vous pourriez souhaiter la désactiver pour tous les cours.

*Par défaut : `true`*

### `thematic_pdf_orientation`

**Orientation PDF pour la progression du cours**

Dans l’outil de progression du cours, vous pouvez imprimer un PDF des différents éléments. Définissez « portrait » ou « landscape » (termes techniques) pour la modifier.

*Par défaut : `landscape`*

### `upload_extensions_blacklist`

**Liste noire - paramétrage**

La liste noire sert à filtrer les extensions de fichiers en supprimant (ou en renommant) tout fichier dont l’extension figure dans la liste noire ci-dessous. Les extensions doivent figurer sans le point (.) initial et être séparées par des points-virgules (;) comme suit : exe;com;bat;scr;php. Les fichiers sans extension sont acceptés. La casse (majuscules/minuscules) n’a pas d’importance.

### `upload_extensions_list_type`

**Type de filtrage des téléversements de documents**

Indique si vous souhaitez utiliser le filtrage par liste noire ou par liste blanche. Consultez les descriptions de la liste noire ou de la liste blanche ci-dessous pour plus de détails.

*Par défaut : `blacklist`*

### `upload_extensions_replace_by`

**Extension de remplacement**

Saisissez l’extension que vous souhaitez utiliser pour remplacer les extensions dangereuses détectées par le filtre. Nécessaire uniquement si vous avez choisi un filtre par remplacement.

*Par défaut : `dangerous`*

### `upload_extensions_skip`

**Comportement du filtrage (ignorer/renommer)**

Si vous choisissez d’ignorer, les fichiers filtrés par la liste noire ou la liste blanche ne seront pas téléversés dans le système. Si vous choisissez de les renommer, leur extension sera remplacée par celle définie dans le paramètre d’extension de remplacement. Attention : le renommage ne vous protège pas réellement et peut provoquer des collisions de noms si plusieurs fichiers portent le même nom mais des extensions différentes.

*Par défaut : `true`*

### `upload_extensions_whitelist`

**Liste blanche - paramétrage**

La liste blanche sert à filtrer les extensions de fichiers en supprimant (ou en renommant) tout fichier dont l’extension ne figure *PAS* dans la liste blanche ci-dessous. Elle est généralement considérée comme une approche plus sûre mais plus restrictive du filtrage. Les extensions doivent figurer sans le point (.) initial et être séparées par des points-virgules (;) comme suit : htm;html;txt;doc;xls;ppt;jpg;jpeg;gif;sxw. Les fichiers sans extension sont acceptés. La casse (majuscules/minuscules) n’a pas d’importance.

### `users_copy_files`

**Autoriser les utilisateurs à copier des fichiers d’un cours vers leur espace de fichiers personnel**

Autorise les utilisateurs à copier des fichiers d’un cours vers leur espace de fichiers personnel, visible via le réseau social ou via l’éditeur HTML lorsqu’ils se trouvent hors d’un cours

*Par défaut : `true`*

### `video_features`

**Fonctionnalités vidéo**

Tableau de fonctionnalités supplémentaires que vous pouvez activer pour le lecteur vidéo dans Chamilo. Les options comprennent « speed », qui permet de modifier la vitesse de lecture d’une vidéo.