Module Oxid

Notre plugin Oxid n’est plus maintenu par notre équipe technique ; il peut vous aider si vous disposez de connaissances sur Oxid.
Toutefois, pour la gestion de votre catalogue, nous vous recommandons un export classique vers la plateforme Lengow.

1. Installation du module

Avant d'installer / mettre à jour le module, suivez nos conseils !

Vous pouvez télécharger le module à l'adresse suivante : http://www.lengow.com/wp-content/uploads/2015/06/lengow.v0.3.zip
Décompressez le module dans le dossier /modules de la solution. Une fois la décompression finie, allez dans le back office d’Oxid en vous connectant avec vos identifiants administrateurs.
Dans le back office, allez dans Extensions, puis Modules. Sélectionnez le module Lengow Oxid Connector et activez le (onglet Overview).

2. Configuration du module

Pour configurer le module, allez dans Master Settings puis Lengow.

2.1 Lengow Account

Dans le menu Lengow Account, indiquez votre Id Client, Id Group et votre token (disponible sur la page https://solution.lengow.com/api/).
Indiquez aussi l’adresse IP avec laquelle vous souhaitez accèder aux services d’export et d’import dans Authorised IPs. Vous pouvez indiquer autant d’adresses que souhaité : toutefois chacune des adresses doit être séparée d’un “;” sans espace.
Par exemple : 127.0.0.1;198.51.21.1

2.2 Tracking options

Dans le menu Tracking options, si vous souhaitez activer le système de tag Lengow, choisissez dans la liste déroulante le tag souhaité. Vous pouvez ensuite choisir l’identifiant du produit qui sera inclut dans le tag (le numéro du produit ou son identifiant).

2.3 Export Settings

Pour les réglages d’export de produits, aller dans le menu Export settings. Si vous souhaitez exporter tous les produits, cochez la case Export all products (voir aussi 2.6 ci-après). Si vous voulez exporter les déclinaisons produits, cochez Export product variation.
Il est aussi possible de forcer l'export des produits hors stocks et inactifs en cochant les options correspondantes.
Vous pouvez aussi choisir le format d’export des produits (parmi csv, xml, json et yaml) et la taille des images. Il est aussi possible d’exporter les commandes dans un fichier en cochant l’option Export in file. Ce fichier sera disponible dans le dossier /export du module ou via l’url qui vous sera indiquée. Sinon le résultat de l’export s’affichera dans votre navigateur.

2.4 Import Settings

Le réglage de l’import se fait dans le menu Import settings.

Indiquez sur combien de jours vous voulez importez vos commandes dans le zone de texte face à Import the last X days. Par exemple si vous voulez importer vos commandes ayant eu lieu ces 4 derniers jours, entrez le chiffre ‘4’.

Remarque : indiquez le nombre de jours en chiffres.
Vous avez à disposition deux options pour l’import :

  • Force products : lorsque cette option est activée, les commandes ayant des produits inactifs ou hors stocks seront importées
  • Force price : si cette option est activée, les prix des commandes importées seront ceux indiqués sur la maketplace où ont été passées ces commandes.

L'option 'Import Orders in a specific folder' a été mise en place dans le but de rassembler les commandes importées par le module Lengow. Si cette option est cochée, dans l'écran Orders qui liste toutes les commandes, un dossier spécial Lengow est créé avec les autres ('New', 'Finished', 'Problems').

2.5 Developer Options

Dans le menu Developer options, l’option Debugging permet de faire des tests d’import. Lorsque cette option est activée, les commandes sont importées avec un identifiant particulier et ne sont pas mises à jour sur la solution Lengow.
En outre cela crée des clients avec une adresse email précédée du caractère ‘_’ (underscore). Cela vous permet de faire des tests avec de réelles commandes sans vous empêcher de les importer une fois vos tests finis.

Remarque : une fois vos réglages effectués, n’oubliez pas de cliquer sur le bouton Save pour sauvegarder la configuration du module.

2.6 Logs

Dans cette section sont stockés les logs du module Lengow : ceux-ci concernent les processus d'export des produits et d'import des commandes.

2.7 Export de produits

Si vous n’avez pas activé l’option Export all products, il faut alors que vous choisissiez quels produits exporter. Pour cela allez dans Administer Products, puis Products Lengow. Une fois sur cette page la liste des produits et des catégories s’affiche. Pour exporter une ou plusieurs catégories, dans l’onglet Mass Export, sélectionnez la/les catégorie(s) puis cliquez sur Publish pour sélectionner la catégorie ou Unpublish pour la retirer de l'export. Pour choisir certains produits, cliquez sur le lien Publish de la ligne du produit. A l’inverse pour le supprimer de la liste des produits à exporter, cliquez sur Unpublish.

Tous les produits à exporter sont marqués par la pastille verte à gauche de la liste.

2.8 Lancer un import de commandes

Pour lancer un import de commandes, aller à l’URL suivante :
{urlBoutique}/modules/lengow/connector/webservice/import.php.
Vous pouvez ajouter des paramètres à l’URL :

  • ‘debug=1’ : lorsque que ce paramètre est présent dans l’URL, l’import se fait en mode debug
  • ‘days={jours}’ : ce paramètre permet d’indiquer la période en jours sur laquelle importer les commandes

Exemple d’URL : www.maboutiqueoxid.com/modules/lengow/connector/webservice/import.php
Attention : les paramètres indiqués dans l’URL suppléent ceux de la configuration du module.

2.9 Lancer un export de produits

L’URL pour lancer un export est la suivante :
{urlBoutique}/modules/lengow/connector/webservice/export.php.
Il est aussi possible d’ajouter un paramètre à l’URL pour le format de l’export :‘format={format}’. Avec ce paramètre, vous pouvez choisir parmi les formats csv, xml, yaml ou json.
Exemple d’URL : www.maboutiqueoxid.com/modules/lengow/connector/webservice/export.php

Attention : comme pour l’import, le format entré dans l’URL supplée celui de la configuration du module

3. Erreurs connues

3.1 ‘Shop Offline’

Si un message ‘Shop Offline’ s’affiche, aller dans Service, puis Tools et cliquez sur Update DB Views Now. Un message de confirmation devrait apparaître, cliquez sur ‘Ok’.

3.2 Le tag Lengow n’est pas dans la page

Si vous venez d’activer ou de changer le type de tag Lengow et que celui-ci ne se trouve pas dans les pages de votre boutique, il est possible que cela vienne du cache de templates généré par la solution. Pour cela allez dans le dossier /tmp/smarty de la solution et supprimez tous les fichiers. Cela forcera la solution à créer un nouveau cache et devrait intégrer le tag Lengow.

3.3 Unauthorized IP

Si lorsque vous lancez les webservices d’import et d’export vous avez le message “Unauthorized IP”, cela signifie que l’adresse IP avec laquelle vous tentez d’accéder au webservice n’a pas été autorisée. Pour l’autoriser, voir plus haut (2.1 Lengow Account).