Migrating from Zen to Theme Press
Moving your content from Zen Foundation to Theme Press.
Before initiating any steps, you should set the scope of the migration. First, determine if you want to migrate all spaces or Zen-only spaces. Select all spaces if:
- all spaces in your site use Zen
- some spaces use Zen and other spaces formerly used Zen
- some spaces use Zen and other spaces contain pages using Zen macros
Next, select a processing mode: migration vs. audit.
- Migration mode completes the conversion during each step.
- Audit mode simulates the conversion and generates an audit log.
Migrate Zen Pages
During this step, the migrator replicates each Zen page as a Theme Press architect page. Afterward, the migrator assigns a site default for each type of architect page (banner, header, menu, layout, footer). Additionally, the migrator looks for any space overrides and applies those pages accordingly. (Admin-notice pages are converted to banner architect pages.)
Migrate Overriding Layouts
For each unique Zen layout that overrides the master, the migrator generates a Theme Press layout page. In other words, if two or more Zen pages use the same type of layout, the migrator creates only one layout page in Theme Press. The migrator also applies these layouts to the appropriate pages. (In Theme Press, layouts are found in the Theme Press Default Space.)
You have the option of migrating Zen brands to Theme Press themes. Just select the appropriate brands. Note, you cannot migrate built-in brands. (In Theme Press, themes are located in the theme tab of the Theme Press Designer.
Migrate Zen Macros
During this step, the migrator finds all pages using Zen macros. Upon building the list, you'll see a blue action circle () next to each macro that is ready for conversion. Click this icon to replace the Zen macro with a Theme Press equivalent. You must manually convert or remove all other macros.
You can find a full list of Zen Macros and their Theme Press equivalents here.
When in audit mode, be sure to click the blue action circle for the following macros:
This step adds helpful information to the audit logs.
How do I find pages using these Zen macros?
Click the blue arrow next to the name of each Zen macro that shows results.
Apply Theme Press
Now that you've migrated your brands and Zen pages, you should apply Theme Press and the resulting themes. For each space, migration involves:
- applying Theme Press as the site or space theme
- assigning a site default theme
- assigning any themes that override the site default
If using a built-in brand as the default, the migrator sets the Theme Press default theme to Splash. This step is necessary because you cannot migrate built-in brands.
Create and View Punch List
As you complete this conversion, the migrator builds a list of items you should review and fix.