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

Screenshots

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.

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.

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

Installation

1. Download and unzip ryo_folding_page_list.zip. 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.

Download

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.

Changelog

2.0.0

• 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 (http://www.webspaceworks.com/) but with entirely new logic.