Run Your Own Website

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.

Beta test version available.

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 Beta test ver .04

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.

Changelog

Beta .04

• Corrected loop error for cases where a Page had been deleted and the parent tree was not clear

Beta .03

• Added Option to include siblings in display.

Beta .02

• Added option to select “Exclude” or “Include Only” checked Pages.

Beta .01

• Initial test release.

1.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.

3 Responses to “RYO Folding Page List & Widget”