=== Exclude Pages ===
Contributors: simonwheatley, jrf, earnjam
Donate link: http://www.simonwheatley.co.uk/wordpress/
Tags: get_pages, navigation, menu, exclude pages, hide pages
Requires at least: 2.7
Tested up to: 3.52
Stable tag: 1.92

This plugin adds a checkbox, _include this page in menus_, uncheck this to exclude pages from the page navigation that users see on your site.


== Description ==

This plugin adds a checkbox, _include this page in menus_, which is checked by default. If you uncheck
it, the page will not appear in any listings of pages (which includes, and is *usually* limited to, your 
page navigation menus).

Pages which are children of excluded pages also do not show up in menu listings. (An alert in the editing screen, 
underneath the "include" checkbox allows you to track down which ancestor page is affecting child pages 
in this way.)

= Localization =
The plugin is currently available in the following languages:
* Dutch - [Jrf, Advies en zo](http://adviesenzo.nl/)
* Italian - [Gianni Diurno](http://gidibao.net/index.php/portfolio/)
* Polish - [Pawel, Siedlecki Portal Informacyjnie Najlepszy](http://www.spin.siedlce.pl)
* German - [Meini, Utech Computer Solutions](http://utechworld.com)

There's only a few phrases to translate, so please send in your translations.


== Installation ==

1. Upload `exclude_pages.php` to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Create or edit a page, and enjoy the frisson of excitement as you exclude it from the navigation

== Screenshots ==

1. WP 2.5 - Showing the control on the editing screen to exclude a page from the navigation
2. WP 2.5 - Showing the control and warning for a page which is the child of an excluded page
3. Pre WP 2.5 - Showing the control on the editing screen to exclude a page from the navigation
4. Pre WP 2.5 - Showing the control and warning for a page which is the child of an excluded page
5. New features in v2.0 - Showing the all pages view with a new column showing the excluded page status and a tick-box in the quick edit box


== Advanced Usage ==

It is possible to temporarily pause and resume the effect of Exclude Pages by using the new `<?php pause_exclude_pages(); ?>` and `<?php resume_exclude_pages(); ?>` templates tags. The following code will show a list of all pages in your site, even those normally hidden:

`<?php pause_exclude_pages(); ?>
<?php wp_list_pages('title_li=<h2>Pages</h2>' ); ?>
<?php resume_exclude_pages(); ?>`

You can also get an array the IDs of the pages which are excluded by calling the function `ep_get_excluded_ids();`, you can then use these IDs as you wish (e.g. feed them into raw MySQL queries).

= Note to other plugin authors: =

The plugin does not operate on wp_list_pages while the user is on an admin page, if this is an issue you can take advantage of the `ep_admin_bail_out` filter and create a filter function which returns false to allow Exclude Pages to operate in the admin area.

= Another note: =

If your plugins or themes don't use the standard WordPress functions to create their menus then they won't work. To get them to work you will need to track down the bit of code in the theme/plugin which gets the pages and change it to apply the filter "get_pages" (I cannot be responsible for any unforeseen effects of the changes you make, so please test thoroughly). The change to getting pages will probably look something like this:

`$pages = apply_filters( 'get_pages', $pages );`

Please [contact me](http://www.simonwheatley.co.uk/contact-me/) if you're completely stuck and we can discuss possible solutions.

= Exclude pages is incompatible with: =

* [WP CSS Dropdown Menus](http://wordpress.org/extend/plugins/wordpress-css-drop-down-menu/)
* [Phantom theme](http://wordpress.org/extend/themes/phantom)

== Requests & Bug Reports ==

I'm simply noting requests & bug reports here, I've not necessarily looked into any of these.

*None!*




== Changelog ==

= v2.0beta2 2013/06/28 by [earnjam](http://twitter.com/earnjam) and [Jrf, Advies en zo](http://adviesenzo.nl/) =
* ENHANCEMENT: Added support for all hierarchical post types - Displays exclude meta box, quick edit field and 'in menu' column for any hierarchical post type
* BUGFIX: Patch for bug where exclude status doesn't save
* FIX: Improvements to ep_update_exclusions() - Added code to prevent saving on auto-save, on initial post creation, a check to be sure the person updating the value has the rights to do so, and a check to prevent saving the post revision IDs to the excluded pages array.
* ENHANCEMENT: Added upgrade routine which will remove revision IDs from the option array. This will cut the size of the excluded pages array by at least 50%. PLEASE NOTE: in (very) rare cases this upgrade may make a previously excluded page visible again, so please make sure you backup your database before upgrading and check your exclusions afterwards!
* ENHANCEMENT: added minified js file which respects SCRIPT_DEBUG setting
* (MAYBE) FIXED: 'Only variables should be assigned by reference' strict warning

= v2.0beta 2013/03/08 by [Jrf, Advies en zo](http://adviesenzo.nl/) =
* ENHANCEMENT: The plugin will now add a column to your pages overview page which will indicate the exclusion status of a page
* ENHANCEMENT: You can now in-/exclude a page through the quick edit box on the pages overview page
* ENHANCEMENT: The plugin will now properly remove it's settings when you uninstall it
* FIX: limited the loading of css and js to the relevant admin pages
* LOCALISATION: Updated .POT file available
* LOCALISATION: Dutch translation courtesy of [Jrf, Advies en zo](http://adviesenzo.nl/)

= v1.92 =

* BUGFIX: Fix deprecated notice when WP_DEBUG is true, thanks [hansfordmc](http://wordpress.org/support/topic/plugin-exclude-pages-cant-update-pages)
* Tested up to WordPress v3.3

= v1.91 2011/08/26 =

* BUGFIX: Prevent notice from appearing, thanks [Ray](http://wordpress.org/support/topic/notice-undefined-index-1)

= v1.9 2010/6/16 =

* Tested with WP 3.2.1
* ENHANCEMENT: Detects the use of WP menus and advises the user accordingly

= v1.8.4 2010/5/21 =

* LOCALISATION: Italian translation courtesy of [Gianni Diurno](http://gidibao.net/index.php/portfolio/)

= v1.8.3 2010/5/20 =

* LOCALISATION: Polish translation courtesy of [Pawel, Siedlecki Portal Informacyjnie Najlepszy](http://www.spin.siedlce.pl)
* LOCALISATION: German translation courtesy of [Meini, Utech Computer Solutions](http://utechworld.com)

= v1.8.2 2010/5/14 =

Dear Non-English Exclude Pages Users,

This release includes the facility for Exclude Pages to be translated into languages other than English. Please [contact me](http://www.simonwheatley.co.uk/contact-me/) if you want to translate Exclude Pages into your language.

Sorry it took so long.

Best regards,

Simon

* DROPPED SUPPORT FOR WORDPRESS VERSIONS PRIOR TO VERSION 2.7
* BUGFIX: Everything was reporting that it was excluded by an ancestor for some reason. Crazy. Fixed now.
* LOCALISATION: Added POT file! Woo hoo!

= v1.8.1 2010/4/19 =

* BUGFIX: Check for existence of parent object before attempting to use it. (Thanks to Robert Kosara for the bug report.)

= v1.8 2009/10/27 =

* BUGFIX: PHP 5.3 doesn't like the fact that parameters marked as passed by reference as passed as value. Params now not marked as passed by ref.

= v1.7 2009/7/29 =

* ENHANCEMENT: You can now turn the Exclude Pages functionality off in the admin area through use of a filter (this is mainly of advantage to other plugin and theme author).

= v1.6 2009/6/8 =

* ENHANCEMENT: You can now turn the Exclude Pages functionality off before showing navigation which you want to be comprehensive (and show pages you've normally hidden). This is done with the new `<?php pause_exclude_pages(); ?>` and `<?php resume_exclude_pages(); ?>` templates tags.

= v1.51 2009/4/23 =

* FIX: Was throwing an error when $pages turned out not to be an array. Thanks to (Sandra)[http://www.vinyltangerine.com/] for reporting this.

= v1.5 2008/11/03 =

* ENHANCEMENT: Now compatible with WP 2.7-beta1
* DOCS: Added a list of incompatible plugins
* DOCS: Added a list of incompatible themes

= v1.4 2008/01/02 =

* ENHANCEMENT: Now compatible with WP 2.5
* FIX: Pages are also excluded from the "Front page displays:" > "Posts page:" admin menu. (Reported by Ed Foley) This plugin now checks if it's within the admin area, and does nothing if it is.

= v1.3 2008/01/02 =

* FIXED: Descendant (e.g. child) pages were only being checked to a depth of 1 generation.
* FIXED: The link to visit the hidden ancestor page from an affected descendant page was hard-coded to my development blog URL. ([Reported by webdragon777](http://wordpress.org/support/topic/147689?replies=1#post-662909 "Wordpress forum topic"))
* FIXED: Stripped out some stray error logging code.

= v1.2 2007/11/21 =

* ENHANCEMENT: Child pages of an excluded page are now also hidden. There is also a warning message in the edit screen for any child page with a hidden ancestor, informing the person editing that the page is effectively hidden; a link is provided to edit the ancestor affecting the child page.

= v1.1 2007/11/10 =

* FIXED: Pages not created manually using "Write Page" were always excluded from the navigation, meaning the admin has to edit the page to manually include them. Pages created by other plugins are not always included in the navigation, if you want to exclude them (a less common scenario) you have to edit them and uncheck the box. ([Reported by Nudnik](http://wordpress.org/support/topic/140017 "Wordpress forum topic"))



== Upgrade Notice ==

= 2.0beta2 =
New feature: now works with all hierarchical post types + some bug fixes and other enhancements
PLEASE NOTE: in (very) rare cases this upgrade may make a previously excluded page visible again, so please make sure you backup your database before upgrading and check your exclusions afterwards!

= 2.0beta =
New features: you can now use exclude pages from the quick edit box