Multiviewer Full pour Spip2

Plugin Multiviewer FULL pour Spip 2

(* Plugin Remis à jour le 15 oct 2010 à 22h30 *)

-  Télécharger le plugin Mutliviewer Full pour Spip 2
et l’installer normalement dans /plugins/

-  Multiviewer Full existe aussi pour Spip 1.9 ici !

1 - Utilisation Ultra Simplifiée : dans un article

-  Il suffit d’un lien hypertexte pour créer une galerie Flash à partir d’un article.
Voici le lien à créer :

[Lien->./?page=multiviewer&id_article=#ID_ARTICLE]

On précise le numéro de l’article qui sera utilisé pour créer la galerie :
#ID_ARTICLE doit être remplacé par le numéro de l’article qui contient nos images.

Le squelette présent dans le plugin se charge de rassembler toutes les images Jpeg de l’article choisi , de créer la galerie, la configurer et de l’afficher dans une nouvelle page.

Attention : Les documents joints à l’article doivent être dans le portfolio de l’article
sinon ils n’apparaitront pas dans la galerie.

Choix du viewer flash par l’URL

-  Pour choisir le viewer :

[Lien->./?page=multiviewer&id_article=#ID_ARTICLE&viewer=Nom_du_viewer]

Dans ce cas Nom_du_viewer sera remplacé par un des 6 viewers proposés :

-  autoviewer (Defilement auto)
[Lien->./?page=multiviewer&id_article=#ID_ARTICLE&viewer=autoviewer]

-  postcard
[Lien->./?page=multiviewer_full&id_article=#ID_ARTICLE&viewer=postcard]
(squelette avec javascript)

-  imagerotator (Plein Ecran)
[Lien->./spip.php?page=multiviewer&id_article=#ID_ARTICLE&viewer=imagerotator]
(Plein écran disponible dans le Flash - bouton)

-  simpleviewer
[Lien->./?page=multiviewer&id_article=#ID_ARTICLE&viewer=simpleviewer]

-  simpleviewer 2.0 ... pas encore intégré !
(Plein écran disponible dans le Flash)
[Lien->./?page=multiviewer&id_article=#ID_ARTICLE&viewer=simpleviewer2]

-  simpleviewerpro (Uniquement si vous avez ajouté le fichier SWF)

-  tiltviewer (Plein Ecran)
[Lien->./?page=multiviewer&id_article=#ID_ARTICLE&viewer=tiltviewer]
(Plein écran disponible dans le Flash - clic droit)

2 - Utilisation dans un Squelette

-  Pour creer un lien vers le multiviewer, insérer ce code dans une boucle ARTICLE ou DOCUMENT de son squelette (article.html par exemple) :

[(#URL_PAGE{multiviewer,id_article=#ID_ARTICLE}|parametre_url{viewer,Nom_du_viewer})]

ou

[(#URL_PAGE{multiviewer,id_article=#ID_ARTICLE}|parametre_url{'viewer','Nom_du_viewer'})]

en remplacant Nom_du_viewer par une des galeries : autoviewer, imagerotator, tiltviewer, postcard, simpleviewer, simpleviewerpro.

OPTION : Plein Ecran via Javascript

Pour les viewers qui ne donnent pas accès au « Full Screen » de manière native (dans le viewer flash par un bouton cliquable), on peut utiliser une variante du squelette fournit.
Cette variante permet de placer 2 boutons Javascript pour étendre la fenetre et l’autre pour fermer.

-  Pour cela utilisez multiviewer_full a la place de multiviewer dans toutes les instructions données au-dessus de ce paragraphe pour utiliser le squelette avec des liens en Javascript au lieu du squelette normal.

(le comportement n’est pas forcément homogène avec tous les navigateurs)

3 - Autre possibilité d’utilisation

Création d’une galerie ligne par ligne dans le texte d’un article :

/* Créé la galerie du nom de "toto" qui utilise le viewer "imagerotator",*/
<MULTIVIEWER87|NOUVEAU|nom=toto>
<MULTIVIEWER87|PARAM|nom=toto|typegalerie=imagerotator>
/* avec une taille de galerie de "500"x"350" pixels,*/
<MULTIVIEWER87|PARAM|nom=toto|largeur=500>
<MULTIVIEWER87|PARAM|nom=toto|hauteur=350>
/* et on injecte dans la galerie les documents 901, 902 et 906*/
<MULTIVIEWER87|AJOUTERDOC|nom=toto|doc=901>
<MULTIVIEWER87|AJOUTERDOC|nom=toto|doc=902>
<MULTIVIEWER87|AJOUTERDOC|nom=toto|doc=906>
/* enfin on affiche le nouveau viewer dans notre page*/
<MULTIVIEWER87|VOIR|nom=toto>

Ainsi on peut créer une galerie plus personnalisée et n’inclure que certains documents.
Cela permet aussi d’inclure des documents provenant de différents articles dans une même galerie.

Configuration du plugin

-  Dans le fichier Multiviewer_options.php, on peut redéfinir la taille par défaut et la taille maximum pour l’affichage des galeries (viewers), et la couleur de fond des galeries.

Configuration avancée des viewers

Voir directement sur les sites officiels de chaque viewer pour connaitre la configuration disponible selon le viewer utilisé :

-  Air­tigh­tin­te­rac­tive flashvie­wers,
-  ImageRotator

Changements par rapport à la version 1.03 du plugin pour SPIP 2.0

-  Les fichiers de conf des viewers ont été modifiés.
-  La balise #MULTIVIEWER_ALL ne fonctionne pas,
ni d’ailleurs <MULTIVIEWERXX|ADD|doc=-1>, ect
-  ImageRotator a été ajouté aux autres viewers disponibles.
-  Les squelettes intégrés permettent d’afficher une galerie à partir des images d’un article et choisir son viewer en 1 seule ligne de code.
-  Pas de page de configuration privée pour le moment.

Plugin testé sur Spip v2.0.8 avec plusieurs autres plugins d’affichage de diaporama et autres galeries : le plugin est fonctionnel et pas d’incompatibilité connue avec les autres plugins.

Lien vers l’article final (dernière version)

Démonstration du Plugin

Merci à C. Boutin le plugin de départ,
et merci à F. Turner de air­tigh­tin­te­rac­tive pour ses vie­wers flash,
ainsi qu’à J. Wijering pour le viewer ImageRotator,
et P.Dupouy pour ses précisions sur la config de imagerotator.