Plugin Catalogue

Les « variantes »

Les informations supplémentaires relatives à un article de catalogue sont saisies sous la forme de "variantes". Un article peut contenir une ou plusieurs variantes. Une variante contient les informations de prix, descriptif, taxes. Le principe est qu’on ne peut sélectionner qu’une seule variante de produit à la fois.

Pour l’instant Catalogue ne gère pas les "variantes de variantes" : par exemple un modèle de tee-shirt, proposé en 3 couleurs bleu, jaune et vert (1^re variante : couleur) chaque couleur existant en tailles L, XL ett XXL (2^de variante : taille).

Les « options »

Les options sont similaires aux variantes, à la différence que plusieurs d’options peuvent être sélectionnées en même temps. De même une option peut être attachée à un ou plusieurs articles. Le choix a été fait que les options n’ont pas d’existence propres en tant qu’article séparé.

Une évolution possible du plugin pourra être qu’une option soit définie en tant qu’article pouvant être sélectionné seul. Pour l’instant ce n’est pas le cas

Installation

Les fichiers du plugin Catalogue sont téléchargeables depuis la zone de SPIP.

Exemples

Exemple 1 : une conférence est proposée avec 5 prix différents selon la date de réservation ou le type de personne invitée. La conférence est un article, et les 5 prix sont 5 variantes.

Exemple 2 : un voyage est organisé avec 3 options différentes selon le type de prestation souhaité ; de plus chaque option est proposée avec un tarif différent selon la date de réservation : tarif pré-vente, tarif réservation, tarif normal. Dans ce cas il faut un article pour chaque option ; la sélection de ces 3 articles en vue de les présenter ensemble sur une page, peut être opérée sur la rubrique de ces articles, ou même un mot-clé. Ensuite, les variantes de ces produits peuvent être affichées (ou cachées) par exemple sur le critère de date. les variantes peuvent avoir les mêmes statuts que les articles (prepa, publie, redac, etc.)

Documentation

Principe

Avec le plugin Catalogue, vous pouvez transformer n’importe quel article de votre site SPIP en un article de catalogue. Pour cela, vous ajoutez simplement les informations concernant son prix (prix_ht), et éventuellement la taxe appliquée (tva), la disponibilité (statut) et la date de commercialisation (date_redac) depuis l’interface privée.

Réalisation

Ces informations sont stockées dans une nouvelle table SPIP, liée à la table des articles, la table spip_cat_variantes. Ainsi les articles proposés au catalogue se manipulent comme n’importe quels articles SPIP, avec leurs rubriques, sous-rubriques, auteurs, mots-clé, documents joints. Plusieurs variantes peuvent être attribuées au même article, par exemple avec des prix différents selon les dates de commande.

Fonctionnement

Imaginons que vous souhaitiez proposer la réservation en ligne de places pour un concert rock. Vous allez tout d’abord décrire le concert, l’habiller de photos, de vidéos, de mots clés, de liens, etc. Tout ceci sera fait dans un article SPIP tout a fait classique. Maintenant, vous souhaitez proposer 3 tarifs pour les places : un tarif « pré-vente » à 20€, un tarif « réservation » à 30€ et un tarif « sur place » à 45€.

Actuellement : Ajout manuel en phpMyAdmin
En cours de dév : depuis l’interface d’administration, éditez votre article, puis cliquez sur le bouton : « Ajouter au catalogue ».

De là, vous êtes invités à spécifier au moins une « variante », en indiquant le titre de la variante et prix. Dans notre cas, on commence par insérer la variante « tarif pré-vente » avec l’info prix « 20€ ». Si vous déclarez la TVA et que le prix est un prix TTC, il faut faire un petit calcul pour trouver le prix HT et indiquer la vraie valeur de la TVA, ou bien indiquer le prix TTC dans la case « prix_ht » et mettre la valeur de la taxe à 0.
On peut faire la même chose avec les variantes 2 et 3 à respectivement 30 et 45€.

Utilisation des boucles

Désormais, dans vos squelettes vous pouvez utiliser une nouvelle boucle <BOUCLE_v(CAT_VARIANTES)> au sein de vos boucles articles, avec comme critère éventuel {id_article}. Cette boucle vous proposera les champs suivants :
-  #ID_ARTICLE
-  #ID_VARIANTE
-  #TITRE
-  #DESCRIPTIF
-  #PRIX_HT
-  #TVA
-  #DATE
-  #DATE_REDAC
-  #MAJ

Filtres

Pour bien afficher les montants en Euros avec 2 chiffres après la virgule, utilisez le filtre ’monetaire’.

Modèles livrés en standard

Dans le #TEXTE d’un article vous pouvez utiliser le modèle <fiche> qui affichera les informations de prix relatives au produit que vous avez passé en paramètre.