Page History

h1. Layout Manager

(!) Section under construction

{excerpt}The layout manager is used by theme designers to create any number of theme layouts which can be used throughout the wiki.{excerpt}

(on) _For best results, we recommend using the Firefox web browser with a screen resolution of 1024x768 pixels (or more) when working in the layout manager._

h2. How do I get here?

If you have sufficient [privileges|Global Permissions Tab] to access the Layout Manager, you'll see a link at the top of the [Layout Chooser]. If you are a site Administrator, you'll also see a link in the "Theme Builder" section of the Administration Console.

h2. Available Layouts

{table:width=100%|cellpadding=0|cellspacing=0}
{tr}
{td:style=padding-right:10px;|valign=top}
This panel appears on the left of the Layout Manager and shows the hierarchical list of all theme layouts defined in your wiki:

!available-layouts01-01-1970-managelayouts.png|alignborder=center1!

There's a lot more to this panel than meets the eye! Let's get started...{td}
{tr}
{table}

h3. Toolbar

||Icon||Task||Notes||
| {menuicon:disk_blue}|Save|Saves changes for the currently selected layout.|
| {menuicon:document_refresh}|Reload|Reloads the selected layout from the server, clearing any unsaved changes.|
|{menuicon:document_plain}|Revert|Revert all settings in the selected layout to their defaults (see [Layout Hierarchy]).|
|{menuicon:document_delete}|Delete|Delete the selected layout \\ (!) Warning: Permanently deletes the layout!|
| {menuicon:document_plain_new}|New|Create a new layout based on the selected layout.|
| {menuicon:documents_new}|Duplicate|Duplicate the selected layout. This creates a copy of the selected layout and attaches it to the same parent as the selected layout.|

| |Switch|Switch between the currently selected layout and the previously selected layout.|
| |Parent|Select the parent layout for the currently selected layout.|
| |Previous|Select the previous sibling layout.|
| |Next|Select the next sibling layout.|

h3. Hierarchy
h3. Hierarchy

A hierarchical tree view of existing layouts is shown below the toolbar.

So, why do we have hierarchical layouts? Well, that's such an important feature of Theme Builder 3.x that it's got it's own page: [Layout Hierarchy]

If you haven't already done so, read that page otherwise you'll be freaked out when layouts are affected by settings in their parent layout!

h3. Drag-and-Drop

You can restructure the layout hierarchy by simply dragging and dropping a layout on to another layout. Remember, that makes the layout inherit some or all settings from it's new parent and in doing so can make it look completely different.

h2. Layout Editor

The layout editor contains a number of tabs for editing and customising various aspects of the selected layout.

{note:title=Take regular backups!}
Depending on how much of a perfectionist you are, you can end up spending considerable amounts of time editing layouts. We strongly suggest [taking theme backups|Backup Tab] after any major edits or before editing any complex layouts.
{note}

!Overview Tab^overview-tab.png|align=center!

{section}{column:width=50%}
h3. Overview Tab

The [Overview Tab

h2. Layout Tab

h2] allows you to view/edit the basic details such as layout name and description.

It also shows the layout's ID which is useful as it's used for some macros and also the printable layout option on the [Options Tab].

h3. Layout Tab

The [Layout Tab] is used to select which panels are shown in the layout and also access the [Panel Editor].

h3. Menus Tab

h2. Styles Tab

h2. Options Tab

h2. Permissions Tab
The [Menus Tab] is used to set various options that affect how menus are displayed, including menu design, drop-shadows and tooltips.
{column}{column:width=50%}
h3. CSS Tab

The [CSS Tab] allows you to define custom CSS within the layout and also provides options for optionally removing key CSS resources should you require more control.

h3. JS Tab

The [JS Tab] allows you to define custom JavaScript within the layout and also set various JavaScript-related options should you require more control.

h3. Options Tab

The [Options Tab] contains options for customising the breadcrumb trail, defining a printable layout and various other options which will affect the layout.

h3. Permissions Tab

The [Permissions Tab] allows you to restrict access to a layout - who can select it, edit it, etc.
{column}{section}