Magento plugin V2

1. Install the Magento V2 plug-in

1.1 Compatibility

The Lengow plug-in is compatible from the version 1.5 of Magento.

1.2 Download the plug-in

To download the plug-in:

https://www.lengow.com/integrations/magento/

1.3 Install the plug-in in your Magento

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

To install the Lengow extension for Magento: 

  • via Magento Connect: tab "System" > "Magento Connect" > "Magento Connect Manager". Insert the archive into the field provided and click on Upload.

  • via FTP: unzip the archive on your computer, connect to your FTP server, navigate to the root of Magento and merge the folders from the archive with those present in the Magento root directory.

Once the installation is complete, log off and then log back on to your Magento back office in order to reload the user rights. It may also be necessary to empty the caches (tab "System" > "Cache Management"). A new Lengow tab should then appear in your back office as well as a new Lengow menu in "System" > "Configuration".

With this tab you can access the management of your product catalogue ("Manage products Export"), your Lengow orders ("Manage Orders"), your feeds ("Manage Feeds") and the plug-in logs ("Logs").

2. Configure the plug-in

To access the configuration of your Lengow plug-in, go to the "System" > "Configuration" tab.
Lengow should appear in the list of plug-ins on the left and give you the choice to access "Customer Account", "Export Configuration" and "Manage Orders".

Remember to save your configuration with each modification by clicking on "Save Config".

2.1 User Account

The User Account section is divided into three boxes:

2.1.1 General information

In the first box you will find information about your version of the plug-in and whether an update is necessary, as well as the IP address of your server.

2.1.2 Lengow API

If your Lengow account is still not open, this step is not required to export your product catalogue. This step is vital for you to capture orders and import them onto your Magento site.

Global view: The second box concerns all of your customer information, except your group ID (this requires to select your stores).

Store view: The second box concerns your group ID.

  • Customer ID

Enter the customer login that was given to you by your Lengow account manager. You can also find it in the Lengow solution > tab "See your account details” > « id XXXX »

  • Group ID

Enter the login of your Lengow group or groups.

To find your Lengow group logins, go to the Lengow solution > tab "See your account details" > click on "Group Management".

  • Token API

Fill in your Token API.

