12.2 DOCman (Plateau de téléchargement et gestion de documents)

Le composant DOCman sert à associer des fichiers à des descriptifs et à des licences d’utilisation puis à rendre disponible ces éléments à des groupes d’utilisateurs spécifi ques, pour qu’ils puissent les télécharger.

Voici les principales fonctions de DOCman :

• Classement des documents dans des catégories et des sous-catégories.
• Importation des fichiers sur un serveur local ou un serveur distant.
• Accès aux documents régis par des permissions.
• Création de groupes d’utilisateurs pour contrôler les accès aux documents.
• Génération de statistiques de téléchargement détaillées.
• Système de recherche spécifi que. Vous pouvez chercher les documents d’après le nom du fichier ou d’après le descriptif. Un Plugin complémentaire permet d’intégrer les documents DOCman à la recherche de Joomla!.
• Le chemin d'accès effectif à chaque document n’est jamais visible.
• Plusieurs modèles sont disponibles pour s’adapter au site Web.
• La documentation disponible sur le Web au format Wiki est très complète.

12.2.1 Installation

L’installation de ce composant suit les mêmes règles que celles du forum FireBoard vu en début de chapitre. Récupérez le fichier de paquetage com_docman_1.4.0rc1.zip depuis le CD-ROM ou le réseau (sélectionnez bien le seul composant, pas le paquetage global qui le contient). Installez-le via la commande EXTENSIONS > INSTALLER/DÉSINSTALLER (voir Figure 12.15).

Figure 12.15 Installation de DOCman.

Sous le logo à gauche, vous voyez ensuite un bouton intitulé ADD SAMPLE DATA permettant d’installer les fichiers d’exemples. Utilisez ce bouton pour que DOCman installe les éléments suivants :

• un fichier d'essai ;
• une description appropriée du fichier ;
• une catégorie dans laquelle la description est versée ;
• un groupe d'utilisateurs ;
• une licence d'exemple.

Vous pouvez immédiatement exploiter DOCman une fois les données d’exemples installées.

12.2.2 Configuration

DOCman est un des premiers composants à supporter parfaitement l’approche structurelle des
menus de Joomla! 1.5 (voir Figure 12.16).

Figure 12.16 Le centre de contrôle de DOCman.

Les menus principaux se présentent sous forme horizontale sous le logo. Le centre de contrôle
propose des icônes pour accéder rapidement aux mêmes commandes. La partie droite est un groupe de volets d’informations.

Cliquez sur le bouton ou sur le lien CONFIGURATION pour découvrir les nombreuses possibilités de paramétrages.

12.2.3 Fichier de langues

Normalement, le composant DOCman que vous récupérez possède déjà les fichiers de l’interface en français. Si ce n’est pas le cas, vous devez récupérer un fichier dont le nom ressemble à french_docman_v1.4.0rc1.zip. Si l’installation n’est pas possible par l’installateur de Joomla!, il faut implanter manuellement les cinq fichiers nommés french.backend.php, french.common.php.french.doclink. php.french.frontend.php et french.module.php depuis le sous-dossier du paquetage :

  [PaquetLangue]french_docman_v1.4.0rc1\language

vers le sous-dossier suivant (voir Figure 12.17) :

  [CheminJoomla]administrator\components\com_docman\language

Vous devez ensuite pour la partie publique du site récupérer le fichier nommé french.php depuis le sous-dossier du paquetage :

  [PaquetLangue]french_docman_v1.4.0rc1\themes\language

vers le sous-dossier suivant (voir Figure 12.18) :

  [CheminJoomla]components\com_docman\themes\default\language

Figure 12.17 Les fichiers de langues de la partie administration.

Figure 12.18 Le fichier de langues de la partie publique.

Après cette opération, vous disposez des commandes et messages en français dans la partie administrative et la partie publique (voir Figure 12.19).

Figure 12.19 Configuration de DOCman.

Au départ, vous pouvez laisser tous les paramètres à leur valeur d’origine. Ceux qui ont connu
DOCman auparavant peuvent se rendre compte du chemin parcouru. L’outil est vraiment devenu puissant. Passons en revue les différentes sections fonctionnelles de DOCman :

Home. Ramène au centre de contrôle.

Fichiers. Permet de télécharger des fichiers vers le serveur.

Documents. Sert à créer des descriptions et à les associer à des fichiers. Permet également de définir les permissions d’accès et le type de licence du téléchargement.

Catégories. Gestion des catégories dans lesquelles sont classés les documents.

Groupes. Gestion des groupes d’utilisateurs.

Licences. Gestion des différentes licences. Le nombre n’est pas limité.

Statistiques. Donne accès aux statistiques des téléchargements de chaque document.

Journaux de téléchargement. Donne accès aux fichiers de journalisation.

Configuration. Configuration globale de DOCman.

Thèmes. Vous pouvez définir des thèmes spécifi ques à DOCman. Des thèmes sont disponibles sur le site offi ciel du projet. Ils concernent la partie publique.

