Migrating from Zen to Theme Press

Content Layer

name	Page Info
id	278129461
class	watermark-layer

Content Column

name	Page Body
width	100.00001%
id	278129463

Content Block

background-color	transparent
name	Prompt
id	494677873
class	tight manual-prompt-flex

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

Content Block

name	Outcome
rich-link-hovers	true
id	1042866408
class	tight manual-outcome-flex

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.

Info

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.

Note

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

Content Block

name	Basics Before you migrate, review the following information.Steps
rich-link-hovers	true
id	504786364
class	steps-block numbered manual-steps-flex494842117

Migration Page

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

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

HTML Wrap

class	docs-screenshot

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.

Info

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.

Content Block

name	Note
rich-link-hovers	true
id	495965127
class	manual-note-flex
collapsible	collapse

Note

If using:

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

Content Block

name	Tip
rich-link-hovers	true
id	894522670
class	manual-tip-flex
collapsible	collapse

Tip

If using:

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

Content Block

name	Warning
rich-link-hovers	true
id	504786364894530759
class	steps-block numbered manual-steps-flex	manual-warning-flex
collapsible	collapse

Warning

If using:

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

Content Block

name	Info
rich-link-hovers	true
id	894537203
class	manual-info-flex
collapsible	collapse

Info

If using:

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

Content Layer

id	504856269

504856279

Content Column

width	100%
id	504856279

Content Column

width

100%

id

Content Block

name	Basics Before you migrate, review the following information.
rich-link-hovers	true
id	494842117

Migration Page

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

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

HTML Wrap

class	docs-screenshot

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.

Info

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.

Content Block

name	Note
rich-link-hovers	true
id	495965127
class	manual-note-flex
collapsible	collapse

Note

If using:

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

Content Block

name	Tip
rich-link-hovers	true
id	894522670
class	manual-tip-flex
collapsible	collapse

Tip

If using:

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

Content Block

name	Warning
rich-link-hovers	true
id	894530759
class	manual-warning-flex
collapsible	collapse

Warning

If using:

Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and
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:

Replace me with something to note about this how-to entry that falls outside the scope of all other sections; and

Add the tight-bottom class to the next visible/non-collapsed block above this one to narrow the gap between the two blocks

.

Content Block

name	Info
rich-link-hovers	true
id	894537203
class	manual-info-flex
collapsible	collapse

Info

Content Layer

id	504856269

Content Block

id	504856280

Content Layer

background-color	$lightGrayColor
name	Related
id	888168050

Content Column

name	Related
width	100%
id	888168051

Content Block

rich-links-hide-description	true
rich-link-hovers	true
rich-links-columns	4
rich-links-vertical	true
rich-links-image-height	100px
rich-links-hide-site-icon	true
rich-links-details-padding	10px
name	Related
rich-links-enable	true
border-width	0
rich-links-details-alignment	left
rich-links-margin	20px 30px 0 0
id	496234544
class	related-block clean manual-related-flex

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.

Page tree

Transform Your Digital Workplace

Industry Expertise

Inform Your Strategic Direction

Redefining Work

Documentation and Support

Versions Compared

Old Version 16

New Version 17

Key

Zen and Theme Press Versions

Before Migration!

Migration Page

Site vs. Space

Zen Pages

Layouts Overriding Master Layouts

Brands

Defaults

Overrides

Macros

Custom CSS and JavaScript

Cascading Menus

Migration Page

Site vs. Space

Zen Pages

Layouts Overriding Master Layouts

Brands

Defaults

Overrides

Macros

Custom CSS and JavaScript

Cascading Menus

Platform

Company

Support

Brikit Services