La boucle CARACVAL

De TheliaDoc
Aller à : navigation, rechercher

La boucle CARACVAL permet de récupérer des informations sur la ou les valeurs attribuées à une caractéristique pour un produit donné. Par exemple pour un produit "corde" la valeur de la caractéristique "longueur" est "12 mètres"

Les paramètres d'entrée "caracteristique" et "produit" sont obligatoires. Si ces deux paramètres sont absents ou contiennent des valeurs invalides, la boucle CARACVAL ne retournera rien.

Paramètres d'entrée

caracteristique : identifiant de la caractéristique (obligatoire)

produit : identifiant du produit (obligatoire)

valeur : demande à la boucle de ne retourner que les valeurs de caractéristiques identiques à la valeur indiquée. Préfixer la valeur par '!' pour retourner les valeurs de caractéristiques différentes de la valeur indiquée.

classement : 'caradisp', trie par identifiant de caradisp croissant. A partir de Thelia 1.5.4, son aussi disponibles les classements suivants: alpha (ordre alphabétique), alphainv (ordre alphabétique inverne), manuel (suivant le classement indiqué).

article : numéro d'article dans le panier. Ce paramètre n'a aucune action proprement dite, il est simplement retourné en sortie à l'identique par la boucle.

Paramètres de sortie

#ID : identifiant de la caracval

#CARACDISP : identifiant de la caracdisp associée. Vaut 0 (zéro) si la caractéristique est libre (voir explications plus bas).

#CARACTERISTIQUE : caractéristique associée

#VALEUR : valeur associée. Il s'agit soit du texte saisie dans la fiche produit, soit du titre de la caracdisp choisie dans la fiche produit (voir les explications plus bas).

#RUBRIQUE : identifiant de la rubrique a laquelle appartient le produit

#TITRECARAC : titre de la caractéristique

#REF : référence du produit

#PRODUIT : identifiant à l'identique du produit passé en paramètre d'entrée

#ARTICLE : numéro à l'identique de l'article passé en paramètre d'entrée

Précisions importante sur les paramètres de sortie #VALEUR et #CARACDISP

Les caractéristiques peuvent être classées en deux catégories:

  1. les caractéristiques à valeur libre: leur valeur doit être saisie dans un champ de type texte sur les fiches produit.
  2. les caractéristiques à valeur contrainte: elles sont définies avec une liste finie de valeurs, les caracdisps. Sur les fiches produits, on choisit la ou les valeurs de la caractéristique dans une liste, via un champ de type select.

Pour les caractéristiques à valeur libre, #VALEUR contiendra le texte saisi dans la fiche produit. #CARACDISP sera vide. Pour les caractéristiques à valeur contrainte, #VALEUR contiendra le titre de la caracdisp choisie sur la fiche produit. #CARACDISP contiendra l'identifiant (ID) de cette caracdisp.

Pour les caractéristiques à valeur contrainte, il est possible de sélectionner plusieurs valeurs (c.a.d caracdisps) sur une fiche produit en utilisant Ctrl+clic dans la liste. Dans ce cas, la boucle CARACVAL retournera toutes les valeurs sélectionnées.

Exemples

Pour afficher la valeur de la caractéristique ID=2 pour le produit courant:

   <THELIA_marque type="caracval" produit="#PRODUIT_ID" caracteristique="2">
       #TITRECARAC: #VALEUR (caracdisp: #CARACDISP)
   </THELIA_marque>

Pour afficher la valeur de toutes les caractéristiques du produit courant:

    <ul>
    <THELIA_carac type="caracteristique" produit="#PRODUIT_ID">
        <li>Caractéristique #TITRE (ID=#ID)
            <ul>
            <THELIA_caracval type="caracval" produit="#PRODUIT_ID" caracteristique="#ID">
                <li>Valeur: #VALEUR - caracdisp: #CARACDISP</li>
            </THELIA_caracval>
            </ul>
        </li>
    </THELIA_carac> 
    </ul>

Retour Les boucles simples