Le raccourci typographique "sjcycle" permet d'insérer facilement un ou plusieurs diaporamas au sein d'un article : il vous suffit de le recopier à l’intérieur de la case « Texte » de l'article, là vous désirez situer le diaporama. Exemples d'utilisation par ici.
Ce raccourci comporte plusieurs paramètres séparés par le caractère "|".
-
<sjcycleN>
Paramètre "N", obligatoire :
Correspond au numéro de l'article en cours.
Il permet de cibler les images liées à un unique article.Astuce : Vous pouvez ainsi insérer un diaporama avec les images d'un article dans un autre article.
-
<sjcycleN|ALIGN>
Paramètre "ALIGN", optionnel :
Permet de spécifier l'alignement du diaporama au sein du texte.
S'il n'est pas précisé, l'alignement est "center".
Les options de l'alignement :- "left" : à gauche du texte;
- "center" : centrer dans le texte;
- "right" : à droite du texte.
-
<sjcycleN|ALIGN|docs=n1,n2>
Paramètre "docs=n1,n2,[...],nx", optionnel :
Permet de spécifier la liste d'images à afficher dans le diaporama.
Ainsi, on peut afficher plusieurs diaporamas dans au sein d'un même texte, isoler des images.
S'il n'est pas précisé, l'ensemble des images sont sélectionnées par défaut.
Les arguments de sélection "n1,n2,[...],nx" du paramètre "|docs=" :
Ils se composent d'une suite de numéros d'images séparées par des virgules sans espace.
Sous chaque image est indiqué un raccourci typographique du type "<imgXX|left>", "<docXX|left>" ou "<docXX>", où "XX" désigne le numéro de l'image correspondante.
Ainsi le paramètre "|docs=1,3", sélectionne les images numéro 1 et 3 de l'article courant.Astuce : Vous pouvez utiliser le raccourci en ne passant qu'un seul numéro d'image au paramètre "|docs=" afin de bénéficier de l'effet "FancyBox" : un clic sur l'image redimensionnée du diaporama permet d'afficher l'image originale en superposition.
-
<sjcycleN|ALIGN|id_diapo=X>
Paramètre "id_diapo=X", optionnel :
Permet d’attribuer un id spécifique à un diaporama afin de pouvoir le cibler en css par dsjcycle_X
Depuis la version 1.1, n’est plus nécessaire pour afficher plusieurs diaporamas dans le mème article
Exemple :
<sjcycle16|center|docs=101,102,103,104|id_diapo=1>
<sjcycle16|center|docs=105,106,107,108,109|id_diapo=2|opt=fx:'shuffle',timeout:2000>
Ceci affiche 2 diaporamas dans le même article, le premier sur 4 images avec les paramètres par défaut du site et le second sur 5 images, avec des paramètres différents de ceux par défaut.
-
<sjcycleN|ALIGN|legende=X>
Paramètre "legende=X", optionnel :
Permet d’afficher une légende sous le diaporama- Si X=1, on affiche comme légende le titre des images
- Si X=modele, on affiche comme légende le texte fourni par le modèle sjcycle_modele. Ceci permet de créer une légende contenant le nomde l’auteur, le titre de l’article, enfin ce qu’on veut...
- Si X=un texte, ce texte est affiché comme légende
-
<sjcycleN|ALIGN|opt=p1:v1;p2:v2>
Paramètre "opt=p1:v1;p2:v2;[...];px:vx", optionnel :
Permet d'utiliser les options du script jcycle. La liste complète est définie sur le site du plugin jquery jcycle par ici
Ces valeurs écrasent celles définies dans la page de configuration du plugin.
Les options possibles correspondent à celles de la version utilisée dans ce plugin spip et non à celles proposées sur la page citée ci-dessus. Actuellement, c'est la version 2.88 (08-JUN-2010) qui est utilisée
Exemple :
<sjcycle16|center|opt=autostop:1;autostopCount:5> : diaporama sur toutes les images de l'article 16 mais qui s'arrêtera à la cinquième image
<sjcycle16|center|opt=fx:'fade'> : diaporama sur toutes les images de l'article 16 avec un effet de transition "fade" qui remplace celui défini globalement pour le site entier -
<sjcycleN|ALIGN|lien_article=XXX|forcer_lien_reference=on>
Paramètres "lien_article=XXX" et "forcer_lien_reference=on", optionnels :
Permet de poser un lien sur le diaporama vers un article d'identifiant XXX autre que celui contenant les images. Dans le cas d'un site multilingue, fournir l'id de l'article de référence, le modèle se charge de trouver l'id de l'article correspondant à la langue du visiteur. Cette option désactive l'ouverture vers une box. Si l'article n'existe pas dans la langue courante on met ou pas un lien vers l'article de référence suivant que le paramètre forcer_lien_reference soit défini ou pas.
Exemple :
<sjcycle16|center|lien_article=171> : diaporama sur toutes les images de l'article 16 avec un lien vers l'article 171 -
<sjcycleN|ALIGN|liens_individuels=valeur>
Paramètre "liens_individuels=valeur", optionnels :
Permet de poser un lien sur chaque image du diaporama vers un article, une rubrique ou un site externe suivant la valeur du paramètre (article, rubrique, externe). Si la valeur vaut article ou rubrique, l'identifiant de l'objet est pris dans le champ descriptif de chaque image. Si la valeur vaut externe, le champ descriptif de chaque image doit contenir un lien http.
Exemple :
<sjcycle16|center|liens_individuels=article> : diaporama sur toutes les images de l'article 16 avec sur chaque image un lien vers l'article dont l'identifiant est contenu dans le descriptif de l'image. <sjcycleN|ALIGN|param=valeur>
Autres paramètres optionnels :
Ces paramètres écrasent localement les valeurs définies dans la page de configuration du plugin :- width : largeur en pixels des images recadrées
- height : hauteur en pixels des images recadrées
- position : position de l'image de d'origine dans l'image recadrée (left top, left center, left bottom, center top, center, center bottom, right top, right center, right bottom)
- background : couleur de fond des images recadrées (au format #FF0000)
- border_color : couleur de la bordure des images recadrées (au format #FF0000)
- border_width : largeur en pixels de la bordure
- div_margin : marge en pixels autour des images recadrées
