La boucle CARACVAL : Différence entre versions

De TheliaDoc
Aller à : navigation, rechercher
(→‎Remarque)
Ligne 1 : Ligne 1 :
 +
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 ==
 
== Paramètres d'entrée ==
  
−
'''caracteristique''' : identifiant de la caractéristique
+
'''caracteristique''' : identifiant de la caractéristique (obligatoire)
  
−
'''produit''' : identifiant du produit
+
'''produit''' : identifiant du produit (obligatoire)
  
−
'''valeur''' : valeur de la caracval ( ! si différent )
+
'''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 caradisp
+
'''classement''' : seule valeur possible: 'caradisp', trie par identifiant de caradisp croissant.
  
−
'''article''' : article du panier
+
'''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 ==
 
== Paramètres de sortie ==
Ligne 15 : Ligne 19 :
 
'''#ID''' : identifiant de la caracval
 
'''#ID''' : identifiant de la caracval
  
−
'''#CARACDISP''' : caracdisp associée
+
'''#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
 
'''#CARACTERISTIQUE''' : caractéristique associée
  
−
'''#VALEUR''' : valeur 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''' : rubrique associée
+
'''#RUBRIQUE''' : identifiant de la rubrique a laquelle appartient le produit
  
 
'''#TITRECARAC''' : titre de la caractéristique
 
'''#TITRECARAC''' : titre de la caractéristique
−
 
−
'''#PRODUIT''' : identifiant du produit
 
  
 
'''#REF''' : référence du produit
 
'''#REF''' : référence du produit
  
−
'''#ARTICLE''' : article passé en paramètre
+
'''#PRODUIT''' : identifiant à l'identique du produit passé en paramètre d'entrée
  
−
== Remarque ==
+
'''#ARTICLE''' : numéro à l'identique de l'article passé en paramètre d'entrée
−
La boucle CARACVAL sert dans le cas d'une caractéristique à champ libre (ne pas créer d'item, lors de la création de la caractéristique ; vous aurez alors accès dans la fiche produit du B.O. à un champ libre personnalisable pour chaque produit).
+
  
−
La boucle CARACVAL sert à afficher la valeur de caradisp définie pour un produit et une caractéristique et ne fonctionne donc pas si l'on ne fournit pas de produit en paramètre d'entrée.
+
== Précisions importante sur les paramètres de sortie #VALEUR et #CARACDISP ==
  
−
La boucle CARACVAL ne semble pas fonctionner si on ne passe pas en paramètre d'entrée à la fois produit et caractéristique.
+
Les caractéristiques peuvent être classées en deux catégories:  
−
Pour info, cette boucle correspond aux valeurs des caractéristiques des produits. Du type, pour cette corde (paramètre en entrée : produit) la longueur (paramètre en entrée : caractéristique) vaut 12 mètres (paramètre en sortie : valeur)
+
  
−
== Exemples ==
+
# les caractéristiques à valeur libre: leur valeur doit être saisie dans un champ de type texte sur les fiches produit.
 +
# les caractéristiques à valeur contrainte: elles sont définies avec une liste finie de valeurs, les '''caracdisp'''s. Sur les fiches produits, on choisit la valeur de la caractéristique dans une liste, via un champ de type select.
  
−
     <THELIA_marque type="CARACVAL" produit="#PRODUIT_ID" caracteristique="2">
+
Pour les caractéristiques à valeur libre, #VALEUR contiendra le texte saisi dans la fiche produit. #CARACDISP sera vide.
−
         #TITRECARAC : #VALEUR
+
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.
 +
 
 +
== Exemple ==
 +
 
 +
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>
 
     </THELIA_marque>
−
    <//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]]
 
Retour [[Les boucles simples]]

Version du 21 juin 2012 à 18:56

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 : seule valeur possible: 'caradisp', trie par identifiant de caradisp croissant.

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

Exemple

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:

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

    •    </THELIA_carac>

Retour Les boucles simples

Récupérée de « http://wiki.thelia.net/wiki/index.php?title=La_boucle_CARACVAL&oldid=4635 »