=== Advanced Sidebar Menu ===
Contributors: Mat Lipe, onpointplugins
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=paypal%40onpointplugins%2ecom&lc=US&item_name=Advanced%20Sidebar%20Menu&no_note=0¤cy_code=USD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest
Tags: menus, sidebar menu, hierarchy, category menu, pages menu
Requires at least: 5.0.0
Tested up to: 5.6.0
Requires PHP: 5.6.0
Stable tag: 8.1.0
== Description ==
Uses the parent/child relationship of your pages or categories to generate menus based on the current section of your site. Assign a page or category to a parent and this will do the rest for you.
Keeps the menu clean and usable. Only related items display so you don't have to worry about keeping a custom menu up to date or displaying links to items that don't belong.
Check out Advanced Sidebar Menu PRO for more features including priority support, the ability to customize the look and feel, custom link text, excluding of pages, category ordering, accordions, custom post types, custom taxonomies, and so much more!
PRO version 8.1.0 is now available with support to exclude and change titles of navigation menu items using each page's settings!
Features
* Page and Category widgets.
* Option to display or not display the highest level parent page or category.
* Option to display the menu when there is only the highest level parent.
* Ability to order pages by (date, title, page order).
* Exclude pages or categories by entering a comma separated list of ids.
* Option to always display child pages or categories.
* Option to select the levels of pages or categories to display when always display child is used.
* Option to display or not display categories on single posts.
* Ability to display each single post's category in a new widget or in same list.
Page Widget Options
* Add a title to the widget
* Display the highest level parent page
* Display menu when there is only the parent page
* Order pages by (date, title, page order)
* Exclude pages
* Always display child Pages
* Number of levels of child pages to display when always display child pages is checked
Category Widget Options
* Add a title to the widget
* Display the highest level parent category
* Display menu when there is only the parent category
* Display categories on single posts
* Display each single post's category in a new widget or in same list
* Exclude categories
* Always display child categories
* Levels of Categories to display when always display child categories is checked
PRO Features
* Priority support.
* Ability to customize each page's link text.
* Click and drag styling for page, category, and navigation menu widgets.
* Styling options for links including color, background color, size, and font weight.
* Styling options for different levels of links.
* Styling options for the current page or category.
* Styling options for the parent of the current page or category.
* Block styling options including borders and border colors.
* Bullet style selection from 7 styles or select none to have no bullets.
* Accordion menu support for pages, categories, and navigation menus.
* Accordion icon style and color selection.
* Accordion option to keep all sections closed until clicked.
* Accordion option to include the highest level parent in accordion.
* Ability to exclude a page from all menus using a simple checkbox.
* Link ordering for the category widget.
* Number of levels of pages to show when always displayed child pages is not checked.
* Ability to select and display custom post types.
* Ability to select and display custom taxonomies.
* Optionally display the current page's parents, grandparents, and children only.
* Optionally display child page siblings when on a child page. With our without grandchildren available. .
* Ability to display the widgets everywhere the sidebar displays.
* Ability to select the parent page/category when using the display widget everywhere option.
* Ability to display assigned posts or custom post types under categories.
* Ability to select which levels of categories assigned posts should display under. **NEW**
* Ability to limit the number of posts or custom post types to display under categories.
* Support for custom navigation menus from Appearance -> Menus.
* Ability to display the current Navigation Menu's items parents, siblings and children only.
* Optionally display the top-level Navigation Menu's items when there are no child items or not viewing a menu item.
* Access to members only support area.
Currently ships with the following languages
* English (US)
* German (de_DE)
Developers
Developer docs may be found here.
Contribute
Send pull requests via the GitHub Repo
== Installation ==
Use the standard WordPress plugins search and install.
Manual Installation
1. Upload the `advanced-sidebar-menu` folder to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Drag the "Advanced Sidebar Pages Menu" widget, or the "Advanced Sidebar Categories Menu" widget into a sidebar.
== Screenshots ==
1. Page widget options
2. Category widget options
3. Example of a page menu using the 2017 theme and default styles
3. Example of a category menu ordered by title using the 2017 theme and default styles
== Frequently Asked Questions ==
= The widget won't show up?
The widgets in this plugin are smart enough to not show up on pages or categories where the only thing that would display is the title. While it may appear like the widget is broken, it is actually doing what it is intended to do.
The most common causes for this confusion come from one of these reasons:
1. The incorrect widget was selected (there are different widgets for categories or pages).
2. "Display the highest level parent page" or "Display the highest level parent category" is not checked.
3. The widget is currently not being viewed on a page (for the pages widget) or category (for the categories widget).
= How do I change the styling of the current page? =
You may add css to your theme's style.css to change the way the menu looks
For Instance This would remove the dot and change the color
.advanced-sidebar-menu li.current_page_item a {
color: black;
}
.advanced-sidebar-menu li.current_page_item {
list-style-type: none !important;
}
To style your menu without using any code upgrade to PRO.
= How do you get the categories to display on single post pages? =
There is a checkbox in the widget options that will display the same structure for the categories the post is in.
= How do you edit the output or built in css? =
Create a folder in your child theme named "advanced-sidebar-menu" copy any of the files from the "views" folder into
the folder you just created. You may edit the files to change the output or css. You must have the option checked to use the built in CSS (in the widget) to be able to edit the css file in this way.
= Does the menu change for each page you are on? =
Yes. Based on whatever page, post, or category you are on, the menu will change automatically to display the current parents and children.
== Changelog ==
= 8.1.0 =
* Restructure widget info panels.
* Introduced new `advanced-sidebar-menu/widget/page/before-columns` action.
* Introduced new `advanced-sidebar-menu/widget/category/before-columns` action.
* Improved PHPCS exclusion declarations.
* Improved CSS structure.
* Improved JavaScript structure.
= 8.0.4 =
* Improve styles when used with Beaver Builder.
* Require WordPress version 5.0.0+.
= 8.0.3 =
* Allow `List_Pages::get_args()` to be filtered on any level.
* Make debugging functionality more stable.
= 8.0.2 =
* Introduce new `advanced-sidebar-menu/menus/category/get-child-terms` filter
* Support filtering the first level of categories.
* Use `is_excluded` vs `is_first_level_category` in category view.
= 8.0.0 =
Major version update. See migration guide if you are extending the plugin's functionality via action, filters, or calling plugin classes.
* Entirely new code structure.
* Removed all deprecated code and filters.
* Improved filter and action names.
* Improved performance.
* Remove default plugin styling.
= 7.7.3 =
* Fix widget info pane links.
* Fix widget editing on mobile devices.
* Tested up to PHP 7.4
* Tested up to WordPress Core version 5.4.1
= 7.7.2 =
* Tested to 5.3.3.
* Change default "levels to display" to All.
* Fix notice level errors when retrieving current page.
= 7.7.0 =
* Enable accordion previews when editing via Beaver Builder.
* Greatly improve widget styles and UI when using Elementor.
* Overall third party page builder improvements.
* Move scripts and styles into new Scripts class.
* Introduce a new Singleton trait.
= 7.6.0 =
* Elementor support for multiple widgets of the same type on the same page.
* Automatically increment widget ids under any cases where they would duplicate.
* Bump required WordPress Core version to 4.8.0.
= 7.5.0 =
* Convert "Always display child pages" to use our List_Pages structure and support all widget options.
* Bump required PHP version to 5.4.4.
= 7.4.0 =
* Added support for Beaver Builder
= 7.3.0 =
* Greatly improve category widget performance
= 7.2.0 =
* New improved widget structure
= 7.1.0 =
* Support Pro Version 3.0.0
* Add German translations
* Begin converting code formatting to strict WordPress standards
= 7.0.0 =
* Restructure the codebase to a more modern PSR4 structure
* Improve cache handling
* Improve verbiage in the admin
* Implement new actions and filters
* Rebuild templates for improved stability and future changes
* Improve performance
* Kill conflicting backward compatibility with version 5
* Open up more extendability possibilities
== Upgrade Notice ==
= 8.0.0 =
Major version update. Not fully backward compatible with version 7 filters or code. Please see migration guide if you are extending the plugin via code.
= 7.7.0 =
Update to support PRO version 3.10.0
= 7.6.6 =
Update to support PRO version 3.9.3