Technokinetics

WordPress’s wp_list_pages() function includes a parameter that’s intended to let you exclude a Page and all of its descendants from your Page lists: ‘exclude_tree’. The idea is that if you pass wp_list_pages this parameter, e.g. by using wp_list_pages(’exclude_tree=1′), you can remove entire sections of your website from your Page lists, and new Pages in that section will be automatically excluded without you having to modify your code. (more…)

A new version of Page Lists Plus can now be downloaded from the WordPress plugin repository. This is the most significant update for a long time, and adds enough new features (including several in response to email requests) that an overview is in order. Here are some of the highlights of PLP v1.1.2:

First, the ability to add custom classes to specific list items has been restored. I had removed this, thinking that the page-item-x classes automatically added by WP made it redundant, but several users asked for it to be reinstated. To use this feature, check the “Add Custom Classes to Individual List Items” option on the Settings > Page Lists Plus page in the dashboard, and save. You can then add custom classes to individual Pages on their edit pages.

Second, the ability to unlink the current Page’s link has been added. To use this feature, check the “Unlink current page” option on the Settings > Page Lists Plus page in the dashboard, and save.

Third, the ability to disable links using javascript has been added. Unlinking a Page’s link removes the link’s anchor tags, which causes presentation problems with some themes. Disabling the link leaves the anchor tags in place (to avoid these presentation problems), but still prevents clicking the link from doing anything. To use this feature, check the “Unlink using javascript” option on the Settings > Page Lists Plus page in the dashboard, and save.

Fourth, by default excluding a Page from your Page lists now also excludes its descendant pages (if it has any). Before, the descendants of excluded Pages were tacked on to the end of Page lists; now they won’t appear at all unless you disable this option by unchecking the “Exclude children of excluded pages” option on the Settings > Page Lists Plus page in the dashboard. Similarly, including a Page will include its descendants, unless this option has been disabled.

Thanks to those who requested these features, particularly Steve Magruder (the first to suggest the “Unlink current page” feature), Jim Harbin (one of several to point out the need for a way of unlinking items without removing anchor tags), and gambit37 on the WP forum (who spotted the problem with how the children of excluded pages were handled).

And as always, if you have any ideas for future releases of Page Lists Plus, then please do let me know.