forked from bu-ist/bu-navigation
-
Notifications
You must be signed in to change notification settings - Fork 0
/
readme.txt
125 lines (82 loc) · 6.18 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
=== BU Navigation ===
Contributors: ntk, mgburns, gcorne, jtwiest
Tags: navigation, hierarchical, post type, boston university, bu
Requires at least: 3.1
Tested up to: 3.8.1
Stable tag: 1.2.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Robust tools for managing hierarchical page content in WordPress. Ideal for blogs with large page counts.
== Description ==
BU Navigation provides key tools you need to manage large numbers of pages.
* Replaces the built-in “Page Parent” and “Menu Order” dropdowns with an intuitive drag and drop interface for managing your page hierarchy
* The “Edit Order” screen presents you with a holistic view of your site’s structure for bulk ordering operations
* The Content Navigation widget presents a customizable sidebar navigation list fed from your natural page hierarchy
* Add external links to navigation lists with the “Add a Link” tool
Additionally, themes that support the primary navigation feature gain the ability to display a primary navigation list fed from page order. With two lines of code any theme can benefit from this feature-rich custom menu alternative.
* Display a primary navigation menu using the natural page hierarchy, eliminating the need for end-users to manage navigation lists separately from page order
* Navigation labels give you the ability to vary your page’s navigation label from their title
* Easily toggle the visibility of specific pages or sections of pages from your navigation menus
* Customize primary navigation settings through the “Primary Navigation” screen
For more information check out [http://developer.bu.edu/bu-navigation/](http://developer.bu.edu/bu-navigation/).
= Developers =
For developer documentation, feature roadmaps and more visit the [plugin repository on Github](https://github.com/bu-ist/bu-navigation/).
== Installation ==
This plugin can be installed automatically through the WordPress admin interface, or by clicking the download link on this page and installing manually.
= Manual Installation =
1. Upload the `bu-navigation` plugin folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
== Frequently Asked Questions ==
= I don’t see the “Primary Navigation” menu! How do I enable it? =
The “Primary Navigation” menu item will only appear if the current theme supports it.
Please see this page for more information:
[Adding Theme Support for Primary Navigation Menus](https://github.com/bu-ist/bu-navigation/wiki/Adding-Theme-Support-for-Primary-Navigation-Menus "BU Navigation Wiki on Github")
= How do I hide a page from my navigation lists? =
While editing your page, uncheck the “Display in navigation lists” checkbox next to the “Visibility” label inside the “Placement in Navigation” metabox. If the metabox is not visible, expand the “Screen Options” panel at the upper right hand corner of the screen and make sure the “Placement in Navigation” checkbox is checked.
= My post title is too long for my navigation lists. Is there a way to pick a different label for navigation lists? =
While editing your page, enter an alternate navigation label in the “Label” text field inside the “Placement in Navigation” metabox. If the metabox is not visible, expand the “Screen Options” panel at the upper right hand corner of the screen and make sure the “Placement in Navigation” checkbox is checked.
= Is there a way to prevent my users from adding top level content to the primary navigation menu? =
Visit the “Appearance > Primary Navigation” screen and uncheck the “Allow Top-Level Pages” checkbox. Be sure to click “Save Changes” to save the setting. With this option unchecked, post authors will not be allowed to publish a top level page if the “Display in navigation lists” checkbox is checked.
= I’m a theme / plugin developer that would like to take advantage of the navigation library, but I don’t want any of the administrative interface enhancements. Is there a way to disable them? =
Yes! The navigation manager interface, content navigation widget, and other plugin features can be disabled on a per-install or theme-by-theme basis.
Please see this page for the details:
[Configuring Plugin Features](https://github.com/bu-ist/bu-navigation/wiki/Configuring-Plugin-Features "BU Navigation Wiki on Github")
== Screenshots ==
1. Manage your site’s page hierarchy with an easy to use drag and drop interface
2. The “Add a Link” tool allows you to add external links to your navigation lists
3. The “Content Navigation” widget presents a configurable sidebar navigation list
4. The “Navigation Attributes” metabox replaces the built-in “Page Parent” and “Menu Order” dropdowns
5. The same drag and drop view is available to move pages while editing them
== Changelog ==
= 1.2.1 =
* Added support for editing of HTML entities in navigation label input field
* Added filter: bu_navigation_format_page_label
* Added WP title filters to bu_navigation_format_page_label
= 1.2 =
* Added support for HTML in navigation labels
* Bug Fix: "View" links on "Edit Order" screen corrected for non-root posts
* Added caching to optimize loading of navigation sections
* For Developers: Added several functions for calculating permalinks efficiently for hierarchical post types
* For Developers: Removed the `bu_navigation_pull_page()` function from the navigation library
= 1.1.5 =
* Added Swedish translation (props almhorn)
* Bug Fix: Fix issue where `bu_navigation_breadcrumbs()` was not restoring excluded post filter
* Bug Fix: Only display replacement page template metabox for pages
* Bug Fix: jQuery UI-related issues in 3.6+
= 1.1.4 =
* WP.org release
= 1.1.3 =
* Add support for privately published posts in navigation management views
* Fix for bug that was preventing links from saving
* Assorted cleanup
= 1.1.2 =
* Initial WP.org release
* Increased test coverage
* Added constant for setting default post exclude value
= 1.1.1 =
* Fix for navigation exclude filter
= 1.1 =
* Added localization support
* Added feature configuration through the Theme Features API and PHP constants
* Added navigation links as a true custom post type
* Assorted cleanup and optimizations