Choose Your Gift v 2.2

1
Extension Magento
Choose Your Gift v 2.2
http://michael­joseph.me
ACCEPTATION DU CONTRAT DE LICENCE
INSTALLATION
ACTIVATION
CREER UN Gift Product
Les attributs
General
Images
Inventory
Category
Websites
CRÉER UNE RÈGLE ChooseYourGift
Les attributs
Autoadd Gift(s)
Display Mode
Carousel position
Display in
Title
Maximum Gift Choice
L’onglet Gifts
BIBLIOTHÈQUES JAVASCRIPT REQUISES ET INCLUES DANS LE MODULE
jQuery
jCarousel
Reveal
http://michael­joseph.me
Rédigé le 24/11/2012
Dernière mise à jour le 12/10/2013
2
ACCEPTATION DU CONTRAT DE LICENCE
Vous pouvez à nouveau consulter le contrat de licence en cliquant sur le lien suivant:
http://michael­joseph.me/license­agreement/
Si vous n’êtes pas en accord avec le contrat de licence, merci de ne pas installer ce
module.
http://michael­joseph.me
Rédigé le 24/11/2012
Dernière mise à jour le 12/10/2013
3
INSTALLATION
1. Collez à la racine de votre site Magento le contenu du dossier mjoey_chooseyourgift.
Cela installera également le module Mjoey_All.
2. Rafraîchissez le cache Magento: rendez­vous dans System > Cache Management et
cliquez sur le bouton “Flush Magento Cache”(1) puis “Flush Cache Storage”(2).
3. Déconnectez­vous du back office:
Puis réidentifiez­vous:
http://michael­joseph.me
Rédigé le 24/11/2012
Dernière mise à jour le 12/10/2013
4
ACTIVATION
1. Rendez­vous dans System > Configuration > Mjoey Extensions> Choose Your Gift
>Settings.
2. Choisissez la valeur “Yes” pour “Activer” le module.
3. Cliquez sur Save Config.
http://michael­joseph.me
Rédigé le 24/11/2012
Dernière mise à jour le 12/10/2013
5
CREER UN Gift Product
Rendez­vous dans Catalog > Manage Products
Puis cliquez sur Add Product
Définissez l’ “Attribute Set” à Gift et le “Product Type” à Gift Product et cliquez sur Continue.
Les produits que vous souhaitez proposer en cadeau doivent être de type Gift Product et dans
l’idéal avoir le jeu d’attribut Gift. Seuls les produits de type Gift Product pourront être proposés
en cadeau.
Le jeu d’ attribut Gift contient uniquement les attributs nécessaires à la configuration d’un
produit cadeau. Suivant vos besoins, vous pouvez ajouter des attributs à ce jeu ou tout
simplement définir un autre jeu d' attribut à la création du produit.
Les attributs
Le jeu d'attribut Gift est composé des attributs utiles à un
Gift Product. Il contient 6 onglets: General, Images,
Inventory, Websites et Categories.
http://michael­joseph.me
Rédigé le 24/11/2012
Dernière mise à jour le 12/10/2013
6
General
Name ­ Le nom du produit qui sera affiché dans le panier, dans le récapitulatif de commande du
tunnel de paiement, sur les factures etc...
Sku ­ La référence de votre produit.
Url key ­ L’ Uri à laquelle est visible votre produit si vous désirez le rendre visible dans votre
catalogue. Il est par défaut auto­généré.
Visibility ­ La visibilité de votre "Produit cadeau" sur votre site. Dans les cas les plus fréquents
cet attribut aura la valeur "Not Visible Individually".
Status ­ Permet d'activer ou désactiver le produit. Un cadeau désactivé ne pourra être ajouté à
un panier même si celui­ci est lié à une Shopping Cart Price Rules active.
Description ­ Description du produit, utile si vous désirez le rendre visible dans votre catalogue.
Short Description ­ À l'instar de l'attribut "Description", utile si vous désirez rendre le produit
visible dans votre catalogue.
Images
Ici vous uploadez les images de votre produit. Si vous ne rendez pas votre produit visible dans le
catalogue, seule l'image définie en thumbnail sera nécessaire.
Inventory
Cet onglet comporte tous les attributs inventaire de base des produits simples. Généralement
pour rendre un produit cadeau disponible, il vous faudra définir une quantité (Qty) supérieure à 0
et une disponibilité (Stock Availability) “In Stock”.
Category
Si vous désirez rendre votre produit visible dans votre catalogue, c'est ici que vous définissez la
catégorie à laquelle vous souhaitez l'associer.
Websites
Onglet qui n'est visible que si vous avez plusieurs websites. Il n’est pas obligatoire de définir les
websites du Gift Product car ils seront définit automatiquement à partir de la “Shopping Cart
http://michael­joseph.me
Rédigé le 24/11/2012
Dernière mise à jour le 12/10/2013
7
Price Rule” à laquelle il sera associé.
CRÉER UNE RÈGLE ChooseYourGift
ChooseYourGift s’intègre aux “Shopping Cart Price Rules” de Magento en enrichissant ses
fonctionnalités. C’est pourquoi je vous invite à apprendre à créer ces règles en consultant
cette page officielle:
http://www.magentocommerce.com/knowledge­base/entry/what­are­shopping­cart­price­rules
­and­how­do­i­use­them
ChooseYourGift enrichi les “Shopping Cart Price Rules” de 7 attributs et d’un onglet nommé
Gifts.
Les attributs
Autoadd Gift(s)
Permet de déterminer si les cadeaux seront ajoutés automatiquement au panier ou s’ils seront
proposés au choix via un carousel ou une popin. Par défaut, lorsque vous créez une nouvelle
règle, le seul attribut ChooseYourGift disponible est “Autoadd Gift(s)” et il a pour valeur “Yes”.
Les valeurs:
Yes ­ Les cadeaux associés à la règle seront tous ajoutés automatiquement au panier.
No ­ Sur la page panier un carousel ou une popin s’afficheront avec les cadeaux associés à la
règle. La popin est également affichable sur d’autres pages (voir l’attribut Display in ).
Display Mode
Cet attribut n’est disponible que lorsque Autoadd Gift(s) à pour valeur “No”.
Les valeurs:
Carousel ­ Permet d’afficher les cadeaux à choisir dans un carousel. Le carousel ne peut
s’afficher que sur la page panier.
Popin ­ Permet d’afficher les cadeaux à choisir dans une popin.
http://michael­joseph.me
Rédigé le 24/11/2012
Dernière mise à jour le 12/10/2013
8
Carousel position
Cet attribut n’est disponible que lorsque Display Mode à pour valeur “Carousel”.
Les valeurs:
Before Cart ­ Affiche le carousel au dessus du panier.
http://michael­joseph.me
Rédigé le 24/11/2012
Dernière mise à jour le 12/10/2013
9
By GetChildHtml ­ Permet de choisir l’endroit exact où vous souhaitez afficher le carousel sur la
page panier. Cette méthode d’affichage du carousel est réservée aux initiés ou aux courageux
qui sont prêts à mettre les mains dans le cambuis.
Pour cela, il vous faut éditer le template checkout/cart.phtml de votre design en ajoutant cette
ligne de code:
<?php echo $this­>getChildHtml('choose');?>
Par exemple, entre les balises </fieldset> et </form> de votre template cart.phtml pour un
affichage du carousel sous le panier.
http://michael­joseph.me
Rédigé le 24/11/2012
Dernière mise à jour le 12/10/2013
10
Voici le résultat:
Display in
Cet attribut n’est disponible que lorsque Display Mode à pour valeur “Popin”.
Il permet de définir sur quelles pages afficher la popin. Vous pouvez choisir plusieurs valeurs.
Les valeurs:
Chekout Cart ­ Affichage sur la page panier.
Checkout Onepage ­ Affichage sur la page de paiement.
Product pages ­ Affichage sur les pages produits.
http://michael­joseph.me
Rédigé le 24/11/2012
Dernière mise à jour le 12/10/2013
11
Title
Cet attribut n’est disponible que lorsque Autoadd Gift(s) à pour valeur “No”.
Titre du carousel ou de la popin de cadeaux.
Maximum Gift Choice
Cet attribut n’est disponible que lorsque Autoadd Gift(s) à pour valeur “No”.
Définit le nombre maximum de cadeaux qui pourront être choisis par le client.
L’onglet Gifts
L’onglet Gifts contient un tableau de cadeaux (grid). Pour
qu’un produit soit visible dans ce tableau il faut qu’il soit de
type cadeau.
Le tableau vous permet de sélectionner les cadeaux que
vous souhaitez associer à la règle pour qu’ils soient
proposés au choix à votre client ou ajoutés
automatiquement à son panier. Pour sélectionner un
cadeau, il suffit de cocher la case de la ligne de celui­ci.
Vous pouvez sélectionner autant de cadeaux que vous le souhaitez. Pour chaque cadeau, il est
http://michael­joseph.me
Rédigé le 24/11/2012
Dernière mise à jour le 12/10/2013
12
possible de définir 2 valeurs:
­ 1) Quantity ­ quantité à ajouter au panier. Attention cette valeur est prise en compte
uniquement quand Autoadd Gift(s) est défini à “Yes”.
­ 2) Position ­ position dans le carousel ou la popin.
BIBLIOTHÈQUES JAVASCRIPT REQUISES ET
INCLUES DANS LE MODULE
Les bibliothèques javascript suivantes sont nécessaires au bon fonctionnement de l’extension
ChooseYourGift. Rapprochez­vous de votre développeur Magento afin de savoir si celles­ci ne
sont pas déjà incluses à votre projet Magento.
jQuery
La célèbre bibliothèque javascript nécessaire pour le fonctionnement des plugin jCarousel et
Reveal. Cette bibliothèque est sous license MIT.
jCarousel
Plugin jQuery permettant de construire le carousel du module ChooseYourGift. Cette
bibliothèque est sous license MIT et GPL.
Reveal
Plugin jQuery permettant de construire la popin du module ChooseYourGift. Cette bibliothèque
est sous license MIT.
http://michael­joseph.me
Rédigé le 24/11/2012
Dernière mise à jour le 12/10/2013