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

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.

Before you migrate, review the following information.

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.


Review this list to learn which Zen Foundation macros you can migrate to Theme Press.

Zen Macro

Migrate to...

active-buttonaction-button
active-imagerollover-image-link
add-classhtml-add-class
attachments-listlist-attachments
blog-linkhtml-link
body-classhtml-add-class
clearhtml-clear
click-elementhtml-link
copy-elementhtml-copy-element
disappearexpand
facebook-likeboxwidget connector
flexible-linkhtml-link
gallery-scrollergallery
greetinghello
hide-page-titleremove
include-multi-page-contentinclude-content
include-sectioninclude-content
new-windowtarget-new
page-treepagetree
page-turnerspage-turner
random-contentrotate-content
redirectremove
restrictrestrict-content
restrict-sectionrestrict-content
revealexpand
rotate-imagesrotate-content
rss-feed-linkhtml-link
same-windowtarget-current
seo-meta-descriptionremove (not compatible yet)
seo-titleremove (not compatible yet)
simple-childrenlist-children
simple-favoriteslist-favorites
simple-space-listlist-spaces
space-descriptiondisplay-space-description
space-namedisplay-space-name
timezone-selectorchoose-timezone
toggle-labelremove
twitter-feedwidget connector
whole-section-linkblock-link
wide-screenremove
wraphtml-wrap
zen-buttonaction-button
zen-masterremove
zen-sectioncontent-block

As you move through the migration process, a log appears to the right of the screen. Use this section to monitor your progress and any issues that may arise. You can download these logs if necessary.

  • 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.