Plugin Img

Ce 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 :

Syntaxe

Syntaxe du plugiciel IMG

Copy to clipboard

{img id= , fileId= , attId= , src= ,  randomGalleryId= , height= , width= , max= , link= , thumb=, rel= , usemap= , class= , imalign= , styleimage= , align= , stylebox= , styledesc= , block= , desc= , title= , alt= }

Quelques exemples :

Jolies poires

Cliquez ici pour voir le code...

Copy to clipboard

{img src="img/wiki_up/393px-Pears.jpg" thumb="y" imalign="center" stylebox="border" button="y" desc="Jolies poires" max="200" rel="box"}

Note : cliquez sur l'image ou le bouton pour agrandir.

Commit screenshot

Cliquez ici pour voir le code...

Copy to clipboard

{img attId="37", thumb="mouseover", styleimage="border", desc="desc", max="150"}

Note : placez votre souris sur l'image pour agrandir.

Cliquez ici pour voir le code...

Copy to clipboard

{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"}

Note : image aléatoirement choisie dans une galerie de fichiers avec cadre mis-en-forme.

Paramètres

Les paramètres de ce plugiciel sont détaillés ci-dessous, organisés en onglets :

No Tabs

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.

Note

Les règles suivantes s'appliquent aux paramètres ci-dessus :

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é.

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 ; 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 : l'image est affichée dans le navigateur de galerie d'images ; 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 : 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
rel	Une des valeurs supportées par HTML pour l'attribut rel de la balise anchor (<a>)	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 lusemap dans une page wiki autre que le plugiciel HTML. (Voir la liste de diffusion Tiki-Dev, http://comments.gmane.org/gmane.comp.cms.tiki.devel/24777.)

Paramètre	Valeur acceptées	Effet
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.
height	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.
width	pourcentage
max	Nombre de pixels	Le plus grand coté (largeur ou hauteur) sera défini par cette valeur et les proportions seront mainenues

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.''

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
styleimage	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.
stylebox	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 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.
noDrawIcon	n

Note

Pour utiliser une syntaxe CSS complète, entrez les paramètre et valeurs avec les virgules et point-birgules nécessaires. Par exemple : padding-left: 2cm; border: 1px solid black. Vous trouverez un guide de référence de syntaxe CSS sur le site w3schools.com ici.

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 : "Image".

Exemples

Image-lien alignée à droite

Ce code :

Copy to clipboard

{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.

Produira sur ce site :

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.

Astuce

Voir 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

Insérer plusieurs images sur une ligne

Ce code :

Copy to clipboard

{IMG(attId="57|58|59" desc="desc" alt="Exemple d'images" stylebox="float: left; margin-right:10px")}{IMG}

Produira sur ce site :

Apples

Oranges

Apples and oranges

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) :

Copy to clipboard

{img attId="57" thumb="y" link="tiki-download_wiki_attachment.php?attId=58&display" rel="box[g]"}

Produira sur ce site :

Empecher le redimensionnement d'une image dans les diaporamas

Le moteur de diaporama S5 de Tiki (voir 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 :

Ce code afficherai une petite vignette dans le coin supérieur droit du diaporama :

Code pour permettre de redimensionner et repositionner l'image

Copy to clipboard

{img  src="display2" rel="box[g]" width="500"}

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 pour garder les dimensions et la position originale

Copy to clipboard

{img  src="display2" rel="box[g]" width="500" class="fixedSize"}

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.

Pages liées

Plugiciels Wiki
Mods Type Wikiplugins
Insérer des images - Informations générales sur l'insertion d'images dans les pages wiki
Plugiciel Colorbox - plugiciel affichant les images d'une galerie (de fichiers ou d'images) dans un diaporama
Plugiciel Files - plugiciel utilisant le paramètre slideshow pour créer des diaporama surgissant
Plugiciel Galleriffic - plugiciel permettant d'afficher des images d'une galerie de fichiers en utilisant le module Jquery Galleriffic