EG-Attachments crée un shortcode vous permettant d’afficher la liste des pièces jointes d’un article. WordPress propose des fonctions pour ajouter des pièces jointes, mais il ne fournit rien pour les présenter/afficher correctement. EG-Attachments affiche la liste des pièces jointes, dans le format que vous souhaitez: vous pouvez choisir la liste des pièces à lister, la taille des icônes, … La liste contient des informations comme le nom, la taille du fichier.

Description

EG-Attachments ajoute donc le shortcode [ attachments]. Ce shortcode accepte de multiples options. Contrairement à d’autres shortcode, vous n’avez pas besoin de retenir toutes ces options, puisque EG-Attachments est intégré à TinyMCE: depuis la page d’édition d’un article, cliquer simplement sur l’icône représentant un trombone, le plugin affichera alors une fenêtre vous permettant de choisir l’ensemble des paramètres du shortcode.

Integration à TinyMCE

Intégration à TinyMCE

Configuration du shortcode

Configuration du shortcode

Cette fonction n’est visible qu’à partir de WordPress 2.7.

Si vous le souhaitez, vous pouvez utiliser le shortcode de façon classique:

  • dans un article en tapant [ attachments <options>],
  • dans une template d’un thème, en utilisant la commande do_shortcode('[ attachments >options<]');.

A partir de la version 1.20 du plugin, vous avez également la possibilité, grâce à une option spécifique, d’ajouter automatiquement la liste des pièces jointes à tout les articles qui en disposent sans utiliser de shortcode. Il s’agit de la fonction Shortcode automatique.

Installation

Ce plugin s’installe de façon tout à fait classique:

  1. EG-Attachments est disponible sur le site WordPress.org, ou vous pouvez le télécharger,
  2. Une fois téléchargé, décompresser le fichier eg-attachments.zip,
  3. Copier les fichiers obtenus dans un sous-répertoire du répertoire plugins (en général wp-content/plugins sur votre plateforme WordPress,
  4. Activer le plugin via le menu approprié dans l’interface d’administration.

Le plugin est alors prêt à être utilisé. Avec WordPress 2.7, vous pouvez effectuer l’installation directement depuis l’interface d’administration, en utilisant les fonctionnalités de cette version.

Vous pouvez télécharger le plugin à cette adresse.

Utilisation

Comme indiqué précédemment, EG-Attachments peut être utilisé:

  • dans un article, en insérant le shortcode [ attachments <options>],
  • dans un fichier template (pour le développement d’un thème par exemple), en utilisant la fonction do_shortcode.

Les options du shortcode sont:

  • size: indique la taille de la liste. Trois valeurs possibles: large (valeur par défaut), medium et small
  • docid: liste des identifiants des pièces jointes à afficher. Ces identifiants doivent être séparés par un virgule. Si cette option est vide, ou non spécifiée, toutes les pièces seront affichées. Vous avez la possibilité également de demander le premier ou le dernier élément avec les mots-clés first et last (docid=first par exemple). Attention, la notion de premier et dernier dépend bien sur des règles de tri demandées. Ces mots-clés doivent être employés seuls.
  • orderby: permet de spécifier la clé de tri. Les valeurs possibles sont ID ou titre. Cette opton permet également d’indiquer le sens du tri (Ascendant ou descendant). Par défaut les pièces jointes sont triés par leur titre, et par ordre alphabétique,
  • title: titre à afficher avant la liste. Par défaut aucun titre n’est affiché. Si le titre contient des espaces, il doit obligatoirement être encadrer de guillemets (exemple: titre= »Essai de titre avec espaces »),
  • titletag: balise HTML qui sera utilisé pour l’affichage du titre. Par défaut la balise est H2,
  • label: choix du label indiquant le nom du document. Valeurs possibles: filename ou doctitle. Valeur par défaut: filename. Cette option n’est valable que pour les listes de taille Large et Medium.
  • fields: list of fields to display. Values: none, caption, description, or a set of values such as « caption,description » (comma separated). Default: caption (same behavior than previous version)
  • force_saveas permet de « forcer » l’apparition de la boîte de dialogue proposant le téléchargement. Cela évite d’avoir des comportements hétérogènes (affichage pour certains documents, téléchargement pour d’autres). Les valeurs possibles sont TRUE ou FALSE. La valeur par défaut est définie par l’option équivalente dans le plugin.

Exemples

Voici quelques copies d’écran de l’affichage:

Format small

Format small

Format Medium

Format Medium

Format Large

Format Large

Page des options

Page des options

Utilisation avancée

Vous pouvez modifier le style d’affichage en modifiant la feuille de styles eg-attachments.css. Cette feuille de styles est stockée dans le répertoire du plugin, mais vous pouvez en créer une copie dans le répertoire de votre thème, puis modifier cette copie. Vous pouvez également compléter ou remplacer les icônes du plugin. Il suffit pour cela, de copier des fichiers de type GIF, JPG ou PNG dans le sous-répertoire images du plugin. Ces icônes ne doivent pas dépasser 48×48 ou 52×52.