File Manager

De Wiki.


Cette fonctionnalité FM active le gestionnaire de fichiers (avec en option un accès FTP en mode web).

Deux objets sont utilisés :

  • cms_filemanager : les différentes instances de gestionnaire de fichier. Usuellement un par mini-site. Définit à quelle adresse publique les fichiers seront partagés en HTTP et surtout avec quel compte FTP le moteur FTP web tournera-t-il.
  • cms_filemanageruser : les comptes utilisateurs pour la consultation en lecture HTTP des fichiers.

Sommaire

Activation

La déclaration d'un objet cms_filemanager sur un site comportant la fonctionnalité FM suffit à activer les menus et accès.

Valeurs typiques :

  • nom : nom figurant dans les menus
  • cms_site : le minisite portant l'instance de file manager
  • login : le login du compte FTP déclaré pour ce file manager (option nécessaire pour activer l'uploader FTP en Java)
  • passwd : le mot de passe (en clair) du compte FTP déclaré pour ce file manager (option nécessaire pour activer l'uploader FTP en Java)
  • url : complément de chemin d'accès pour l'interface frontoffice (concaténé à /content/repduminisite/), par défaut /

Emplacements des fichiers

Les fichiers d'un gestionnaire sont stockés dans :

/custom/filemanager/nomduminisite/

Un sous-répertoire files stocke les fichiers échangés. Un autre, skin stocke les fichiers d'interface graphique des pages de consultation HTTP.

Interface web de gestion des fichiers

Les fichiers du filemanager sont les suivants :

/backoffice/cms/filemanager/

Le fichier globals.php situé dans ce répertoire gère les chemins d'accès et les mises en session des variables nécessaires.

FTP en mode web

Pour activer l'Applet Java de transfert FTP, permettant l'envoi de fichiers sans limite de taille, un compte utilisateur FTP doit être créé sur le serveur, et ses coordonnées saisies dans l'objet cms_filemanager. Le home directory de cet utilisateur devra impérativement être :

/custom/filemanager/nomduminisite/files

Consultation

Les fichiers sont accessible en HTTP à l'adresse du mini-site, éventuellement agrémenté du complément de chemin fma_url de l'objet cms_filemanager.

Par défaut, fma_url est setté à / ou une chaîne nulle. Les fichiers sont donc servis à /content/repminisite/ ou tout simplement la racine du site, si un nom d'hôte lui est réservé.

Le fichier qui répond est /content/repminisite/index.php, fichier écrit automatiquement par le CMS. Il n'effectue qu'un simple include de /backoffice/cms/filemanager/frontoffice/ls.php ; c'est ce dernier qui fait effectivement le travail, avec ls.inc.php.

Comptes clients pour la consultation

Les objets cms_filemanageruser permettent de créer des comptes utilisateurs qui seront authentifiés pour consulter les pages rendues par /backoffice/cms/filemanager/frontoffice/ls.php.

Un login * est autorisé si on ne souhaite authentifier que sur mot de passe uniquement.

Dans le cas contraire, lorsqu'un login est saisi, un dossier personnel est créé dans le dossier de stockage du file manager. Si l'option chroot pour un cms_filemanageruser est activée, cet utilisateur ne pourra consulter que les fichiers contenus dans son répertoire personnel.