le voir en ligne : mbtPdfAsm
discret, non ?
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 :
| champ | description |
|---|---|
| url_paypal | Adresse de traitement du formulaire PayPal de paiement. Vous pouvez laisser la valeur par défaut ou utiliser https://www.sandbox.paypal.com/fr/cgi-bin/webscr si vous souhaitez faire des tests. |
| validation_paypal | url à laquelle il faut renvoyer la notification paypal pour la valider. Vous pouvez laisser la valeur par défaut ou utiliser www.sandbox.paypal.com si vous souhaitez faire des tests. |
| url_retour | L’adresse ou le donateur sera redirigé après le don. |
| compte_paypal | une adresse mail correspondant à un compte PayPal |
| style_page | Le nom d’une personnalisation de la page de paiement PayPal. Si vous ne comprenez pas, laissez la valeur par défaut. |
| vendre | Inactif, et ne sera probablement jamais actif |
| donner | Vous permet de rendre vos articles aptes à provoquer des élans de générosités de vos lecteurs. A condition de paramétrer l’article. |
| garder_notification | Si cette option est activée, les requêtes de notification PayPal sont sérialisées et enregistrées dans la base. |
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).
RSS 2.0