[[PageOutline(2-5,Contents,pullout)]]

= Adds user option for displaying navigation menu as fixed menu or other navigation options =

== Description ==

Normally, when you scroll a Trac page, the main menu and other navigation controls may scroll out of the visible area. This plugin enables a more elegant way: Either let the main menu stay fixed on top of the window or add bottom controls of context navigation.

Type of displaying menu. Possible types are:
 - `normal` (default): No integration - ''leaves menu as in Trac standard'' 
 - `fixed_menu`: fixes menu on top of browser window,
 - `buttom_ctx_menu`: adds context menu at bottom of page, if available

This plugin somehow implements [http://trac.edgewall.org/ticket/8135 Trac-Ticket 8135].

Furthermore mainnav entries are customizable through user preference page, see also [http://trac.edgewall.org/ticket/10543 Trac-Ticket 10543].

=== Sample screenshot for option `fixed_menu` ===
[[Image(fixed_menu_sample.png)]]

=== Sample screenshot  for option `buttom_ctx_menu` ===
[[Image(buttom_ctx_menu_sample.png)]]

=== Preference Panel ===
The display types can be setted by each user differently through the preference panel:

[[Image(prefs_display_sample2.png)]]

== Bugs/Feature Requests == 

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

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

== Download ==

Download the [download:navigationdisplayplugin zipped source] or [/browser/navigationdisplayplugin/trunk/dist/Navigation_Plugin-0.1.0-py2.6.egg pre-compiled egg (py2.6)].

== Source ==

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

== Example ==

You can set system default value in `trac.ini` as following (if you do not specify it, this plugin has no effect):
{{{
[trac]
display_nav = fixed_menu
}}}

Possible values for option `display_nav`are:
 - `normal` (default): No integration - ''leaves menu as in Trac standard'' 
 - `fixed_menu`: fixes menu on top of browser window,
 - `buttom_ctx_menu`: adds context menu at buttom of page, if available

== Recent Changes ==

[[ChangeLog(navigationdisplayplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:framay] [[BR]]
'''Maintainer:''' [wiki:framay] [[BR]]
'''Contributors:'''