Les fichiers de contenus (assets) de l'application sont nécessaires pour l'affichage et plus généralement, aux fonctions de l'interface.
De trois types principaux, ils sont placés dans /assets/
:
- les fichiers de styles dans css/
et css/vendor/<theme>
- les fichiers javascript de l'interface dans js/
- les fichiers envoyés par les utilisateurs, généralement par les éditeurs, dans uploads/
(ce sont les icônes, les images des contenus et d'autres médias de l'application et des contenus d'un site)
Fichiers Javascript
Les fichiers javascript sont communs à tous les sites et thèmes d'une installation (y compris dans le cas d'une installation multisites.) En principe, vous n'aurez jamais à y toucher (ils sont nécessaires au bon fonctionnement de l'application).
Feuilles de style
Les fichiers css comprennent :
- les feuilles de styles communes à tous les sites/thèmes d'une installation (placés dans
assets/css/template.css
) et
- les fichiers de styles locaux qui dépendent du thème chargé par l'utilisateur (dans
assets/css/vendors/<theme>/
; ce sont notamment le fichier
local.css
d'un thème et éventuellement un ficher
content.css
personnalisé (qui contient les styles de la page d'accueil).
Fichiers envoyés par les utilisateurs/éditeurs
Les fichiers envoyés par les utilisateurs sont placés dans des dossiers correpondant à leur type, distincts pour chaque site configuré (dans le cas d'une installation multisites) :
assets/uploads/<ENVIRONNEMENT DU SITE>
, avec les sous-dossiers suivants :
carriers : icônes des produits des transporteurs (sites ecommerce seulement)
icons : icônes des collections et des contenus
logos : logos utlisés par les différents thèmes et sites de l'application
qrcodes : qrcodes générés par l'application
editors : fichiers spéciaux des éditeurs
avatars : icônes des utilisateurs de l'application
files : fichiers médias des contenus
ui : fichiers spéciaux de l'interface utilisateurs (dans le cas d'une application modifiée)
.thumbs et thumbs : fichiers des vignettes générées par l'application
Veuillez noter que les dossiers .thumbs et thumbs (autogénérés par l'application) sont distincts et tous deux nécessaires au fonctionnement de l'application (ils contiennent respectivement les vignettes utilisées par le gestionnaire de fichiers et celles utilisées dans l'application elle-même).
Du point de vue de l'utilisateur, le principal de ces dossiers est le dossier icons (généralement le plus utilisé).
Notez que les fichiers attachés aux collections et aux contenus sont eux-mêmes considérés comme des contenus. Pour cette raison, ils se trouvent dans un dossier séparé dont l'emplacement est configurable dans
/application/config/site.php
: le dossier
/files/