1 sur 10 Mise en place du Module Magento V 1.5.7 1. Installation du Module Vous pouvez installer le module de deux façons différentes, en passant par Magento Connect, ou directement via les fichiers de Magento. 1.1 Installation via Magento Connect 1.1.1 Méthode classique Rendez vous sur la page du module : http://www.magentocommerce.com/magento-connect/lengow-importexport-7172.html (http://www.magentocommerce.com/magento-connect/lengow-import-export-7172.html) Cliquez sur Installer, sélectionnez la version de MagentoConnect disponible sur votre site, récupérez la clé. Rendez-vous sur votre backoffice, sur la page MagentoConnect Manager et collez la clé dans le champs prévu à cette effet, pour finir cliquez sur Install. 1.1.2 Par upload d'archive Récupérez notre archive à cette adresse : http://www.lengow.fr/view/plugins/magento /module_lengow.1.5.7.tar.gz (http://www.lengow.fr/view/plugins/magento/module_lengow.1.5.7.tar.gz) Rendez-vous sur votre backoffice Magento, page MagentoConnect Manager. Insérez l'archive dans le champs prévu à cet effet et cliquez sur Upload.
2 sur 10 1.1 Installation via le FTP Si vous souhaitez installer le module sans passer par MagentoConnect, téléchargez l'archive à l'adresse suivante : http://www.lengow.fr/view/plugins/magento/module_lengow.1.5.7.zip (http://www.lengow.fr /view/plugins/magento/module_lengow.1.5.7.zip) Dézippez l'archive sur votre ordinateur, connectez vous à votre serveur FTP, naviguez jusqu'à la racine de Magento et fusionnez les dossiers tirés de l'archive avec ceux présents dans le dossier racine Magento. 1.3 Tester l'installation Une fois l'installation terminée connectez-vous à votre backoffice Magento. Vous devriez voir un nouveau menu Lengow dans le menu horizontal supérieur. Un autre menu Lengow est également visible dans la page Système > Configuration Erreurs possibles Si vous rencontrez des erreurs pendant ou après l'installation du module Lengow reportez-vous au dernier chapitre de cette documentation. 2. Configuration du flux Rendez-vous sur la page Système > Configuration pour configurer le flux. Votre flux est accessible à l'adresse http://www.votre-nom-de-domaine.com/lengow/export_flux/ (http://www.votre-nom-de-domaine.com/lengow/export_flux/) Si vous souhaitez en savoir plus à propos de la gestion des flux, reportez-vous au paragraphe 8. 2.1 Lengow API et Tagcapsule Ce menu vous permet de gérer les informations générales du module. Cette configuration est essentiel pour le bon fonctionnement du module. Id Client Lengow : Votre identifiant client Lengow communiqué par votre chargé de compte
3 sur 10 Id Group Lengow : Votre identifiant groupe Lengow communiqué par votre chargé de compte Api key : La clé API Lengow, disponible à cette adresse https://solution.lengow.com/api/ (https://solution.lengow.com/api/) (token API) Sauvegardez vos modifications. 2.2 Configuration générale du flux Activer le module Lengow : Active le module IP(s) autorisée(s) pour l'export : Renseignez les IPs autorisées à visualiser le flux Exporter uniquement les produits sélectionnés : Si oui, seul les produits sélectionnés dans Lengow > Export > Sélection des produits seront traités par l'export Exporter les produits hors stock : Permet de filtrer ou non les produit avec un stock à 0 Exporter les types de produits : Permet de choisir si l'on souhaite exporter uniquement les produits simples, configurables ou les deux. 2.3 Configuration des données du flux Fusionner les images des produits parents : Si oui les images des produits parents sont fusionnées avec celles du produit enfant. Les images sont limitées à 5 par produit.
4 sur 10 Formater les données : Remplace les caractères spéciaux en caractères HTML Pays de livraison : Pays de livraison par défaut pour l'export Délais de livraison : Délais en jours par défaut pour l'export Frais de port : Prix du frais de port par défaut pour l'export Mode de livraison : Mode de livraison par défaut pour l'export 2.4 Configuration avancée du flux Mémoire allouée pour l'export : Mémoire vive allouée pour l'export Utiliser le XML : Si oui, le flux sera généré en XML et non en CSV Sauvegarder le flux : Si oui, le flux ne sera pas affiché mais sauvegardé. Pour savoir où est stocké le fichier, appelez l'url du flux, une fois la sauvegarde effectuée un message vous renverra vers le fichier sauvegardé. 2.5 Choix des attributs spécifiques Sélectionnez les attributs spécifiques que vous souhaitez voir apparaître dans le flux. Pour sélectionner plusieurs attributs, maintenez Ctrl. 3. Sélection des produits à exporter Vous avez la possibilité de sélectionner les produits à exporter. Pour cela, allez dans le menu Lengow Export Sélection de produits.
5 sur 10 Filtrer les produits puis cochez la sélection. Ensuite choisissez «Changer la publication» dans «Action». Sélectionnez oui ou non puis Validez. 4. Gestion des commandes La gestion des commandes consiste à récupérer les commandes effectuées sur les places marchandes depuis Lengow. 4.1 Configuration depuis Magento Attention, la remontée de commande nécessite que les configurations du menu Lengow API et Tagcapsule, référez-vous au chapitre 2.1.1 pour en apprendre plus. Activer la gestion des commandes : Passer à Oui pour activer la remontée de commandes. Importer depuis X jours : Définit le nombre de jour pris en compte lors de la remontée de commandes. Importer par n commandes : Permet de limiter le nombre maximum de commandes à importer Facturation automatique : La facturation sera créée si la commande remonte comme facturée. Si la fonctionnalité est désactiver vous devrez facturer vos commande vous même. Appliquer la TVA : Applique ou non la TVA sur les produits.
6 sur 10 Attention, le module Lengow utilise les méthodes natives de Magento. Si vous utilisez un ou plusieurs module(s) spécifique(s) il est possible que le module Lengow ne prenne pas en compte certaines fonctionnalités des autres modules. Contactez le support Lengow pour avoir plus d'informations à ce sujet. 4.2 Configuration depuis Lengow Avant tout : pensez à sélectionner le bon groupe dans la solution si vous avez plusieurs groupes. Sur la page https://solution.lengow.com/marketplace/commandes/all/?type=importmagento (https://solution.lengow.com/marketplace/commandes/all/?type=importmagento) Vous devez uniquement renseigner l id du site et l id de la boutique Magento. Les autres parties sont pour les anciennes version du module Magento. Sur la page https://solution.lengow.com/api/ (https://solution.lengow.com/api/), vous devez indiquer l ip du serveur sur lequel est hébergé votre Magento afin que Lengow autorise l accès à l API Lengow. Pour récupérer les identifiants de site (magasin) et de boutique Magento : Rendez-vous dans Système > Gestion des magasins puis
7 sur 10 Vous les trouverez au survol de la souris dans l url en bas de votre navigateur 5. L'import des commandes dans Magento L'import peut se faire manuellement depuis le menu Lengow Commandes Lengow import des commandes. Il suffit de cliquer sur le bouton «Lengow import des nouvelles commandes». L'import se fait également automatiquement grâce à une tâche de fond qui s'exécute toutes les 30 minutes. Toute erreur est reportée dans le journal lengow. Accessible depuis le menu: Lengow Commandes Journal Lengow mais aussi dans la solution lengow au niveau des paramètres d'import Magento (https://solution.lengow.com/marketplace/commandes/all/?type=importmagento (https://solution.lengow.com /marketplace/commandes/all/?type=importmagento) ). 6. L'import des commandes dans Lengow Vous pouvez facilement accéder à vos commandes Lengow depuis le menu: Lengow Commandes Commandes Lengow 7. Passage de l'ancien vers le nouveau module Si vous utilisez l'ancien module : Vous devez conserver l'ancien module le temps de configurer le nouveau. Vous devez en revanche supprimer les identifiants API renseignés sur cette page de la solution (https://solution.lengow.com/marketplace/commandes/all/?type=importmagento (https://solution.lengow.com
8 sur 10 /marketplace/commandes/all/?type=importmagento) ) le temps de configurer le flux source. Une fois que c'est ok au niveau de la prise en compte du nouveau flux source côté Lengow, vous pourrez supprimer l'ancien module et renseigner vos nouveaux identifiants API Magento dans la solution. Attention le passage de l ancien vers le nouveau module implique un changement de structure du flux source. Lengow fait une correspondance pour les champs les plus importants mais tous les champs d attributs ne seront pas traités dans cette correspondance. Il faudra donc revoir le matching des champs et toutes les optimisations liées à ces champs. Vous devez impérativement prévenir le support Lengow lorsque vous passez de la version 1.4 à la version 1.5 du module Lengow. Il faudra également nous transmettre la nouvelle url du flux source à prendre en compte. 8. Utilisation avancé du module Lengow Si vous êtes sur un multi-site, que vous souhaitez générer un flux spécial pour une marketplace en particulier, ou encore que votre catalogue est très spécifique ou très complet, voici quelques exemples d'utilisation avancée du module. 8.1 Gestion des flux via les paramètres GET Il arrive que des marchands souhaitent générer des flux sources spécifique à chaque marketplace. Selon la marketplace en question, ces clients vont vouloir exporter tous leurs produits, ou uniquement les produits avec un stock positif, ou encore uniquement les produits simples. Dans ce cas là nous allons utiliser les paramètres GET pour gérer les différents flux. Ainsi vous n'aurez pas à modifier votre configuration, ni à créer des URLs spécifique pour chaque flux. Pour utiliser un flux spécifique, remplacez simplement l'url du flux source de la marketplace en question par http://www.url-sans.parametres/?parametre=valeur (http://www.url-sans.parametres/?parametre=valeur) 8.1.1 Les types Tout comme dans la configuration via la backoffice, vous pouvez déterminer quels types de produits vous souhaitez exporter. Pour cela utilisez le paramètres types. Le paramètres prend comme valeurs : simple configurable,simple configurable 8.1.2 Les formats Vous pouvez également forcer un format de fichier via le paramètre mode. Les valeurs possibles sont : csv xml 8.1.3 Les délimiteurs Il arrive de ne vouloir exporter qu'un nombre défini de produit pour un seul shopbot, alors qu'on souhaite exporter tous les produits quelque soit le nombre sur le reste des plateformes. Dans ce cas deux délimiteurs sont disponibles. Si vous rencontrez des difficultés à comprendre le fonctionnement de ces paramètre documentez vous sur les conditions LIMIT et OFFSET en SQL. 8.1.3.1 Limit
9 sur 10 Le paramètre limit permet de définir le nombre maximum de produits exportés. Il accepte comme valeur n'importe quel entier positif. Admettons que votre export classique renvoi 500 produits. Si vous utilisez le paramètre limit avec une valeur à 100, alors uniquement les 100 premiers produits seront exportés. 8.1.3.2 Offset offset va permettre de définir la position de départ de l'export. Toujours sur votre export classique qui renvoi 500 produits, si vous utilisez offset à 200 et limit à 100 le flux n'exportera que 100 produits à partir du 200éme produit. 8.2 Gestion des flux complets et lourds Certains catalogues sont trop lourds pour êtres lu directement par nos serveurs. La génération d'un flux très complets (au dessus des 10 000 produits et/ou avec plus de 30 attributs à exporter) peut être longue et dépasser les 3 minutes autorisées lors du rapatriement du flux par nos serveurs. Dans ce cas il est souvent très utile de sauvegarder le flux plutôt que de l'afficher. Sélectionnez donc l'option en question (détaillée plus haut) et générez une première fois le flux à la main via un navigateur. Une fois le flux généré, au lieux de visualiser le flux vous verrez un message type CSV saved at /chemin /vers/magento/media/lengow/default/lengow_feed.csv Utilisez donc la partie qui suit /media (/media inclu) pour déterminer l'url de votre flux source à renseigner sur la solution. Générez ensuite un cron qui appellera ce script, via curl, par exemple. 8.3 Gestion des multi-sites 8.3.1 Configuration La gestion des multi-sites utilise le processus classique de Magento. Dans la page Système > Configuration utilisez le menu en haut à gauche Portée de la configuration pour déterminer la boutique sur la quelle vous souhaitez appliquer les modifications. Il est important de bien configurer les ids groupe par boutique si vous utilisez un groupe par site. Ainsi vos commandes remonterons pour chaque boutique et TagCaspule remontera les bonnes valeurs. Vous pouvez également modifier les configurations de flux et/ou de commandes par boutique. 8.3.2 Utilisation Pour définir un flux source spécifique à chaque boutique utilisez un lien comme définit ci-dessous : http://www.votre-nom-de.domaine/lengow/export_flux/index/store/ (http://www.votre-nom-de.domaine/lengow/export_flux/index /store/) {code_de_la_boutique} Bien entendu, vous pouvez utiliser les paramètres GET définis dans le chapitre supérieur en plus de la définition de la boutique. 9. Erreurs fréquentes Si vous rencontrez des erreurs lors de l'utilisation du module Lengow, commencez par consulter cette partie de la documentation. Celle-ci est régulièrement mise à jour.
10 sur 10 Consultez également régulièrement la page des corrections (https://solution.lengow.com/dokuwiki /doku.php?id=module_lengow:module_magento_maj) qui liste les erreurs corrigées et les fichiers à mettre à jour pour les corriger. 9.1 Backoffice Magento : Erreur 404 Si après l'installation du module, en navigant des les différents menus du module Lengow vous tombez sur une erreur 404 suivez la procédure suivante : Rendez-vous dans Système > Gestion du cache et rafraîchissez les caches de Configuration, Layouts, Blocks HTML, Traductions et EAV types et attributs. Déconnectez-vous de votre backoffice Magento, puis reconnectez-vous. 9.2 Magento : Erreur 503 Cette erreur, qui est impressionnante vient d'un bug de Magento. Lors ce que Magento installe un module (via Magentoconnect) celui-ci passe le site en maintenance pour des raisons de sécurité. Il arrive qu'après l'installation du module, Magento reste en maintenance et affiche une erreur 503. Pour résoudre l'erreur connectez-vous à votre serveur FTP, naviguez jusqu'à la racine de Magento et supprimez le fichier maintenance.flag 9.3 Remontées de commandes : Result is not Varien_Simplexml_Element Si vous rencontrez l'erreur suivante lors de la remontée de commande : exception 'Mage_Core_Exception' with message 'Result is not Varien_Simplexml_Element' in L'erreur vient du fait que notre module ne parvient pas à accéder à l'api Lengow. Pour corriger cette erreur vérifiez les points suivants : L'IP de votre serveur est non ou mal renseignée dans le backoffice Lengow : https://solution.lengow.com/api/ (https://solution.lengow.com/api/). La configuration de l'id client et des ids groupe dans le backoffice Magento est vide ou erronée. La configuration du serveur interdit les appels aux pages extérieurs. 9.4 Remontées de commandes : Orders can't getted Si vous vos commandes ne remontent pas et que dans les logs des commandes Lengow le message suivant est remonté : ''Orders can't getted' vérifiez les configurations de ids client et groupes.