[All Adaptavist Apps]

Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

...

Excerpt

Theme Builder gives you unprecedented control over the navigation within Confluence...

Fully Customisable Navigation

All navigational elements within the theme are completely customisable - so you can move them to different locations, replace them with different forms of navigation or remove them completely.

Because the navigation is based on wiki markup and macros, you can easily add your own custom navigation and macros to the theme layout. You can use virtually any navigation macro available for Confluence.

Menus

Menus allow you to provide extensive navigation without cluttering up the screen.

– pic –Image Added

Menus can be located within any layout panel and can be horizontal, vertical or context-sensitive (eg. display by right-clicking on a HTML element).

The menus are fully editable using simple wiki notation , including macros.

– pic of sample wiki notation –

Performance Boost!

Theme Builder 2.1 introduces a new compount menulink macro which is three times faster (server-side) than previous implementations.and you can automatically generate menu structures using macros. You can even embed menus in your wiki pages and blog posts!

Page Tree

Image Added
The new page tree component displays a highly customisible customisable hierarchical tree of content within your wiki.

– pic or real thing? –

The The dynamic page tree shows users where they currently are within the wiki, including all parent pages, and more importantly what other content is close to their current location. If the page hierarchy within the wiki is developed so that related contnet or topics are grouped together (eg. same parent page) this provides end-users with an excellent way of locating similar information.

As with all hierarchical views, the page tree can be browsed without refreshing the page thus allowing users to browse for content.

Global Navigation

Context-Sensitive Navigation

By embedding macros in to layout panels you can easily create context-sensitive navigation.

– pic of children macro alongside menu showing same links –

Sectional Navigation

A new feature in Theme Builder 2.1 allows you to create "sectional" navigation - that is to say, different areas within a wiki space can generate navigation relating to that area of the wiki.

Customisable Dashboard

Theme Builder allows you to completely customise the Dashboard using simple wiki notation!

Global Navigation

Creating global navigation is easy with Theme Builder thanks to hierarchical layouts.

With hierarchical layouts, you can define a master layout on which other layouts are based. This allows you to define global navigation in the master layout and have it appear in all child layouts. If desired you can also configure the master layout to prevent child layouts overriding the global navigation using the in-built permissions system.

You can also use macros bundled with the theme to import centrally defined navigation elements and render them in the context of the current page, taking in to account the users' permissions for the current page, etc.

Sectional Navigation

Image Added
Sectional navigation can be added, allowing end-users to quickly access key areas within a space, or key spaces within your wiki.– pic –

A common example is a wiki space that's used to publish a monthly magazine. Each month, a new edition of the magazine is added with it's own content. When browsing content within the space, the navigation intelligently adapts "snaps" to whichever edition you are looking at showing navigation for just that edition.

Dynamic Navigation

...

Context-Sensitive Navigation

In many cases you will want to maintain some level of control over the navigation used throughout your wiki but will also want to allow space administrators and/or content authors to add their own navigation specific to the space they are working in or even the page being viewed.

– pic ? –Image Added

Using macros bundled with the theme you can easily allow space-level navigation to be injected in to your global or centrally defined navigation. Related Tutorial

Privilege-Based Navigation

Theme Builder includes a number of mechanisms for automating display of navigation based on privileges.

Logged Out

Image Added

 

Logged In

Image Added

 

The most notable are the menulink and menuitem macros which will intelligently show and hide navigation elements based on user privileges within the current context.

You can also use third party plugins such as the Visibility Plugin which can show and hide any content based on user privileges.

Customisable Breadcrumbs

Theme Builder allows you to optionally remove any of the first three items on the breadcrumb trail - perfect for removing the Dashboard or Space link, etc.

The breadcrumb trail is always output after the main page content (see Search Engine Optimisation (SEO)) and can be displayed anywhere within the layout (header, footer, etc).

If you're using the Metadata 2 plugin you can easily replace the Confluence breadcrumb trail with the hierarchical space breadcrumb trail provided by the Metadata plugin.

Accessibility

We're constantly improving the accessibility of the theme and navigation is no exception - for more information, please see Accessibility.

Serving Suggestion

Image Added
Use our Community Bubbles plugin to add portals to layout panels:

These allow you to centrally define re-usable navigation widgets and easily deploy them throughout your wiki. Space Administrators can easily choose which widgets to show and end-users can quickly hide any widgets they don't use.

You can also use virtually any available Confluence macro to generate navigation within a sidebar. There are plenty of navigation and list macros to choose form, including table of contents, list of child pages, incoming and outgoing links, etc.

You can also use our Scriptix plugin to create custom navigation using a wide variety of programming languages such as JavaScript, Ruby and PHP - directly within your wiki. Of course, if so desired, you can write your own Java plugins or user macros and use those too!

Performance Boost!

Theme Builder 3.0 introduces a new compound-menuitem macro which is three times faster (server-side) than previous implementations for common link destinations. If you're upgrading from Builder 2.x we highly recommend updating your menus!