Nota SPIP-Contrib : Cette contrib est encore en développement. Cet article est publié dans ce contexte comme support au travail commun, et pour permettre de rédiger la documentation en même temps que le code. Il doit être apprécié en conséquence.
Liens
Ce plugin est une adaptation à SPIP du script Innerfade.
Article de présentation détaillé et exemples complets sur http://www.charlesrazack.com
En développement
Bien que fonctionnel, le plugin est encore en développement. Pour l’instant, l’intégration à SPIP se borne aux documents joints à un article. Un peu sommaire, certes... mais ça fonctionne. Pour l’instant, le plugin fait la moitié du travail, à savoir insérer le code nécessaire entre les balises <head>. Il faut ensuite l’appeler à la main dans le squelette. C’est un peu léger certes, mais je n’ai que quelques rudiments de php. Rien de bien compliqué cependant. Par la suite, son utilisation devrait être plus simple et plus poussée.
Il y a 2 types d’utilisation possibles :
pour le rédacteur d’un article, qui doit pouvoir activer le diaporama dans un article s’il le désire.
pour le webmaster, qui doit pouvoir activer le diaporama là ou il veut dans le site (tous les articles de telle ou telle rubrique, ou alors ponctuellement pour tel ou tel #div) dans l’interface privée.
Je le propose tout de même en téléchargement en l’état, bien qu’il reste pas mal de développement à faire pour rendre son utilisation plus transparente pour les rédacteurs, et plus poussée pour les webmasters.
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 :
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...)
RSS 2.0