To find your Token API, go to the Lengow solution > link "API/WebServices" (bottom of the page) > tab "Authentification" > "Token API"  (https://solution.lengow.com/api/)

2.1.3 TagCapsule

The Magento plug-in allows you to add a Lengow tracker directly on your site.
You must therefore configure the product identifier required for the tracker. You have the choice between:

  • the SKU (the reference)
  • the product ID

The Magento plug-in offers you two types of tracker:

  • SimpleTag: This is the classic Lengow tracker that allows you to move up the sales in the interface of your Lengow account.
  • TagCapsule: TagCapsule centralises the set of Lengow partner trackers within a single tag by choosing those that you want. This allows you to move up the sales in the interface of your Lengow account.

2.2 Enter your IP address in Lengow

It is necessary to enter your IP address to use Lengow Webservices. To do so you can follow the link of the first box "Click here to update it". This will redirect you to the page concerned (https://solution.lengow.com/api/).

Once on this page, in the "Authorize the following IP addresses" field you can add the IP address(es) which are likely to require Lengow webservices. Each IP must be separated by a ';' (semicolon) without a space. Once you have entered your addresses, click on "Save".

3. Export Setup

This space allows you to set up the options related to the export of your product catalogue. This part is divided into 4 boxes, each of which proposes options.

3.1 Global

  • Enabled store : this is an important step to enable shop to export. It is possible to activate all shops in default configuration.
  • Export only selected products: if this option is enabled, only the selected products will be exported in your feed. Caution: if no product in your selection is available to be exported (in case of restrictions), your entire catalogue will be exported.
  • Auto export new product: if this option is enabled, new products are automatically added to your export feed.
  • Export product out of stock: this option allows you to export your products that out of stock. If you sell on the marketplaces, we recommend that you enable this option.
  • Product type to export: you can select the types of products to export (configurable, simple, bundled, grouped or virtual).
  • Status of product to export: with this option you can limit the export of your products to those that are activated (Active), deactivated (Deactivated) or both (Activated and deactivated).

3.2 Data

  • Format: this option allows you to choose the format to export your catalogue. You have the choice between xml, json, csv and yaml. To use this export as a Lengow source feed, we recommend csv format.
  • Images max: maximum number of images per product in your catalogue feed.
  • Merge images with parents products if exist: if you enable this option, the images of the parent products are merged with those of the child product. Images are limited to 5 per product.
  • Level max for category: indicates the maximum depth of the breadcrumb trail of the category of a product.
  • Stock without products ordering: with this option, it is possible to deduce stocks of products that are about to be ordered on your site (in a basket for example).
  • Convert date: when this option is enabled, special characters are replaced by HTML characters This avoids certain encoding errors.
  • Keep html for the selected fields: the selected fields retain the present HTML. Otherwise they will be cleaned up.
  • Country shipping: country of delivery for the export by default.
  • Shipping cost: allows you to define the shipping cost by default if no match is found.
  • Shipping method: sets the default shipping method to calculate shipping costs.
  • Delay of shipping: estimated delivery time, in days.

3.3 Product attributes

  • Select attributes to export : This option allows you to choose the fields of the products that you want to export. To do this, select your fields among the list that is displayed. If you want to select multiple fields, hold down the "Ctrl" key of your keyboard.

3.4 Performances

  • Ip authorised to export: this field allows you to authorise certain IP addresses to access your export, i.e. the URL of your source feed.
  • Save feed on file: This option is useful if your catalogue contains a large number of products (+ 3000) or if catalogue feed takes a lot of time to generate. With this option your catalogue feed is stored in a file located in the  /export folder of your Lengow plug-in. Lengow will then retrieve this file directly to index your catalogue. Caution: if you use a file, it is important to enable the scheduled task in order to keep your file up-to-date.
  • Active cron: allows you to launch the export process every 4 hours. This option is useful when the "Save feed on file" option is enabled. This allows you to keep your file up-to-date. This option utilises Magento's CRON system.

3.5 Product Management and export feed

In "Lengow" > "Product Management" tab, you can see the list of your catalogue and select the products that you want to see in your feed.

To do this, select the desired products. Then select (Change Lengow's publication) and click on Submit.

You may also see your export feed (or regenerate the file containing your catalogue) of your stores by clicking on the button "See the export feed". It is possible to see your export feed of one of your stores, by choosing the shop in "Choose Store View".

This feed will be retrieved by Lengow as the source feed, in order to be processed and will be then sent to the different channels.

The feed generation URL always follows the same pattern:

www.your-magento-store.com/index.php/lengow/feed (replace "your-magento-store.com" by the your website domain name).

3.6 Manage feeds

In "Lengow" > "Manage Feeds" tab, you have access to all your catalogue feeds. So you can manage them from your Magento back office without using your Lengow space. 

Attention: this space is recommended for advanced users who have a good overall mastery of the Lengow solution.

3.7 Advanced use of the export URL of a feed

If you are on a multi-site and you would like to generate a special feed for one marketplace in particular, or your catalogue is very specific or very full, it is possible to have several filters in order to create a specific feed. 

In this case, you must use the Magento settings to manage the various feeds. 

The URL must be of the type: http://www.your-website-marchand.com/lengow/feed/index/parameter1/value1c2/parameter2/value2A,value2B/parameter3/value3/[etc] 

The possible settings are:

  1. format: format type for export data (csv, yaml, json or ,xml),
  2. store: id of the merchant store
  3. product_type: configurable, simple, grouped, bundle or virtual, separated by commas (no spaces)
  4. product_status: 0 or 1 or 0,1 for active and inactive products
  5. product_out_of_stock: 0 or 1
  6. selected_products: 0 or 1 for the product selection list. The selection may be different according to the store
  7. stream: 0 or 1. 1 displays the feed even if the vendor has selected export in a file
  8. local: language of the site in ISO format (en, fr, etc…)
  9. limit: maximum number of products to export
  10. offset: number of products to be ignored at the start
  11. products_ids: SKU of the products to export, separated by commas

Example: http://www.your-website-marchand.com/lengow/feed/index/store/4/product_type/configurable,simple/product_status/0/local/EN/ 

4. Order management

This space allows you to set up the options related to the import of your orders. This part is divided into 2 boxes, each of them proposes options.

Note: It is mandatory to fill in your Lengow Identifier (part "2.1.2 Lengow API") to import your orders.

4.1 Manage Orders

In this part you can configure all the options related to the import of orders on your Magento.

  • Enabled store : this is an important step to activate one or few shops that you want to be imported. It is possible to activate all shops in default configuration.
  • Import orders from x days: This option allows you to set the period for which you want to import your orders. Thus, if you want to import your orders over the last 5 days, just enter the value "5". Orders that have already been imported are stored in your database. This avoids the orders being imported several times.
  • Use the real date of import's order: with this option you can make sure that the date of the order is the same as the one of the marketplace. Otherwise it will be the date on which it was imported.
  • Import processing fee from Marketplace: If this option is enabled, the costs associated with the marketplaces (commissions) are included in the order. This enables better accounting management.
  • Customer group: allows you to assign the clients created at the time of the import to a group of clients.
  • Import with product's title from Lengow: If you want the name of the product to be the one from the marketplace instead of the product name matched on your Magento. Caution: you must check the SKU of the imported product to avoid problems of stock.
  • Split name: this option allows you to split the names in two. This option is useful when the name and first name of the customer who placed the order, are contained in the same line of information.
    • For example, when the first name line of the order is empty and the name line contains "Jean Dupont", if the option is not activated the customer file will be:
      • first name: __  name: Jean Dupont. The "__" are added by the plug-in to complete the empty fields.
    • If the option is activated, the customer's file will look like this:
      • first name: Jean name: Dupont
  • Choose default shipping : This option allows you to assign a carrier by default to the order. The list that is proposed is based on the carriers configured in your Magento back office.
  • Use fake emails: This option can generate fake emails during import orders.

4.2 Performances

  • Auto import: if this option is enabled, the import is automatically launched every 30 minutes. This option uses Magento's CRON system.
  • Debug mode: this mode allows you to carry out tests with the Lengow plug-in. When it is enabled, it allows you to import orders under a fictitious Lengow order identifier. Thus, no action on the imported orders in debug mode will be passed on to Lengow. Caution: If this mode is enabled, the orders can be imported several times. It is therefore important only to activate it in a test area.​

4.3 Order management

Order management gives you access to Lengow orders only. From this screen, you have a better visual display of the information of the order (such as the identifier of the order or the marketplace where the order originated).

You can also perform actions on the orders that you have selected from the "Action" drop-down list.
From this screen you can also launch a manual import by clicking on the "Manual import" button.

When you access the details of an order, certain information may be useful to you:

  • in the payment block you will find the name of the marketplace where the order was placed

  • in the shipment section, if the order is to be delivered to a delivery point, the identifier of the latter will be available in the shipping address. In addition, the method of transport chosen by the merchant of the marketplace is available between [ .. ]

5. CRON and Magento Tasks

Magento incorporates a management system for scheduled tasks: it is thanks to this system that the Lengow plug-in is able to propose scheduled import and export options.

For this system to work, it is necessary to create a CRON task on your server: it is recommended that you execute the cron.sh orcron.php script (at the root of your Magento) every 5 minutes. The purpose of this task is to create, schedule and execute the tasks defined by the different applications and plug-ins for Magento.

6. Logs

This last space gives you access to the logs of the Lengow extension. When you encounter a problem with the import of orders or with the generation of your catalogue feeds, we suggest you first consult these logs to understand where the problem originates.

You can also permanently delete all logs by clicking on the "Flush logs" button.