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

= Display 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, see screenshot of [/attachment/wiki/NavigationDisplayPlugin/prefs_display_sample.png PreferencePanel]. 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 the user preferences page, see also [http://trac.edgewall.org/ticket/10543 Trac-Ticket 10543].

=== Screenshot for option `fixed_menu`

[[Image(fixed_menu_sample.png)]]

=== Screenshot for option `buttom_ctx_menu`

[[Image(buttom_ctx_menu_sample.png)]]

=== Preference Panel

The display types can be set by each user differently through the Preferences panel:

[[Image(prefs_display_sample.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].

[[TicketQuery(component=NavigationDisplayPlugin&group=type,format=progress)]]

== 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:
{{{
#!ini
[trac]
display_nav = fixed_menu
}}}

If you do not specify it, this plugin has no effect.

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:''' [[Maintainer]] [[BR]]
'''Contributors:'''