Prestashop Migration Tools: User Guide Page 1
Prestashop Migration Tool
User Guide
Shopify to Prestashop
Bigcommerce to Prestashop
3DCart to Prestashop
Copyright © 2015 LitExtension.com. All Rights Reserved.
Prestashop Migration Tools: User Guide Page 2
Contents
1. Preparation ..................................................................................................................... 3
2. Setup .............................................................................................................................. 4 For Shopify .................................................................................................................................. 4 For Bigcommerce ......................................................................................................................... 5 For 3DCart ................................................................................................................................... 6
3. Plugins Setup .................................................................................................................. 8
4. Enter License Key ............................................................................................................ 9
5. Migration ...................................................................................................................... 10 Step 1: Source Cart Configuration .............................................................................................. 10
For Shopify .................................................................................................................................... 10 For Bigcommerce .......................................................................................................................... 11 For 3DCart ..................................................................................................................................... 12
Step 2: Migration Configuration ................................................................................................. 13 Step 3: Migration ....................................................................................................................... 15
6. Migration Resuming ...................................................................................................... 17
7. Advanced Configuration ................................................................................................ 18
8. Frequently Asked Questions .......................................................................................... 20
Prestashop Migration Tools: User Guide Page 3
1. Preparation For Source Store:
- Please ensure you have the right permission to upload files into your Source Store.
- It must not block access from Target Store to the connector.
Source Store can operate normally during migration as it requires a very limited resource for the
process.
For Target Store:
- Target Store should be placed in a stable hosting or in localhost.
- PHP Curl must be enabled.
- PHP Fopen (allow_url_fopen) must be On.
- It also must not block connection to Source Store.
- Webserver (mostly apache) should have full permission to write on /img folder.
- Demo mode on backend should be turned off
It is strongly recommended to backup Prestashop Target Store first.
Prestashop Migration Tools: User Guide Page 4
2. Setup After downloading the product zip file from our Store, please extract it into a folder. The module
consists Prestashop Data Migration Module (“lecartmigration” folder) .
Prestashop Data Migration Module Setup
Prestashop Data Migration Module is a Prestashop Module which acts like a hub at Prestashop side
to receive data and import it into Prestashop database. It can be installed just like all other
Prestashop Modules:
1. Using your FTP software, place the folder in your PrestaShop /modules folder.
2. Go to Back Office >> Modules.
3. Locate the new module in the list, scrolling down if necessary.
4. In the row for the new module, click Install.
For Shopify Create API Key and Password for Shopify
Prestashop Migration Tools: User Guide Page 5
In order to enable data migration to or from Shopify, you will need to provide an API Password for
your store. So, here is a step-‐by-‐step tutorial that will help you to get this information by your own.
1. At first, log in to your store's admin area and go to Apps Menu. 2. Than, press Private Apps button 3. Click Generate a Private App button. 4. Enter the title of your new Private App and save the changes. 5. Right after that, you will see your API Key and Password.
You will then need to copy and paste these info into migration Step 1.
For Bigcommerce Create Username, API Path and API Token for Bigcommerce
Prestashop Migration Tools: User Guide Page 6
You need to retrieve Username, API Path and API Token from your Bigcommerce admin account.
1. Please Login to your store's control panel.
2. Look at the top right conner, click on Setup & Tools > Advanced tools > Legacy API Accounts.
3. Press Create a Legacy API Account.
4. You will see Username, API Path and API Token.
You will then need to copy and paste these info into migration Step 1.
For 3DCart
Log into your 3dcart Online Store Manager and, using the left hand-‐navigation menu:
1. Go to Modules 2. Look for the SOAP API module and click on its + Icon to expand the selection. 3. Click on the "Change Settings" link 4. Place a mark in the "Enable API" checkbox. 5. Copy your API key and click on the "Save" button at the top right.
Prestashop Migration Tools: User Guide Page 7
The API key you just copied can now be used on whatever program you're using that requires API.
You will then need to copy and paste these info into migration Step 1.
Prestashop Migration Tools: User Guide Page 8
3. Plugins Setup Plugins are purchased and setup separately into Prestashop Data Migration Module. They will
provide additional functionalities to the tool. Normally plugins need to be customized and tweaked
by LitExtension Team to fit customers requirements and will be sent to customers later on. There are
a few types of plugin:
-‐ Products and Categories SEO Urls Plugin: helps migrate Products and Categories urls. Old urls will
be saved in Target Prestashop Store and will be maintained to keep all current SEO ranking you have
built up for years.
-‐ Custom Fields Plugin: help migrate custom fields from Source Store to Target Prestashop Store. This
is useful in case customers have customized their store, for example: adding fields to database
tables, and also want to migrate these fields into Prestashop Store.
-‐ Customer Password Plugin: special plugin which adds the ability to read passwords encrypted by
Source Stores to Prestashop. All passwords are migrated over and remains encrypted, customers can
login to the new shop right away without the need of resetting passwords. “Prestashop to
Prestashop " tool natively supports migrating passwords and does not need this plugin.
To install plugins, just copy plugin files into the instructed folder inside Cart Migration Prestashop
Module. New functionalities will be enabled.
Prestashop Migration Tools: User Guide Page 9
4. Enter License Key License Key is an encoded string which comes with your download package. This key is required to
activate your Migration Tool.
1. After purchasing the product, please login to our store and enter “My downloadable products”
section. Here you will find download link and license key for the download package.
2. Login your Prestashop Target Store backend, select Cart Migration > Configuration, and copy and
paste your license key here:
Prestashop Migration Tools: User Guide Page 10
5. Migration Please login your Prestashop Target Store backend, select Cart Migration > Migration
The migration will go through 3 simple steps. Just hit “Next” when you finish one step to advance.
Step 1: Source Cart Configuration
For Shopify
• Cart Type: select corresponding source cart type (auto selected as Shopify)
• Cart Url: shopify store original url
• API Key, Password: created in section 2. SETUP
Prestashop Migration Tools: User Guide Page 11
For Bigcommerce
• Cart Type: select corresponding source cart type (auto selected as Bigcommerce)
• Cart Url: bigcommerce store original url
• Username, API Path, API Token: created in section 2. SETUP
Prestashop Migration Tools: User Guide Page 12
For 3DCart
• Cart Type: select corresponding source cart type (auto selected as 3dcart)
• Cart Url: 3dcart store original url
• API Key: created in section 2. SETUP
Prestashop Migration Tools: User Guide Page 13
Step 2: Migration Configuration
• Root Category: the category of current Prestashop store to import all source cart categories
into.
• Languages Mapping: If your Source Cart is multilingual, corresponding languages ( or
storeviews) should be available in Target Prestashop Store. You may need to create
additional languages in Prestashop Store to avoid data loss.
• Currencies Mapping: Assign Source Cart currencies to proper Target Prestashop Store
currencies. Creating currencies in Target Prestashop Store may be needed.
• Orders Status Mapping: Assign Source Cart order statuses to proper Target Prestashop Store
order statuses. Creating additional order statuses in Target Prestashop Store may be needed.
Prestashop Migration Tools: User Guide Page 14
• Entities to Migrate: select all entities to migrate or just a part of them.
Additional Options:
• Migrate recent data: if you choose this option, it will migrate new data only. Supposed you
have just finished a full migration from your current Source store to Target store, after that
Source store is still live and continue getting new data, and you want to get your Target store
updated with the new data, select this feature to avoid starting over again.
• Clear current data on Target Store before Migration: if you choose this option, all current
products, categories, manufacturers, customers, orders, product reviews, taxes will be
cleared.
• Migrate categories and products SEO URLs: if you choose this option, old SEF urls of source
will be preserved in Target Prestashop Store, allowing you to maintain your Pagerank.
Prestashop Migration Tools: User Guide Page 15
• Transfer images in product descriptions to Target Store: download all images in product
description into your store so that it won’t have to refer back to your source store or
anywhere else for images.
• Preserve Customer IDs on Target Store: this will help you preserve your old Customer IDs for
easier reference.
• Preserve Order IDs on Target Store: this will help you preserve your old Order IDs for easier
reference.
• Migrate Categories and Products SEO Urls: imports and keeps old Urls alive. This option is
only available when “SEO Url plugin” is installed.
Step 3: Migration
Prestashop Migration Tools: User Guide Page 16
The migration will take place automatically in this final step. In order for it to progress, you should
not close your browser of remove Source Cart Connector. Information shows in this step:
1. Source cart: source cart base url you have entered in Step 1, this url will be registered with
your license.
2. Entity limit: the limit associated with your license. To change this value, you need to
upgrate/purchase another license code.
3. Tips slider: handly tips you should know
4. Migration progress: show current progress
5. Console: show debug information.
After the migration is completed, click on “Clear Cache and Re-‐build Index” to finish. If you don’t want to run it right here or it returns false for any reason, you can do that manually in “Advanced Parameters > Performance > Clear Cache” and “Preferences > Search > Re-‐build the entire index”.
Advanced Parameters > Performance > Clear Cache
Preferences > Search > Re-‐build the entire index
Prestashop Migration Tools: User Guide Page 17
6. Migration Resuming
When a problem occurring on the migration process, Prestashop Migration Tool provides the ability
to resume the process:
1. Automatically resume on the spot: the tool will automatically resume after a failure until all data is
imported.
2. Manually resume: you can refresh the page to go back to Step 1 and click on “Resume”, this is
helpful when you want to temporarily stop migration and resume when you want to.
Prestashop Migration Tools: User Guide Page 18
7. Advanced Configuration Access Advanced Configuration by going to Cart Migration > Configuration from Prestashop backend
menu. All default values are configured to work with most cases, thus it is recommended to change
these values only when it is necessary to.
• XXX Per Batch: Cart Migration splits each entity data into small batches (or chunks) and
import them in turn. This option defines batch size to process in each turn. Depending on
your Prestashop hosting resource you can change the values accordingly. The lower the value
is, the less time and resource Prestashop spends to process a batch, also the longer overall
time to import full data.
• Delay Time: the sleeping time between each batch. This option defines the “break time” for
both Source Store and Target Store. It is also helpful to prevent Timeout issue if Source Store
has been setup to limit the number of requests in a period of time.
• Auto Retry After: if by some reason, the batch process fails, the tool will automatically retry
after a period of time defined by this option.
Prestashop Migration Tools: User Guide Page 19
• Source Cart Database Prefix: Fill this in only in case your Source Cart does not support Table
Prefix by default (e.g osCommerce), but has been customized to have Custom Table Prefix.
• License Key: license key associated with your product.
Prestashop Migration Tools: User Guide Page 20
8. Frequently Asked Questions
1. How to stop/resume a running migration process?
a. Hit F5/refresh the current page ( Step 3 ), it will go back to Step 1. This will stop current
migration process. A button “Resume” will now show on this page.
b. Hit “Resume” to continue migration from the last point.
2. Product import stops permanently at some specific point, how to resolve?
Cause: php execution time too low
Solution:
1. Stop current migration process
2. Go to Cart Migration Configuration, change value “Products per Batch” to a lower number (1
or 2 for best safe), save and try “Resume” migration.
3. If it still can not go through, stop migration process again
4. Increase you server php max_execution_time value, try “Resume” again.
3. Can the tool migrate customer passwords?
Yes!
The tool can migrate passwords with "Customer Password Plugin". This is a special plugin which adds
the ability to read passwords encrypted by source stores to Prestashop. All passwords are migrated
over and remains encrypted, customers can login to the new shop right away without the need of
Prestashop Migration Tools: User Guide Page 21
resetting passwords. "Prestashop to Prestashop" tool does not need this plugin.
4. Can the tool migrate products and categories old Urls to preserve SEO ranking?
Yes!
"Products and Categories SEO Urls Plugin" helps migrate Products and Categories urls. Old urls will be
saved in Target Prestashop Store and will be maintained to keep all current SEO ranking you have
built up for years.
For us to create the plugin, please provide your source cart url, we will diagnose and create the
plugin to send to you within 24 hours. There are cases which we also require FTP of your source cart.
5. My Source Store has some custom data which I have manually added, can we migrate such
data to my target store?
Yes!
"Custom Fields Plugin" helps migrate custom fields from Source Store to Target Prestashop Store.
This is useful in case customers have customized their store, for example: adding fields to database
tables, and also want to migrate these fields into Prestashop Store.
For us to create the plugin, please provide FTP of your source cart, we will diagnose and create the
plugin to send to you within 24 hours.
6. More questions?
Please drop us a message at: http://litextension.com/contacts/
Or email us at: [email protected]
We are striving to get your questions answered within 24 hours.