Migration: Difference between revisions
No edit summary |
m (→Next Step) |
||
| (13 intermediate revisions by the same user not shown) | |||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:Template Migration}} | |||
This tool enables you to migrate all templates and app blocks created by the Easy Content Builder app from an existing theme to a new one. | This tool enables you to migrate all templates and app blocks created by the Easy Content Builder app from an existing theme to a new one. | ||
| Line 9: | Line 11: | ||
* The migration utility will create new templates in the Destination theme based on the default JSON template files of products (product.json), pages (page.json), and articles (article.json). | * The migration utility will create new templates in the Destination theme based on the default JSON template files of products (product.json), pages (page.json), and articles (article.json). | ||
* And copy App sections from the templates of the Source theme to the bottom of the corresponding templates in the Destination theme. | * And copy App sections from the templates of the Source theme to the bottom of the corresponding templates in the Destination theme. [[File:Ecb template migration.jpg|1200x1200px]] | ||
=== Migration Steps === | === Migration Steps === | ||
| Line 26: | Line 28: | ||
If you want the Destination theme only shows the migrated content blocks (in the migrated templates) without sections from the default templates - ''product.json''/''page.json''/''article.json'', you need to create three [[Clean Template|Clean templates]] '''in the Destination theme''' - each for a page type: Product, Page, Blog Post. | If you want the Destination theme only shows the migrated content blocks (in the migrated templates) without sections from the default templates - ''product.json''/''page.json''/''article.json'', you need to create three [[Clean Template|Clean templates]] '''in the Destination theme''' - each for a page type: Product, Page, Blog Post. | ||
{{Note|Please refer to the section [[Clean Template|Create Clean Template]] for more details on how to create a Clean template.|inline}} | |||
[[File:Default vs clean templates migration.jpg|1548x1548px]] | [[File:Default vs clean templates migration.jpg|1548x1548px]] | ||
====Step 3: Migrate the templates and content blocks created by Easy Content Builder==== | ====Step 3: Migrate the templates and content blocks created by Easy Content Builder==== | ||
| Line 35: | Line 37: | ||
* Identify the '''Destination theme''' - the new OS 2.0 theme that you want to migrate over. | * Identify the '''Destination theme''' - the new OS 2.0 theme that you want to migrate over. | ||
* Click '''Submit'''. Then, you will be prompted a confirmation message, click '''OK''' to proceed with the migration. | * Click '''Submit'''. Then, you will be prompted a confirmation message, click '''OK''' to proceed with the migration. | ||
[[File:Ecb template migration form.png|1200x1200px]] | |||
If a template already exists in the destination theme (which means you successfully migrated the template before), the migration tool will notify 'no new templates created'. | If a template already exists in the destination theme (which means you successfully migrated the template before), the migration tool will notify 'no new templates created'. | ||
If there are any issues during the migration, the migration tool will notify you of details of the error. Then you can resolve and migrate again to transfer those pending items from the old theme to the new theme. | If there are any issues during the migration, the migration tool will notify you of details of the error. Then you can resolve and migrate again to transfer those pending items from the old theme to the new theme. | ||
=== Migration, Before and After === | |||
Below is an example of the '''Smartphone A55''' product in the '''Dawn''' theme (the Source theme) before migration and that same product in the '''Craft''' theme (the Destination theme) after migration. | |||
As can be seen, all content blocks created by the Easy Content Builder have been migrated to the Destination theme ''''Craft'''<nowiki/>'. They inherit the style of the current '''Craft''' theme by default. | |||
[[File:Ecb template migration result.jpg|1456x1456px]] | |||
{{Note|You can check out the [https://easy-content-builder.myshopify.com Easy Content Builder demo] to see sample content blocks in different themes: Dawn, Craft, Crave, Refresh, and Sense.|inline}} | |||
=== Next Step === | === Next Step === | ||
Now that you have all migrated content blocks in the Destination theme, you can add, remove, or edit those content blocks to your need. (''Please refer to the [[Add_section_settings|Add Sections]] for more details)'' | |||
Latest revision as of 09:19, 31 May 2024
This tool enables you to migrate all templates and app blocks created by the Easy Content Builder app from an existing theme to a new one.
Requirements
- The destination theme must be an OS 2.0 theme that supports template files of product, article, and page in JSON format.
- You can not migrate data to the Demo (Free Trial) theme until you buy it.
How does migration work?
- The migration utility will create new templates in the Destination theme based on the default JSON template files of products (product.json), pages (page.json), and articles (article.json).
- And copy App sections from the templates of the Source theme to the bottom of the corresponding templates in the Destination theme.
Migration Steps
Step 1: Back up the Destination theme
Before migration, it's a good idea to make a backup copy of the Destination theme - the new OS 2.0 theme that you want to migrate over - so that you can discard your changes and start again if you need to.
- From your Shopify admin, go to Online Store > Themes.
- For the theme that you want to duplicate, click the ... button to open the actions menu, and then click Duplicate.
The duplicate theme will be named Copy Of + the name of the theme that you duplicated and appears on the Themes page.
Step 2 (Optional): Create a Clean template
With the current migration workflow, all migrated content blocks will append at the bottom of the Destination theme after migration.
If you want the Destination theme only shows the migrated content blocks (in the migrated templates) without sections from the default templates - product.json/page.json/article.json, you need to create three Clean templates in the Destination theme - each for a page type: Product, Page, Blog Post.
Step 3: Migrate the templates and content blocks created by Easy Content Builder
- From the Easy Content Build dashboard, click the Migration tool.
- Identify the Source theme - the original theme on which you created the templates and content blocks using the Easy Content Builder app.
- Identify the Destination theme - the new OS 2.0 theme that you want to migrate over.
- Click Submit. Then, you will be prompted a confirmation message, click OK to proceed with the migration.
If a template already exists in the destination theme (which means you successfully migrated the template before), the migration tool will notify 'no new templates created'.
If there are any issues during the migration, the migration tool will notify you of details of the error. Then you can resolve and migrate again to transfer those pending items from the old theme to the new theme.
Migration, Before and After
Below is an example of the Smartphone A55 product in the Dawn theme (the Source theme) before migration and that same product in the Craft theme (the Destination theme) after migration.
As can be seen, all content blocks created by the Easy Content Builder have been migrated to the Destination theme 'Craft'. They inherit the style of the current Craft theme by default.
Next Step
Now that you have all migrated content blocks in the Destination theme, you can add, remove, or edit those content blocks to your need. (Please refer to the Add Sections for more details)
