La boucle PRODUIT spip et thelia

De TheliaDoc
Aller à : navigation, rechercher
Erreur lors de la création de la miniature : Impossible d'enregistrer la vignette sur la destination

le plugin thelia-spip

Attention ces boucles nécessitent l'installation du plugin spip-thelia

Param entrée

rubrique: rubrique du produit

deb : premier produit

num : nombre de produits

bloc : nombre de blocs ( si utilisation de tableaux )

nouveaute : 0 ou 1 ( produit nouveau : nouveaute="1" ; ou non )

promo : 0 ou 1 ( en promo : promo="1" ; ou non ) 

<form action="#URL_PAGE{panier,lang=#LANG}" method="post" id="formAjouter">
<input type="hidden" name="thelia_action" value="ajouter" />
<input type="hidden" name="ref" value="THELIA-REF" />
<T_produitpromo>
<THELIA_produitpromo type="PRODUIT" ref="THELIA-REF" promo="1">
<span class="thelia_promo">THELIA-PRIX2 €</span> au lieu de THELIA-PRIX €
</THELIA_produitpromo>
</T_produitpromo>
THELIA-PRIX €
<//T_produitpromo>
</form>

reappro : 0 ou 1 ( en réappro : reappro="1" ; ou non ) 

<form action="#URL_PAGE{panier,lang=#LANG}" method="post" id="formAjouter">
<input type="hidden" name="thelia_action" value="ajouter" />
<input type="hidden" name="ref" value="THELIA-REF" />
<T_produitreappro>
<THELIA_produitreappro type="PRODUIT" ref="THELIA-REF" reappro="1">
<span class="thelia_reappro">en cours de reapprovisionnement</span>
</THELIA_produitreappro>
</T_produitreappro>
<input type="submit" class="LIEN_commander" value="ajouter panier" />
<//T_produitreappro>
</form>

ref : référence produit

id : id produit

garantie : nb année garantie

motcle : mot clé

classement : prixmin, prixmax, rubrique, manuel, inverse, date, titre, titreinverse

aleatoire : 0 ou 1 ( aléatoire ) (attention : pensez a l'argument nocache="1" pour vider le cache)

prixmin : prix mini

prixmax : prix max

caracteristique : caractéristique produit (identifiant). 

  Ce paramètre n'est utilisé que si une valeur de caracdisp ou caracval est définie.
  Si une de ces deux valeurs est défine il est alors obligatoire.

caracdisp : valeur de la caractéristique ( identifiant dans une liste ) 

  Pour le paramètre caracdisp les valeurs caracteristique doivent être séparées par un tiret -.

Si une seule valeur est passée en paramètre le tiret - reste obligatoire pour les paramètres caracteristique et caracdisp. 

  exemples : 
  <THELIA_PROD type="PRODUIT" caracteristique="3-" caracdisp="16-">
  <THELIA_PROD type="PRODUIT" caracteristique="3-" caracdisp="16-22">
  <THELIA_PROD type="PRODUIT" caracteristique="3-4" caracdisp="16-">
  <THELIA_PROD type="PRODUIT" caracteristique="3-4" caracdisp="16-22">
  
  Astuces

Pour afficher tous les produits d'une ou plusieurs valeurs de caracteristique quelque soit la valeur de caracdisp 

  <THELIA_PROD type="PRODUIT" caracteristique="3-" caracdisp="*-">

Pour afficher tous les produits d'une ou plusieurs valeur de caracteristique sans valeur de caracdisp 

  <THELIA_PROD type="PRODUIT" caracteristique="3-" caracdisp="--">

caracval : valeur de la caractéristique ( manuel )

typech : prend comme valeur like. Permet de faire une recherche sur une caractéristique libre. Est donc en association avec l'entrée caracval

declinaison : déclinaison produit

declidisp : valeur de la déclinaison ( dans une liste )

declival : valeur de la déclinaison ( manuel )

declistockmini : stock mini (si déclinaison)

stockmini : stock mini (sans déclinaison)

courant : 1 si produit courant, 0 sinon

profondeur  : profondeur dans l'arborescence

exclusion : id à exclure --> ex : « 1,2,7 »

poids  : poids du produit

stockvide ' : (0 ou x)

ligne  : (0 ou 1) Permet de forcer l'pparition de produit hors ligne (ligne="0"). Par défaut ce paramètre est à 1 si non mentionné.

forcepage  : (0 ou 1) force la boucle à garder page=1 en paramètre. Utile pour afficher des promos par exemple dans un bas de page. Si on change de page alors cette boucle gardera toujours le même deb et num.

Param sortie

THELIA-REF : référence produit

THELIA-COMPT : compteur de produit

THELIA-DATE : date de dernière modif

THELIA-HEURE : heure de la dernière modif

THELIA-DEBCOURANT : début courant ( voir exemple ci-dessous )

THELIA-ID : id du produit

THELIA-PRIX : prix TTC du produit

THELIA-PRIXHT : prix HT du produit

THELIA-PRIX2 : prix promotionné

THELIA-PRIX2HT : prix HT promotionné

THELIA-PRIXORIG : prix TTC d'origine (avant application d'une éventuelle réduction pour un client)

