Plugin GoPayPal

Installation

Récupérer le plugin.

Après c’est comme pour n’importe quel plugin : cf http://www.spip.net/fr_article3396.html

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 de 0 à tous les articles.

Chaque versement PayPal effectué provoque l’émission par PayPal d’un message de notification qui est traité par le plugin lequel maintient une table de gestion des versements. Cette table de gestion est accessible dans l’interface privée via le menu « Edition ».

Configuration

Ici le plugin CFG est requis.

La configuration se fait via l’interface privée et le menu « configuration ». Vous ne pouvez pas vous dispenser de configurer ce plugin si vous souhaitez qu’il fonctionne.

Elle se résume à renseigner certains champs :

Utilisation

Le plugin est fourni avec un squelette article.html, inactivé car renommé av_article.html. Il est donc possible d’activer ce squelette.

Une autre possibilité est d’utiliser la nouvelle balise #FORMULAIRE_ACHETER dans les boucles ARTICLES de vos squelettes.

Pour que tout cela ait des effets visibles il faut avoir modifier 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 la mise en don ou en vente d’un article.

Cette mise en don ou en vente s’accompagne de la saisie d’informations qui vont influer sur le comportement de la balise #FORMULAIRE_ACHETER.

La balise #FORMULAIRE_ACHETER

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 conversion lui même)

Si un prix a été spécifié lors de la mise en don de l’article, alors la balise provoque aussi l’affichage d’un <input type="text" /> dont la valeur par défaut est le prix saisi. Ce prix est modifiable du coté publique. Cette modification n’affectera pas la mise en don, uniquement la valeur transmise à PayPal.

Si aucun prix n’a été saisi le montant du don devra être saisi par l’utilisateur sur PayPal.

Pour la mise en vente le prix est obligatoire et non modifiable par le visiteur.

Seule la mise en vente utilise l’information de tva qui est un pourcentage. Dans le cas d’un don la balise #FORMULAIRE_ACHETER 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 dons/ventes effectués sur le compte PayPal.

Evolutions

-  gestion de la quantité achetée.

Remarques

J’attire l’attention des curieux sur le fichier av_tabledata.php qui est un début de mise en oeuvre de fonctionnalités de formulaires automatiques basées sur la description des tables par SPIP (spip_abstract_showtable).