You can choose to install the plugin through Magento Connect or by directly using the archive files.

13 

Full text

(1)

Magento plugin 1.5.7 installation

1. Plugin installation

You can choose to install the plugin through Magento Connect or by directly using the archive files.

1.1 Installation with Magento Connect

1.1.1 Classic method

Go the plugin page: http://www.magentocommerce.com/magento-connect/lengow-import-export-7172.html Click on Install, select your MagentoConnect version, and get the key.

Go to your backoffice, paste the key on the page MagentoConnect Manager, then click on Install.

We often update our plugins to fix bugs that can appear depending on the Magento versions or configurations.

If you encounter issues following the installation, please follow the process described in the point 1.2 of this guide.

1.1.2 Using the archive file upload

Our archive is available at the

(2)

Magento back office, on the MagentoConnect Manager page. Insert the archive URL in the dedicated field and click on Upload.

1.2 FTP Installation

If you prefer to install the plugin without using MagentoConnect, download the file at the

following location:http://www.lengow.fr/view/plugins/magento/module_lengow.1.5.7.zip

Unzip the file on your computer, log into your FTP server. Go to the root of your Magento

and merge the archive files with the existing files.

1.3 Test the installation

Once you have installed the plugin, go back to your Magento back office.

A new menu is now visible in the horizontal menu.

Another Lengow menu is also visible in the page System > Configuration

Possible bugs

If you encounter bugs during or after the plugin installation, refer to the last point of this handbook.

2. Feed configuration

(3)

Go to the page System > Configuration to configure the feed. Your data feed will be available at the following

link : http://www.domain name.com/lengow/export_flux/

If you want to know more about the feed management, go to the point 8.

2.1 Lengow API and Tagcapsule

This menu allows you to manage the plugin general information. This configuration is

mandatory to insure the efficiency of the plugin.

Id Client Lengow : Your Lengow client ID, indicated by your account manager

Id Group Lengow : Your Lengow group ID, indicated by your account manager

Api key : Lengow API key available at the following

link : https://solution.lengow.com/api/ (API token)

Save the changes.

(4)

Activer le module Lengow : Activate the plugin

IP(s) autorisée(s) pour l'export : you must indicate here the authorized IP to see the

export.

Exporter uniquement les produits sélectionnés : If yes, it only exports the products

selected in Lengow > Export > Sélection des produits in the export.

Exporter les produits hors stock : Allows you to exclude or not products that have a

stock of 0 (usefull for marketplaces).

Exporter les types de produits : Allows you to export variants products or not.

(5)

Fusionner les images des produits parents : If yes, parent products pictures will be

merged with the child products pictures. 5 pictures max. per product.

Formater les données : Replace special characters with HTML characters

Pays de livraison : Default delivery country

Délais de livraison : Default delivery delay (in days)

Frais de port : Default shipping costs

Mode de livraison : Default delivery method

(6)

Mémoire allouée pour l'export : Memory allocated for the export

Utiliser le XML : If yes, the feed will be generated in XML (not in CSV)

Sauvegarder le flux : If yes, the feed will not be displayed but saved as a file. To know

where the file is located, open the feedURL, once it is saved, a message will tell you

where the file is saved.

2.5 Choose your specific attributes

Select the specific attributes that you want to have in the data feed. To select more than

one attribute, keep the CTRL touch pulled down.

(7)

You can select the products to export in your datafeeed: Go to the Lengow menu⇒Export⇒Sélection de produits.

Filter products and tick the selection, then choose « Changer la publication » in Action. les produits Select yes or no and save.

4. Orders management

The order management allows you to import orders from marketplaces in your Magento.

4.1 Configuration in Magento

Be aware, to import orders in Magento, you have to configure information in

Lengow’s API and TagCapsule. Refer to point 2.1.1 to know more about this.

(8)

Activer la gestion des commandes : If you select yes, that will activate the order

import.

Importer depuis X jours : Defines the number of days on which orders should be

imported.

Importer par n commandes : Allows to limit the maximum number of orders to import.

Facturation automatique : Automatic invoicing, an invoice will be created if the order

is imported as « paid ». If this functionnality is deactivated you will have to handle

invoicing manually.

Appliquer la TVA : Applies or not VAT on the products

Be aware

, Lengow’s plugin is using native Magento methods. If you use one or more

specific plugins, the Lengow plugin might not take them all into account.

Contact Lengow support team to know more about this.

4.2 Configuration in Lengow

Select the right group if you have more than one group in Lengow.

On the page https://solution.lengow.com/marketplace/commandes/all/?

type=importMagento

(9)

You must only fill in the fields Site ID and Store ID. Other parts regard old plugin versions.

On the page https://solution.lengow.com/api/, you must add the server IP on which your

