Migration Tool. User Guide. SHOPIFY to MAGENTO. Copyright 2014 LitExtension.com. All Rights Reserved.

Transcription

1 SHOPIFY to MAGENTO Migration Tool User Guide Copyright 2014 LitExtension.com. All Rights Reserved. Shopify to Magento Migration Tool: User Guide Page 1

2 Contents 1. Preparation Set-up Set-up License Key validation Migration Migration Resuming Advanced Configuration Frequently Asked Questions Shopify to Magento Migration Tool: User Guide Page 2

3 1. Preparation For Source Store: - Please ensure you have the right permission to your Source Store. 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 /media folder. It is strongly recommended to backup Magento Target Store first. 2. Set-up After downloading the product zip file from our Store, please extract it into a folder. Shopify to Magento Migration Tool is a Magento extension which acts like a hub at Magento side to receive data and import it into Magento database. It can be installed just like all other Magento Modules, please follow our general Installation Guide: n_guide.pdf Shopify to Magento Migration Tool: User Guide Page 3

4 3. Set-up Extensions are purchased and setup separately into Migration Tool. 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 2 types of plugin: - Products and Categories SEO Urls Plugin: help migrate Products and Categories urls. Old urls will be saved in Target Magento Store and it will create 301 redirects from old urls to new urls. - Custom Fields Plugin: help migrate custom fields from Source Store to Target Magento 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 Magento Store. To install plugins, just copy plugin files into the instructed folder inside Magento Migration Tools. New functionalities will be enabled. Shopify to Magento Migration Tool: User Guide Page 4

5 4. License Key validation License Key is an encoded string which comes with your download package. This key is needed 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 Magento Target Store backend, select Cart Service Migration > Configuration, and copy and paste your license key here: Shopify to Magento Migration Tool: User Guide Page 5

6 5. Migration Please login your Magento Target Store backend, select Cart Service 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 Cart Url: source cart full url API Key and Password: API of your source cart 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. Log in to your store's admin area and go to Apps Menu. Press Private Apps button Click Generate a Private App button. Enter the title of your new Private App and save the changes. You will see your API Password. Copy and paste it into the corresponding field and proceed to the next step. Shopify to Magento Migration Tool: User Guide Page 6

7 Step 2: Migration Configuration Shopify to Magento Migration Tool: User Guide Page 7

8 Root Category: the category of current Magento store to import all source cart categories into. Product Attribute Set: select an Attribute Set which is used to import products, all necessary attributes in migration process will be created in to this set. Languages Mapping: If your Source Cart is multilingual, corresponding languages ( or storeviews) should be available in Target Magento Store. You may need to create additional languages in Magento Store to avoid data loss. Currencies Mapping: Assign Source Cart currencies to proper Target Magento Store currencies. Creating currencies in Target Magento Store may be needed. Orders Status Mapping: Assign Source Cart order statuses to proper Target Magento Store order statuses. Creating additional order statues in Target Magento Store may be needed. Entities to Migrate: select all entities to migrate or just a part of them. Additional Options: 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 Magento Store, allowing you to maintain your Pagerank. Shopify to Magento Migration Tool: User Guide Page 8

9 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 Step 3: Migration The migration will take place automatically in this final step. In order for it to progress, you should not close your browser. After the migration is completed, click on Clear Cache and ReIndex Data to finish. If you don t want to run it right here or it returns false here, you can do that manually in System > Cache Management and System > Index Management. Shopify to Magento Migration Tool: User Guide Page 9

10 6. Migration Resuming When a problem occurring on the migration process, Magento 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. Shopify to Magento Migration Tool: User Guide Page 10

11 Shopify to Magento Migration Tool: User Guide Page 11

12 7. Advanced Configuration Access Advanced Configuration by going to Cart Service Migration > Configuration from Magento 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 Magento hosting resource you can change the values accordingly. The lower the value is, the less time and resource Magento 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. Shopify to Magento Migration Tool: User Guide Page 12

13 8. Frequently Asked Questions 1. Product import stops permanently at some specific point, how to resolve? Cause: php execution time too low Solution: Go to Cart Migration Configuration, change value Products per Batch to a lower number Increase you server php max_execution_time value 2. At step 2, the tool can not read my mapping data? Shopify to Magento Migration Tool: User Guide Page 13

14 Cause: migration tool can not read your source store database Solution: check Cart Migration Configuration and ensure you enter correct table prefix for your source database 3. Magento database isn't working when hitting Next on Step 1? Cause: there was an issue with the installation, the module could not create its additional tables into Magento database. Solution: login mysql admin, run this script: DELETE FROM `core_resource` where code = "lecamg_setup" After that, refresh the Step 1 page. Shopify to Magento Migration Tool: User Guide Page 14