List Pages at Depth

November 05, 2019

List Pages at Depth Plugin

A more powerful version of wp_list_pages() which allows you to specify a start depth.

A more powerful version of wp_list_pages() which allows you to specify a start depth.

This means you can easily display secondary and tertiary navigation seperately from the primary navigation on your site.

The list_pages_at_depth function accepts all the same arguments as wp_list_pages, but has an additional argument called ‘startdepth’. Set this to be 0 to display primary navigation, 1 for secondary navigation etc. If you wanted to display secondary navigation with indented tertiary navigation you can use this in conjunction with the depth argument – simply set startdepth to 1 and depth to 2.

<?php list_pages_at_depth( array( 'startdepth' => 1, 'depth' => 1 ) ); ?> 

The plugin also includes a widget so you can easily add it to your site.

You can contribute and submit bug issues on the plugin’s GitHub page.

Changelog

1.5

  • Use PHP 5 style constructors.

1.4

  • Add selected page classes: current_page_item, current_page_parent, current_page_ancestor.
  • Allow list pages to be displayed on pages other than single pages.
  • Sanitize widget fields when updating.

1.3.1

  • Test up to WordPress 4.0
  • Adhere to formatting standards and a little bit of code tidying.

1.3

  • Added support for ‘ancestors_of’ argument.
  • Added support for other post types via ‘list_pages_at_depth_post_types’ filter.
  • Widget includes ‘widget_pages_args’ filter.
  • Tested compatibility with WordPress 3.3

1.2

  • Now shows in all circumstances, not just on pages, if the startdepth is set to zero.

1.1

  • Added widget.
  • Fixed bug caused by duplicates when finding parent and child pages.

1.0

  • First Release.

Details

  • Version: 1.5
  • Active installations: 100
  • WordPress Version: 3.5
  • Tested up to: 5.2.21

Ratings


5 Stars
4 Stars
3 Stars
2 Stars
1 Stars