Building Your Website, Step-By-Step

RYO Folding Page List & Widget

RYO Folding Page List provides a sidebar widget that displays only top level Pages plus parents
and children of currently displayed Pages. If your website has lots of Pages, this can simplify
your sidebar real estate considerably by displaying only Pages of current interest.

The widget's user interface lets you set the displayed title. It displays your Pages and lets
you designate which Pages should be excluded entirely from the list.

I once used a rather complex function called Fold Page List by the same author as Folding Category List. It took a long path to do the same thing as wp_list_pages(). And it didn’t upgrade well. Here it’s redone with entirely new logic that makes it fast and clean, plus there’s a powerful widget with lots of customization options. And it’s compatible with sorting functions like pageMash.

Requires: WordPress 2.8+

See all of our WordPress Plugins


Page Widget Display - Front Page
1. This is the display of the widget on the Front Page. Top level Pages only are shown, excluding any that were checked in the widget options.

This image reflects our theme, of course. Your website will be styled as defined in your theme.

Page Widget viewing Contact Us Page
2. This is the display of the widget when you select the "Contact Us" Page. The top level categories are still displayed, plus the children of "Contact Us," in this case "Getting Our Email." Children of other top level Pages do not appear.

This image reflects our theme, of course. Your website will be styled as defined in your theme.

Folding Page List Widget Options
3. This is the widget drop down options panel, illustrating how you may choose to exclude listed Pages.


  1. Download and unzip This will unzip to a folder called ryo_folding_page_list.
  2. Upload the ryo_folding_page_list folder to the /wp-content/plugins/ directory.
  3. Activate the plugin through the 'Plugins' menu in WordPress
  4. The user interface is in the Appearance, Widgets section of the Dashboard. Customize the display there.

With WordPress 2.8 or later you can use the plugin "Upload" utility to upload and install the plugin.


RYO Folding Page List ver. 2.0.1

Frequently Asked Questions

Can I have more than one instance of the widget?

Yes, the current widget system allows for this.

This would allow you to have a completely separate block in your sidebar for unrelated or special Pages.
It might require customization of each widget as Pages are added. But one easy way to do this would be:

  • Folding Page Widget #1: Exclude Pages D, E, F.
  • Folding Page Widget #2: Include only D, E.
  • Folding Page Widget #1: Include only F.

This lets you put certain pages (D, E, and F) in special places on your website. If you add another page
which you want to appear in Widget #2, you'd have to add it to Widget #2 and Exclude it from Widget #1.

When I select a subpage, will other subpages on the same level be hidden?

That's up to you. In normal operation, subpages on the same level (also called "siblings") will
be hidden. This means one has to go to the parent in order to choose a subpage.

If that's not what you want check the "Include Siblings" checkbox and the other pages with the same parent
will also be displayed.

How do I use this without the widget?

You call ryofpl_folding_list_pages() using the same arguments you would for wp_list_pages().

Consider it to be a direct replacement for that function. (Ultimately, it actually calls the function
after excluding child pages for non-current parents.)

There is one additional argument, optional:

You can set siblings=1 if you want to display "siblings," the other child pages to the
current parent page.



  • Initial release.
  • Complete rewrite to use WP internals available in WP 2.8+. Not compatible before WP 2.8.
  • New logic eliminates most database queries; more efficient, less overhead.
  • Based on original idea by Rob Schumann ( but with entirely new logic.

34 Responses to RYO Folding Page List & Widget

Leave a Reply

Your email address will not be published. Required fields are marked *

Member Center



Your Own Dot-Com Domain
Our Recommended Source for Securing Your Domains. Fast Registration, Direct Support Phone

Reliable Website Hosting
Small businesses often use Shared Hosting and the "GrowBig" plan. Free LetsEncrypt SSL included.

Create Your Own Graphics
Website headers and banners are easy to do yourself when you have this inexpensive tool!