La boucle IMAGE

De TheliaDoc
Aller à : navigation, rechercher

Paramètres d'entrée

produit : identifiant du produit (dans le cas où on veut les images associées à un produit )

rubrique : identifiant de la rubrique (dans le cas où on veut les images associées à une rubrique )

dossier : dossier associé (dans le cas où on veut les images associées à un dossier)

contenu : contenu associé (dans le cas où on veut les images associées à un contenu)

id : identifiant de l'image à afficher

source (1.5.2) : permet de désigner la source des images: produit, rubrique, dossier ou contenu. Si source est renseigné, le paramètre id doit contenir l'identifiant associé. Par exemple, si source="produit" et id="12", la boucle retournera les images du produit dont l'ID est 12.

num : nombre total d'images à afficher

nb : numéro de l'image à afficher. Par exemple, pour afficher la troisième image d'un produit, indiquer nb="3. Produit le même effet que deb="3" num="1"

deb : première image à afficher

largeur : largeur maxi de l'image désirée

hauteur : hauteur maxi de l'image désirée

exact : si exact=1 ou 2, et que hauteur et largeur ont été indiqués, l'image retournée aura exactement les dimensions demandées. Si nécessaire, des bordures seront ajoutées (si exact=1), ou l'image sera recadrée (exact=2). Incompatible avec le paramètre miroir. (A partir de Thelia 1.5.1 - exact=2 à partir de 1.5.2)

couleurfond : code RGB hexadecimal de la couleur à utiliser pour les bordures, la transparence et l'effet miroir. Exemple: ff0000 pour un rouge, aaaaaa pour un gris moyen, etc. Par défaut ffffff (blanc). (A partir de Thelia 1.5.1)

opacite : opacité de l'image (0-100)

noiretblanc : si ce paramètre vaut 1, l'image sera convertie en niveaux de gris.

miroir : si ce paramètre n'est pas vide, l'image sera retournée avec un effet de reflet vertical "miroir". A partir de Thelia 1.5.1, la valeur du paramètre miroir est la hauteur du reflet à générer. Par exemple miroir="30" permet de générer un reflet d'un hauteur de 30 pixels.

aleatoire : si ce paramètre vaut 1, les images seront retournées en ordre aléatoire.

exclusion : identifiant des images à exclure séparés par des virgules. Par exemple exclusion="1,2,7"


debut (déprécié) : idem deb

Paramètres de sortie

#PRODUIT : identifiant du produit associé (valué si le paramètre "produit" a été indiqué)

#PRODTITRE : titre du produit associé (valué si le paramètre "produit" a été indiqué)

#PRODREF : référence du produit associé (valué si le paramètre "produit" a été indiqué)

#RUBRIQUE : identifiant de la rubrique associée (valué si le paramètre "rubrique" a été indiqué)

#RUBTITRE : titre de la rubrique associée (valué si le paramètre "rubrique" a été indiqué)

#DOSSIER : identifiant du dossier associée (valué si le paramètre "dossier" a été indiqué)

#DOSTITRE : titre du dossier associée (valué si le paramètre "dossier" a été indiqué)

#CONTENU : identifiant du contenu associée (valué si le paramètre "contenu" a été indiqué)

#CONTTITRE : titre du contenu associée (valué si le paramètre "contenu" a été indiqué)

#IMAGE : URL de l'image transformée (redimensionnée, inversée, etc. suivant les paramètres d'entrée de la boucle).

#FICHIER : URL de l'image originale

#ID : identifiant de l'image

#TITRE : titre de l'image

#CHAPO : description courte de l'image

#DESCRIPTION : description longue de l'image

#COMPT : compteur débutant à 1. Utile pour l'utilisation de Javascript.


Paramètres dépréciés, à ne plus utiliser :


#NOMCACHE (déprécié) : idem #IMAGE

#CACHE (déprécié) : idem #NOMCACHE

#FGRANDE (déprécié) : idem #FICHIER

#FPETITE (déprécié) : idem #FICHIER

#GRANDE (déprécié) : idem #IMAGE

#PETITE (déprécié) : idem #IMAGE

Exemple(s)

Exemple n°1

    <THELIA_IMAGE type="IMAGE" produit="#ID" largeur="42">
        <a href="#FICHIER" target="_new">
           <img src="#IMAGE"  alt="#PRODTITRE" title="#PRODTITRE" border="0" />
        </a>
    </THELIA_IMAGE> 

Explications

Affiche toutes les images associées au produit concerné, en les redimensionnant à une largeur de 42 pixels.
Un lien permet d'afficher l'image originale en pleine résolution dans une nouvelle fenêtre.


Exemple n°2

<THELIA_IMAGE type="IMAGE" num="1" produit="#ID"  largeur="159" deb="2">
<img src="#IMAGE"  alt="#PRODTITRE  " title="#PRODTITRE  " border="0" class="contourImage" />
</THELIA_IMAGE>


Explications

Affiche la deuxième (deb="2") image d'un produit, et elle seule (num="1")


Exemple n°3

<THELIA_IMGRUB type="IMAGE" rubrique="#RUBRIQUE_ID">
   <img src="#IMAGE"  alt="#TITRE" />   
</THELIA_IMGRUB>


Explications

Affiche l'image associée à une rubrique ou sous rubrique.

Retour Les boucles simples