Magento is hosted. So Lengow can grant access to the API.

(10)

you will see them in the URL when you mouse over the stores

and shops names (the URL is visible at the bottom of the

browser)

5. Order imports in Magento

You can import your orders manually into Magento in Lengow⇒Commandes⇒Lengow import des commandes. Click on « Lengow import des nouvelles commandes » to launch an order import.

The import occurs automatically every 30mn. If there is an error, you can check the order import report in the Lengow journal, visible from Lengow⇒Commandes⇒Journal Lengow but also in your

(11)

Lengow interface in your Magento import page.

(https://solution.lengow.com/marketplace/commandes/all/?type=importMagento).

6. Order import in Lengow

You can easily access your orders from the menu : Lengow⇒Commandes⇒Commandes Lengow

7. Migrating from an older plugin version

If you were using an older plugin: You have to keep the old plugin while you configure the new one. You will have to remove the API logins you have filled in Lengow

(https://solution.lengow.com/marketplace/commandes/all/?type=importMagento) the time you configure the new data feed.

Once your new data feed is configured, send it to your Lengow account manager and/or the support team. We will tell you if the feed is well configured and you will be able to delete the old plugin version.

You will then be able to add your new Magento API logins within the solution.

Warning: migrating from an older plugin to the new one implies a data feed structure change. Lengow matches your most important fields (price, description, product ID, title…) but all field attributes cannot be matched automatically. Thus, you will have to check your feeds field matching and check the optimisations you have previously done. You must imperatively inform the support team if you update your Magento plugin from the version 1.4 to the plugin version 1.5. You will also have to send us the new data feed URL.

8. Advanced used of the plugin

If you have a multi site version of Magento, and if you want to generate a specific feed for a marketplace, here are few examples of advanced used of the plugin

8.1 Managing the feeds with GET parameters

Sometimes merchants want to export one data feed per marketplace.

According to the marketplace, merchants will need to export all products or available

products or only products with variations.

(12)

In this case, we will use the GET parameters to manage the several data feeds. Thus you

will not have to edit/change your configuration nor create specific URLs for each data

feed.

To use a specific data feed, simply replace the data feed

URL

by:

http://www.mywebsiteURL.com/?parametre=value

8.1.1 Product types

Like in the back office configuration, you will be able to determine which product types you want to export, to do so, use the parameter “types”:

Available values are:

'simple (products without variations)

configurable,simple (products with and without variations)

configurable (products with variations)

E.g.: to export only simple products, your URL is: http://www.mywebsiteURL.com/?types =simple

8.1.2 Feed format

You can also define a specific file format. Use the “mode” parameter in your URL. Available values are:

csv

xml

E.g.: to generate a csv feed: http://www.mywebsiteURL.com/?mode=csv

Please note that you can combine parameters in your URL: http://www.mywebsiteURL.com/? mode=csv&types=simple

8.1.3 Other parameters

You can export a specific number of products for a single partner, and all products to another partner, to do so you can use the parameters limit and offset in the feed URL.

If you are not familiar with these parameters, you can find some information online (SQL specialized websites).

8.1.3.1 Limit

This parameter limits the number of entries on any given page. The limit will default to 100 entries if a value is not specified.

limit=“200” to export the first 200 products.

8.1.3.2 Offset

This parameter offsets the display by X number of entries.

For example, if you want to show all entries except the three latest ones, you would do this: offset=“3”

Toujours sur votre export classique qui renvoi 500 produits, si vous

(13)

you have 500 products in your export catalogue, you only want to export 100 products from the 200th product, you can set up offset to 200 and limit to 100.

8.2 Full and heavy exports

Some product catalogues are very heavy and they cannot be loaded by our servers (we

have a time out of 180 sec).

If your feed is very long to load, it is recommended to save the feed instead of displaying

it.

Select the option (explained above) and generate the feed manually with a browser.

Once the feed is generated, you will not see it on your screen but you will see a message

like “CSV save at /chemin/vers/magento/media/lengow/default/lengow_feed.csv”

Use the part following ”/media” (”/media” must be included) to have your data feed

URL

.

This data feed

URL

will have to be sent to Lengow.

You can then generate a cron task that will call this script, through a “curl” for instance.

8.3 Multi-site management

8.3.1 Configuration

Multi-site management uses the classic Magento process.

On the page Système > Configuration use the left hand corner menu “Portée de la configuration” to specify the store concerned by the changes.

It is very important to well configure your groups in Lengow in order to have one store per Lengow group. You can also edit the feed/order configuration per store.

8.3.2 Use

To define a specific data feed for a specific store, use a link like the one below : “http://www.domain-name.com/lengow/export_flux/index/store/{storeID}“ You can also use the GET parameters detailed previously.

Figure

Updating...

Related subjects :