1. Introduction

Cet article est une documentation à l'utilisation du module Diaporama pour le CMS Drupal.

Les commandes sont des commandes à effectuer sous linux en mode console. On supposera que vous disposez des droits de votre utilisateur web (exemple www-data pour un ubuntu classique).

2. Installation du module

2.1. Téléchargement et décompression du module

Pour installer le module, placez-vous dans votre répertoire de modules /sites/all/modules/.

cd sites/all/modules

Si vous n'avez pas encore installé de modules, il va falloir créer le répertoire modules.

cd sites/all
mkdir modules
cd modules

Si ce n'est pas déjà fait, téléchargez la dernière version du module correspondant à votre version de Drupal sur Diaporama et décompressez-la. Remplacez bien entendu la version du module par la version que vous désirez.

wget http://ftp.drupal.org/files/projects/diaporama-6.x-2.0-beta1.tar.gz
tar zxvf diaporama-6.x-2.0-beta1.tar.gz

Ce module possède deux dépendances avec le module image que vous pouvez trouver sur la page drupal du module. La procédure d'installation est identique à celle décrite ci-dessus.

2.2. Téléchargement du player flash dewslider

Le module Diaporama utilise un player flash : Dewslider que vous pouvez trouver sur le site de son créateur Alsacreations.
Dewslider est libre d'utilisation pour tout type de site et de structure mais ne peut être modifié. Voir sur le site de Alsacréations pour plus d'informations.

Après avoir téléchargé le player, le placer dans le répertoire files/diaporamas ou autrement :

#Drupal 5
cd files/
# Drupal 6
cd sites/default/files/
 
# 2 versions
mkdir diaporamas
cd diaporamas
wget http://www.alsacreations.fr/mediaflash/dewslider5/dewslider.swf.zip
unzip dewslider.swf.zip dewslider.swf
rm -Rf  dewslider.swf.zip

2.3. Activation du module

Rendez-vous sur la page de gestion des modules : votresite.com/?q=admin/build/modules
Activer les modules image, image_gallery et diaporama.

Capture d'écran de la page de gestion des modules sur Drupal 6

Le module Diaporama est maintenant installé.

3. Configuration du module

Il est possible de paramétrer les variables globales des diaporamas, c'est à dire les valeurs par défaut lors de la création de vos diaporamas. Pour cela rendez-vous sur la page votresite.com/?q=admin/settings/diaporama.

Capture d'écran de la page de configuration des diaporamas sur Drupal 6

4. Création d'un diaporama

Pour pouvoir créer un diaporama vous devez au préalable avoir ajouté des images via le module d'image.

4.1. Création d'une galerie d'images

Il est plus pratique d'utiliser des galeries d'images pour regrouper vos images en catégories. De cette manière, vos images sont organisées et peuvent être utilisées en lots.

4.2. Création d'une image

Si vous n'avez pas encore d'image de créée, allez sur la page votresite.com/?q=node/add/image et créez une ou plusieurs images (il est préférable d'avoir plusieurs images pour un diaporama).

4.3. Création et paramétrage d'un diaporama

Maintenant que nous avons une ou plusieurs galerie d'images et images, nous pouvons créer notre diaporama. A noter que les galeries d'images sont facultatives.

Voici les différentes options paramétrables pour un diaporama :

• Largeur : Largeur du diaporama
• Hauteur : Hauteur du diaporama
• Conserver le ratio :

  Si cette case est cochée, les images conserveront leur ratio, et un fond de la couleur précisée dans la page de paramétrage des diaporamas sera ajouté si les images n'ont pas exactement la même taille que le diaporama.

  
  Capture d'écran du diaporama avec conservation du ratio et fond vert.

  Si cette case n'est pas cochée, les images sont étirées pour correspondre à la taille du diaporama.

  
  Capture d'écran du diaporama sans conservation du ratio.

• Transition : Permet de déterminer l'effet de transition. Voir le site d'Alsacréations pour plus d'informations
• Vitesse de transition : La vitesse de transition est la durée en millisecondes (ms) de l'effet de transition entre deux images.
• Délai d'affichage : Le délai d'affichage est la durée en secondes de l'affichage d'une image.
• Afficher les boutons : Si la case est cochée, les boutons de passage à l'image précédente/suivante sont affichés. Autrement, ils ne sont pas affichés.
• Position des boutons : Cette option permet de déterminer l'emplacement des boutons image précédente/suivante dans le diaporama.
• Afficher les titres : Si la case est cochée, le titre des images est affichée tels qu'ils ont été saisis à la création de l'image avec le module image.
• Position des titres : Cette option permet de déterminer l'emplacement des titres dans le diaporama.
• Début aléatoire : Si la case est cochée, le diaporama commence par une image au hasard puis suis la trame normale.
• Afficher l'image lors du clicSi la case est cochée, lors du clic sur l'image,celle-ci est affichée pour visualisation.
• Activer le diaporama embarqué : Si la case est cochée, une image permet d'afficher un code à mettre sur son site pour afficher le diaporama.
• Lier aux galeries : Si des galeries d'images sont sélectionnées, le diaporama sera lié à ces galeries. A chaque fois que le cron est exécuté, celui-ci met à jour les diaporamas en fonction des ajout et suppression d'images dans les galeries. Après enregistrement, les images des galeries sélectionnées apparaitront automatiquement comme cochées dans la partie "Sélectionner les images" et ne pourront être désélectionnées.
• Sélectionner les images : Les images créées via le module d'image sont affichées sous forme de miniatures et triées par galerie d'images. Sont aussi affichées les images n'appartenant à aucune galerie. Il suffit de cocher les images voulues dans le diaporama.
  

  
  Capture d'écran du paramétrage de sélection des images lors de la création d'un diaporama.

5. Demandes de fonctionnalités, erreurs et anomalies

Vous pouvez reporter les anomalies ou faire des demandes de fonctionnalités sur le site de drupal dans la partie de support.