Choose Your Gift v 2.2
Transcription
Choose Your Gift v 2.2
1 Extension Magento Choose Your Gift v 2.2 http://michaeljoseph.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://michaeljoseph.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://michaeljoseph.me/licenseagreement/ Si vous n’êtes pas en accord avec le contrat de licence, merci de ne pas installer ce module. http://michaeljoseph.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: rendezvous dans System > Cache Management et cliquez sur le bouton “Flush Magento Cache”(1) puis “Flush Cache Storage”(2). 3. Déconnectezvous du back office: Puis réidentifiezvous: http://michaeljoseph.me Rédigé le 24/11/2012 Dernière mise à jour le 12/10/2013 4 ACTIVATION 1. Rendezvous dans System > Configuration > Mjoey Extensions> Choose Your Gift >Settings. 2. Choisissez la valeur “Yes” pour “Activer” le module. 3. Cliquez sur Save Config. http://michaeljoseph.me Rédigé le 24/11/2012 Dernière mise à jour le 12/10/2013 5 CREER UN Gift Product Rendezvous 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://michaeljoseph.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 autogé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 celuici 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://michaeljoseph.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/knowledgebase/entry/whatareshoppingcartpricerules andhowdoiusethem 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://michaeljoseph.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://michaeljoseph.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://michaeljoseph.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://michaeljoseph.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 celuici. Vous pouvez sélectionner autant de cadeaux que vous le souhaitez. Pour chaque cadeau, il est http://michaeljoseph.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. Rapprochezvous de votre développeur Magento afin de savoir si cellesci 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://michaeljoseph.me Rédigé le 24/11/2012 Dernière mise à jour le 12/10/2013