Documentation du composant "Fichiers Joints"

Version 1.2 - 20 févier 2008

Traduction en Français par : Pascal Adalian

  1. Introduction
  2. Restrictions de transferts (uploads)
  3. Paramètres des Fichiers Joints
  4. Affichage des noms de fichiers
  5. Changer le style de la liste de fichiers joints
  6. Icones de types de fichiers
  7. Avertissements
  8. Mises à jour
  9. Remerciements

Introduction

L'extension pour Joomla! 'Fichiers Joints' permet de transférer des fichiers vers le serveur (upload) et d'attacher ces fichiers à des articles spécifiques . 'Fichiers Joints' inclut un plugin permettant d'afficher les fichiers joints et un composant pour gérer ces fichiers et les transférer vers le serveur. Il existe des options pour définir qui est autorisé à les voir et qui peut les transférer, ainsi que de nombreuses autres options qui augmentent la flexibilité et l'intérêt du composant. Note: Toutes les options sont controlées au moyen du gestionnaire du composant. Cette extension fonctionne seulement pour Joomla! 1.5 ou une version supérieure.

Cette extension fournit des possibilités de traduction et supporte les langages suivants (autres que l'anglais):

Merci beaucoup aux traducteurs! Si vous souhaitez aider à traduire cette extension dans d'autres langues, veuillez contacter l'auteur (voir à la fin de ce texte). [Revenir au début]

Restrictions de transferts (uploads)

Tous les types de fichiers joints ne peuvent pas être transférés vers le serveur. L'extension 'Fichier Joint' ne permettra pas le transfert de fichiers qui ne sont pas autorisés par le gestionnaire de médias de Joomla!. Pour voir (ou changer) quels types de fichiers sont autorisés, allez dans la page Configuration globale. Dans la zone Paramètres des médias, il y a les options permettant de contrôler quels types d'extensions et de types mimes sont autorisés à être transférés vers le serveur. L'extension 'Fichiers Joints' respecte ces limitations. Cependant, la restriction sur les 'Extensions des images autorisées (types de fichier) ' est ignorée. [Revenir au début]

Paramètres des Fichiers Joints

Tous les paramètres de l'extension 'Fichiers Joints' sont contrôlés via le gestionnaire de composant. Pour accéder à ces paramètres, allez dans l'interface d'administration de Joomla! et sélecionnez "Fichiers Joints" sous le menu "Composants". cliquez sur le bouton "Paramètres" à l'extrémité droite de la barre d'outils et vous verrez une série de paramètres pour cette extension. Ces paramètres incluent les éléments suivants:
[Revenir au début]

Afficher le nom de fichier

Normalement, lorsque les fichiers sont transférés sur le serveur et stockés dans la lise de fichiers joints, le nom de fichier complet est affiché et sert de lien de téléchargement. Dans certains cas, les noms de fichiers peuvent être trop longs pour que ceci fonctionne bien. Dans le formulaire de transfert vers le serveur, il y a un champ nommé "Nom de fichier affiché" dans lequel la personne qui souhaite transférer le fichier peut insérer un titre alternatif qui sera affiché à la place du nom de fichier complet. Par exemple, un nom de fichier abrégé peut être inséré dans ce champ. le champ peut en suite être édité dans l'interface administrateur de Joomla!. Note: Il y a une option nommée "Longueur de nom de fichier maximum" dans les options du plugin. Elle peut être paramétrée pour tronquer automatiquement l'affichage de noms de fichiers. Dans ce cas, le nom de fichier tronqué sera inséré automatiquement dans le champ "Nom de fichier affiché". [Revenir au début]

Changer le style de la liste de fichiers joints

Les listes de fichiers joints affichées dans l'interface publique de Joomla! sont créées dans un 'div' spécial qui contient un tableau pour les fichiers joints. Le tableau a plusieurs classes CSS différentes afin de permettre au développeur du site de personnaliser son apparence. Regardez dans le fichiers CSS du plugin 'Fichiers Joints' (plugins/contenu/attachments.css) pour avoir des exemples. Si vous souhaitez changer le style, pensez à copier les styles originaux à la fin du même fichier et à renommer 'attachmentsList' dans la section copiée pour lui donner le nom de votre choix. Editez les paramètres de fichiers joints (dans le gestionnaire de composants) et changez le paramètre Style des tableaux de fichiers joints par le nouveau nom de classe. Ensuite modifiez les définitions de classe de manière appropriée dans la section que vous avez copiée. Cette approche cous permettra de rapidement revenir au style initial des tableaux en changeant le paramètre Style des tableaux de fichiers joints, pour le remettre sur 'attachmentList'. Ceci a également l'avantage de pouvoir copier les styles modifiés dans un fichier spécifique qui pourra facilement être récupéré quand l'extension 'Fichiers Joints' sera mise à jour ou évoluera. Ceci peut aussi être fait avec une commande d'import de CSS. [Revenir au début]

Icones de types de fichiers

L'extension 'Fichiers Joints' ajoute une icone en face de chaque fichier joint dans la liste qui s'affiche en bas de l'article considéré. Si vous souhaitez ajouter une nouvelle icone, suivez ces étapes: (1) Ajoutez l'icone choisie dans le répertoire 'media/attachments/icons', si une icone appropriée n'y est pas déjà; (2) Editez le fichier 'components/com_attachments/file_types.php' et ajoutez une ligne au tableau statique $attachments_icon_from_file_extension qui associe une icone à une extension de nom de fichier (dans media/attachments/icons directory). Si ceci ne fonctionne pas, vous pourriez avoir besoin d'ajouter une ligne appropriée au tableau $attachments_icon_from_mime_type. (3) N'oubliez pas de faire des copies des fichiers d'icones et de updated file_types.php dans un répertoire en dehors de votre site web afin de pouvoir mettre à jour votre version de l'extension 'Fichiers Joints' dans le futur. [Revenir au début]

Avertissements

[Revenir au début]

Mises à jour

Si vous avez déjà ajouté des fichiers joints et que vous souhaitez les conserver lors d'une mise à jour, voici les étapes à suivre:
  1. Utilisez phpMyAdmin (ou un autre outil SQL) pour sauvegarder le contenu de la table jos_attachments (en utilisant l'option 'Exporter' et les option de données 'insertions complètes' mais pas 'insertions étendues').
  2. Désinstallez le composant 'Fichiers Joints'.
  3. Désinstallez les deux plugins 'Fichiers Joints'
  4. Installez à présent la nouvelle version en dézippant les fichiers et en installant le nouveau composant et les nouveaux plugins.
  5. Republiez les plugins 'Fichiers Joints' dans le gestionnaire de plugins.
  6. Utilisez phpMyAdmin pour restaurer les données précedemment sauvegardées dans la nouvelle table jos_attachments.
  7. Si vous effectuez une mise à jour depuis une version inférieure à la 1.0 vers une version postérieure à 1.0 et que vous avez d'anciens fichiers joints, vous devrez ajouter les valeurs appropriées au nouveau champ 'icon_filename' en vous connectant en tant qu'administrateur dans l'interface d'administration et en utilisant l'URL suivante dans votre navigateur:
    /administrator/index.php?option=com_attachments&task=add_icon_filenames

Notez que le fait de désinstaller l'extension 'Fichiers Joints' n'efface pas les fichiers précédemment transférés sur le serveur mais enlève le table de fichiers joints de la base de données. De ce fait, après avoir réinstallé une nouvelle version de 'Fichiers Joints', il est seulement nécessaire de restaurer les données dans la table adéquate de la base se données pour remettre en place tous les anciens fichiers joints.

Si vous choisissez de ne pas restaurer la base de données des fichiers joints, n'oubliez pas de supprimer tous les anciens fichiers joints du sous-répertoire afin d'éviter les conflits de noms de fichiers dans le futur. [Revenir au début]

Remerciements

De nombreux remerciements aux contributeurs ou ressources suivants: [Revenir au début]

Merci de transmettre vos suggestions et rapports d'erreurs à jmcameron@jmcameron.net.