Oxid plugin

Our Oxid plugin is no longer maintained by our technical team.
It can help you if you already have some knowledge of Oxid, however, to manage your catalogue, we recommend a classic export via the Lengow platform.

1.Installation

Before the installation / update of the plugin, follow our tips!

You can download the Lengow module for Oxid at http://www.lengow.com/wp-content/uploads/2015/06/lengow.v0.3.zip
To install the Lengow module, you need to unzip the file into the /modules directory of the solution. Once unzipped, go to your Oxid back office by logging into you admin account. Then go to Extensions, Modules, select the Lengow Oxid Connector and activate it (in the Overview tab). 

2.Configuration

To configure the Lengow module, please go to Master Settings, and click on Lengow.
You should then see acces the module configuration screen as below: 

2.1 Lengow Account

In the Lengow Account menu, please enter you customer id in the IdClient box, group id in IdGroup and your token ( available at https://solution.lengow.com/api/).
Please also enter the IP addresses from which the Lengow services (products publishing and order import) will be launched: you can add as many IP addresses as you wish. However each of them must be separated by ‘;’ (no space between). For instance : 127.0.0.1;198.51.21.1.

2.2 Tracking Options

The Tracking options menu allows you to configure the Lengow trackers. Simply chose the type of tracker you want to set up in your e-shop (TagCapsule or SimpleTag) and chose which product attribute you want to include in your tracker : product number or product id.

2.3 Export Settings

 

This menu helps you configure the publishing of your products. If you wish to export all your products, you may check the Export all products box (see also 2.6 below). If you want the product variations to be exported, check the Export product variation box.
You may also want to publish inactive and/or out of stock products: if so check the corresponding boxes. In this menu you can also chose the format of your export (csv, xml, json or yaml) and the size of pictures.
You can also export your products feed into a file by checking the Export in file box. If so, the file will be located in the /export directory of the module (the URL to the file should appear when 'Export in file' is activated and the configuration saved). Otherwise it will be displayed in your browser

2.4 Import Settings

In the Import settings menu you can set different options : first enter the period (in days) for which you wish to import your orders. Please note that the period must be written in numbers (letters are not recognised). For instance if you wish to import the orders from the last four days, enter ‘4’.

You can also activate other options:

  • Force products: if enabled, orders will be imported even if the products are inactive or out of stock
  • Force price: if checked, the products price will be the prices from the marketplaces and not as they are in your Oxid
  • Import orders in a specific folder: this option allows you to gather orders imported with the Lengow extension. Therefore if checked, when in the order list view, a Lengow folder is created among the 'New', 'Finished' and 'Problems' folders. If it is then unchecked, the Lengow folder is removed and the orders will be moved to all.

2.5 Developer Options

This last menu has only one option: Debugging. This option is useful to run tests: when activated, the orders imported will have a different id and the customers’ email address will be prefixed by ‘_’. Moreover these orders will not be synchronised with Lengow solution. Therefore you can run tests with real orders and when you are done still import them to be processed.

Please make sure that you hit the save button when you are finished configuring the module.

2.6 Logs

This last section gives you access to the module logs. They contain information about export and import. Note that the log files have a lifetime of 7 days.

2.7 Chosing products to publish

If the Export all products option is not enabled you will need to chose which product(s) you want to publish. To do so, go to Administer Products then Products Lengow. This page lists all the products and categories.
You can publish a whole category by selecting it in the list from the Mass Export tab and click Publish. You can select one or more categories. If you wish to unselect these categories, then click on Unpublish.
You can also select products one by one by clicking on Publish the product line (or Unpublish to unselect them).

As you select the products to export, you will notice a green marker appearing.

2.8 Launch import

The import URL pattern is the following: {shopURL}/modules/lengow/connector/webservice/import.php
You can add parameters to this URL by adding the following :

  • ‘debug=1’ : if this parameter is added, orders are being imported in debug mode
  • ‘days={days}’ : this parameter indicates the period (in days) for which to import orders

Example of valid URL : www.myoxidshop.com/modules/lengow/connector/webservice/import.php

Please note that the URL parameter(s) will replace the parameter(s) you entered in the module configuration.

2.9 Launch export

The export URL pattern is as follow:
{shopURL}/modules/lengow/connector/webservice/export.php

You can add one parameter to this URL : ‘format={format}’. This will sets the export format to the value you entered (csv, xml, yaml or json).

Example of valid URL : www.myoxidshop.com/modules/lengow/connector/webservice/export.php

Please note that as for import, the URL parameter will replace the parameter you entered in the module configuration.

3. Known Issues

3.1 ‘Shop Offline’

If a message saying ‘Shop Offline’ appears on your browser, go to Service, Tools and click on Update DB Views Now. An alert box should appear, click ‘Ok’.

3.2 The Lengow Tag is not in the page

If you have just activated or changed the Lengow tag type, and it does not appear in your shop webpage, it may be because of template cache generated by Oxid. To solve this problem go to the solution repository /tmp/smarty and delete all the files contained in it. This will force Oxid to generate a new cache including the Lengow tag. 

3.3 Unauthorized IP

If when you launch a Lengow webservice (such as import or export) and you have the message ‘Unauthorized IP’, this means that the IP address has not been authorized in the module configuration. To solve this issue, please have a look at 2.1 Lengow Account above.