benknight

<p>This is a simple plugin that was born out of working on several projects with sectional navigations.  For example, consider the following common navigation tree structure:</p>
<ul>
<li>Home</li>
<li>Item</li>
<li>About Us
<ul>
<li>Sub-item #1</li>
<li>Sub-item #2</li>
</ul>
</li>
<li>Item</li>
<li>Item</li>
</ul>
<p>Then, whenever on the “About Us” page or any of its sub-items, it would output that peice of the navigation:</p>
<ul>
<li>About Us
<ul>
<li>Sub-item #1</li>
<li>Sub-item #2</li>
</ul>
</li>
</ul>
<p>This is particularly useful for websites that have a top horizontal navigation which shows top-level items and want to show a vertical subnavigation in the sidebar.</p>
<p>This plugin works by parsing the output of the <code>wp_nav_menu</code> function as XML and analyzing the CSS class hooks (current-menu-ancestor, current-menu-item, and current-menu-parent).  Because it uses PHP’s SimpleXML library it therefore requires PHP 5+.  It uses the theme’s registered menu locations.</p>
<p>This plugin also exposes the <code>section_subnav()</code> function for theme developers to use as a template tag to manually place a subnav inside the theme.  Here is the usage:</p>
<pre><code><?php

    section_subnav( array( // defaults
        'before_widget' => '<nav id="section-subnav" class="widget widget_section-subnav">',
        'after_widget' => "</nav>",
        'before_title' => '<h3 class="section-subnav-title widget-title">',
        'after_title' => '</h3>',
        'echo' => true
    ));

?>
</code></pre>
<p>It returns false when there is no subnavigation.</p>
<p>This function also provides the <code>section_subnav_args</code> filter hook for writing less code and easier integration with other plugins and child themes.</p>


Section Subnav

Adds a widget and template function for displaying subnavigation based on the current navigation state.

robfelty

<p>This is a very simple plugin that uses Javascript to form a collapsable set of<br />
links in the sidebar for the pages. Every page corresponding to a given<br />
parent page will be expanded.</p>
<p>It is largely based off of my Collapsing Pages and Collapsing Pages<br />
plugins.</p>
<h3>What’s new?</h3>
<ul>
<li>
<p>2.0.3 (2024.01.01)</p>
<ul>
<li>Fixed issue with subsubpages not closing correctly</li>
<li>Got rid of some more warnings</li>
<li>Tested with 6.4.2</li>
</ul>
</li>
<li>
<p>2.0.2 (2023.12.01)</p>
<ul>
<li>Got rid of some warnings</li>
<li>Updated deprecated property __experimentalGroup</li>
<li>Tested with 6.4.1</li>
</ul>
</li>
<li>
<p>2.0.1 (2023.06.16)</p>
<ul>
<li>Bug fixes</li>
</ul>
</li>
<li>
<p>2.0.0 (2023.03.17)</p>
<ul>
<li>Updated to use Gutenberg block</li>
</ul>
</li>
<li>
<p>1.0.1 (2016.05.09)</p>
<ul>
<li>Fixed bug where sometimes setting accordion to false broke javascript</li>
</ul>
</li>
<li>
<p>1.0 (2015.08.12)</p>
<ul>
<li>Compatible with WordPress 4.3</li>
<li>Fixed bug where expanding symbol showed up at lowest depth specified instead<br />
(thanks to tkibler for pointing it out)</li>
<li>Added option to only display pages of the current subpage</li>
<li>Added option to show top-level page (previously it was always shown)</li>
<li>Added accordion style option</li>
<li>Cleaned up widget settings</li>
<li>improved style management, including the ability to specify style per widget</li>
<li>Switched from unicode symbols to html entities</li>
<li>Not showing tags for title if empty</li>
<li>Fixed bug with title attribute of pages</li>
<li>Totally rewrote javascript</li>
</ul>
</li>
</ul>
<h3>Options</h3>
<p>If using the manual version, you can pass options either as an array, or using<br />
the query style, just like for other wordpress functions such as<br />
    wp_list_pages</p>
<pre><code>  $defaults=array(
    'title' => __('Pages', 'collapsing-pages'), 
    'sortOrder'=> 'ASC' ,
    'sort'=> 'pageName' ,
    'defaultExpand'=> '',
    'expand' => 0,
    'depth' =>-1,
    'inExcludePage' => 'exclude',
    'linkToPage' => true,
    'inExcludePages' => '',
    'showPosts' => false,
    'animate' => 0,
    'useCookies' => true,
    'postTitleLength' => 0,
    'showTopLevel' => true,
    'currentPageOnly' => false,
    'debug' => false,
  );
