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 :
Paramètres
Les paramètres de ce plugiciel sont détaillés ci-dessous, organisés en onglets :
| 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")
| 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 |
| 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. |
| 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 |
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 |
| 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 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 |
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 :
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
|
|
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
|
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