Le cahier des charges
On se propose de réaliser un diaporama comme sur le site suivant
On trouve sur ce diaporama
5 miniatures ;
des flèches de navigation permettant d’accéder directement aux premières et dernières images ainsi qu’à la précédente et la suivante ;
une image en grand format.
Un clic sur une miniature entraine l’affichage de celle-ci et un décalage des miniatures afin que la miniature de l’image affichée se retrouve au centre (sauf bien sur si l’on se trouve à une extrémité du diaporama.
Les boucles
Quelques commentaires
Les boucles suivantes utilisent les balises :
- #ENV
qui va nous permettre de récupérer dans l’url le rang dans la boucle du document à afficher. - #TOTAL_BOUCLE
qui retourne le nombre de résultats trouvés par la boucle - #COMPTEUR_BOUCLE
qui nous donne l’itération actuelle de la liste - #SELF
qui permet de récupérer l’url de la page actuelle, à laquelle on ajoute de nouveaux paramètres avec le filtre|parametre_url
Les différentes valeurs de ces balises sont comparées pour gérer l’affichage des différentes miniatures et des flèches de navigation.
Détaillons maintenant les boucles :
Pour les valeurs de n comprisent entre 3 et total des miniatures - 2, on souhaite afficher les 5 miniatures dans l’ordre suivant :
<miniature n-2>, <miniature n-1>, <miniature n>,<miniature n+1>, <miniature n+2>La miniature n étant celle affichée dans le diaporama.
Pour les valeurs de n inférieures à 3, on doit afficher :
<miniature 1>, <miniature 2>, <miniature 3>,<miniature 4>, <miniature 5> Pour les 3 dernières valeurs de n on doit afficher :
<miniature total-4>, <miniature total-3>, <miniature total-2>,<miniature total-1>, <miniature total>Cette première boucle permet de générer les 5 miniatures à afficher à partir de la valeur courante du compteur #ENV{compteur} récupérées dans l’Url.
La boucle contient le critère {(#ENV{compteur}|moins5),7} qui permet d’extraire de la liste des documents de l’article 7 documents.
moins5 est un filtre programmé (voir plus bas) dans mes fonctions.php3 qui permet de décompter de 5 la valeur courante de #ENV{compteur} ainsi :
- si
#ENV{compteur}= 6, Spip applique le filtre suivant{(6-5,7}c’est à dire{(1,7}, il extrait donc 7 documents de n=1 = n=7. - si
#ENV{compteur}= total des miniatures, Spip applique le filtre suivant{(total-5,7}, Spip ici ne peut extraire que 5 documents de la boucle, les 5 derniers. - si
#ENV{compteur}= 1, Spip applique le filtre suivant{(-4,7}il n’affiche donc que les 3 premiers documents.
Pour le premier cas, il faut supprimer les deux premiers documents, c’est l’objet de la deuxième boucle
Le deuxième cas correspond à l’affichage souhaité.
Pour obtenir l’affichage désiré avec le troisième cas, il est nécessaire de rajouter 2 miniatures
Dans tous les cas, les miniatures à afficher sont stockées dans {doublons cinq}
La troisième boucle doit à la fois permettre de générer la valeur du compteur et n’autoriser que l’affichage des 5 miniatures choisies.
Elles est constituée de deux boucles,
la première :
balaie la totalité des documents, elle permet de générer la valeur courante du compteur &compteur=#_doc:COMPTEUR_BOUCLE que l’on va transmettre dans l’Url
la deuxième :
limite l’affichage aux miniatures sélectionnées
On remarquera dans cette boucle l’URL passée
La balise #SELF avec le filtre |parametre_url permet de reconstruire l’url de la page courante avec les bons paramètres, par exemple, si on ajoute la galerie sur la page article, on aura l’url suivante :
href="article.php3?id_article=#ID_ARTICLE&id_document=#ID_DOCUMENT&compteur=#_doc:COMPTEUR_BOUCLE" title="[(#TITRE)]">On passe à la fois, l’id_article, id_document et la valeur du compteur.
On doit aussi dans ces deux boucles compléter l’affichage des miniatures manquantes pour les deux premières valeurs de #ENV{compteur}.
On a choisit ici, de réaliser un test sur la valeur de #ENV{compteur} et de #_doc:COMPTEUR_BOUCLE qui peut se lire
SI#ENV{compteur}=2ALORSSI#_doc:COMPTEUR_BOUCLE=5ALORS afficher la miniature 5SINON rien
De la même manière, on détermine les miniatures à ajouter si le compteur vaut 1
soit en littéral
SI#ENV{compteur}=1ALORSSI#_doc:COMPTEUR_BOUCLE=4ALORS afficher la miniature 4SI#_doc:COMPTEUR_BOUCLE=5ALORS afficher la miniature 5SINON rien
Affichage des flèches
L’affichage des flèches est obtenue grace à la boucle suivante :
Cette boucle à la même structure que la boucle _doc, c’est à dire qu’elle balaie la totalité de documents de l’article, l’affichage des résultats lui est conditionné par la valeur de #COMPTEUR_BOUCLE si :
#COMPTEUR_BOUCLE = 1 on affiche la fléche start ;
#COMPTEUR_BOUCLE = #TOTAL_BOUCLE on affiche la flèche end
#COMPTEUR_BOUCLE +1 = compteur on affiche la flèche previous
#COMPTEUR_BOUCLE -1 = compteur on affiche la flèche next
Affichage de l’image sélectionnée
La toute dernière partie permet l’affichage de l’image sélectionnée (id_document), si aucun document n’est sélectionné, on affiche le premier.
On notera des les comparaisons les deux filtres |decremente et |incremente qui permettent comme leur nom l’indique de rajouter ou de soustraire 1 à la valeur passée en argument. ces deux fonctions doivent être ajoutées dans mes_fonctions.php3
Le fichier diaporama_fonctions.php3
Le fichier diaporama_fonctions.php3 doit être placé avec le squelette et déclare les nouveaux filtres :
Appel de la procédure diaporama
Vous pouvez directement intégrer cette procédure dans votre squelette article.html, il n’y a alors aucune précaution particulière. Il est souvent préférable pour des questions de lisibilité du squelette d’appeler celle ci via un <INCLURE.....> , il faut alors prendre soin de passer d’un inclure à l’autre la variable compteur passée dans l’url. On écrira donc dans article.html :
INCLURE(page.php3){fond='diaporama'}{id_article}{id_document}{compteur}>
en passant, à la fois :
id_article : l’article à traiter,
id_document : le document à afficher,
compteur : le rang courant de l’image dans la liste des images
Si vous avez plusieurs <INCLURE(....... en cascade, il faudra pour chacun rappeler chacun des arguments.
Remarque : pour que l’affichage soit correcte dès le premier appel, c’est à dire avec 5 miniatures, il est souhaitable d’imposer la première fois la valeur de compteur, on peut donc écrire :
Les tests permettent de vérifier que la valeur passée dans l’Url est numérique (en fait qu’elle existe) si c’est le ca, l’appel est normal, si elle n’existe pas, on impose la valeur 1.
Evolutions et aménagements
Les trois boucles, génération des 5 miniatures, génération de flèches de névigation et affichage de l’image étant indépendantes, il est possible :
de supprimer les miniatures et conserver uniquement la navigation avec les flèches ;
de supprimer les flèches de navigation ;
de positionner différement les miniatures et les flèches de navigation.
remarque : les images de navigation viennent de la contrib Encore un album photo
le squelette
RSS 2.0