History: Plugiciel Img

            ! Plugin Img
Ce ((Wiki Plugin|plugiciel Wiki)) affiche une image telle quelle ou re-formatée. Les images peuvent être identifiées par leur adresse URL ou par leur numéro d'identification dans la galerie de fichiers du site. Les images peuvent être redimensionnées ou avoir une mise-en-forme particulière. Elle peuvent aussi être affichées dans une boite et une description ou leur nom peuvent être affichés. On peut aussi régler ce plugiciel pour permettre d'agrandir l'image dans la fenêtre actuelle, dans une nouvelle ou dans une ''colorbox''.


!!Uilisation et paramètres
Pour ajouter ce plugiciel dans une page wiki, utilisez la syntaxe associée ou le bouton d'édition de la barre d'outils~hs~:

!!!Syntaxe

{CODE(caption="Syntaxe du plugiciel IMG", wrap=1, ishtml=1)}
{img id= , fileId= , attId= , src= ,  randomGalleryId= , height= , width= , max= , link= , thumb=, rel= , usemap= , class= , imalign= , styleimage= , align= , stylebox= , styledesc= , block= , desc= , title= , alt= }
{CODE}

Quelques exemples~hs~:

{SPLIT()}
{img src="img/wiki_up/393px-Pears.jpg" thumb="y" imalign="center" stylebox="border" button="y" desc="Jolies poires" max="200" rel="box"}
{FADE(label="Cliquez ici pour voir le code..." icon="y")}{CODE(wrap="1")}{img src="img/wiki_up/393px-Pears.jpg" thumb="y" imalign="center" stylebox="border" button="y" desc="Jolies poires" max="200" rel="box"}{CODE}{FADE}

''Note : cliquez sur l'image ou le bouton pour agrandir.'' 
---
{img attId=37, thumb=mouseover, styleimage=border, desc=desc, max=150}
{FADE(label="Cliquez ici pour voir le code..." icon="y")}{CODE(wrap="1")}{img attId="37", thumb="mouseover", styleimage="border", desc="desc", max="150"}{CODE}{FADE}

''Note : placez votre souris sur l'image pour agrandir.''
---
{img randomGalleryId="1" stylebox="border: 1px solid #000;-moz-box-shadow: 3px 3px 8px #3b120e; -webkit-box-shadow: 3px 3px 8px #3B120E; box-shadow: 3px 3px 8px #3B120E;" height="180" width="250"}
{FADE(label="Cliquez ici pour voir le code..." icon="y")}{CODE(wrap="1")}{img randomGalleryId="1" stylebox="border: 1px solid #000;-moz-box-shadow: 3px 3px 8px #3b120e; -webkit-box-shadow: 3px 3px 8px #3B120E; box-shadow: 3px 3px 8px #3B120E;" height="180" width="250"}{CODE}{FADE}

