Migration: Difference between revisions

From Posstack.com Documentation
(Created page with "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...")
 
No edit summary
Line 21: Line 21:
The duplicate theme will be named '''Copy Of +''' the name of the theme that you duplicated and appears on the Themes page.
The duplicate theme will be named '''Copy Of +''' the name of the theme that you duplicated and appears on the Themes page.


Step 2: Create a Clean template  
'''Step 2 (Optional)''': Create a Clean template  


With the current migration workflow, after migration, all migrated content blocks will append at the bottom of the Destination theme like the screenshot below:


'''Step 2''': Migrate the templates and content blocks created by Easy Content Builder
<image>


* From the Easy Content Build dashboard, click the '''Migration tool'''.
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 can follow these steps:
* 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.
Create a Clean template for products: 
* Click '''Submit'''. Then, you will be prompted a confirmation message, click '''OK''' to proceed with the migration.
 
* From the Shopify Theme editor, tab Products > click '''Create''' template in the dropdown menu.
* Then enter '''''clean''''' to the '''Name field''' & set the '''Default page''' to '''''Based on''''':
<image>


==== Migration tip: ====
Create a Clean template for Pages:  
With the current migration workflow, after migration, all migrated content blocks will append at the bottom of the Destination theme like the screenshot below:  


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 can follow these steps:
* From the Shopify Theme editor, tab Products > click '''Create''' template in the dropdown menu.
* Then enter '''''clean''''' to the '''Name field''' & set the '''Default page''' to '''''Based on''''' Create a Clean template for Blog Posts:
* From the Shopify Theme editor, tab Products > click '''Create''' template in the dropdown menu.
* Then enter '''''clean''''' to the '''Name field''' & set the '''Default page''' to '''''Based on''''':
<blockquote>
Note: Steps above are aimed at creating a template with .clean suffix (product.clean.json, page.clean.json, article.clean.json) so that these page types can remove those default sections before performing the migration.</blockquote>


* From the Shopify Theme editor, tab Products > click '''Create''' template in the dropdown menu.
* Then enter '''''clean''''' to the '''Name field''' & set the '''Default page''' to '''''Based on''''':


Then follow exactly the steps above to create templates for Pages and Articles.
'''Step 3''': Migrate the templates and content blocks created by Easy Content Builder


Note: Steps above are aimed at creating a template with .clean suffix (product.clean.json, page.clean.json, article.clean.json) so that these page types can remove those default sections before performing the migration.  
* 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.


Once done, you can perform the migration as noted in section 5.3. Migration Steps.
Once done, you can perform the migration as noted in section 5.3. Migration Steps.

Revision as of 03:25, 11 November 2022

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, after migration, all migrated content blocks will append at the bottom of the Destination theme like the screenshot below:

<image>

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 can follow these steps:

Create a Clean template for products:

  • From the Shopify Theme editor, tab Products > click Create template in the dropdown menu.
  • Then enter clean to the Name field & set the Default page to Based on:

<image>

Create a Clean template for Pages:

  • From the Shopify Theme editor, tab Products > click Create template in the dropdown menu.
  • Then enter clean to the Name field & set the Default page to Based on Create a Clean template for Blog Posts:
  • From the Shopify Theme editor, tab Products > click Create template in the dropdown menu.
  • Then enter clean to the Name field & set the Default page to Based on:

Note: Steps above are aimed at creating a template with .clean suffix (product.clean.json, page.clean.json, article.clean.json) so that these page types can remove those default sections before performing the migration.


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.

Once done, you can perform the migration as noted in section 5.3. Migration Steps.

Retrieved from "https://docs.posstack.com/index.php?title=Migration&oldid=107"