sjcycle/Utilisation du modèle sjcycle du plugin jQuery Cycle
Utilisation du modèle sjcycle du plugin jQuery Cycle
Le modèle <sjcycle> permet d’insérer facilement un ou plusieurs diaporamas au sein d’un article : il vous suffit de le recopier à l’intérieur du bloc « Texte » de l’article, là où vous désirez situer le diaporama.
Ce raccourci comporte plusieurs paramètres séparés comme il se doit par le caractère "|" et qui sont décrits ci-après.
sjarticle/Paramètre N, numéro de l’article
Paramètre N, numéro de l’article, obligatoire
<sjcycleN>
Correspond au numéro de l’article contenant les images. Vous pouvez ainsi insérer un diaporama avec les images d’un article X dans un article Y.
sjalign/Paramètre N, alignement du diaporama
Paramètre ALIGN, alignement du diaporama, optionnel
<sjcycleN|ALIGN>
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.
sjdocs/Paramètre docs, liste des images
Paramètre docs, liste des images, optionnel
<sjcycleN|ALIGN|docs=n1,n2>
Permet de spécifier la liste d’images à afficher dans le diaporama, nx étant le numéro SPIP du document. Ainsi, on peut afficher plusieurs diaporamas 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.
sjdiapo/Paramètre id_diapo, id css du diaporama
Paramètre id_diapo, id css du diaporama, optionnel
<sjcycleN|ALIGN|id_diapo=X>
Permet d’attribuer un id spécifique à un diaporama afin de pouvoir le cibler en css par l’id 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.
sjlegende/Paramètre legende du diaporama
Paramètre legende du diaporama, optionnel
<sjcycleN|ALIGN|legende=X>
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
sjldiapo/Paramètres lien_article et forcer_lien_reference
Paramètre Paramètres lien_article et forcer_lien_reference, optionnels
<sjcycleN|ALIGN|lien_article=XXX|forcer_lien_reference=on>
Permet de poser un lien sur le diaporama vers un article 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.
Ces paramètres sont disponibles depuis la version 1.6 du plugin.
sjlimage/Paramètres liens_individuels de chaque image
Paramètre liens_individuels de chaque image, optionnel
<sjcycleN|ALIGN|liens_individuels=valeur>
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. Cette option désactive l’ouverture vers une box.
Ce paramètre est disponible depuis la version 1.7 du plugin.
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.
sjcfgjs/Paramètres de surcharge des options du script js
Paramètres de surcharge des options du script js, optionnel
<sjcycleN|ALIGN|opt=p1:v1;p2:v2>
Permet d’utiliser les options du script jcycle. La liste complète est définie sur le site du plugin jquery jcycle : http://malsup.com/jquery/cycle/opti... 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. Depuis la version 1.2, il faut utiliser le point-virgule comme séparateur pour que ça fonctionne en modèle.
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
sjcfgplug/Paramètres de surcharge de la configuration du plugin
Paramètres de surcharge de la configuration du plugin
<sjcycleN|ALIGN|param=valeur>
Ces paramètres optionnels é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
Exemple :
<sjcycle16|center|background=#000000> : diaporama centré sur toutes les images de l’article 16 mais avec un fond noir, peu importe la couleur de fond définie dans la page de configuration du plugin.
