Ce plugin est une mise à niveau pour la version SPIP 2.1.8 du Plugin GoPayPal qui était resté en SPIP 1.9.2 depuis 3 ans. Il
change de nom pour ne pas faire trop de pub à une entreprise bancaire critiquable.
La présente version reprend les tables SQL de la version initiale, toutefois le champ "id_devise" a été renommé "devise" pour respecter la règle implicite qu’un champ de préfixe "id_" est un entier.
La balise principale de la version initiale, FORMULAIRE_ACHETER, a été renommée FORMULAIRE_PAYER puisqu’il ne s’agit pas forcément d’acheter, simplement de payer (une cotisation à une association par exemple). En outre, elle accepte (et souvent nécessite) un argument, et même un deuxième pour faciliter son interfaçage avec d’autres plugins.
Le point essentiel du plugin, l’interface avec Paypal, est conservé et légèrement étendu, la configuration ayant à présent des valeurs par défaut suffisant à assurer ce service. La nouvelle version n’utilise plus le plugin CFG, mais les balises #CONFIGURER_META et #META, reprises du plugin Association (les fichiers sont identiques et de même PATH relatif, le find_in_path ne chargera donc que l’un d’entre eux si l’on active les deux plugins en même temps).
Installation
Récupérer spipal sur le dépôt SPIP-Zone, ou bien utiliser le fichier zip joint. Le plugin s’installe comme n’importe quel plugin. Ensuite,
cliquer sur l’icône des outils à côté de son nom dans la page d’administration des plugins pour modifier ses paramètres par défaut.
Principes
Les articles sont sélectivement étendus via la page de modification des articles. Un article peut être étendu en lui ajoutant un bouton don ou un bouton paiement. Le plugin permet d’étendre tous les articles, ou seulement ceux appartenant à des rubriques indiquées à la configuration.
Chaque versement PayPal effectué provoque l’émission par PayPal d’un message de notification qui est traité par le plugin, par une fonction précisée par le deuxième argument de la balise FORMULAIRE_PAYER. Par défaut, elle gère une table SQL mémorisant les versements. Cette table est accessible dans l’interface privée via le menu « Édition ».
Configuration
La configuration est automatique si l’adresse du Webmaster du site est celle du compte PayPal. Sinon, il faut donner explicitement cette adresse. Les autres valeurs par défaut sont normalement les bonnes.
On peut toutefois utiliser https://www.sandbox.paypal.com/fr/cgi-bin/webscr si l’on souhaite faire des tests.
Les autres paramètres sont :
| rubriques | Liste des numéros des rubriques dont les articles décrivent quelque chose à payer. Laisser vide si cela doit s’appliquer à tous les articles du site |
| garder_notification | Si cette option est activée, les requêtes de notification PayPal sont sérialisées et enregistrées dans la base. |
| donner | Vous permet de rendre vos articles aptes à provoquer des élans de générosités de vos lecteurs. À condition de paramétrer l’article. |
| vendre | Inactif, et ne sera probablement jamais actif |
Utilisation
Le plugin est fourni avec une nouvelle balise #FORMULAIRE_PAYER,
à mettre dans vos squelettes.
Pour que tout cela ait des effets visibles il faut avoir modifié l’article que l’on souhaite utiliser pour s’attirer la bienveillance pécuniaire de ses lecteurs. Pour réaliser cela le plugin utilise le pipeline affiche_milieu qui provoque l’affichage, dans la page de modification de l’article, d’un nouveau formulaire permettant de solliciter un paiement lié à l’article.
Cet affichage s’applique aux seuls articles des rubriques indiquées dans la configuration, ou à tous les articles si cette donnée de configuration est vide.
La balise #FORMULAIRE_PAYER
Elle provoque l’affichage d’un bouton accompagné d’une liste déroulante de sélection d’une devise. La devise par défaut est EUR (euro). C’est actuellement la seule devise supportée. (PayPal gère toutes les autres devises et fait les conversions lui même)
Si un montant a été spécifié avec le formulaire mentionné ci-dessus, alors la balise provoque aussi l’affichage d’un <input type="text" /> dont la valeur par défaut est ce montant. Il est modifiable du côté public, mais cela n’affectera pas la valeur en base, uniquement la valeur transmise à PayPal.
Si aucun montant n’a été saisi, il devra l’être par l’utilisateur sur PayPal.
Seule la mise en vente utilise l’information de TVA, qui est un pourcentage. Dans le cas d’un don la balise #FORMULAIRE_PAYER force cette valeur à 0.
La saisie d’un nom commercial pour l’article provoquera, sur PayPal, l’affichage de « nom commercial ».
Si aucune référence n’est saisie pour l’article celle ci sera automatiquement positionnée à « id_article ». Cette référence permet de suivre les opérations sur le compte PayPal.
La balise doit avoir comme argument un numéro indiquant ce qui est payé. Le plus souvent ce numéro sera celui de l’article spécifié par une boucle ARTICLES, comme dans :
#FORMULAIRE_PAYER{#ID_ARTICLE}
Par souci de compatibilité avec l’ancienne version, cet argument peut parfois être omis mais ça ne marche que dans certains cas. Tout autre moyen d’indiquer un numéro comme argument est possible.
Le deuxième argument indique la fonction traitant la notification par Paypal :
#FORMULAIRE_PAYER{#ID_ARTICLE, association}
aura pour effet d’appliquer la fonction inc_association_spipal au tableau de couples variable-valeur envoyé par Paypal à la notification. Par défaut cette fonction se nomme inc_valider_spipal et est fournie en standard.
spipal.zip
Vos commentaires
# Le 21 mai à 12:59, par spipheure
En réponse à : Plugin SPIPAL
Bonjour
Je viens d’installer ce plugin, qui fonctionne bien
le seul soucis est que la TVA n’est pas transmise à PAYPAL
Une bonne âme aurait elle trouvée la solution ?
# Le 21 mai à 13:50, par spipheure
En réponse à : Plugin SPIPAL
je me reponds à moi même et j’espere que cela profitera à la communauté
le problème vient du fichier payer.html dans le repertoire « formulaires »
à la ligne 17 le script est :
il faut le remplacer par
la TVA passe ensuite sur Paypal
CQFD
Répondre à ce message
# Le 18 avril à 15:42, par tounse
En réponse à : Plugin SPIPAL
bonjour
si j’ai bien compris :
ce plugin permet d’afficher un article après paiement auprès de Paypal
est il possible si l’articlez est déjà payé de revenir le visualiser sur le site ?
en fait je dois faire un site avec vente en ligne de cours
donc si ils sont sur un article de cours, alors sipal et accès à un autre artcile avec le pdf à trelecharger
mais il faudrait autoriser de nouveau le telechargmeent si celui çi est par exemple perdu ...
merci
Tounse
Répondre à ce message
# Le 4 décembre 2011 à 17:13, par OneMore
En réponse à : Plugin SPIPAL
Bonjour,
Quelques questions :
1/ Où changer la mise en page (CSS) qui gère le formulaire ?
Je souhaiterai touché à la mise en forme du côté
de l’espace public, actuellement j’ai un champs de formulaire avec le montant à payer
et un même champs en dessous avec la devise, plus le bouton « Paiement Paypal »
Dans mon cas, c’est un prix fixe donc je ne souhaite pas
la possibilité de changer le montant.
2/ Est-ce qu’il a été prévu un formulaire pour des quantités différentes, qui multiplierai le prix par le nombre d’exemplaires indiqués ?
3/ Dans Internet Explorer rien ne s’affiche dans le champs du prix, le champs est vide, une solution ?
MErci
# Le 29 février à 14:31, par OneMore
En réponse à : Plugin SPIPAL
Bonjour,
Je me réponds.
Pour la 3/, tout est rentré dans l’ordre une fois que j’ai mis un autre article à la vente, par contre y a -t-il possibilité, surement mais comment, de faire qu’il ne soit pas possible de changer le prix pour le visiteur, actuelement on peut, pratique voire indispensable lorsqu’il s’agit d’un don, mais dans ce cas précisil s’agit de prix fixes.
Bien à vous.
Répondre à ce message
# Le 11 décembre 2011 à 19:35, par gregol
En réponse à : Plugin SPIPAL
Bonjour,
Comment faire si par exemple mon article est en rupture de stock et que je veux désactiver SPIPAL pour cet article (sans effacer l’article, parce qu’il sera à nouveau en vente bientôt) ?
# Le 5 février à 23:05, par gilcot
En réponse à : Plugin SPIPAL
repasser l’article en brouillon jusqu’à ce que le stock soit réapprovisionné ou mettre sa date de publication à la date où l’article sera de nouveau disponible :)
# Le 27 février à 12:44, par OneMore
En réponse à : Plugin SPIPAL
Bonjour,
Oui, y a une astuce avec les mots clefs :
tu créer le mot clef « acheter » que tu attribues à tous les article à
vendre.
Ensuite dans ton squelette tu poses cette boucle :
BOUCLE_achat(ARTICLES)id_article titre_mot=acheter
#FORMULAIRE_PAYER#ID_ARTICLE
/BOUCLE_achat_dvd
Si ton article ne possède pas le mot clef « acheter »,
le formulaire de paiement n’apparait pas.
J’espère t’avoir aidé.
OneMore
PS : on ne peut plus insérer du code dans le forum ?
Pour pouvoir insérer ma boucle j’ai du enlever les signes < et > sans quoi
le code n’apparaissait pas.
Répondre à ce message
# Le 29 août 2011 à 19:51, par Artlogic
En réponse à : Plugin SPIPAL
Salut.
Avez-vous une astuce pour que le formulaire ne s’affiche pas quand il n’y a « rien à payer » ?
# Le 5 février à 10:55, par gilcot
En réponse à : Plugin SPIPAL
Pas testé, mais en désactivant l’option « dons » dans la configuration du plugin ? parce-que pour les dons il n’y a rien à payer...
Autre aprcoche : dans le squelette en question, n’afficher le formulaire que si le prix est renseigné...
# Le 11 février à 19:13, par Bruno
En réponse à : Plugin SPIPAL
Bonjour,
En modifiant le fichier spipal\balise\formulaire_payer.php :
Dans la fonction formulaires_payer_charger, remplacer la ligne
if (!$row) return « Rien a payer » ;
par
if (!$row) return ;
Ce if correspond le cas de figure où l’article est gratuit.
Bien cordialement,
Bruno.
Répondre à ce message
# Le 5 février à 23:31, par gilcot
En réponse à : Plugin SPIPAL
Bonjour.
Je viens de parcourir les autres messages pour voir si la question avait été déjà posée.
J’aimerais savoir comment bénéficier du traitement de ce plugin à partir d’un autre formulaire : je souhaite utiliser un formulaire maison, mais pouvoir payer avec PayPal avec ce plugin installé ; commet procéder ?
Merci.
Répondre à ce message
# Le 21 novembre 2011 à 20:25, par magatst
En réponse à : Plugin SPIPAL
Bonjour à tous
J’ai installé SPIPAL, j’ai configuré celui-ci sur une rubrique particulière,
Puis j’ai placé un article de la rubrique avec un paramètre de 60€ sans rien en tva en achat.
Puis dans le squelette d’article, dans la boucle article j’ai placé ma balise :
A priori il se passe bien quelque chose, mais je n’obtient pas le formulaire de paiement mais juste la mention :
(rien à payer)
!!!Comment obtenir l’affichage du formulaire ?!!! corectement.
De plus cela s’affiche sur tout mes articles malgré la déclaration de rubriques en configuration ???
Pour obtenir cela j’ai ajouté la balise (#FORMULAIRE_PAYERid_article) sur la boucle d’article du plugin AVELINE .
En utilisant la méthode COMPOSITION par la composition d’un modèle (produit).
Avec une copi modifier de article-contenuprincipal.html d’AVELINE dans le répertoire squellette/contenu/article-produit.html.
Et en plaçant mon article sur la composition (produit) j’obtiens un double affichage de l’article quand je l’affiche ?!!
Aussi j’aimerais savoir :
1) qu’est-ce que j’oubli pour que mon formulaire SPIPAL s’affiche correctement ?
2) Qu’est-ce que je fait de travers et comment ne plus avoir cette double publication d’article avec le plugin COMPOSITION ?
PS : en utilisant directement un bouton créer par paypal dans l’article tout s’affiche correctement mais je préférerait utiliser la méthode SPIPAL plus élégante.
QS : Peut-on écrire directement une boucle ou une balise dans un article par l’interface privé ??
Désolé je ne comprend pas toujours trés bie la logique de SPIP, merci pour votre compréhension et votre aide précieuse àà tous.
Cordialement
magatst->magat.net
# Le 11 décembre 2011 à 17:21, par gregol
En réponse à : Plugin SPIPAL
Ajoutes le #ID_ARTICLE comme ceci dans ton squelette :
.
Cela marche pour moi
G
Répondre à ce message
# Le 16 novembre 2011 à 06:57, par Gil
En réponse à : Plugin SPIPAL
Bonjour,
Est-il possible d’utiliser la fonction panier de Paypal avec ce Plugin ? Ce qui permettrait d’ajouter plusieurs produits.
Merci e vos lumières.
# Le 16 novembre 2011 à 07:01, par Gil
En réponse à : Plugin SPIPAL
Oups, la solution est là : https://www.paypal.com/fr/cgi-bin/webscr?cmd=_pdn_xclick_to_cart_outside
Avez-vous mieux ?
Répondre à ce message
# Le 5 novembre 2011 à 22:21, par ?
En réponse à : Plugin SPIPAL
Bonjour et merci pour ce plugin.
Le sélectionneur de rubrique ne fonctionne pas chez moi. Tout fonctionne sauf ceci. Que faut-il faire pour que sélectionner les rubriques ? Merci de vos lumières.
Répondre à ce message
# Le 12 août 2011 à 12:25, par Alfred
En réponse à : Plugin SPIPAL
bonjour à tous,
je ne comprends pas bien si ce plugin permet autre chose que de « faire un don ». Permet-il en particulier, après paiement, de donner accès à l’intégralité du contenu d’un article ?
Répondre à ce message