''Note : image aléatoirement choisie dans une galerie de fichiers avec cadre mis-en-forme.''
{SPLIT}
!!! Paramètres
Les paramètres de ce plugiciel sont détaillés ci-dessous, organisés en onglets~hs~:
{TABS(tabs="Identification|Lien|Taille|Mise-en-forme|Texte ajouté")}
{FANCYTABLE( head="Paramètres|Valeurs acceptées")}
''src''|adresse URL valide ou chemin relatif
''id''|numéro d'identification de l'image (ou de multiples images, voir ci-dessous) dans une __galerie d'images__
''fileId''|numéro d'identification de l'image (ou de multiples images, voir ci-dessous) dans une __galerie de fichiers__
''attId'' |numéro d'indentification d'une image (ou de multiples images, voir ci-dessous)  attachée à une page. Pour d'autre types d'images atachées (par exemple dans un forum), utilisez le paramètre ''src''.
''randomGalleryId''|numéro d'indentification d'une galerie de fichiers. Une image choisie aléatoirement dans cette galerie sera affichée.
{FANCYTABLE}
{REMARKSBOX(type="note", title="Note")}Les règles suivantes s'appliquent aux paramètres ci-dessus~hs~:
*Un et un seul de ces paramètres est obligatoire
*Plusieurs images peuvent être affichées en entrant une liste séparée du charactère | ou de virgules (exemples ''fileId''=1|3|6|4 or ''fileId''="1,3,6,4")
Aucun autre paramère n'est exigé.{REMARKSBOX}
/////
{FANCYTABLE( head="Paramètre|Valeurs acceptées|Effet")}
\\\\\\\\\''thumb'' |(toute valeur associée)|L'image sera affichée comme une vignette qui envoie sur sa version en taille réelle
//::''Modifiez la façon dont l'image est agrandit avec les valeurs suivantes::'' 
y|Agrandit l'image dans une nouvelle page (dépend des réglages du navigateur). S'ouvre dans une ''colorbox'' lorsque le paramère ''rel'' est réglé sur ''box''
mouseover |\\ Agrandit l'image dans la page actuelle lors du pasage de la souris au dessus~hs~; Avec ''mousesticky'' l'image agrandit reste ouverte tant que la page est active.
mousesticky
popup|Agrandit l'image dans une nouvelle fenêtre ou onglet.
browse |\\ __Ne fonctionne qu'avec les images plaçées dans les galeries d'images~hs~:__ l'image est affichée dans le navigateur de galerie d'images~hs~; s'ouvre dans une nouvelle fenêtre ou onglet si ''browsepopup'' est utilisé.
browsepopup
download | __Ne fonctionne qu'avec les images plaçées dans les galeries de fichiers ou images attachées~hs~:__ Une boite de dialogue pour télécharger l'image apparait (à la place de l'image elle-même)
\\\\\''button'' | y |\\\\\ Ajoute un bouton (icone loupe) pour agrandir l'image sous celle-ci, à utiliser avec ''thumb''. Suis les réglages de ''thumb''  à part ci ce dernier est réglé sur ''mouseover'' or ''mousesticky'' (ou est outrepassé par ''link''), sinon les paramètres de ''button'' sont pris en compte, fonctionnant comme pour le paramètre ''thumb''.
popup
browse
browsepopup
download
''link'' | Adresse URL valide ou  chemin relatif|Transforme l'image en lien vers cette adresse. Outrepasse ''thumb'' à part si ''thumb'' est réglé sur ''mouseover'' ou ''mousesticky''
\\''rel'' | box | L'image sera agrandit dans une ''colorbox''
Une des valeurs supportées par HTML pour l'attribut ''rel'' de la balise ''anchor'' (~060~a~062~)|Spécifie la relation entre l'image du lien et la cible
''usemap'' | Nom de n'importe quelle ''image map'' définie pour l'image|Spécifie le nom de l'''usemap'' (permet de diviser l'image en différentes parties pour créer des liens, etc.), qui doit être définie quelque part ailleur dans la page wiki. Il n'y a apparement pas de manière documentée pour inclure la définiion de l''usemap'' dans une page wiki autre que le ((PluginHTML|plugiciel HTML)). (Voir la liste de diffusion Tiki-Dev, [http://comments.gmane.org/gmane.comp.cms.tiki.devel/24777].)
{FANCYTABLE}
/////
{FANCYTABLE( head="Paramètre|Valeur acceptées|Effet"  colwidths="10%|45%|45%")}
\\''height'' |Nombre de pixels (''exemple 100'')|Définie la hauteur de l'image. Les proportions sont maintenues si 'la largeur n'est pas spécifiée.
//pourcentage (''exemple 50%'')
\\''width'' |Nombre de pixels|Définie la largeur de l'image. Les proportions sont maintenues si la hauteur n'est pas spécifiée.
//pourcentage
''max'' |Nombre de pixels|Le plus grand coté (largeur ou hauteur) sera défini par cette valeur et les proportions seront mainenues
{FANCYTABLE}
{REMARKSBOX(type=tip title="Resizing large images")}''Pour de meilleurs performances, utilisez les galeries d'images si vous souhaitez redimensionner de très grande images, ou utilisez 'thumb'' avec les galeries de fichiers ou d'images.''
{REMARKSBOX}
/////
{FANCYTABLE( head="Paramètres|Valeur acceptées|Effet")}
\\\''imalign'' | left |\\\ Aligne l'image elle-même.Outrepassé par le paramètre ''styleimage''. %%% Si ''stylebox'' ou ''desc''  sont aussi définis, alors l'image s'alignera seulement dans sa boite - dans ce cas utilisez ''stylebox'' pour aligner la boite dans la page
right
center
\\''styleimage'' | border | Ajoute une bordure grise à l'image
Syntaxe CSS valide|met l'image en forme
\\\ ''align'' | left |\\\ Aligne un bloc autour de l'image (incluant l'image). L'image n'est alors plus ''inline''. Peut être ourepassé par n'impore quel réglage du paramètre ''stylebox''.
center
right
\\ ''stylebox'' | border |\\ Met en page un bloc autour de l'image. Une syntaxe CSS complète peut être utilisée, ou entrez "border" pour ajouer une bordure et un fond gris au bloc.
syntaxe CSS valide
\\\\ ''block'' | top |\\\\ Empêche les autres élémens d'une page de s'aligner à coté du bloc de l'image lorsque réglé sur  ''top'', ''bottom'' ou ''both''. Equivalent à régler la propriété CSS ''style'' sur ''clear'' avant et après l'image.
bottom
both
none
''class'' |Classe CSS valide|Ajoute une propriété CSS ''class'' à l'image. __class="fixedSize"__ empêche l'image d'être automatiquement redimensionnée et relocalisée dans un ((SlideShows|dipaorama Tiki)).
\\ ''noDrawIcon'' | y |\\ A partir de ((Tiki11)), une icone est ajoutée à coté de l'icone d'édition du plugiciel si celle-ci est activée ainsi que la fonctionnalité DRAW. Elle permet d'éditer l'image en utilisant SVG. Par défaut cette icone est toujours affichée, cad noDrawIcon="n". Réglez ce paramètre sur "y" si vous ne voulez pas voir cette icone. Il est à  noter que si vous utilisez le plugiciel img dans un gabarit wiki (''wiki template'') pour produire un formulaire amélioré (''pretty racker'') et que le paramètre noDrawIcon n'est PAS réglé sur "y", ceci produit une erreur de compliation smarty.
n
{FANCYTABLE}
{REMARKSBOX(type=>comment, title=>Note)}''Pour utiliser une syntaxe CSS complète, entrez les paramètre et valeurs avec les virgules et point-birgules nécessaires. Par exemple~hs~:  __padding-left: 2cm; border: 1px solid black__. Vous trouverez un guide de référence de syntaxe CSS sur le site  w3schools.com [http://www.w3schools.com/css/css_reference.asp|ici].''
{REMARKSBOX}
/////
{FANCYTABLE( head="Paramètres|Valeur acceptées|Effet")}
\\\\\\\ ''desc'' | (tous les réglages desc possibles) | Ce texte apparaitra sous l'image. Par défaut le texte est centré - utilisez ''styledesc'' pour modifier sa mise-en-page.
un texte | Ce texte apparaitra sous l'image.
desc |\\ Pour les images situées dans les galeries (de fichiers ou d'images) ou images attachées, ''desc'' affichera une description pour cette image et ''name'' affichera le nom entré par l'utilisateur lors du téléchargement de l'image sur le site (pour les images attachées le champ "commentaire" est utilisé pour la description et le nom).
name
namedesc | Affichera le nom et la description.
idesc |\\ ''idesc'' affichera n'importe quelle description et ''ititle'' n'importe quel nom inclue dans l'image elle-même (méta-données IPTC).
ititle
\\\''styledesc'' | left |\\ Aligne la description si ''desc'' est défini. La description est centrée par défaut.
right
Syntaxe CSS valide | Met la description en forme si ''desc'' est défini.
\\\\''title'' | un texte | Ce texte apparaitra dans une info-bulle lors du survol de l'image par la souris. Si ce paramètre n'est pas défini, le réglage ''desc'' sera utilisé.
desc |\\\ Voir le paramètre ''desc''.
name
namedesc
''alt'' | un texte | Texte alternatif qui sera affiché si l'image ne peut pas être chargée. Par défaut~hs~: "Image".
{FANCYTABLE}
{TABS}

!! Exemples
!!! Image-lien alignée à droite
''Ce code~hs~:''%%%
{CODE(wrap=>1, ishtml=>1)}
{img attId="39" imalign="right" link="http://info.tiki.org" alt="Chapeau de Panama"} Ce bout de text après le code du plugiciel img sera de toute façon plaçé sur la gauche car l'image est alignée à droite. Il s'enveloppera aussi autour de l'image puisque le paramètre ''align'' "float" l'image.
{CODE}

''Produira sur ce site~hs~:''%%%
{img attId="39" imalign="right" link="http://info.tiki.org" alt="Chapeau de Panama"} Ce bout de text après le code du plugiciel img sera de toute façon plaçé sur la gauche car l'image est alignée à droite. Il s'enveloppera aussi autour de l'image puisque le paramètre ''align'' "float" l'image.
%%%
{REMARKSBOX(type=tip title=Astuce)}''Voir ((PluginDiv|#Controlling_Wrapping_|Controlling Wrapping)) si vous avec besoin de contrôler plus précisement comment le texte ou autre élément s'enveloppe autour de l'image''{REMARKSBOX}
---
!!! Insérer plusieurs images sur une ligne
''Ce code :''%%%
{CODE(wrap=>1, ishtml=>1)}
{IMG(attId="57|58|59" desc="desc" alt="Exemple d'images" stylebox="float: left; margin-right:10px")}{IMG}
{CODE}

''Produira sur ce site~hs~:''%%%
{IMG(attId="57|58|59" desc="desc" alt="Exemple d'images" stylebox="float: left; margin-right:10px")}{IMG}
---
!!! Images différentes que la vignette
Ci-dessous, un exemple uilisant une vignette (pommes) qui est différente que l'image qui apparait lorsqu'on clique dessus (oranges)~hs~:
{CODE(wrap=>1, ishtml=>1)}
{img attId="57" thumb="y" link="tiki-download_wiki_attachment.php?attId=58&display" rel="box[g]"}
{CODE}
''Produira sur ce site~hs~:''%%%
{img attId="57" thumb="y" link="tiki-download_wiki_attachment.php?attId=58&display" rel="box[g]"}

!!! Empecher le redimensionnement d'une image dans les diaporamas
Le moteur de diaporama S5 de Tiki (voir ((PluginSlideShow|Plugiciel diaporama))) redimensionne les images automatiquemen par défaut afin d'afficher son contenu rapidement et d'afficher une petite vignette de l'image dans son coin supérieur droit.

Si vous préférez que l'image soit affichée avec ses dimensions d'origine, vous pouvez ajouter le paramètre __class="fixedSize"__ à votre plugiciel img. Exemple~hs~:

^{SPLIT(colsize="48%|4%|48%")} Ce code afficherai une petite vignette dans le coin supérieur droit du diaporama~hs~:

{CODE(caption="Code pour permettre de redimensionner et repositionner l'image", wrap="1")}
{img  src="display2" rel="box[g]" width="500"}
{CODE}
--- 
~hs~
--- Mais ce code permettrai d'afficher l'image avec ses dimensions d'origine de 500px et de la positionner où le code a été écrit.

{CODE(caption="Code pour garder les dimensions et la position originale", wrap="1")}
{img  src="display2" rel="box[g]" width="500" class="fixedSize"}
{CODE}
{SPLIT}^

!!Notes
Utilisez le champ source de l'image. Le SEF doit être activé pour pouvoir choisir une image dans une galerie de fichiers. Sinon vous devriez entrer "displayID" dans le champ source de l'image, où ID est le numéro d'identification de l'image dans la galerie.

{include page="Modules et Plugiciels Includes" start="startinclude2" stop="stopinclude2"}
*((Insérer des images)) - Informations générales sur l'insertion d'images dans les pages wiki
*((PluginColorbox|Plugiciel Colorbox)) - plugiciel affichant les images d'une galerie (de fichiers ou d'images) dans un diaporama
*((PluginFiles|Plugiciel Files)) - plugiciel utilisant le paramètre ''slideshow'' pour créer des diaporama surgissant
*((PluginGalleriffic|Plugiciel Galleriffic)) - plugiciel permettant d'afficher des images d'une galerie de fichiers en utilisant le module ''Jquery Galleriffic''