[[PageOutline(2-5,Contents,pullout)]]
= Move and add custom navigation items to the Trac navigation bars =

== Description ==

This plugin lets you move navigation items between the meta and main Trac navigation bars.

Additionally it lets you configure custom navigation items.

Only one navigation bar can be active at a time, the other is completely hidden.

== Configuration ==

By default all meta navigation items are moved into the main navigation bar.

You can override this with configuration items in the `[navmover]` section of TracIni:

 `move_to=<bar>`:: The navigation bar to move items to, either `mainnav` or `metanav`.
 `move_items=<item>,<item>,...`:: The items to move. eg. settings, logout, blog.

Custom navigation items are added in a manner similar to Trac's custom ticket fields:

 `<item> = <title>`:: Define a new item with the given button title.
 `<item>.url = <url>`:: The URL the button should point to.
 `<item>.permission = <perm>`:: The Trac permission required to view this button ''(optional)''.

== Bugs/Feature Requests == 

Existing bugs and feature requests for NavMoverPlugin are 
[report:9?COMPONENT=NavMoverPlugin here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=NavMoverPlugin&owner=athomas new ticket].

== Download ==

Download the zipped source from [download:navmoverplugin here].

== Source ==

You can check out NavMoverPlugin from [http://trac-hacks.org/svn/navmoverplugin here] using Subversion, or [source:navmoverplugin browse the source] with Trac.

== Example ==

{{{
#!ini
[navmover]
move_items = settings,logout,account
move_to = mainnav
newblog = New Blog Post
newblog.url = http://trac-hacks.org/blog/new
newblog.permission = TRAC_ADMIN
}}}

== Recent Changes ==

[[ChangeLog(navmoverplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:athomas] [[BR]]
'''Maintainer:''' ''none'' [[BR]]
'''Contributors:'''