</code></pre>
<ul>
<li>inExcludePage
<ul>
<li>Whether to include or exclude certain pages
<ul>
<li>‘exclude’ (default) </li>
<li>‘include’</li>
</ul>
</li>
</ul>
</li>
<li>inExcludePages
<ul>
<li>The pages which should be included or excluded</li>
</ul>
</li>
<li>showPosts
<ul>
<li>Whether or not to include posts as well as pages. Default if false</li>
</ul>
</li>
<li>linkToPage
<ul>
<li>True, clicking on a parent page title will link to that page (default)</li>
<li>False, clicking on a parent page will expand to show sub-pages</li>
</ul>
</li>
<li>sort
<ul>
<li>How to sort the pages. Possible values:
<ul>
<li>‘pageName’ the title of the page (default)</li>
<li>‘pageId’ the Id of the page</li>
<li>‘pageSlug’ the url of the page</li>
<li>‘menuOrder’ custom order specified in the pages settings</li>
</ul>
</li>
</ul>
</li>
<li>sortOrder
<ul>
<li>Whether pages should be sorted in normal or reverse<br />
order. Possible values:</p>
<ul>
<li>‘ASC’ normal order (a-z 0-9) (default)</li>
<li>‘DESC’ reverse order (z-a 9-0)  </li>
</ul>
</li>
</ul>
</li>
<li>expand
<ul>
<li>The symbols to be used to mark expanding and collapsing. Possible values:
<ul>
<li>‘0’ Triangles (default)</li>
<li>‘1’ + –</li>
<li>‘2’ [+] [-]</li>
<li>‘3’ images (you can upload your own if you wish)</li>
<li>‘4’ custom symbols</li>
</ul>
</li>
</ul>
</li>
<li>customExpand
<ul>
<li>If you have selected ‘4’ for the expand option, this character will be<br />
used to mark expandable link categories</li>
</ul>
</li>
<li>customCollapse
<ul>
<li>If you have selected ‘4’ for the expand option, this character will be<br />
used to mark collapsible link categories</li>
</ul>
</li>
<li>postTitleLength
<ul>
<li>Truncate post titles to this number of characters (default: 0 = don’t<br />
truncate)</li>
</ul>
</li>
<li>animate
<ul>
<li>When set to true, collapsing and expanding will be animated</li>
</ul>
</li>
<li>useCookies
<ul>
<li>When true, expanding and collapsing of pages is remembered for each<br />
visitor. When false, pages are always display collapsed (unless<br />
explicitly set to auto-expand). Possible values:</p>
<ul>
<li>true (default)</li>
<li>false</li>
</ul>
</li>
</ul>
</li>
<li>showTopLevel
<ul>
<li>True –  show top level pages (default)</li>
<li>False – only display sub-pages and below</li>
</ul>
</li>
<li>currentPageOnly
<ul>
<li>True –  show only parent and sub pages of the current page</li>
<li>False – show all pages (subject to the include or exclude parameters<br />
set) (default)</li>
</ul>
</li>
<li>debug
<ul>
<li>When set to true, extra debugging information will be displayed in the<br />
underlying code of your page (but not visible from the browser). Use<br />
this option if you are having problems</li>
</ul>
</li>
</ul>
<h4>Examples</h4>
<pre><code>collapsPage('animate=true&sort=ASC&expand=3,inExcludePages=about')
</code></pre>
<p>This will produce a list with:<br />
* animation on<br />
* shown in alphabetical order<br />
* using images to mark collapsing and expanding<br />
* exclude page about</p>
<h3>Demo</h3>
<p>I use this plugin in my blog at http://blog.robfelty.com</p>
<h3>CAVEAT</h3>
<p>Currently this plugin relies on Javascript to expand and collapse the links.<br />
If a user’s browser doesn’t support javascript they won’t see the links to the<br />
posts, but the links to the pages will still work (which is the default<br />
behavior in wordpress anyways)</p>


Collapsing Pages

This plugin uses Javascript to dynamically expand or collapsable the set of pages for each parent page.

Section Subnav vs Collapsing Pages