Utilisation

  1. Installer tout d'abord Dewslider et lisez sa documentation !
  2. Télécharger le script (voir plus bas).
  3. Modifier ses paramètres dans le source (en particulier le nom du répertoire où se trouvent les images)
  4. Installez le sur votre serveur (ne pas oublier de le renommer en .php)
  5. Intégrer l'appel de Dewslider dans votre page html de façon à ce que le script soit appelé en paramètre à la place du fichier xml

Voir une page de démonstration.

Modification des paramètres

Les paramètres du script sont situés à partir de la ligne 80. Reportez-vous au script, ce sera plus simple et auto documenté. J'ai fait le choix de renommer tous les paramètres pour les passer en français (ce qui aidera peut-être certains d'entre-vous) ainsi que pour avoir des paramètres communs qui ont des noms différents dans les versions de Dewslider, ce qui simplifie la portabilité.

Encore une fois, je vous invite à consulter la documentation de Dewslider pour déterminer l'impact de chaque paramètre.

Les paramètres spécifiques à mon script sont :

  • $DewsliderVersion : 2 ou 5 (même pour la v4)
  • $dirimages : le répertoire que l'on doit scanner pour les images, relatif au répertoire d'appel de la page html. Le nom DOIT se terminer par un /
  • $tri : détermine si l'ordre des images sera mélangé, trié par ordre alphabétique ou laissé dans l'ordre d'écriture dans le répertoire. Cette option avait été ajouté car n'existait pas dans la version et vient en remplacement du paramètre "randomstart" de la v5
  • $titre : détermine la légende à utiliser sous chaque image. En particulier, on peut utiliser "JOLI_NOM_FICHIER" qui utilisera le nom du fichier, débarassé des "-" ou "_" ou extension ".jpg/.jpeg". Si on ne veut pas voir la légende, mettre l'option "$afficherLegende" à non.
  • $styleTransition : spécifique à la v5, permet de choisir comment doit s'enchaîner les images. J'ai ajouté l'option "random" qui permet de choisir une transition au hasard à chaque exécution du script (sauf "none")

Intégration du code dans une page html

Dans cet exemple, je reprend le code généré sur la page offcielle de Dewslider en remplaçant le nom du fichier xml par le script php. J'ai choisi d'utiliser la version la plus portable même si elle n'est pas compatible w3c.

Comme on utilise un fichier XML, il n'est pas nécessaire de mettre d'autres paramètres dans l'appel de l'applet, tous les paramètres sont dans le fichier XML.

<object classid="clsid:d27cdb6e-ae6d-11cf-96b8-444553540000" codebase="http://fpdownload.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=7,0,0,0" width="516" height="418" id="dewplayer" align="middle">
<param name="allowScriptAccess" value="sameDomain" />
                  C'est ici que ça se passe +- - - - - - - - - -  - - - - - - +
                                            |                                 |
<param name="movie" value="dewslider.swf?xml=suricat.net-20080204-dewslider.php" />
<param name="quality" value="high" />
<embed src="dewslider.swf?xml=suricat.net-20080204-dewslider.php" quality="high" width="516" height="418" name="dewplayer" align="middle" allowScriptAccess="sameDomain" type="application/x-shockwave-flash" pluginspage="http://www.macromedia.com/go/getflashplayer">
                             |                                 |
                             + - - - - - - - - - - - - - - - - + C'est aussi ici que ça se passe 
</embed>
</object>

Téléchargement

Générateur de fichier XML pour Dewslider
Version 1.2 - 20080204
Testé avec Dewslider 2.0 et 5.0
Distribué sous licence CC-BY-SA
suricat.net-20080204-dewslider.php 
(bouton droit ou équivalent, Enregistrer sous...)

Si vous utilisez ce script, merci de laisser un commentaire sous ce billet avec un lien vers votre site ! Merci

Limitations/Problèmes connus

Un problème a été remonté par Dano dans la version précédente. En cliquant sur le bouton gauche, les images défilent en boucle très rapidement et clignote. En fait, ce bug n'est pas lié au fichier xml généré. Si toutes les images n'ont pas encore été chargées par le Dewslider, et que l'on clique sur la gauche, il ne doit pas trop savoir quelle image afficher, et cela ne fonctionne pas correctement. J'ai reproduit le problème sans soucis. Si l'on attend que toutes les images soient chargées, cela fonctionne correctement.

D'autres soucis ?

Ce page remplace le billet sur l'ancienne version, toujours consultable pour référence.