Crédits. Journal des évolutions depuis l’année 2004.

12.2.4 Activation du composant sur le site

La procédure est la même que pour le forum Fireboard (voir le Chapitre 12.1). Supposons que nous désirions créer un élément de menu dans notre menu LIVRE JOOMLA! 1.5 pour l’accès aux téléchargements. Comme type d’élément de menu, il faut choisir DOCMAN (voir Figure 12.20). Vous définissez ensuite les détails dans la fenêtre d’édition d’élément (voir Figure 12.21).

Figure 12.20 Création d’un élément de menu pour DOCman.

Figure 12.21 Édition de l’élément de menu.

Il reste à choisir un titre et un alias pour l’élément. Vous pouvez amener directement le visiteur sur une catégorie de documents à partir du lien. Il suffit de spécifier l’identifi cateur ID de la catégorie dans les paramètres. Les numéros ID sont affichés dans la section des catégories de l’administration de DOCman.

Dès que vous cliquez sur SAUVER, réactualisez le site Web pour disposer immédiatement d’une fonction de téléchargement de niveau professionnel (voir Figure 12.22).

Figure 12.22 DOCman disponible sur le site Web.

Lorsque vous cliquez sur le bouton TÉLÉCHARGER, vous devez accepter ou refuser la licence associée. Le téléchargement ne démarre qu’ensuite (voir Figure 12.23).

Figure 12.23 Demande d’acceptation de la licence.

12.2.5 Ajout de contenus

Vous pouvez ajouter de nouveaux fichiers et de nouvelles descriptions à votre « plateau de téléchargement » depuis la partie Administration. C’est aussi possible depuis la partie Publique si vous ouvrez une session avec un compte d’utilisateur approprié, tel que admin. Dans ce cas, vous voyez dans la partie supérieure une icône et un lien SOUMETTRE UN FICHIER (voir Figure 12.24). Trois étapes suffi sent à implanter un nouveau document.

Dans la première étape, vous désignez l’emplacement source du document. Il peut être situé sur
votre propre ordinateur ou sur un serveur distant. Vous pouvez aussi établir un lien dynamique avec la source du document (voir Figure 12.24).

Figure 12.24 Soumission d’un document : étape 1.

Supposons que nous ayons opté pour la première solution (fichier local). Nous choisissons un fichier compressé Zip (voir Figure 12.25).

Figure 12.25 Soumission d’un document : étape 2.

Figure 12.26 Soumission d’un document : étape 3.

Une fois le transfert réussi, nous arrivons à la dernière étape dans laquelle nous saisissons une
description, et défi nissons les permissions d’accès, la catégorie et le type de licence. Il suffit alors de cliquer sur le bouton vert en haut à droite (il possède une coche) pour terminer la mise en place. Le document est d’offi ce rendu public, dans la mesure où l’utilisateur qui vient de définir ce téléchargement dispose des droits suffisants. Cet utilisateur dispose d’ailleurs d’un nombre de boutons plus important qu’un utilisateur normal (voir Figure 12.27). En temps normal, vous devez publier explicitement les documents dans la partie Administration (voir Figure 12.28).

Figure 12.27 Le nouveau document disponible au téléchargement sur le site.

Figure 12.28 Rendre un document public.

12.2.6 Le Plugin de recherche de DOCman

Si vous mettez beaucoup de fichiers à disposition, il est indispensable d’ajouter une fonction de
recherche parmi tous ces documents, mais un Plugin a été prévu à cet effet. Vous l’installez comme le composant en désignant le fichier nommé bot_docman_search_1.4.0rc1.zip depuis le CD-ROM compagnon ou depuis le Web.

Votre Plugin de recherche DOCman apparaît ensuite dans la liste des Plugins (menu Extensions). Il faut encore l’activer (voir Figure 12.29).

Figure 12.29 Le Plugin de recherche de DOCman.

Vous pouvez ensuite saisir un critère de recherche dans le champ de la fonction de recherche générale du site Web. Vous verrez apparaître tous les documents contenant ce critère dans la description (voir Figure 12.30).

Figure 12.30 Recherche d’un document.

12.2.7 Module complémentaire

Si le plateau de téléchargement est de taille conséquente, il devient utile d’afficher les noms des
documents les plus demandés. Il suffit à cet effet d’installer le module approprié (fichier mod_ docman_mostdown_1.4.0rc1.zip). Vous utilisez l’installateur normal de Joomla! puis vous l’activez par la liste des Modules (voir Figure 12.31).

Par défaut, le module se présente à gauche, mais vous pouvez le placer à une autre position et modifi er son titre. Les paramètres permettent de contrôler le nombre d’entrées et l’affichage de l’icône et du nombre. En standard, le module offre l’aspect de la Figure 12.32.

Figure 12.31 Un module de DOCman.

Figure 12.32 Un module de DOCman sur le site public.