To move from Zen Foundation to Theme Press, you'll want to migrate all of your Zen pages, brands, macros and settings.

To facilitate this process, the Zen Migrator add-on is available. Please create a support ticket at https://support.brikit.com to request a copy.

Zen and Theme Press Versions

You need Zen Foundation 5.2.16 or higher and Theme Press 1.1.7 or higher to complete the migration successfully.

Before Migration!

Before migrating your production server, be sure to:

  • verify your results in a test environment
  • backup your site and verify the validity of the backup

Migration Page

Once you install the add-on, complete the following to access the migration page.

  1. Access the admin console.
  2. Locate the Zen Migrator section on the left.
  3. Click the Migrate Zen Foundation to Theme Press link.

Site vs. Space

As you move through the process, the migrator takes note of:

  • Zen's application on a site-wide and space-by-space basis
  • any spaces using themes other than the default
  • any spaces using layouts other than the master

Zen Pages

When you migrate, your Zen pages become Theme Press architect pages. The migrator creates an architect page for each header, layout (page or blog), menu and footer page in your site. For each admin-notice page, the migrator creates a banner page.

Layouts Overriding Master Layouts

The migrator also creates a Theme Press layout page for any Zen layout overriding the master.

Brands

Migrating involves creating a Theme Press theme for each Zen brand that is not a built-in brand.

Defaults

Both Zen and Theme Press allow you to set a default brand/theme. Likewise, you have defaults for Zen and architect pages. You do not need to map your defaults from Zen to Theme Press. The migrator sets them for you.

Overrides

The migrator also looks for any spaces using a brand or Zen page other than the default, including layouts overriding the master. The migrator applies these overrides accordingly in Theme Press.

Macros

Macros available through Zen differ from those in Theme Press. In some cases, Theme Press offers equivalent macros. When available, you can use the migrator to convert Zen macros into Theme Press macros. When not available, you must manually change or remove Zen macros.

Custom CSS and JavaScript

After migrating, manually add your custom CSS and/or JavaScript to Theme Press. You may need to update this code.

Cascading Menus

Theme Press does not support cascading menus. Therefore, Theme Press ignores any second level items in migrated menus. Try menu panels or secondary menus instead.


Migration Page

Once you install the add-on, complete the following to access the migration page.

  1. Access the admin console.
  2. Locate the Zen Migrator section on the left.
  3. Click the Migrate Zen Foundation to Theme Press link.

Site vs. Space

As you move through the process, the migrator takes note of:

  • Zen's application on a site-wide and space-by-space basis
  • any spaces using themes other than the default
  • any spaces using layouts other than the master

Zen Pages

When you migrate, your Zen pages become Theme Press architect pages. The migrator creates an architect page for each header, layout (page or blog), menu and footer page in your site. For each admin-notice page, the migrator creates a banner page.

Layouts Overriding Master Layouts

The migrator also creates a Theme Press layout page for any Zen layout overriding the master.

Brands

Migrating involves creating a Theme Press theme for each Zen brand that is not a built-in brand.

Defaults

Both Zen and Theme Press allow you to set a default brand/theme. Likewise, you have defaults for Zen and architect pages. You do not need to map your defaults from Zen to Theme Press. The migrator sets them for you.

Overrides

The migrator also looks for any spaces using a brand or Zen page other than the default, including layouts overriding the master. The migrator applies these overrides accordingly in Theme Press.

Macros

Macros available through Zen differ from those in Theme Press. In some cases, Theme Press offers equivalent macros. When available, you can use the migrator to convert Zen macros into Theme Press macros. When not available, you must manually change or remove Zen macros.

Custom CSS and JavaScript

After migrating, manually add your custom CSS and/or JavaScript to Theme Press. You may need to update this code.

Cascading Menus

Theme Press does not support cascading menus. Therefore, Theme Press ignores any second level items in migrated menus. Try menu panels or secondary menus instead.


If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the Steps block above to narrow the gap between the two blocks.

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.

If using:

  1. Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
  2. Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks.
  • Replace me with a link
  • Replace me with a link
  • Aim for 4 or fewer related links.  If we need more, that's okay.  Be judicious.  Delete me when you're done.