~ ZenGalerie ~


ZenGalerie : Testing zenPhoto Gallery with my coding

~ ZenGalerie ~ | ZenPaypal Plugin (FR)

ZenPaypal Plugin (FR)

Plugin zenPaypal !

CHANGELOG

Concernant les changements de fonctionnalités les plus importantes :

  • le plugin peut agir comme un panier ou un système d'achat immédiat,
  • il est possible de tester l'extension sur la zone web "Sandbox" de Paypal (bien sûr, pour cela, il vous faut un compte actif sur cette zone web),
  • il est possible de changer les couleurs de fond et/ou de bordures sur les pages Paypal afin d'être au plus prêt de votre charte graphique,
  • il vous est possible de choisir votre devise selon celles supportées par Paypal,
  • et d'autres options supportées et permises par Paypal

Tous les changements sont journalisés sur cette page : ZenPaypal Plugin - Changelog.

INSTALLATION

L'installation de l'extension est assez aisée. Il faut :

  1. Décompresser l'archive zip et la poser dans l'espace web de votre galerie zenphoto, dans le répertoire 'plugins' (/plugins),
  2. Éditer le script 'image.php' de votre thème, pour ajouter le code php suivant, dans la section body, où vous le désirez :
    <?php if(function_exists('zenPaypal')) zenPaypal(); ?>

ADMINISTRATION

Aller dans la section 'Administration' de la galerie ZenPhoto pour activer l'extension dans la section 'extensions'.

Ensuite, paramètrer les différentes options de l'extension dans la section 'options' > 'extension'.

CONFIGURATION

Custom Datas : Utilisez les options zenPaypal

- v1.1.6 - Il est maintenant possible d'utiliser certaines options, dans le contexte du champ "Données personnalisées" (en anglais "Custom datas") des images ... et des Albums contenant des images !

Ces options sont :

  • zenpaypal:nopaypal pour désactiver l'affichage de l'extension ...
  • zenpaypal:pricelist:size;media;price;quantity gère la liste de prix
    • Il est important de séparer size, media, price et quantity par le symbole suivant ';' (le point-virgule).
    • Vous pouvez écrire plusieurs ensembles 'size;media;price;quantity', mais il vous faut séparer chacun par le symbole '|' (nommé pipe [Alt Gr]+[6]).
    • 'media' : si vous devez écrire un ensemble de mots contenant un ou plusieurs espaces, utilisez impérativement le symbole '_' (le tiret bas, nommé underscore, [Alt Gr]+[8]) au lieu des espaces !
    • 'quantity' : est optionnel ; si vous désirez spécifier une quantité, faites-le en mettant la lettre q devant votre quantité, telle que : 'q7'.
    • exemple : zenpaypal:pricelist:10x15;Xtrem_Paper_Thin;3.3;q3|13x18;Paper_Glossy;6.99|18x24;Paper_Thin_Xtra;18;q7
  • zenpaypal:shipping:number gère le coût de livraison ; 'number' est votre chiffre.
  • zenpaypal:tax:number gère le coût de la taxe ; 'number' est votre chiffre.
  • zenpaypal:viewing_pricelist:binary pour activer l'affichage ou non de la liste de prix sous forme de table HTML dessous l'image - v.1.1.7 -
    • binary : 0 ou 1 !

Il vous faut spécifier chacune de ces options, en exécutant un retour à la ligne - une option par ligne !

Boutons Encryptés

Avec la version 1.1.7, il est possible de tester l'usage de boutons PayPal encryptés.

Pour cela, connectez-vous sur votre compte PayPal, sur le site de PayPal. Allez dans la section "Préférences" ; cliquez sur "Mes boutons enregistrés", et choisissez "Créer un bouton".

  • Étape 1 : choisissez le type de bouton, panier ou achat. Nommez l'objet et son identifiant.
  • Étape 2 : Déselectionnez la case à cocher "Enregistrer le bouton auprès de PayPal".
  • Puis, cliquez sur le bouton [Créer le bouton].

PayPal restitue du code HTML ; copiez-le.

Ensuite, allez dans la section d'administration de votre galerie, puis copiez ce code dans l'option "PayPal: Button encrypted Code HTML". Activez ensuite l'option "PayPal: Encrypted Button".

Ceci est expérimental. Besoin de testeurs !
À utiliser réellement à vos risques et périls ...
Si vous ne souhaitez pas utiliser cette option, laissez l'option "PayPal: Encrypted Button" par défaut sur "No".

 

Astuces

Afficher la liste de prix

Pour afficher une liste d'objets - prix, sous forme de table html, vous pouvez modifier l'option 'Table HTML : Voir la liste de prix' (en anglais 'HTML Table: Viewing Price list').

À ce propos, il est possible aussi de modifier le Tag, l'ID et le text correspondant à l'affichage de cette liste de prix. ATTENTION, pour cela vous devez savoir ce que vous faites en connaissance de cause ; autrement, laissez tel quel, le choix par défaut !

Afficher le Logo PayPal

Pour afficher le Logo PayPal, ou le fait que votre galerie utilise le système de paiement PayPal, ajoutez dans le script 'sidebar.php' dans votre thème, le code PHP suivant - plugin v1.1.5 - :
<?php if(function_exists('printZenPayPalLogo')) printZenPayPalLogo(); ?>

Désactiver l'extension sur un album, dans son entier
  1. Dans la section "Administration", allez vers l'album sur lequel vous souhaitez désactiver l'extension, ...
  2. Dans le champ de texte nommé "Données personnalisées", écrivez le texte suivant : zenpaypal:nopaypal - plugin v1.1.6 -
Désactiver l'extension pour une image
  1. Dans la section "Administration", allez vers l'image sur laquelle vous souhaitez désactiver l'extension, ...

  2. Dans le champ de texte nommé "Données personnalisées", écrivez le texte suivant : zenpaypal:nopaypal - plugin v1.1.6 -

 

TÉLÉCHARGEMENT

Vous pouvez télécharger l'archive de cette nouvelle version :

http://zenphoto.dev.stephane-huc.net/uploaded/zenPayPal-1.1.7.zip

Vous trouverez aussi les fichiers de vérification MD5 ou SHA1.

DONS

Si cette extension vous plaît, n'hésitez pas en me remerciant :

Crédits

L'auteur original est Ebrahim Ezzy. Cetteversion apporte son lot de modifications, tant au niveau du code PHP, qu'en terme de fonctionnalités.