THELIA-PRIXORIGHT : prix HT d'origine (avant application d'une éventuelle réduction pour un client)

THELIA-PRIX2ORIG : prix TTC promotionné d'origine (avant application d'une éventuelle réduction pour un client)

THELIA-PRIX2ORIGHT : prix HT promotionné d'origine (avant application d'une éventuelle réduction pour un client)

THELIA-POURCENTAGE : pourcentage de réduction

THELIA-PROMO[ ...oui... ][ ...non... ] : afficher quelque chose si la promo est activée, et sinon autre chose 

THELIA-PROMO[
    <strong>THELIA-PRIX2 €</strong> <del>(THELIA-PRIX €)</del>
][
    <strong>THELIA-PRIX €</strong>
]

THELIA-RUBRIQUE : rubrique du produit

THELIA-PERSO : objet personnalisable ( 0 ou 1 )

THELIA-STOCK : quantité disponible en stock

THELIA-POIDS : poids du produit

THELIA-TITRE : titre du produit

THELIA-STRIPTITRE : titre du produit sans les tags HTML

THELIA-CHAPO : chapo du produit

THELIA-STRIPCHAPO : chapo sans les tags HTML

THELIA-DESCRIPTION : description du produit

THELIA-STRIPDESCRIPTION : description du produit sans les tags HTML

THELIA-POSTSCRIPTUM : postscriptum du produit

THELIA-URL : url du produit

THELIA-REWRITEURL : url réécrite du produit

THELIA-GARANTIE : nombre d'années de garantie du produit

THELIA-PANIER : url d'ajout au panier

THELIA-PANIERAPPEND : url d'ajout au panier forçcant l'incrémentation de la quantité commandé (si le produit est déjà dans le panier, la quantité sera alors augmenté).

THELIA-RUBTITRE : titre de la rubrique

THELIA-ECOTAXE : ecotaxe

THELIA-ECOTAXEHT : ecotaxe HT

THELIA-TVA : taux de tva

THELIA-APPRO : date d'appovisionnement

Substitutions produits

THELIA-PRODUIT_REFORIG : retourne l'attribut reforig passé en paramètre d'url celui-ci est utilisé lorsque l'on veut connaître la référence du produit ayant conduit à une page donnée. ( page accessoire par ex )

THELIA-PRODUIT_REF : retourne l'attribut ref passé en paramètre d'url. On l'utilise généralement pour appeler la page produit en spécifiant le produit à afficher.

THELIA-PRODUIT_ID : retourne l'attribut id_produit passé en paramètre d'url. On l'utilise généralement pour appeler la page produit en spécifiant le produit à afficher.

THELIA-PRODUIT_MOTCLE : retourne l'attribut motcle passé en paramètre d'url. On l'utilise généralement pour appeler la page recherche en spécifiant un mot clé.

THELIA-PRODUIT_NOM : retourne le titre du produit.

THELIA-PRODUIT_RUBRIQUE : rubrique du produit en cours

THELIA-PRODUIT_CLASSEMENT : choix du classement

THELIA-PRODUIT_PRIXMIN : prix minimum

THELIA-PRODUIT_PRIXMAX : prix maximum

THELIA-PRODUIT_CHAPO : chapo du produit

THELIA-PRODUIT_POSTSCRIPTUM : postscriptum du produit

THELIA-PRODUIT_NOUVEAUTE : produit nouveau (0 ou 1)

THELIA-PRODUIT_PROMO : produit en promo (0 ou 1)


Afficher un produit spip et thelia

La boucle PRODUIT permet d’afficher un ou plusieurs produit(s), elle récupère toutes les informations concernant un produit.

Exemple de la boucle PRODUIT : 

<THELIA_PROD type="PRODUIT" ref="THELIA-PRODUIT_REF">

     <div>THELIA-TITRE</div>

</THELIA_PROD>

