=== WordPress Navigation Tool (NAVT) === Contributors: gbellucci, et_ux Donate link: http://gbellucci.us Tags: navigation, menu, breadcrumb, lists, pages, categories, links, navbar, widget, dropdown, avatars, gravatars, graphic links Requires at least: 2.3 Tested up to: 2.5 RC1.1 Create, organize and manage your WordPress menus and navigation lists by logically grouping your pages, categories, users via a drag'n drop interface. == Description == = Version 1.0.4 Release Candidate = All new version * [Plugin Homepage](http://www.gbellucci.us/forums/ "Plugin Homepage") * [Author Homepage](http://www.gbellucci.us/ "Author Homepage") * [Donation to this plugin](http://www.gbellucci.us/ "Donation page") __Note that the version information in the sidebar is NOT WORKING and I can't seem to get anyone on this web site to FIX IT__ The __WordPress Navigation Tool (NAVT)__ plugin is a powerful tool designed to provide you with complete control over the creation, styling and contents of your web site's navigation. The plugin gives you the ability to create unique site navigation from your pages, categories and users using a Drag 'n Drop Interface; arrange the items within a group in any arbitrary order. Navigation groups may be composed of any combination of pages, categories, Authors, (Editors, Contributors, Subscribers), internal/external links and list dividers. = Plugin Features = * Navigation items can be duplicated and may appear in more than one group. Each item (even if duplicated) can be independently configured. * List item names (called a menu alias) can be set to a name that differs from the name used as the page title or the category name. * Create navigation items to be displayed in one of the following format: 1. Text only 1. Text over graphics 1. Graphic only * Group items can be constructed to appear as a hierarchy - parent/child relationships can be formed between all types of items. * Navigation menus may be styled using NAVT provided CSS classes, standard Word Press classes, or NAVT will apply _user specified CSS classes_. * Supports BreadCrumb navigation. * Supports navigation trees. Clicking a parent navigation item on a page reveals all child navigation on the subsequently displayed page. * Navigation menus can be displayed (or not displayed) on any combination of user selected posts, pages, home page, archives, 404, search pages. * Theme integration options allow you to insert a navigation group anywhere in your theme (_without editing your theme_). * Create navigation using HTML Selects. Create multiple selects in a single group by using dividers. * Embed navigation lists inside your posts and/or pages. * Privacy settings for all navigation items and entire groups allows you to hide navigation items in a menu if the user is not logged into your site. * Supports Gravatars for user navigation items. * Transparently supports Word Press widgets. * Transparently supports K2 sidebar modules when used with the K2 theme. * Built in help. * Backup/Restore functionality. * Compatible with the Word Press 2.3+ and WordPress MU * Compatibility tested with IE6/IE7, Firefox, Opera (_all pc browsers only_, I don't have accesss to a MAC for testing). = Localization = * English (en_US) * German (de_DE) [Rico Neitzel](http://www.rizi-online.de "Rico Neitzel") If you'd like to contribute by offering your translating skills please contact me at greg[at]gbellucci[dot]us I'll send you the necessary files and information. For more information, help, etc. Visit the [NAVT Forum](http://www.gbellucci.us/forums "navt user forum") == Installation == _Classic WordPress and WordPress MU Plugin directory_ 1. Download the plugin. 1. Unzip the file in the WordPress directory: `/wp-content/plugins/` - The plugin resides in its own directory. 1. Activate the NAVT plugin from the Word Press plugin page. 1. After activating the plugin, go to the `Manage` menu and select the menu tab: __NAVT Lists__ to use the plugin. 1. NAVT requires the use of JavaScript (_it must be turned on in your browser_). NAVT version 1.0.2+ will convert navigation groups created with previous versions to the new data format used by NAVT 1.0.2+. However, you should backup any current navigation groups using the NAVT plugin you have installed BEFORE installing and activating the new version of the plugin. NAVT backups are forward compatible with NAVT 1.0.2+ Click the ? (help) buttons provided on the NAVT List page to get help. More help is available in the [NAVT User Forum](http://www.gbellucci.us/forums "navt user forum") The `doc` directory contains a single page manual explaining the PHP interface function call syntax. The `modules` directory contains a document explaining how to install the sidebar module. = Release Notes = *__1.0.4 Release Candidate__ _(March 27, 2008)_ 1. Fix for missing end of anchor tag for user defined URIs *__1.0.3 Release Candidate__ _(March 25, 2008)_ 1. '#wpcontent select' height was changed in WP 2.5 RC1.1 - this caused NAVT selects to display incorrectly. Set the NAVT css stylesheets to change the select height to auto. *__1.0.2 Release Candidate__ _(March 23, 2008)_ 1. Fixed the version information 1. Added backup your data reminder to the installation page *__1.0.1 Release Candidate__ _(March 23, 2008)_ 1. Major rewrite - Brand new interface, new options == Frequently Asked Questions == = Does NAVT provide a widget or a K2 sidebar module? = __Yes.__ 5 NAVT widgets are transparently added when you activate the NAVT Plugin. The NAVT sidebar module is also transparently added to K2SBM if you are using the K2 theme. = How do I create horizontal menus at the top of my theme? = NAVT enables you to use your own classes by entering the CSS class information into the group options dialogbox. The group options dialogbox is indicated by the _gear icon_ on the left side of any navigation group container. Write or obtain a CSS stylesheet that contains the classes for creating a horizontal menu (there are several sources available on the Internet). Integrate the CSS stylesheet with your theme style sheet. Note the style class names for the UL and LI tags that are used in the stylesheet and enter the names into the places provided under the group CSS options tab. __Be sure to select: Do not apply CSS classes and check the Apply the CSS information below to this navigation group__ . This will force NAVT to apply the classes you've entered to the navigation group. Add the navigation group to the theme by using a widget, use the theme integration tab or by adding the navt function call directory to your theme. = How do I use NAVT Theme Integration? = NAVT theme integration allows you to add a navigation group into your theme without editing the theme. It does this by using an XPATH expression and applying one of the available actions: _insert before_, _insert after_, _insert above_, etc. An XPATH statment is used to identify a specific location within your theme where you'd like to put the navigation group. XPATH expressions use a combination of CSS selector ids and CSS classes to target a specific location within your theme. For example, if you wanted to place a navigation group at a specific location in your sidebar, you would formulate the necessary XPATH expression. If your sidebar had the selector id #sidebar and you wanted a navigation group to appear at the bottom of the sidebar the XPATH expression would simply be: #sidebar and you would use the _insert bottom_ action. CSS selector ids must begin with a __#__ symbol and classes must begin with a single __dot__. You can also target locations using expressions like ___#header div.main ul.menu__ This XPATH expression describes an unordered list with the class __menu__ that is contained within a div that has the class named __main__ that is contained with a container named __header__. Here is a working example to __replace the top menu in a K2 theme with a NAVT navigation group__: Select the Theme Integration tab for the NAVT navigation group you want to use. Enter the following XPATH __#page #header ul.menu__ and use the action __Replace With__. The navigation group will replace the standard K2 horizontal menu across the top of the theme. == Screenshots == 1. Major components of the NAVT List page. 2. Drag items created by the Asset Panel into your navigation groups. 3. Configuring item options. 4. Create multiple copies of a single navigation item. 5. Item copies can be placed into several different groups.