Diaporama Innerfade - développement

Liens

Ce plugin est une adaptation à SPIP du script Innerfade.

Voir le carnet de notes de développement sur le wiki de SPIP-Contrib Diaporama_innerfade

Installation

ce plugin nécessite la bibliothèque jquery pour fonctionner (intégrée en standard à SPIP 1.91 et plus). Il est à installer comme n’importe quel plugin, soit en résumé [1] :
-  télécharger le fichier à dézipper
-  copier dans le dossier /plugins de SPIP le répertoire diaporama_innerfade contenu dans l’archive zip.
-  ensuite activer le plugin dans l’interface privée de SPIP.

Mise en œuvre

Ajouter le code qui suit dans le squelette à l’endroit où doit apparaitre le diaporama :

<div id="diaporama_innerfade">
	<BOUCLE_diaporama_innerfade (DOCUMENTS) {id_article} {mode=document} {extension IN png,jpg,gif} {par num titre, date}>
	<a href="[(#URL_DOCUMENT)]" type="#MIME_TYPE">
	<img src="[(#FICHIER|image_reduire{0,400}|extraire_attribut{src})]" title="#TITRE"/>
	</a>
	</BOUCLE_diaporama_innerfade>
</div>

Précisions

Le bloc id doit impérativement s’appeler diaporama_innerfade, car c’est ce nom qui active le diaporama. Il est possible d’activer le diaporama sur plusieurs blocs différents, contenant du texte ou des images.

Pour régler la hauteur des images : changer la valeur de image_reduire{0,400}. Attention, si la hauteur est plus grande que 400px, l’image risque de déborder du conteneur... Editer alors le fichier en_tete.php dans plugins/diaporama_innerfade, et donner la même valeur à $diapohauteur.

Pour n’afficher que le diaporama (et pas d’éventuelles miniatures en plus) : rajouter {doublons} dans la boucle .

Pour enlever la bordure blanche : éditer diaporama_innerfade.css dans plugins/diaporama_innerfade ou bien rajouter un tag #diaporama_innerfade dans votre feuille de style.

Voir le site du script pour une explication plus détaillée, et plus bas pour le développement.

Licence

distribué sous licence GNU/GPL.

A faire

1) pour le rédacteur

Rendre le diaporama activable dans l’article au moyen d’une balise genre {diapo|slide|transition=1|duree=4|sequence|hauteur=400} où les options sont :
-  slide : défilement (au lieu du fondu enchainé)
-  transition=x : duree de la transition (en secondes)
-  duree=x : temps d’affichage de chaque image (en secondes)
-  random : succession aléatoire
-  hauteur : hauteur en px

2) pour le webmaster

Avoir accès aux différentes options du script dans l’interface privée de SPIP, où l’on pourrait :
-  définir les options par défaut (durée de chaque image, vitesse de transition etc...)
-  définir sur quelles rubriques activer le plugin (actif sur tous les articles contenant des images de la rubrique), avec les options.
-  et pour chaque rubrique, définir sur quel tag activer un diaporama.

Ainsi il serait possible de créer les diaporamas plus finement, à partir de n’importe quelle liste créée par SPIP, texte ou images (liste d’articles, de rubriques, de documents joints etc...)