Description de la boucle :

  • Le préfixe <THELIA_ permet d'identifier la boucle produit
  • PROD est le nom de la boucle, librement choisi par le webmestre, pour chaque boucle qu’il utilise.
  • Pour afficher un produit, il faut utiliser une boucle de type PRODUIT et lui donner un identifiant unique.
  • Pour cela on peut utiliser la référence du produit ou l'id du produit.
  • L’argument ref est un paramètre entrant qui permet de définir une référence de produit, cela permettra de faire apparaître un seul produit.
  • La valeur THELIA-PRODUIT_REF permet de récupérer la référence passée en paramètre lors de l'appel de la page.
  • THELIA-TITRE est un paramètre sortant qui affichera le titre du produit.
  • Le titre est entouré d’une balise div où l’on peut mettre un style.

affichage d'un produit avec image, titre et description 

<THELIA_PROD type="PRODUIT" ref="THELIA-PRODUIT_REF">
<THELIA_img type="IMAGE" num="1" produit="THELIA-ID" largeur="300">
<a href="THELIA-" onclick="window.open('#URL_PAGE{imgpop,ref=THELIA-PRODUIT_REF&id_image=THELIA-ID}',
 '', 'toolbar,width=600,height=840')">
<img src="THELIA-IMAGE"  alt="THELIA-PRODTITRE" title="THELIA-PRODTITRE" class="contourImage"
  id="photozoom" /></a>		
</THELIA_img>
<form action="#URL_PAGE{panier,lang=#LANG}" method="post" id="formAjouter">
<input type="hidden" name="thelia_action" value="ajouter" />
<input type="hidden" name="ref" value="THELIA-REF" />
THELIA-TITRE
THELIA-DESCRIPTION
<input type="submit" class="LIEN_commander" value="ajouter panier" />
</form>
</THELIA_PROD>

Affichage d'une page catalogue spip et thelia

L’affichage du catalogue est l’affichage des produits d’une rubrique. Pour cela, il faut utiliser une boucle de type produit avec en paramètre l’id de la rubrique (rubrique="THELIA-RUBRIQUE_ID"). 

<THELIA_PROD type="PRODUIT" rubrique="THELIA-RUBRIQUE_ID" num="6">
<form action="#URL_PAGE{panier,lang=#LANG}" method="post" id="formAjouterTHELIA-ID">
<input type="hidden" name="thelia_action" value="ajouter" />
<input type="hidden" name="ref" value="THELIA-REF" />
<a href="THELIA-REWRITEURL">
<THELIA_IMAGE type="IMAGE" num="1" produit="THELIA-ID" largeur="159">
<img src="THELIA-IMAGE"  alt="THELIA-PRODTITRE  " title="THELIA-PRODTITRE" class="contourImage" />
</THELIA_IMAGE>
THELIA-TITRE
THELIA-DESCRIPTION
<input type="submit" class="LIEN_commander" value="ajouter panier:>" />
</form>
</THELIA_PROD>

Cette boucle permet d’afficher six produits dans la rubrique en cours

  • avec son titre, son chapeau, sa description et enfin une image.
  • L’argument Rubrique permettra de récupérer dans la base de données tous les produits qui correspondent à cette rubrique.
  • La valeur de cet argument sera un chiffre correspondant à l’identifiant de la rubrique.
  • les paramètres sortant qui permettront d’afficher les informations relatives au produit
  • THELIA-TITRE le titre.
  • THELIA-DESCRIPTION le descriptif.
  • L’argument num permet de choisir le nombre ici de produit à afficher.
  • La boucle de type IMAGE permet d’afficher les images ici d’un produit.
  • Largeur est un argument qui redimensionne l’image avec une largeur de 105 px.
  • L’argument produit permet d’identifier le produit qui correspond à l’image.
  • THELIA-ID est un paramètre de sortie de la boucle produit qui donnera l’identifiant du produit à la boucle IMAGE.
  • La balise pour insérer une image est img, nous allons donc créer une balise image avec pour attribut src="THELIA-IMAGE" (chemin de l’image).
  • Le paramètre alt="THELIA-PRODTITRE de la balise HTML img permet d'afficher un texte alternatif lorsque l'image ne s'affiche pas.
  • Donc, nous ajoutons la valeur THELIA-PRODTITRE qui renvoie le titre du produit.
  • De même, le paramètre title="THELIA-PRODTITRE" donne le titre de l’image et donnera ici le titre du produit.


--alainormandie 19 septembre 2008 à 12:00 (CEST)

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