Attention Le plugin ne s’occupe pas de la gestion des paniers, ni des paiements, ni des factures. Pour l’aspect « boutique », voir le post-scriptum.
Ce plugin a été élaboré grâce aux contributions de Matthieu Marcillaud, Rastapopoulos, Yffic, touti, Cyril, et du rédacteur de cet article.
Principe
Le plugin agit sur 2 fronts :
→ d’une part il permet aux utilisateurs de gérer les commandes depuis l’espace privé.
→ d’autre part, il fournit les outils permettants et aux développeurs et aux autres plugins de créer et manipuler des commandes.
Installation et dépendances
Le plugin est repertorié dans le dépôt proposé par défaut : « SPIP-Zone - Plugins ». Aussi, il est installable depuis la page Gestion des plugins
, onglet Ajouter des plugins
si vous avez activé ce dépôt.
2 dépendances seront installées automatiquement :
D’autres plugins sont plus ou moins optionnels, là c’est à vous de voir :
- Notifications avancées : à installer si on veut bénéficier de l’envoi de notifications par email.
- Facteur : sans lui, les notifications seront au format texte au lieu d’un joli HTML.
- Coordonnées : fortement recommandé afin de pouvoir gérer les adresses liées aux commandes (livraison et facturation).
- Contacts et organisations : peut vous servir à gérer les auteurs/clients des commandes.
Fonctionnement
A l’installation, 2 tables sont créées :
- La table principale
spip_commandes
sert à enregistrer les données de base des commandes : l’auteur/client, le numéro de référence, le statut et les dates. - La table auxiliaire
spip_commandes_details
sert à enregistrer les « détails » correspondants aux commandes, c’est à dire tous les éléments à partir desquels on va pouvoir calculer le prix total d’une commande : objets et services commandés, frais annexes, ristournes etc.
En théorie, à chaque commande enregistrée dans la table spip_commandes
doit correspondre une ou plusieurs lignes de détails dans la table spip_commandes_details
.
La table spip_commandes :
Une commande est un objet éditorial, au même titre que les articles, brèves et cie. Elles ont un auteur (le client), différents statuts et 3 types de dates : date de création, date de paiement & date d’envoi.
La date de création correspond au champ « date », elle est définie à la création de la commande, et n’est pas censée être altérée par la suite.
Le changement d’un statut peut déclencher l’envoi de notifications par email, et la mise à jour de la date s’y rapportant :
→ passer le statut à "payée" met à jour la date de paiement.
→ passer le statut à "envoyée" met à jour la date d’envoi.
id_commande |
Identifiant unique de la commande |
reference |
Numéro de référence (il ne s’agit pas d’une clé unique). |
id_auteur |
Identifiant de l’auteur/client |
statut |
encours , attente , partiel , paye , envoye , retour_partiel , retour , erreur |
date |
Date de création |
date_paiement |
Date de paiement |
date_envoi |
Date d’envoi |
maj |
Date de la dernière mise à jour |
La table spip_commandes_details :
Pour le contenu des commandes, on parle de « détails » : chaque commande est constituée d’une ou plusieurs lignes de détails.
Un détail est tout élément qui participe au prix d’une commande.
On peut distinguer 2 types de détails :
- Les détails correspondants directement aux objets ou aux services commandés.
- Les détails « annexes » : il peut s’agir des frais de port, des frais de dossier, des ristournes etc.
Une ligne de détail comprend à minima les champs descriptif
et prix_unitaire_ht
, le cas échéant complétés par les champs taxe
et quantite
.
Dans le cas où l’objet commandé est un objet éditorial SPIP, des champs objet
et id_objet
permettent de l’identifier.
id_commandes_detail |
Identifiant unique du détail (attention au « s » à commandes) |
id_commande |
Identifiant de la commande concernée |
descriptif |
Texte décrivant le détail. S’il s’agit d’un objet éditorial, il peut s’agir de son titre, descriptif ou autre. |
quantite |
Quantité |
prix_unitaire_ht |
Prix Hors Taxe |
taxe |
Taxe (TVA) |
statut |
Statut |
objet |
Type d’objet s’il s’agit d’un objet éditorial |
id_objet |
Identifiant de l’objet s’il s’agit d’un objet éditorial |
maj |
Date de la dernière mise à jour |
Exemple des enregistrements en base pour une commande et ses détails
Prenons une commande de 2 objets avec TVA à 20%, comportant des frais de port et une ristourne. Dans la base de donnée, ça nous donne ceci :
1 ligne dans la table spip_commandes
id_commande | reference | id_auteur | statut | date | date_paiement | date_envoi | maj |
1 | xxxxxx | 1 | encours | 2014-05-14 09:00:00 | 0000-00-00 00:00:00 | 0000-00-00 00:00:00 | 2014-05-14 09:00:00 |
4 lignes dans la table spip_commandes_details
id_commandes
_detail |
id_commande | descriptif | quantite | prix
_unitaire_ht |
taxe | statut | objet | id_objet | maj |
1 | 1 | Gibolin 2000 | 2 | 8 | 0.2 | produit | 1 | 2014-05-14 09:00:00 | |
2 | 1 | Ripolin 5000 | 1 | 12 | 0.2 | produit | 2 | 2014-05-14 09:00:00 | |
3 | 1 | Frais de port | 0 | 4 | 0 | 2014-05-14 09:00:00 | |||
4 | 1 | Ristourne | 0 | -2 | 0 | 2014-05-14 09:00:00 |
Boucles et balises
Balises #PRIX
et #PRIX_HT
Grâce au plugin API prix, les balises #PRIX
et #PRIX_HT
permettent d’obtenir automagiquement les prix TTC et HT d’une commande ou d’un de ses détails.
Dans une boucle COMMANDES :
-
#PRIX
= somme des prix TTC des détails. -
#PRIX_HT
= somme des prix HT des détails.
Dans une boucle COMMANDES_DETAILS :
-
#PRIX
=#QUANTITE
* (#PRIX_UNITAIRE_HT
+ (#TAXE
*#PRIX_UNITAIRE_HT
)) -
#PRIX_HT
=#QUANTITE
*#PRIX_UNITAIRE_HT
.
Boucles
Exemple minimal de boucle affichant pour chaque commande un résumé de ses détails et son prix total TTC :
<BOUCLE_commandes(COMMANDES)>
<h4>Commande N°#ID_COMMANDE</h4>
<ul><BOUCLE_details(COMMANDES_DETAILS){id_commande}>
<li>[(#QUANTITE) *]#DESCRIPTIF = #PRIX</li>
</BOUCLE_details></ul>
Prix total TTC : #PRIX
</BOUCLE_commandes>
Gestion dans l’espace privé
Configuration
La page de configuration est accessible depuis le menu Configuration
> Commandes
On peut y gérer les 3 points suivants :
- La durée d’expiration des commandes ayant le statut « en cours ». On considère que les commandes restant « en cours » pendant plus d’un certain temps sont des commandes abandonnées : il est inutile de les conserver dans la base.
- l’activation et le fonctionnement des notifications (cf. plus bas).
- L’affichage en page d’accueil de la liste des commandes « actives » (cf. plus bas).
Liste des commandes
Une page Commandes
est accessible depuis le menu Edition
.
L’encart à gauche sert à filtrer les commandes en fonction de leurs états, de leurs dates de création, et des auteurs/clients.
Au niveau de la liste, les commandes ayant le statut « envoyé » sont surlignées en vert, afin de repérer facilement les commandes terminées.
Fiche d’une commande
La fiche d’une commande est composé de 3 parties :
- Le contenu de la commande : il s’agit d’un tableau listant les détails de la commande.
- Les adresses : si le plugin Coordonnées est installé, sont affichées les adresses associées à la commande, ou à défaut celles associées à l’auteur de la commande.
- L’auteur/client de la commande : si le plugin Contacts et Organisations est installé, on affiche les infos du contact, sinon des infos sur le client.
A noter : Pour les adresses, il n’est pas nécessaire d’activer l’ajout de coordonnées aux commandes dans les options du plugin Coordonnées.
Commandes « actives »
Il est possible d’afficher en page d’accueil la liste des commandes « actives ». il s’agit des commandes nécessitant une prise en charge. Pour se faire, il faut activer l’option dans la configuration du plugin, et choisir les statuts correspondants.
Notifications
Mise en place
On peut activer ’envoi d’emails de notification au vendeur et au client lorsque les commandes acquièrent certains statuts.
Le plugin « Notifications avancées » doît être installé. Le plugin Facteur est également fortement recommandé afin d’envoyer les messages au format HTML.
Rendez vous ensuite sur le formulaire de configuration du plugin pour activer et configurer les notifications.
Personnalisation des emails
Par défaut, les messages envoyés sont spartiates :
Leurs squelettes sont présents dans le répertoire /notifications
du plugin.
Pour chaque type de notification (vendeur
& client
), il y a 3 variantes :
-
commande_xxx_html.html
au format HTML. -
commande_xxx.html
au format texte brut. -
commande_xxx_court.html
au format court, type microblog ou SMS.
Par commodité, ces 6 squelettes incluent tous le même squelette mutualisé, avec différents paramètres pour moduler l’affichage : contenu_commande_mail.html
.
Il suffit de surcharger ce squelette pour le personnaliser selon vos besoins.
Si vous avez besoin de 2 squelettes vraiment différents pour les emails vendeur et client, vous pouvez au choix :
- Faire ça au niveau du squelette
contenu_commande_mail.html
en jouant sur le paramètre#ENV{qui}
:[(#ENV{qui}|=={client}|oui)<INCLURE{fond=mon_squelette_mail_client, env}>][(#ENV{qui}|=={vendeur}|oui)<INCLURE{fond=mon_squelette_mail_vendeur, env}>]
- Ou bien surcharger directement les 6 squelettes clients et vendeurs.
Fonctions utiles
Voici une liste non exhaustive de certaines fonctions, celles qui pourront vous être utiles lors de l’intégration du plugin dans votre projet. Pour les détails (paramètres etc.) et la liste complète, voir le site https://code.spip.net/commandes/.
commandes_lister_statuts Cette fonction retourne les différents statuts des commandes. On peut s’en servir comme filtre dans les squelettes pour obtenir la chaîne de langue d’un statut : [(#STATUT|commandes_lister_statut)] |
creer_commande_encours Crée une commande avec le statut « en cours » pour le visiteur actuel. La commande créée est « vide » : la fonction ne se charge pas de créer les détails. C’est le rôle des plugins tiers (Commandes de paniers par ex.). A noter : on considère qu’il ne peut y avoir qu’une commande « en cours » par session et par auteur. Si une telle commande est déjà présente dans la session, elle va être supprimée de la base et de la session avant la création de la nouvelle.
|
commandes_supprimer Permet de supprimer « proprement » une ou plusieurs commandes, en s’occupant également des données associées. Pour chaque commande à supprimer, la fonction effectue les actions suivantes : - suppression de la commande - suppression de ses détails - dissociation de ses adresses liées, et éventuellement suppression si elles se retrouvent orphelines. Exemple :
|
traiter_notifications_commande Envoie les notifications par email d’une commande, si les conditions sont réunies. Cette fonction est appelée lors de la création d’une commande, puis à chaque changement de statut. |
inc_commandes_reference_dist Cette fonction retourne une référence unique utilisée pour remplir le champ éponyme lors de la création d’une commande. Il s’agit du temps écoulé depuis le 1er janvier 1970, en secondes. Elle est destinée à être surchargée pour l’adapter à vos besoins. |
supprimer_commande Supprime « proprement » une commande. Fait appel à la fonction commandes_effacer , avec les mêmes effets donc.Exemple : #URL_ACTION_AUTEUR{supprimer_commande,#ID_COMMANDE,#SELF} |
instituer_commande Change le statut d’une commandes Exemple : #URL_ACTION_AUTEUR{instituer_commande,#ID_COMMANDE-envoye,#SELF} |
Discussions par date d’activité
38 discussions
Avec le plugin 1.4.9 les courriels-notifications (client et vendeur) n’ont pas de description des produits achetés ni de prix.
Je n’ai pas touché aux fichiers de notification du plugin et j’ai facteur 3.0.20 et notifications avancés 0.2.1
Voir mangersaison.com il y a un produit pour le test
http://www.mangersaison.com/Pour-tester-le-processus-d-achat
Répondre à ce message
Bonjour et merci pour cette doc,
j’envisage de mettre en place une boutique de vente de tirages photo. Une unique photo sera proposée en plusieurs formats. Et chaque format aura un prix différent.
Ma question est de savoir comment structurer l’arborescence de départ ? J’ai dans l’idée qu’il faut une rubrique pour chaque image et un article pour chaque format/prix ? C’est un peu lourd, mais c’est ce que j’ai compris en lisant la doc ici et sur la page du carnet wiki.
Donc, en résumé, une rubrique/image et un article/format/prix (et x articles pour décliner format/prix) ? Pouvez-vous me confirmer que c’est la méthode qui s’applique dans mon cas ?
Merci d’avance,
Rémy
P.S. Dans un second temps, j’aimerais proposer en plus non pas des tirages mais l’achat direct de fichiers numériques. Est-ce-que ce plugin pourra répondre à ce besoin ?
Bonjour,
Techniquement, l’arborescence n’a pas d’impact direct sur la gestion des commandes, utilisez celle qui vous semble la plus intuitive et la plus simple. Une rubrique par photo et un article par format, ça me semble ok.
La seule chose qui importe, c’est que techniquement, la commande soit objet éditorial SPIP : ça peut être un article, mais aussi une rubrique, voir une brève, etc.
Après, dans l’idéal, je pense qu’il vaut mieux utiliser autre chose que les articles pour faire de la vente.
Il y a bien le plugin « produits » qui ajoute justement un objet « produit » avec tous les champs qu’il faut : prix, taxe etc. Mais la version pour SPIP 3 n’est pas encore fonctionnelle, et il ne prend pas en compte la notion de « déclinaison », or c’est ce dont vous auriez besoin pour gérer les différents formats.
En ce qui concerne l’achat de fichiers numériques, oui c’est possible, mais il faut mettre en place un système de téléchargement des fichiers, les protéger et tout ça.
Mais là on sort du domaine du plugin Commandes : la mise en place d’une boutique fera l’objet d’un article à part, il s’agit d’une question assez vaste.
Pour rappel, le plugin Commandes est juste une des briques nécessaires pour faire de la vente en ligne.
Merci pour votre réponse rapide et claire.
En effet la vente de fichiers numériques nécessite de sécuriser l’accès aux fichiers, etc. Dans un premier temps, si j’arrive à mettre en place la vente de tirages ce sera déjà très bien.
Bonne journée,
Rémy
Le top du top, ce serait de pouvoir lier le plugin declinaison produit avec le plugin commande.
Je sais, c’est beaucoup demander...
Mais je suis sûr qu’un jour, ce sera possible !
Répondre à ce message
Ce plugin va-t-il être compatible SPIP 3.1
Il l’est peut-être déjà, il n’y a pas vraiment de différence majeure. Il faut le tester en changeant la borne supérieure dans le XML, en utilisant ses fonctionnalités, et si c’est bon, le dire soit ici soit sur la liste spip-zone (ou demander un compte pour le SVN et modifier directement :D).
Répondre à ce message
Bonjour,
J’utilise ce plugin, et j’arrive sur la page « commande_terminee » avec tous les produits choisis dans le panier et leur prix respectif.....ma question est la suivant si je veux le règlement se face par paypal qu’est ce qu’il faut faire ? j’ai déja installé les plugins paypal et « commande payées avec payppal »
Mais je ne sais pas qu’est ce qu’il faut intégré et ou ? pour pouvoir régler par paypal avec le recap du panier et les prix. Merci de votre aide
Bonjour ???,
Le documentation du plugin « Paypal » pourra vous aider : http://contrib.spip.net/Paypal-4519.
Il suffit de placer sur votre page le formulaire Paypal avec les bons paramètres.
Répondre à ce message
Bonjour,
Je cherche à utiliser le plugin « Abonnements 2 » qui semble très prometteur mais très peu documenté, je n’ai pas trouvé le moyen de le coupler à un système de paiement sécurisé, faut-il passer par un plugin de gestion de commandes comme celui ci ?
Si quelqu’un a un peu de doc pour moi pour Abonnements, je suis preneur !
Merci :)
Freed
La doc est terminée, elle est programmée pour être publiée samedi midi. Si tu as un compte ici, c’est là :
http://contrib.spip.net/Abonnements-4607?var_mode=preview
et là :
http://contrib.spip.net/Abonnements-a-des-zones-restreintes?var_mode=preview
Pour ce qui est du paiement, il n’y a encore aucun automatisme pour l’instant, mais c’est prévu normalement dans le mois qui arrive, par une liaison avec Commandes et Bank.
Merci pour ta réponse, je vais donc faire à ma façon en attendant
Répondre à ce message
Lorsque je fais la mise à jour du plugin de 1.2.6 à 1.4.8 j’obtiens une page blanche sur http://www.mangersaison.com/mang/ecrire
J’ai jeté les plugins commandes_panier et quantimandes et j’ai quand même une page blanche sur /ecrire
Je suis donc revenu à la 1.2.6 avec commandes_panier 0.15 et le plugin spécial quantimandes et le tout fonctionne.
Je pensais que le « bug » était dû à quantimandes qui nécessite dans paquet.xml
<necessite nom="commandes" compatibilite="[1.2.0;]" ></necessite>
mais ce n’est pas la bonne piste puisque même si le plugin quantimandes est jeté l’activation de commandes 1.4.8 génère toujours une page blanche dans écrire ???? QUE faire pour tenir le tout à jour ???Quand il y a une page blanche, c’est qu’il y a des erreurs PHP. Par défaut ça ne s’affiche pas, il faut ajouter des directives (dans config/mes_options.php par exemple) pour que ça s’affiche. Une fois les erreurs affichées, on sait déjà mieux de quoi il retourne.
Pour info cette semaine le plugin Commandes a eu une mise à jour notoire qui transforme les détails de commandes en vrai objet SPIP, et qui permet de les modifier manuellement (ainsi que d’en ajouter à la main).
Mais du coup le plugin « Commandes de Paniers » (panier2commande) n’était plus raccord. Tcharlss a corrigé ça hier !
Merci
J’ai installé le plugin 1.4.9 et maintenant tout fonctionne à merveille !
Répondre à ce message
Bonjour,
Je suis en train de monter un site e-commerce en SPIP, pour mon plus grand plaisir...
Après la confirmation de la commande, je souhaiterai décrémenter un champ Quantité que j’ai défini avec « Champs Extra ».
Cela est-il possible ?
Merci !
Bonjour,
Oui c’est possible, la façon de procéder dépend de plusieurs choses :
- déjà, qu’est-ce que vous entendez par « confirmer » la commande : est-ce au moment où le panier est validé ? Ou quand le visiteur choisit des adresses pour la commande ? Ou quand la commande aquiert un statut précis ?
- ensuite, comment avez-vous mis en place la partie e-commerce de votre site ? Quels autres plugins sont installés ? Y a-t-il des formulaires persos ?
Il va très certainement falloir utiliser un pipeline pour compléter les traitements d’un formulaire, mais sans plus de détail, impossible de vous dire lequel et comment.
Bonjour,
Merci pour ce retour.
Je souhaite décrémenter la quantité lorsque la commande a été payée.
Le champ Quantité a été ajouté dans Articles avec « Champs Extras ».
Ensuite, j’utilise les plug-ins Paniers, Commande de paniers et les plug-ins paypal.
Une possibilité est se se brancher sur le pipeline « traitement_paypal » du plugin Commandes payées avec Paypal.
Ce pipeline est utilisé au moment où la notification de paiement (IPN) de Paypal est réceptionnée, donc c’est le plus indiqué.
L’idéal serait de faire ça dans un petit plugin perso, sinon dans
mes_options.php
.Voilà un exemple de base, à adapter à vos besoins. Attention, j’ai pas testé, il y a peut-être des coquilles qui trainent.
Merci beaucoup !
Je vais tester çà !
Répondre à ce message
J’ai ajouté avec le plugin champ extra un champ quantite.
J’ai créé dans plugin un dossier intitulé : editer_commande
J’y ai mis un fichier nommé plugin.xml
puis j’ai ajouté un fichier nommé editer_commande.php
J’ai été coché acheté dans l’interface de commandes en espace privé.
Cela ne fonctionne pas. Les quantités ne bougent pas.
Je ne sais pas comment faire pour gérer les quantités une fois que le produit a été coché acheté
Bonjour,
Pour les gens qui aimeraient suivre, le message fait suite à une discussion sur la liste spip users. La question était la suivante :
Je vais vous faire à peu près la même réponse que la pour question précédente : la gestion des quantités n’est pas gérée par le plugin, les options dans l’interface n’auront aucun effet sur ce point. Le mieux, c’est de gérer ça dans un plugin perso adapté à vos besoins, comme vous le faîtes.
Par contre, c’est très déconseillé de surcharger le fichier
editer_commande.php
(et puis quelles modifs y apportez vous ? on ne saura pas... ), il vaut mieux passer par un pipeline.L’idée de base serait de décrémenter le champ « quantite » des articles d’une commande quand elle acquiert le statut « paye », via le pipeline « post_edition ».
Donc dans
ed_com_pipelines.php
(et en déclarant le pipeline danspaquet.xml
) :Bon, c’est juste un exemple de base, avec un calcul des quantités tout simple.
C’est à compléter et à adapter à votre situation.
C’est dommage que ce plugin ne gère pas les stocks car pour le reste il est parfait et ma boutique en développement avec SPIP fonctionne à merveille.
Je n’ai jamais fait de plugin, je ne connais pas les pipelines. J’ai lu http://programmer.spip.net/Utiliser-les-pipelines puis j’ai découvert que post_edition est déjà dans SPIP http://code.spip.net/autodoc/pipelines/post_edition.html puis j’ai rédigé un paquet http://plugins.spip.net/redaction-du-paquet-xml.html je l’ai validé http://plugins.spip.net/validation/
J’ai copié le code fourni ci_haut dans un fichier ed_com_pipelines.php que j’ai placé dans le nouveau plugin au même niveau que le paquet. Sur l’article qui affiche le produit j’ai ajouté un champ #QUANTITE en espérant que celui-ci diminuerait après avoir fait des achats.
Voici le paquet
Il y a sûrement une ou des erreurs car cela ne fonctionne pas.
Merci de m’aider.
C’est normal que ce plugin ne gère pas les quantités, car ça n’a aucun rapport avec « une commande ». Ce plugin ne fait qu’une seule chose, comme tous les plugins de la suite de commerce (Produits ne fait que des listes de produits, Paniers ne gère que les paniers, etc).
Dans le code au-dessus, je vois au moins à changer « >= 0 » pour le test de mise à jour de la quantité. Car elle peut bien évidemment être à 0. Par ailleurs les parenthèses ne sont pas du tout au bon endroit.
Il faut au moins remplacer :
Par :
Mais il y a peut-être d’autres choses, je n’ai lu que rapidement…
Répondre à ce message
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires : |