These recommended tips can make Zen Foundation easier to use and maintain.

Disable Unused Themes

When not in use, disable the default theme plugins using the following procedures. Disabling helps to clean up the GUI and avoid errors.

Default Themes

Depending on your version of Confluence, you may not see all of the following themes.

  1. From the Configuration menu, select Admin Console.
  2. The Administration Console page opens.
  3. From the Configuration section, select Plugins.
  4. The Plugins page opens.
  5. Locate the System Plugins section.
  6. If necessary, click the Show System Plugins link.
  7. Select each of the following themes (if available), then click the Disable button.
    • Classic Left Navigation Theme
    • Clickr Theme
    • Documentation Theme
    • Easy Reader Theme

Simplify Default Content

Confluence allows you to set the default content for spaces (including personal spaces). Confluence auto-populates this content when you create a space. When using Zen Foundation as a global default, we recommend simplifying the defaults because they are not designed for multi-column layouts.

  1. From the Configuration menu, select Admin Console.
  2. The Administration Console page opens.
  3. From the Configuration section, select Default Space Content.
  4. The Default Space Content page opens.
  5. Verify that the Space Home Pages section is selected.
  6. Click the Customise button.
  7. The page refreshes to show a text box.
  8. Replace any text within this box with markup similar to the following.

    Welcome to the {0} space.
  9. Click the Save button.
  10. Click the Personal Space Home Pages link.
  11. Click the Customise button.
  12. The page refreshes to show a text box.
  13. Replace any text within this box with markup similar to the following.

    This is the personal space for {0}.
  14. Click the Save button.

Use a Utility Space for Standardized Branding

We recommend you create a utility space to house the standard settings (layouts, menus, headers/footers) for your site (or for individual spaces). We recommend separating the layout from the content because it:

  • can be structurally helpful, easing the organization and management of spaces
  • provides an easy way to stop recent updates on layout pages (like the .zen.master page) from creeping into macro content (like the Recently Updated macro)

Space Permissions

For internal Confluence users, grant the View permission to this utility space. If your site is visible to the general public, grant the View permission to anonymous users.

Caution: Editing Entire Pages

The toolbar's Page menu includes an Edit Entire Page option useful for two reasons:

  • facilitate copying full page content
  • troubleshoot individual macros

Only administrators have access to this feature because (1) basic users are likely to find full page macros/wiki markup intimidating or confusing and (2) some Zen macros contain auto-generated Zen data. Administrators should use extreme caution when manually editing macros in the Edit Entire Page view.

Zen Sections

Zen Sections contain auto-generated ID parameters. Each section must contain this unique ID to identify the section relative to the page. Also, order matters. Zen arranges Zen Sections to column and appearance, so creating sections or moving them around using the Edit Entire Page view is discouraged.