1 Extension Magento Choose Your Gift v 2.2.1 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
2 ACCEPTATION DU CONTRAT DE LICENCE Vous pouvez à nouveau consulter le contrat de licence en cliquant sur le lien suivant: /license agreement/ Si vous n êtes pas en accord avec le contrat de licence, merci de ne pas installer ce module.
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:
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.
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.
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
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.
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.
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.
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.
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
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.