Moving your content from Zen Foundation to Theme Press.

To move Successfully transitioning from Zen Foundation to Theme Press , you'll want to migrate requires migration of all of your Zen pages, brands, macros and settings. To facilitate this process, we have created the Zen Migrator add-on, available by request via our normal support process.

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.

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.

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.

Select Scope

Before initiating any steps, you should set the scope of the migration. First, determine if you want to migrate all space 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.

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.

Migrate Brands

You can migrate Zen brands to Theme Press themes. Just select the appropriate brands. Note, you cannot migrate built-in brands.

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.

When in audit mode, be sure to click the blue action circle for the following macros:

• include-section
• simple-space-list
• zen-section

This step adds helpful information to the audit logs.

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

Create and View Punch List

As you complete this conversion, the migrator builds a list of items you should review and fix.

Once you generate the punch list, you'll see several items that require manual changes. Some relate to migrated brands. Others relate to pages and layouts.

Migrated Brands

When migrating a brand, the punch list shows tasks for brand settings that (1) need review or (2) cannot be migrated. Each item shows a brand setting reference that begins with a dollar sign ($).

Pages and Layouts

When viewing the punch list, review the following tasks related to pages and layouts:

• check layout format
• review layout (floating sections)

The punch list provides a link for each page that you may need to fix. Most likely, these pages previously contained floating or tabbed sections.

Manual Changes

You can fix affected pages so that content appears in columns. When doing so, you may need to add additional columns to a layer or create a new layer with several columns. Once you create new columns, drag and drop your content into the appropriate areas. You can also create tabbed blocks when needed.

We recommend you disable Zen Foundation upon completing the migration steps and checklist. Once you determine the migration is successful, uninstall the add-on.

What's Happening to Zen Foundation?

Theme Press is our next-generation theming product for Confluence, which will eventually replace Zen Foundation. However, we will continue to support and upgrade Zen Foundation for new Confluence versions for a couple more years, though improvements will be limited to bug fixes and compatibility upgrades.

We will be encouraging Zen Foundation users to migrate to Theme Press, as well as providing tools to facilitate this migration.

Does Theme Press Have All of Zen's Features?

Largely, Theme Press has Zen's features (and then some), with one exception: the drafts and publishing features are not included in Theme Press.

Drafts and publishing features will be available in a separate add-on (Content Flow), which will include additional features such as content routing and scheduling.

Will You Need to Buy a Theme Press License?

If you have a commercial or academic Zen Foundation license with a current maintenance contract, we will issue free matching licenses for both Theme Press and Content Flow on request. These licenses will appear in your my.atlassian.com account alongside your Zen Foundation license.

Can You Install Theme Press and Zen Foundation in the Same Environment?

Yes, but you will need to use Theme Press version 1.1.5 or later and Zen Foundation 5.2.16 or later. Earlier versions ran into a theme-management bug in Confluence.

Should You Migrate?

If you've followed the decision tree on our Products page, you know you're able to switch to Theme Press if:

1. You're using Confluence 5.3 or greater, AND
2. You don't need Zen's drafts and publishing feature (or can wait until the fall)

How Does Migration Work?

We are building and testing tools to automatically migrate:

• Zen macros to their Theme Press equivalents
• Zen master page and page layouts to Theme Press equivalents
• .zen pages into their Theme Press equivalents
• Your custom Zen brand to a Theme Press theme (excluding custom CSS and JavaScript you may have added)
  • Note: if you have a current Zen brand maintenance contract, we will upgrade your brand for you

The process will be approximately:

1. Clone your production server to a test server, on which you'll
2. Install Theme Press
3. Install the migrator tool
4. Disable Zen Foundation
5. Run the steps described the migrator tool
6. Spot check the results

When Will the Migrator be Available?

The migrator is available now. Please contact us to learn more.

Can Brikit Perform the Migration for My Site?

As we test the migrator on ourselves and Atlassian, we will be defining a service package to offer to customers who would like us to help. This service package will also be available through our global network of Atlassian Expert Partners. Pricing and service timing is TBD.

• Built-in Layouts
• Uploading a Theme
• glossary