Role Scoper is a comprehensive access control solution, giving you CMS-like control of reading and editing permissions.  Assign restrictions and roles to specific pages, posts or categories.  For WP 2.7 to 2.9, use <a href="http://agapetry.net/downloads/role-scoper_legacy">Role Scoper 1.2.x</a>.

= How it works: =
Your WordPress core role definitions remain unchanged, and continue to function as default permissions.  User access is altered only as you expand it by assigning content-specific roles, or reduce it by setting content-specific restrictions.

Users of any level can be elevated to read or edit content of your choice.  Restricted content can be withheld from users lacking a content-specific role, regardless of their WP role.  Deactivation or removal of Role Scoper will return each user to their standard WordPress access (but all RS settings remain harmlessly in the database in case you change your mind).

Scoped role restrictions and assignments are reflected in every aspect of the WordPress interface, from front end content and navigation to administrative post and comment totals.  Although Role Scoper provides extreme flexibility and powerful bulk administration forms, basic usage is just a set of user checkboxes in the Post/Page Edit Form.

= Partial Feature List =
* WP roles work as is or can be limited by content-specific Restrictions
* RS roles grant additional Read or Edit access for specific Pages, Posts or Categories
* Define User Groups and give them one or more RS roles
* Can elevate Subscribers to edit desired content (ensures safe failure mode)
* Control which categories users can post to
* Control which pages users can associate sub-pages to
* Specify element(s) in Edit Form to withhold from non-Editors
* Grant Read or Edit access for a limited time duration
* Limit the post/page publish dates which a role assignment applies to
* Customizable Hidden Content Teaser (or hide posts/pages completely) 
* RSS Feed Filter with HTTP authentication option
* File Attachment filter blocks direct URL requests if user can't read corresponding post/page
* Inheritance of Restrictions and Roles to sub-categories / sub-pages
* Default Restrictions and Roles for new content
* Un-editable posts are excluded from the Edit Posts/Pages list
* Optimized to limit additional database queries
* XML-RPC support
* Integrates with the <a href="http://wordpress.org/extend/plugins/revisionary/">Revisionary plugin</a> for moderated revisioning of published content.
* Supports custom Post Types and Taxonomies (when defined using WP schema by a plugin such as <a href="http://wordpress.org/extend/plugins/custom-post-type-ui/">Custom Post Type UI</a>) 
* Extensive WP-mu support

= Plugin API =
* Abstract architecture and API allow other plugins to define their own data/taxonomy schema and role definitions
* Author provides some <a href="http://agapetry.net/category/plugins/role-scoper/role-scoper-extensions/">extensions to support integration with other plugins</a>

= Template Functions =
Theme code can utilize the is&#95;restricted&#95;rs() and is&#95;teaser&#95;rs() functions to customize front-end styling.

Other useful functions include users&#95;who&#95;can(), which accounts for all content-specific roles and restrictions.

For more information, see the <a href="http://agapetry.net/downloads/RoleScoper_UsageGuide.htm">Usage Guide</a> or <a href="http://agapetry.net/forum/">Support Forum</a>.

= Support =
* Most Bug Reports and Plugin Compatibility issues addressed promptly following your <a href="http://agapetry.net/forum/">support forum</a> submission.
* Author is available for professional consulting to meet your configuration, troubleshooting and customization needs.

== Installation ==

Role Scoper can be installed automatically via the Plugins tab in your blog administration panel.

= To install manually instead: =
1. Upload `role-scoper&#95;?.zip` to the `/wp-content/plugins/` directory
1. Extract `role-scoper&#95;?.zip` into the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress

== Frequently Asked Questions ==

= How can I prevent low-level users from seeing the Roles/Restrictions menus and Edit boxes? =

In your blog admin, navigate to Roles > Options.  In the "Content Maintenance" section, set the option "Roles and Restrictions can be set" to "by blog-wide Editors and Administrators" or "by Administrators only".  Click the Update button.

= How does Role Scoper compare to <a href="http://sourceforge.net/projects/role-manager/">Role Manager</a> or <a href="http://wordpress.org/extend/plugins/capsman/">Capability Manager</a>? =

Role Scoper's functionality is entirely different and complementary to RM and CM.  RM/CM do little more than alter WordPress' definition of the capabilities included in each role.  That's a valuable task, and in many cases will be all the role customization you need.  Since RM/CM modifications are stored in the main WordPress database, they remain even if RM/CM is deactivated.

Role Scoper is useful when you want to customize access to specific content, not just blog-wide.  It will work with the WP roles as a starting point, whether customized by RM/CM or not.  To see how Role Scoper's role definitions correlate to your WordPress roles, navigate to Roles > Options > RS Role Definitions in your blog admin.  Role Scoper's modifications remain only while it stays active.

= Why are there so many options? Do I really need Role Scoper? =

It depends on what you're trying to accomplish with your WordPress installation.  Role Scoper is designed to be functionally comprehensive and flexible.  Great pains were taken to maintain performance and user-friendliness.  Yet there are simpler permission plugins out there, particularly if you only care about read access.  Review Role Scoper's feature list and decide what's important to you.

= Why doesn't Role Scoper limit direct access to files that I've uploaded via FTP? =

Role Scoper only filters files in the WP uploads folder (or a subfolder).  The uploads folder must be a branch of the WordPress directory tree.  The files must be formally attached to a post / page via the WordPress uploader or via the RS Attachments Utility.

In your blog admin, navigate to Roles > Options > Features > Attachments > Attachments Utility.

= Where does Role Scoper store its settings?  How can I completely remove it from my database? =

Role Scoper creates and uses the following tables: groups&#95;rs, user2group&#95;rs, role&#95;scope&#95;rs, user2role2object&#95;rs.  All RS-specific options stored to the WordPress options table have an option name prefixed with "scoper&#95;".

Due to the potential damage incurred by accidental deletion, no automatic removal is currently available.  You can use a SQL editing tool such as phpMyAdmin to drop the tables and delete the scoper options.

== Screenshots ==

1. Admin menus
2. Role boxes in Edit Post Form
3. Role boxes in Edit Page Form
4. Category Restrictions
5. Category Roles
6. <a href="http://agapetry.net/demos/category_roles/index.html">View an html sample of the Category Roles bulk admin form</a>
7. <a href="http://agapetry.net/demos/rs-options_demo.htm">View an html sample of Role Scoper Options</a>
8. <a href="http://agapetry.net/news/introducing-role-scoper/">View more screenshots</a>

== Changelog ==

= 1.3.28-dev =
* BugFix : Term-specific management roles did not grant editing access
* Change : Term-specific management role also grants ability to create child terms
* BugFix : In wp-admin, Page menu not visible while editing a post if page editing access is not site-wide
* Compat : More Types: support late registration of post types by automatically forcing RS to initalize later
* Feature : Category Assigner role does not grant post creation/editing capabilities but specifies categories which are assignable to any user-editable post regardless of post ownership or status
* Compat : Quick Post Widget - categories were not filtered
* BugFix : Default roles were not applied at Page / Post creation
* BugFix : Did not support meta_key without meta_value in get_pages call (or vice versa)
* Change : Support post_type argument in get_terms / wp_list_terms function call
* BugFix : Non-administrators could not delete categories
* BugFix : Internal Cache (and therefore permissions) did not refresh when an existing user's role is changed
* Compat : When plugin or theme code forces autologin, RS filtering does not reflect it until the next http request
* Feature : Nav Menu Manager role can be assigned to users who do not have edit_theme_options capability
* Feature : Nav Menu Manager role can be assigned site-wide
* Feature : For Nav Menu Management, option to list only user-editable content as available items
* Compat : NextGEN Gallery - with versions 1.7+, error when uploading images as a non-Administrator
* BugFix : Nav Menus displayed categories even if no posts readable
* Compat : Grand Flash Gallery - error when uploading images as a non-Administrator
* Compat : Simple Fields plugin - non-Administrators could not use custom field file uploader
* BugFix : When editing is based on category, could not upload files into edit form prior to saving post 
* Feature : Filter "Add New" links out of WP Admin bar if user lacks site-wide capability
* BugFix : Non-administrators could not add a non-hierarchical custom term to post unless they have corresponding taxonomy Manager role (since 1.3.28-dev)
* BugFix : Duplicate entries in Author dropdown if RS editing roles have been assigned to WP role groups
* BugFix : Non-administrators could not add a non-hierarchical custom term to post if taxonomy is included in post type registration

= 1.3.27 - 19 Jan 2011 =
* BugFix : Hidden Content Teaser - private pages were not included for teasing to anonymous reader
* BugFix : Hidden Content Teaser - pages with Reader restriction were not flagged in page listing

= 1.3.26 - 17 Jan 2011 =
* BugFix : User Search on Role Group creation/edit form did not work (since 1.3.23)
* BugFix : Group Search on User Profile form did not work (since 1.3.23)

= 1.3.25 - 14 Jan 2011 =
* BugFix : Hidden Content Teaser did not include private posts or pages, regardless of "hide private" setting (since 1.3.2)

= 1.3.24 - 14 Jan 2011 =
* BugFix : On Page Edit form, invalid blank item in Page Parent dropdown for Non-Editors with a General Role of Page Contributor / Author, caused new pages to be saved as top level 

= 1.3.23 - 12 Jan 2011 =
* BugFix : Under some configurations, Database Error when attempting to update a subpage
* BugFix : Find Posts results in Media Library were not filtered
* BugFix : Media Library count was not filtered
* BugFix : Various PHP warnings/notices (visible in wp-admin when running with WP_DEBUG enabled)
* Compat : Replace function calls deprecated by WP 3.1

= 1.3.22 - 7 Jan 2011 =
* BugFix : Under some configurations, Database Error when attempting to update a subpage
* Compat : Simple:Press - PHP warning (database error) on forum page for logged non-Editors
* BugFix : Private pages were still accessible by direct URL (with teaser imposed) if Hidden Content Teaser enabled with "hide private posts" option enabled
* BugFix : PHP Notice "Undefined property: stdClass::$src_name" under some configurations
* Lang : Revised Italian Translation (Alberto Ramacciotti - http://obertfsp.com)

= 1.3.21 - 23 Dec 2010 =
* BugFix : Role assignment metaboxes in post edit form did not indicate implicit role assignments based on Category Roles

= 1.3.20 - 18 Dec 2010 =
* BugFix : Bulk assignment of Category or Taxonomy Retrictions failed when specified "for selected and sub-categories" or "for sub-categories"

= 1.3.19 - 17 Dec 2010 =
* Compat : NextGEN Gallery - fatal error on file upload attempt

= 1.3.18 - 15 Dec 2010 =
* BugFix : Users designated as Group Administrator for a specific group could not edit the group
* BugFix : Currently assigned Group Administrators did were not indicated by checkbox
* BugFix : Custom post types were included in front-end Pages listing under some configurations

= 1.3.17 - 11 Dec 2010 =
* BugFix : Template functions is_teaser_rs() and is_restricted_rs() caused fatal error
* BugFix : Comments on teased posts were included in Recent Comments widget

= 1.3.16 - 8 Dec 2010 =
* BugFix : Roles, Restrictions menus not visible on Plugins page

= 1.3.15 - 8 Dec 2010 =
* BugFix : Spam-tagged comments were linked in Recent Comments widget

= 1.3.14 - 6 Dec 2010 =
* BugFix : Page Associate role assignments failed to make pages available for selection as Page Parent 
* BugFix : Trashed posts were included in Post/Page Restrictions bulk editor
* Change : Include Role Scoper help links within wp-admin for Users, Media and RS Options pages

= 1.3.13 - 3 Dec 2010 =
* BugFix : Activation of "Sync WP Editor" option in RS Role Defs caused capabilites of other post types to be stripped out of WP Editor role definition 
* Compat : Revisionary - If another plugin (Events Manager) triggers a secondary edit_posts cap check when a Revisor attempts to edit another user's unpublished post, a pending revision is generated instead of just updating the unpublished post

= 1.3.12 - 3 Dec 2010 =
* BugFix : Page Parent automatically changed (possibly to an invalid selection) when a page is edited by a limited user who cannot fully edit current parent
* BugFix : Category Manager restrictions were not applied for WP Editors
* BugFix : "Navigation Menus" checkbox displayed inappropriately in Roles > Options > Realm > Taxonomy Usage
* BugFix : Invalid filtering results after other template/plugin code manually changed current user via call to wp_set_current_user
* Change : Default to requiring site-wide Editor or Administrator role for role/restriction assignment
* Compat : Revisionary - Was causing duplicate checkboxes for Pending Revision Notification in some cases
* Compat : Revisionary - Some qualifying users were not included in Pending Revision Notification checkboxes if internal cache was disabled
* Compat : Revisionary - All authors to see and edit revisions submitted on their posts (unless HIDE_REVISIONS_FROM_AUTHOR is defined)

= 1.3.11 - 26 Nov 2010 =
* BugFix : Page editing by user lacking site-wide Page Editor role caused page parent to revert to Main (since 1.2.9)
* BugFix : Non-administrators could not modify or request group membership via Ajax UI (since 1.2.9)

= 1.3.10 - 25 Nov 2010 =
* Compat : More Taxonomies - Category Roles could not be managed because of bug in More Taxonomies (and possibly other plugins) where category taxonomy is overriden without setting it public

= 1.3.9 - 24 Nov 2010 =
* BugFix : Non-administrators could delete users with a higher role level
* BugFix : When viewing a page, hidden categories are listed
* BugFix : Site-wide edit_theme_options capability was not honored for Nav Menu management by non-Administrators
* Feature: Support menu-specific restrictions for Nav Menus
* Feature: Constant definition 'SCOPER_NO_COMMENT_FILTERING' honored in backend for users lacking site-wide moderate_comments capability
* BugFix : Scheduled posts included in front-end listing for logged Administrators, Editors
* BugFix : "Add New" button was displayed on Edit Posts form even for users lacking a qualifying WP / General role
* BugFix : Category Restrictions were not applied to a post if it also had a tag in a non-hierarchical (tag-type) taxonomy 

= 1.3.8 - 19 Nov 2010 =
* BugFix : Improper blocking of content for custom post types not selected for RS filtering (Roles > Options > Realm > Post Type Usage)

= 1.3.7 - 18 Nov 2010 =
* BugFix : On PHP 4 sites, logged non-administrators had no read/edit access based on WP role
* BugFix : Various PHP Notices / Warnings

= 1.3.6 - 17 Nov 2010 =
* BugFix : Post previews for qualified users failed with "Not Found" error
* BugFix : For template calls to get_terms() / get_categories() / wp_list_categories(), include argument was not handled correctly (since 1.0)
* BugFix : Fatal Error for logged Administrators (undefined method merge_scoped_blogcaps) in some cases
* BugFix : Reader role restrictions not applied in some situations

= 1.3.5 - 13 Nov 2010 =
* BugFix : Post Author dropdown was limited to Editors and Administrators if "Filter Users Dropdown" option enabled
* BugFix : Category Manager role was not applied to new subcategories when assigned for "parent and sub-categories"
* BugFix : Invalid posts filtering when template invokes two or more query_posts calls with category_name argument
* BugFix : Front-end attachment queries returned only attachments authored by logged user
* BugFix : With "default new posts to private visibility" enabled, existing posts also forced to private when edited
* BugFix : Link Admin roles / restrictions were not correctly applied per-category
* Change : If a limited Link Editor submits new link without selecting a category, default to a selectable category
* Change : Separate role definitions for link editing, link category management for per-category assignment
* BugFix : Posts / Comments menu sometimes displayed inappropriately for content-specific editors
* Change : Display user_login for role assignment and group membership administration, even if user has set a different display name
* Compat : Revisionary - Dashboard Right Now count did not include revisable posts/pages (since 1.3.3)
* Compat : Revisionary - Revisor role now available by default for direct post/page assignment; allows editing others' revisions

= 1.3.4 - 5 Nov 2010 =
* Compat : Revisionary - Posts were blocked from front-end display if both Role Scoper and Revisionary enabled (since 1.3.3)

= 1.3.3 - 5 Nov 2010 =
* Compat : Smart YouTube (and other plugins that execute a posts query joined to comments table) - database error
* Compat : Revisionary - Pending count and links were not displayed in Dashboard Right Now or Edit Posts listing if revisor capability is by term or object role assignment
* Compat : Revisionary - Non-Administrators receive Not Found error for revision preview

= 1.3.2 - 3 Nov 2010 =
* BugFix : Post counts and other dashboard items were not filtered for non-Administrators (since 1.3.1)
* Compat : Revisionary - users could not submit or edit revisions based on Contributor role direct-assigned for post

= 1.3.1 - 2 Nov 2010 =
* Compat : Role Scoping for NextGEN Gallery - Gallery Authors could not manage a gallery after creating it

**1.3.RC - 8 Oct 2010**

= File Attachment Filtering =
* Feature : For File Filtering, ability to force regeneration of access keys and rewrite rules via utility URL
* BugFix : Infinite redirection if file keys in .htaccess (uploads folder) were manually modified

= Multisite =
* BugFix : With Multisite, some Default Site Options could not be modified
* BugFix : On WP 3.0 Multisite installations, all files in wp-content/cache get deleted, clashing with other plugins such as WP Super Cache
* BugFix : On Multisite installations, could not save changes to Default Sitewide Options

= Post Editing =
* Change : In Post Edit Form, currently assigned categories and other hierarchical terms shown with disabled checkboxes if current cannot edit in the term
* BugFix : Default Post/Page Roles were assigned to existing posts at post edit (since 1.1.3, now assigned only to new posts)
* BugFix : Page Parent dropdown filtering hid published pages from Contributors if none editable
* BugFix : Page Structure option "Page Authors, Editors and Administrators" did not work (prevented all non-Administrators from editing top-level pages)
* BugFix : Uploaded files could not be edited / deleted in some cases
* BugFix : With "Users CSV Entry" enabled, checkboxes for existing role assignments were not displayed in some cases 
* BugFix : Display of edit link in Edit Posts/Pages listing did not reflect capability requirements imposed by other plugins 

= Custom Post Types / Taxonomies =
* BugFix : Previous, Next links on single post page for custom types included unpublished posts (since 1.0.0)
* Compat : More Taxonomies, More Types now supported by automatically forcing RS to initalize later
* Compat : Late registration of custom types/taxonomies can be supported by forcing RS to initialize later: define( 'SCOPER_LATE_INIT', true );
* Change : Dropped support for "WP" Role Type (means scoper-assigned roles and restrictions must be object type-specific)

= Performance Enhancement =
* Perf : Eliminate extensive delays on some sites using Page Roles on hundreds of pages (when filtering posts, pre-execute a problematic subquery) 
* Perf : Eliminate superfluous query clauses for better wp-admin/edit.php performance
* BugFix : Dozens of PHP Notices / Warnings for undeclared variables or missing array indexes
* Perf : Extensive code refactoring to reduce memory usage

= Category / Term Management =
* BugFix : Category-specific assignment of Category Manger role (and management roles for custom terms) was not applied correctly with WP 3.0
* BugFix : Bulk Administration of Term Roles / Restrictions was too narrowly limited for non-Administrators (since 1.2.?)
* BugFix : Category Manager restrictions were not enforced against users with site-wide manage_categories capability
* BugFix : Category creation was not appropriately restricted with WP 3.0
* Feature : Hide the "Add New Category" UI if logged user does not have term management role site-wide

= User Groups =
* BugFix : Administrators could not modify User Group name or description (since 1.2)
* Change : User search results for group membership show user display name (rather than login)

= Plugin Compatibility =
* Compat : Revisionary plugin - Pending Revisions were not included in Edit Posts listing for non-Administrators when editing access to published post is affected by category-specific roles or restrictions (since 1.0)
* Compat : Store persistent cache to a subdirectory to avoid clashing with other plugin use of wp-cache (Multisite usage was wiping WP Super Cache .htaccess file)
* Compat : New "scoper_access_name" hook to allow 3rd party plugins to force a custom URI to be treated with wp-admin / front-end filtering

= Misc. =
* Feature : Nav Menu Manager role assignments per-menu
* Change : For Role Date Limits settings, show / hide the entry boxes if "keep stored setting" checkbox is toggled 
* Change : Auto-flush the persistent cache more aggressively on role / restriction modification
* Lang : updated .pot file
* Change : Raise minimum WP version to 3.0

= 1.2.8 RC9 - 6 Sep 2010 =

= Custom Types / Taxonomies =
* Feature : New simple checklist enables/disables RS usage of each defined post type and taxonomy 
* BugFix : Hidden Content Teaser could not be enabled for custom post types
* BugFix : Category Role usage was not available for custom post types
* BugFix : Role assignment metaboxes did not display for custom types
* BugFix : Custom Post Type menus were not displayed based on Object Role assignment
* BugFix : Newly enabled custom roles were not handled correctly by RS because initial save following activation de-associated their role capabilities (under RS Role Defs tab)
* BugFix : Some RS Options (including custom post type / taxonomy role usage) did not store correctly with WP Multisite
* BugFix : Was not requiring type-specific editing capabilities for term selection in post edit form for custom types
* BugFix : Post Types and Taxonomies disabled via new option checkboxes were not removed from Roles, Restrictions menus
* BugFix : Error when using custom post types with WP 2.9 
* Change : Force type-specific capability_type and caps for all custom post types
* Change : Enable new Post Types and Taxonomies for RS Roles & Restrictions by default
* Change : Support get_pages / list_pages filtering of hierarchical custom post types
* Change : Better support for nonstandard capabilities in custom post type definitions

= File Attachment Filtering =
* BugFix : File Attachment Filter was inactive for installations upgraded to WP 3.0 multisite and still using wp-content/uploads folder
* BugFix : On failed direct file access attempt, any page / term listings on 404 page were not filtered for RS restrictions / roles

= Front End =
* BugFix : Fatal error when manage_categories capability is checked from the front end by template or plugin code

= Post Edit Form =
* BugFix : Post submission categories not filtered when user had category-specific Post Editor role but a General Role of Page Author / Editor (since 1.2)
* BugFix : Implicit role ownership (indicated by coloring in role metaboxes) was not indicacted correctly under some configurations

= Role / Restriction Maintenance =
* BugFix : Category Roles, Category Restrictions bulk admin forms had invalid category edit links
* BugFix : Roles, Restrictions were not displayed on single term edit form
* BugFix : Invalid Roles > Roles submenu displayed if logged user has edit_users capability but not manage_settings capability
* Change : Suppress scroll links in Term Roles / Restrictions bulk admin form if terms total over 300

= Admin - Misc. =
* Feature : Media Library option, for non-Editors, to prevent the inclusion of files uploaded by other users (even if logged user can edit the related post)
* Perf : Unnecessary DB query on post save added needless overhead, caused out of memory error on some configurations (since 1.2)
* BugFix : In admin menus, "Add New" was not properly suppressed in some configurations
* BugFix : Comment listing in wp-admin was not filtered to match post editing access
* BugFix : Custom-defined WP Nav menus were not filtered for RS restrictions / roles
* BugFix : XML-RPC submissions failed for users lacking blog-wide edit_posts capability
* BugFix : On version upgrade from RS < 1.2, groups_rs db table update failed under certain conditions
* Lang : Removed ASCII HTML character codes from Spanish translation (David Gómez Becerril - www.desarrollowebdequeretaro.com)

= Plugin Compatibility =
* Compat : WPML plugin - category names with @lang suffix did not have suffix filtered off
* Compat : Verve Metaboxes - Internal server error when Administrator attempted to add a new custom post type
* Compat : Revisionary - Images attached to published content were not listed in Media Library based on Contributor / Revisor role
* Compat : Edit Flow plugin (Edit Posts / Pages listing filtered for custom status)
* Change : (with Revisionary plugin) Revisor role does not satisfy "Roles and Restrictions can be set" requirement of "site-wide Editor"

= 1.2.7 - 30 June 2010 =
* BugFix : Conflict with Tag Cloud (since 1.2.6) 

= 1.2.6 - 30 June 2010 =
* BugFix : Multibyte string functions used in Role Scoper admin forms caused fatal errors on servers lacking that PHP module
* BugFix : Page Parent filtering was broken for new pages with WP 3.0
* BugFix : If multiple sticky posts exists, all except one were dropped down to non-sticky display position
* BugFix : Various PHP warnings (harmless to normal installations)
* BugFix : "Add New" links were included in Posts, Pages menu if user has an object-specific editing role but lacks the sitewide role required for object creation
* BugFix : Database error when filtering Recent Comments widget (ambiguous reference to post_status)
* BugFix : Query parsing become confused by queries which included a tab character before or after WHERE instead of a space
* BugFix : Auto-drafts were listed in Page Roles, Page Restrictions administration forms with WP 3.0
* BugFix : Category Roles / Restrictions were applied regardless of Realm settings (causing overly restricted read access under some configurations)

= 1.2.5 - 19 June 2010 =
* BugFix : .htaccess file became corrupted on WP-MU versions < 3.0 on plugin re-activation with File Filtering enabled, causing inaccessable site
* BugFix : On WP 3.0, File Filtering was not automatically re-enabled following plugin de-activation, re-activation

= 1.2.4 - 18 June 2010 =
* BugFix : Category or Page listing with include / exclude argument caused PHP error with WP 3.0
* BugFix : Limited users could not use the Media Library based on a Post Author Category Role, and could not upload into the Edit Form until after saving the post
* Compat : My Category Order plugin (and any other plugins or custom queries which pass a child_of argument with nullstring value)
* BugFix : User group could not be removed via User Profile, using jQuery interface
* BugFix : Category Roles link on User Profile was invalid
* Lang : Partial French translation (thanks to Chryjs - http://chryjs.free.fr)
* Lang : Update English .po file via poEdit, add .pot file as generated by wordpress.org

= 1.2.3 - 17 June 2010 =
* BugFix : Non-administrators could not assign post categories correctly with WP 3.0
* BugFix : Custom object types and taxonomies were not recognized (for RS roles and restrictions) under some configurations

= 1.2.2 - 2 June 2010 =
* BugFix : Category filtering for some widgets and plugins (Subscribe2) was broken (since 1.2) 

= 1.2.1 - 2 June 2010 =
* BugFix : Syntax error when attempting to access RS Options (since 1.2)
* BugFix : Blank options area when attempting to access General Options (since 1.2)

**1.2 - 2 June 2010**

= WordPress 3.0 Compatibility =
* Compat : WP 3.0 elimination of page.php, edit-pages.php, page-new.php broke many aspects of page filtering
* Compat : Support RS Roles, Restrictions for Custom Post Types created via WP 2.9 / 3.0 framework
* Compat : Support RS Roles for Custom Taxonomies created via WP 2.9 / 3.0 framework
* Compat : WP 3.0 Multisite menu items had invalid link
* BugFix : File Filtering did not work on WP 3.0 Multisite
* BugFix : File Filtering did not work on new MU blogs until plugin re-activation or File Filtering re-enable

= New Features =
* Feature : Ajax interface for group membership selection
* Feature : Group membership requests
* Feature : Group membership recommendations (2-tier membership moderation)

= Major Bug Fixes =
* BugFix : File Filtering was not imposed based on Post/Page Restrictions or Default Category Roles (also required Private visibility)
* BugFix : RS Restrictions and Roles were not applied to Sticky Posts
* BugFix : Attachment filenames with spaces, parenthesis and other special chars caused corrupt or ineffective .htaccess (possibly resulting in Internal Server Error)
* BugFix : Last blog paging link sometimes hidden when Hidden Content Teaser enabled (also caused WP-PageNavi conflict)
* BugFix : With Revisionary (or possibly other plugins) enabled, posts are inappropriately forced into default category in logged user cannot post there.
* BugFix : Custom calls to wp_dropdown_pages (in template or other plugin code) were sometimes filtered inappropriately
* BugFix : On abnormally configured web servers, RS menu links did not work
* BugFix : Private Posts were excluded from Recent Posts widget if Hidden Content Teaser enabled, even if logged user can read the post
* BugFix : On some installations, Page Roles could not be updated correctly following upgrade from older Role Scoper version

= Minor Bug Fixes =
* BugFix : When previewing a post, non-editors don't see Page or Post listings in sidebar / topbar
* BugFix : Recent Comments widget included comments on unreadable posts, with WP 2.9
* BugFix : Custom WP_PLUGIN_DIR was not supported
* BugFix : In Bulk Object Roles Edit forms, links to edit roles of individual object were broken
* BugFix : RS addition to wp-admin footer forced horizontal scroll bar in IE7
* BugFix : Role Basis settings (User Roles and Group Roles enable / disable) were hidden and unalterable
* BugFix : If Page Reader is enabled as an "Additional Object Role", Private Page Reader also remains captioned as "Page Reader"
* BugFix : If Post Reader is enabled as an "Additional Object Role", Private Post Reader also remains captioned as "Post Reader"
* BugFix : Bad edit link on User Profile where user is a Group Manager for specific group(s)
* BugFix : When scanning Posts/Pages for unregistered attachments, File Attachment Utility did not distinguish broken links
* BugFix : Roles and Restricions menu did not remain collapsed
* BugFix : If redundant Page / Post / Category roles were stored to database, they could only be deleted one at a time (giving the appearance and effect of a failed role deletion)
* BugFix : Javascript error in Page Edit form, failed to set tooltip caption for Page Role checkboxes

= Plugin Compatibility =
* Compat : WP-PageNavi - conflict with paging links, see above
* Compat : Amember - PHP Warning (array_diff_key) after importing users
* Compat : QTranslate - unparsed page titles in Page Parent dropdown
* Compat : Simple Section Nav - children of excluded pages bubbled up to the page menu
* Compat : Reveal IDs plugin wiped out "Groups" column in Edit Users page
* Compat : Role Scoper potentially wiped out other plugin custom columns on Edit Users page

= Other Changes =
* Change : Apply Excerpt Teaser Prefix,Suffix whenever excerpt, pre-more, or first X chars replace content, if SCOPER_FORCE_EXCERPT_SUFFIX is defined.
* Change : When running with WP 3.0, use "Network / Site" terminology in captions
* Change : On WP < 2.9, Roles and Restrictions menus will appear at the bottom of the navigation sidebar
* Lang : Use mb_strtolower() for better multibyte support in translated captions
* Perf : Don't load and initialize Role Scoper on asynchronous dashboard feed calls (WP dev blog, etc.)

= 1.1.7 - 15 Feb 2010 =
* BugFix : In Post/Page Edit Form, user checkboxes for role assignment were not sorted alphabetically (since 1.1)
* Feature : Omit other users' trashed posts from Edit Posts / Edit Pages listing if not editable by logged user
* Compat : Initial WP 3.0 compat (fixing errors related to custom post type and changes to contextual help API)
* Change : Widen Page Parent dropdown on Edit Page Form to full width of Attributes box

**1.1.6 - 13 Feb 2010**

= File Filtering Fixes =
* BugFix : File Filtering failed on some installations, possibly causing an Internal Server Error
* BugFix : In WP-MU with File Filtering enabled, .htaccess file in uploads folders was regenerated on each site access (since 1.1.2)
* BugFix : In non-MU installations, .htaccess file was not immediately updated on activation / deactivation of File Filtering

= Other Changes =
* BugFix : Non-Administrators could not modify any Roles or Restrictions via bulk admin forms, even if some are delegated to them
* Lang : Added Spanish translation (Rafael P&eacute;rez Gana - http://www.rafo.cl/)
* Change : Use https link for Role Scoper css and js files if ssl is being used / forced for the current uri
* BugFix : Archives listing using postbypost listing type did not display private posts to logged Administrator
* BugFix : Template function is_protected() / is_restricted() did not work with secondary queries
* BugFix : Private posts / pages not sometimes hidden from logged Administrators in front-end custom query results
* BugFix : PHP warnings on Edit Post / Page form (if WordPress debug mode enabled)
* BugFix : PHP notice for undefined constant (SCOPER_FORCE_FILE_INCLUSIONS)
* Feature : Support SCOPER_TEASER_HIDE_PAGE_LISTING definition, to suppress teased pages from front-end listing (while still applying teaser on direct access)

= 1.1.5 - 28 Jan 2010 =
* BugFix : Fatal error under some configurations: Call to undefined function is_site_admin()
* Change : Don't create a blank .htaccess file in uploads folder if there are no restricted attachments to filter
* Feature : Observe SCOPER_DEFAULT_MONITOR_GROUPS definition to disable custom editing of Pending Revision Monitors, Scheduled Revision Monitors groups

= 1.1.4 - 27 Jan 2010 =
* BugFix : Fatal error on activation with wp-MU if File Filtering enabled
* BugFix : File Filtering was ineffective with wp-MU under some configurations
* BugFix : Updates to Role assignments fail if MySQL does not convert nullstring to zero value for datetime storage
* Lang : Reverted _x() translation calls to __(), due to issues with poEdit support

**1.1.3 - 22 Jan 2010**

= WP-mu Fatal Error =
* BugFix : Fatal error on wp-MU version upgrade, due to failed get_home_path() call (since 1.1)

= File Filtering =
* BugFix : .htaccess file was not regenerated when File Filtering is re-enabled following a disable (since 1.1)
* BugFix : File Filtering was not imposed for new attachments to private / restricted posts (since 1.1)

= WP 2.9 Trash Function =
* WP Compat : Trashed posts / pages were included in edit listing when status filter set to default "All"
* WP Compat : Trashed pages were included in Page Parent dropdown

= Significant, Prevalent Bugs (new in 1.1 code base) =
* BugFix : Main Page was not selectable when Quick Editing a Page
* BugFix : Posts were included in get_pages listing if "Include private pages in listing" option was disabled and Hidden Content Teaser turned off
* BugFix : When Contributor / Author category selection is limited, valid default category was not automatically selected
* BugFix : Some Category Roles were inappropriately auto-deleted on blogs which originated with WP < 2.3 (and have cats with term_taxonomy_id != term_id)
* BugFix : With Limited Editing Elements option enabled, some Post/Page Edit Form elements were inappropriately hidden from Editors / Authors / Contributors

= Significant but Obscure 1.1 Bugs (only affect nonstandard config) =
* BugFix : "Not valid" error message when a non-administrator saves a post/page with Role Type option set to "WP"
* BugFix : If RS Realm was customized for Page Roles only, the Restrictions menu included an invalid link to Category Restrictions
* BugFix : Some custom taxonomy queries were not filtered correctly
* BugFix : If "Remap terms" option was disabled, Category Edit Form did not list editable categories whose parent is uneditable

= Significant but Rare 1.1 Bugs (only affect some installations) =
* BugFix : New Pages / Posts did not inherit parent restrictions, in some installations
* BugFix : New Role assignments fail if MySQL does not convert nullstring to zero value for datetime storage
* BugFix : If Additional Object Roles option was enabled for some role, Page/Post assignments of that role could not be removed
* BugFix : PHP Warning on Group creation, in some installations

= Hidden Content Teaser =
* BugFix : Template function is_teaser_rs() did not work unless post ID was explicitly passed in (should default to ID of global $post)
* BugFix : Hidden Content Teaser, when applying "first x chars" teaser, stripped out img tag but not image caption
* Feature : Support SCOPER_NO_FEED_TEASER constant definition to prevent teasing of feed items even if teaser is enabled for main posts/pages listing

= Nuisance Bugs =
* BugFix : Convenience links to Category / Page Restrictions and Roles (within caption text) were invalid
* BugFix : "Browse Members" link on User Groups management page was broken
* BugFix : On General Roles assignment attempt, role selections were not preserved if user/group selection is missing

= Plugin Compatibility =
* Compat : PHP Warnings with WP Facebook Connect plugin

= 1.1.2 - 31 Dec 2009 =
* Change : Disable File Filtering by default, due to undiagnosed errors on some installations

= 1.1.1 - 30 Dec 2009 =
* BugFix : Recursive execution of category filter caused memory error in some installations

**1.1 - 30 Dec 2009**

= WP-mu: =
* Feature : Option for site-wide groups when running on WP-mu
* Feature : Most RS options can be applied either site-wide or blog-specific
* Feature : Default settings for per-blog options can be customized via Site Admin > Role Defaults
* BugFix : User RS Blog Roles were not added / removed appropriately with mu user addition / removal for specific blogs
* BugFix : RS General Role assignments were not effective; attempt to add post/page caused redirect to profile page of main blog
* BugFix : Internal cache returned categories from other blogs in some situations

= Date Limits =
* Feature : Roles can be assigned with limited duration (grant and expire dates)
* Feature : General Roles and Category Roles can be assigned with content date limits (role only applies for posts/pages dated within specified range)

= File Filtering =
* Feature : New filtering scheme eliminates many quirks by using header redirect rather than opening and sending file contents directly
* BugFix : Attachment filtering blocked some unattached files or public files.  New scheme uses per-file RewriteRules, does not filter unprotected files at all.
* Feature : File filtering can be disabled / enabled via RS Option.
* Feature : Definition / removal of DISABLE_ATTACHMENT_FILTERING constant definition now forces automatic .htaccess regeneration / restoration
* BugFix : Fatal error due to failed flush_rules call on initialization, in some upgrade scenarios
* BugFix : Auto-regenerate .htaccess if it gets out of sync with DB-stored file access key(s)
* Perf : Reduce unnecessary script loading / execution when applying file filtering

= Performance Enhacement Results =
* Default memory usage is lower than v 1.0.8 despite feature additions.
* Further memory savings possible by disabling various features (see below).
* Decreased database execution time in several areas.

= Performance Enhancements Details =
* Perf : User role sync at activation (for WP role assignments) was executing a separate query for each user (leading to long delays on some installations) 
* Perf : Do not resync all users on each user registration / profile update
* Perf : Extensive optimization of code structure and inclusion logic to prevent unnecessary memory usage.
* Change : Require MySQL >= 4.1 so LEFT JOINs can be replaced by subqueries
* Perf : Converted LEFT JOIN in posts query to subselect
* Perf : Eliminated unnecessary LEFT JOIN in terms query
* Perf : Further wp-admin memory savings via option to disable filtering of Post Author dropdown (if "Indicate Blended Roles" and "Limit eligible users" also disabled)
* Perf : Further front-end memory savings if you define SCOPER_GET_PAGES_LEAN (don't retrieve page content just to list page titles) 
* Perf : Further wp-admin memory savings if you define SCOPER_EDIT_POSTS_LEAN, SCOPER_EDIT_PAGES_LEAN
* Perf : Eliminated redundant filtering for page parent dropdown
* Perf : Eliminated unnecessary RS queries in Media Library
* Perf : Eliminated unnecessary RS-initiated post/page retrieval queries
* Perf : No construction / translation of role names in wp-admin until they are needed
* Perf : set RS option records to autoload = no, since RS does its own buffering
* Perf : Eliminated lots of PHP warnings for unset variables / array keys
* Change : Stop storing postmeta last_parent entry for pages / posts that have no Parent setting

= User Editing / Role Assignment =
* Feature : support distinction between Content Administrator, User Administrator and Option Administrator.  Currently designate cap for each via define( 'SCOPER_CONTENT_ADMIN_CAP', 'cap_name' );
* Feature : Option to allow role assignment only by Content Administrators / User Administrators
* Feature : Don't allow the editing of users with a higher level than logged user (can disable via RS Option)
* Feature : Don't allow the assignment of a WP role with a higher level than logged user's level (can disable via RS Option)

= Role Definition =
* Feature : Synchronize RS Role Defs to WP Role Defs at installation (eliminates unexpected results when WP roles are customized)
* Feature : On RS Role Defs tab, warn if WP Roles do not have normal RS role containment (WP Author contains RS Post Author, etc.) due to extra caps in RS Role def
* Feature : On RS Role Defs tab, option to synchronize WP Contributor / Author / Editor role def with current RS Post Contributor / Post Author / Post Editor / Page Editor role def
* BugFix : WP Role Definitions tab empty on reload after updating RS Options
* Change : Post Editor / Page Editor role assignment also grants unfiltered_html capability for that content.  Can be disabled via Roles > RS Role Defs.

= Group Roles =
* Feature : Metagroup for anonymous users - define SCOPER_ANON_METAGROUP.  Only to be used when some content should be seen by anon users but not all logged users.
* BugFix : WordPress roles with name longer than 25 characters caused RS metagroup record to be perpetually regenerated with new group_id, leaving orphaned role assignments
* BugFix : Group deletion did not always delete all associated roles
* BugFix : Incorrect eligible groups count if orphaned Group Role assignments are stored
* Change : Delete all orphaned group role assignments on plugin re-activation

= Media Library =
* BugFix : non-administrators could not view unattached uploads via View link in Media Library
* BugFix : non-administrators could not see unattached uploads in Library tab of uploader
* BugFix : Authors were not allowed to edit or delete their unattached uploads in Media Library

= Post / Page Edit Form =
* Feature : Option to default new posts and/or pages to Private visibility
* Feature : Option to auto-select Private visibility when the Reader role is restricted in Page/Post Edit Form
* Feature : Additional "Lock Top Pages" option to allow any Page Author to set or remove top-level pages
* BugFix : On post creation, default category was not applied in some situations when author had save / publish capability for it
* BugFix : On post creation, first available category was not applied in some situations when author did not select any categories (and does not have save/publish capability for default cat)
* BugFix : Authors could not edit their own private posts / pages in some configurations
* BugFix : Non-editors were sometimes unable to save subpages of pages based on their Page Associate role; received a "cannot associate with the Main Page" error message
* BugFix : WP Metagroup Category/General Role assignments were not indicated by color coding in Post/Page Edit Form role metaboxes
* BugFix : "Attempt has failed" error when submitting post with some certain WP/RS Role Definitions and editing roles restricted in all categories
* BugFix : Out of memory / timeout error on some servers when non-Administrator views Edit Posts listing
* BugFix : In some configurations where user can edit a subpage based on propagated Page Editor role, that role assignment was lost when they saved a change to the page content.
* Change : Implicit role ownership via Category/General Role assignment is indicated by slashes around user/group name.  Previous versions used square brackets.
* BugFix : Contributors could not upload an image before a category is set, if editing rights are based on category
* BugFix : Invalid HTML formatting of Page Parent dropdown if no published pages exist

= Post / Page Edit Form - Limited Editing Elements =
* Feature : Option to require blog-wide Administrator / Editor / Author / Contributor role for specified Limited Editing Element IDs
* BugFix : Comment and Trackbacks status turned off when a post was edited with Discussion metabox (commentstatusdiv) hidden via Limited Editing Elements
* BugFix : Custom Post Excerpt cleared when a post was edited with Post Excerpt metabox hidden via Limited Editing Elements setting
* Change : If a specified Limited Editing Element is not a metabox, hide it via CSS
* Change : "Limited Editing Elements" includes customdiv, pagecustomdiv, revisionsdiv by default

= Edit Posts / Pages Listing =
* Feature : Custom Role / Restriction indicator columns in Edit Posts and Edit Pages listing can be selectively disabled
* Feature : Custom columns are suppressed if logged user does not satisfy RS Option requirement for "Roles and Restrictions can be set by"
* BugFix : Custom Roles / Restriction indicator columns were sometimes displayed even if none of the listed posts used them
* BugFix : Edit Posts column indicated some false positives for Category Restrictions
* BugFix : Edit Posts listing included Term Roles column even if none of the listed posts had Term Roles

= Page / Category Listing (Front End) =
* Feature : When remapping a page to visible ancestor, Option for whether remap can bypass an explictly excluded ancestor
* Feature : When remapping a term to visible ancestor, Option for whether remap can bypass an explictly excluded ancestor
* Feature : Support remap_parents, enforce_actual_depth, remap_thru_excluded_parent args to override defaults in a get_pages() / get_terms() call
* Compat : Never remap pages if get_pages called without hierarchical arg (unnecessary, caused conflict with Flexi Pages plugin)
* Compat : Never remap terms if get_terms called without hierarchical arg
* Change : RS Option "Remap Hiden Pages to Visible Ancestor" disabled by default, to avoid conflict with template code that relies on exclude+depth arguments being treated as exclude_tree
* Change : RS Option "Remap Hiden Terms to Visible Ancestor" disabled by default, to avoid conflict with template code that relies on exclude+depth arguments being treated as exclude_tree

= XML-RPC =
* BugFix : XML-RPC post submissions created without category selection for users without less than blog-wide Editor role
* BugFix : With some XML-RPC clients, non-administrators can publish new posts but cannot edit them following publish 
* BugFix : XML-RPC retrieval of recent posts only returned one post

= Custom Taxonomies =
* Feature : Support Restrictions on custom taxonomies
* BugFix : When custom taxonomies are enabled for use with RS, "Category Restrictions and Roles for Posts" checkbox caption was not modified accordingly 
* BugFix : Invalid edit URL from bulk role administration form for Post Tags, Custom Taxonomies
* Workaround : WP core forces display of published posts only in Edit Posts listing when filtering by a custom taxonomy term

= Front-End Misc =
* Feature : If HTTP authentication is enabled, append the http_auth argument to Category, Tag, Author and Comment feed links also 
* BugFix : get_comments() function did not include comments on attachments to private posts
* BugFix : In some installations with a language defined and "suppress private caption" option enabled, fatal error from translate call in template-interceptor 
* BugFix : template function is_restricted_rs() indicated some false positives for category restrictions
* BugFix : Tags filter defaulted to limiting number of displayed tags to 45
* BugFix : tag__not_in argument was not supported for manual calls to WP_Query

= Admin Misc =
* Feature : Add pending posts and pages total to Dashboard Right Now list
* BugFix : Cannot approve / unapprove comments when capability is granted via Category Role or Page/Post Role
* BugFix : Roles, Restrictions menu icons were not displayed if custom WP_CONTENT_DIR set
* BugFix : PHP Warning on installation / version update due to DB key name conflicting with an existing WP key name
* BugFix : In User Profile, link to edit individual Object Role yielded "insufficient permissions" message
* BugFix : RS roles were hidden from User Profile for users who cannot assign roles due to blogwide role requirement set in RS Options
* Change : Prevent activation (with helpful error message) if another copy of RS is already active
* Change : If RS_DEBUG is defined and the script is plugins.php or edit-plugins.php, don't initialize the plugin (prevents hung server on bad edits via Plugin Editor)
* Change : On RS Options form, rearranged and recaptioned "Realm" options for clarity
* Change : Popup confirmation box before reverting RS Options to defaults
* Change : Update button in all RS forms styled the same as WordPress Update buttons

= Misc =
* BugFix : Warning messages on servers with open_basedir restriction
* BugFix : RS Internal Cache did not work if custom WP_CONTENT_DIR set

= API =
* API : ScoperAdminLib::create_group($name, $desript), returns group_id
* API : ScoperAdminLib::get_group_by_name($name), returns group object
* API : ScoperAdminLib::get_group($group_id), returns group object

= Plugin Compatibility =
* Compat : Formatting of table header in Role / Restriction bulk admin forms was thrown off by BuddyPress
* Compat : Pages listing was broken when Theme My Login active with option to exclude login page from listing
* Compat : Automatically switch Roles, Restrictions tabs to default(bottom) positioning if some other plugin has moved the Users tab
* Compat : Support nonstandard usage of wp_dropdown_pages filter by Simple Section Nav plugin
* Compat : PHP Warning after AMember creates a role with no capabilities
* Compat : Apply RS restrictions and roles to Snazzy Archives plugin listing
* Compat : PHP Warning "Missing argument 2" with WPML plugin
* Compat : Suppress RS filtering when another plugin has initiated a scheduled operation via WP Cron (conflict with WP Robot, Twitter News Feeds)
* Compat : Tiny MCE Advanced (conflict was present in RS 1.1 beta versions)
* Compat : Flutter (may require Flutter code patch, see Notes)
* Compat : Use display names and plural display names defined by Custom Taxonomies plugin
* Compat : Simple Section Nav: page selection list in Widget setup was broken with latest SSN version

= Browser Compat (wp-admin) =
* BugFix : Background color not applied to RS Options form in some versions of IE
* BugFix : IE8 tab, checkbox positioning in Post/Page Edit Form role metaboxes

= Translation =
* Lang : Added Italian translation (Alberto Ramacciotti - http://obertfsp.com)
* Feature : Default teaser strings included in .po file for translation.  Must add this to wp-config.php: define( 'SCOPER_TRANSLATE_TEASER', true );

= 1.0.8 - 18 Aug 2009 =
* Feature : Option to prevent non-Administrators from assigning or viewing content-specific roles
* Feature : For front-end Page and Category listings, parent remapping behavior is now adjustable via RS Options
* Change : When a depth limit is specified for pages/categories listing, default to enforcing that limit based on actual depth prior to parent remap
* Bugfix : Fix compatibility with various custom child_of / depth / exclude / order combinations in pages, categories listing
* BugFix : Pages listing filter did not honor number, offset arguments
* BugFix : Terms (categories) listing filter did not apply custom ordering filter with WP 2.8
* Change : Work around WP bug when page / category listing is generated with child_of arg, but first element in result array is not a direct child
* Compat : Simple Section Navigation plugin displayed misplaced subpages in some situations
* Compat : My Category Order plugin
* Compat : Flutter/FreshPage plugin (disable custom menu indexing if plugin is active)
* Compat : Capability Manager plugin (automatically re-sync role defs on role creation / deletion)
* BugFix : When hiding other users' unattached uploads in Media Library, attachment count did not match 
* Change : Blog-wide Editors always see all unattached uploads in Media Library, regardless of option setting
* Doc : Replaced standalone change log and plugin compat documents with readme.txt sections

= 1.0.7 - 10 August 2009 =
* BugFix : With WP 2.8, new users were not assigned membership in WP Role metagroup until cache flush
* Change : Exclude role metagroups from groups column in users list (to reduce clutter)
* Feature : Option for whether non-administrators can see unattached uploads from other users
* Change : By default, non-administrators see only their own unattached uploads in Media Library
* Compat : Disable caching of pages, categories listing if QTranslate plugin is active
* Change : remap get&#95;pages exclude argument to exclude&#95;tree if called with depth=1
* Change : remap get&#95;terms exclude argument to exclude&#95;tree if called with depth=1
* Change : more descriptive error message when another plugin prevents RS initialization

= 1.0.6 - 6 August 2009 =
* BugFix : Failed to re-activate after WordPress auto-update
* BugFix : In WP-mu, Category Roles not inherited from parent on new category creation
* BugFix : Users with Category Manager role for a limited no. of cats could change Cat Parent to None
* BugFix : Users with Category Manager role for a limited no. of cats could create new top-level cats
* BugFix : Category Edit Form offered selection of a category as its own parent (though not stored)
* BugFix : In Bulk Roles / Restrictions form, "Collapse All" script hid some Categories / Pages inappropriately

= 1.0.5.1 - 5 August 2009 =
* Bump up version number to force wordpress.org to regenerate .zip.  The 1.0.5 zip was missing many files.

= 1.0.5 - 5 August 2009 =
* Change : Hidden Editing Elements now hidden securely on server side, not via CSS.
* Change : In RS Options, recaption "Hidden Editing Elements" as "Limited Editing Elements"
* Change : Updated sample IDs displayed on Role Scoper Options form for Hidden Editing Elements
* Change : Updated default IDs for Hidden Editing Elements
* Compat : Conflict with QTranslation plugin - translation of page titles, term names, bulk admin post titles
* Compat : Support SCOPER&#95;DISABLE&#95;MENU&#95;TWEAK definition for compat with Flutter plugin
* BugFix : New pages by non-Editors initially saved as Pending even if Publish was clicked
* BugFix : Administrator could not modify default category with WP 2.8
* BugFix : Default Groups could not be edited with WP 2.8
* BugFix : Attachments Utility (in RS Options) was not accessible under WP 2.8
* BugFix : In some configurations, fatal error when unavailable user&#95;can&#95;for&#95;any&#95;object() function called with administrator logged in
* BugFix : When editing group, could not remove last group administrator
* BugFix : Group roles were not displayed in group edit form if no members in group
* BugFix : Eliminated orphaned role deletion (no longer needed and deleted non-orphan group roles in some situations)
* BugFix : Object Roles, Blog Roles cache was not flushed following group membership change
* BugFix : On some server, the internal cache did not update following user profile edit
* BugFix : RS menu links were broken if role scoper activated within custom-named directory

= 1.0.4.1 - 28 June 2009 =
* BugFix : Roles, Restrictions menu links were broken for administrators (since 1.0.4)

= 1.0.4 - 26 June 2009 =
* Change : Deny implicit comment moderation rights to Authors if they lack moderate&#95;comments cap
* BugFix : In Edit Post form, non-editors could see / select other users as "author"
* BugFix : Option "role assignment requires blog-wide editor role" was only requiring blog-wide contributor role
* BugFix : Page Parent filtering was broken for Quick Edit
* BugFix : Category Restrictions were not inherited upon new category creation
* BugFix : Option "role assignment requires blog-wide editor role" did not suppress Roles, Restrictions sidebar menu
* BugFix : XML-RPC support (ScribeFire, WLW) was broken for non-administrators
* BugFix : User groups were unusable on DB servers that do not support default value on text columns
* BugFix : exclude&#95;tree argument was ineffective in get&#95;terms / wp&#95;list&#95;categories call
* BugFix : invalid Category / Object role edit links displayed in user profile for non-editors in some configurations 
* BugFix : Role Scoper Options inaccessable to administrator with WP 2.8.1
* Change : Moved option "Role administration requires a blog-wide Editor role" to main Options tab

= 1.0.3.4 - 8 May 2009 =
* BugFix : Fifth attempt to prevent re-activation failure following Role Scoper update via WP auto-updater
* BugFix : WP 2.8 Compat: Moved Restrictions, Roles menus back to familiar location unders Users menu

= 1.0.3.3 - 8 May 2009 =
* BugFix : Fourth attempt to prevent plugin activity during WordPress update operation, to prevent re-activation failure

= 1.0.3.2 - 8 May 2009 =
* BugFix : Third attempt to prevent plugin activity during WordPress update operation, to prevent re-activation failure

= 1.0.3.1 - 8 May 2009 =
* BugFix : Second attempt to prevent plugin activity during WordPress update operation, to prevent re-activation failure

= 1.0.3 - 8 May 2009 =
* BugFix : Prevent plugin activity during WordPress update operation, to prevent re-activation failure

= 1.0.2 - 7 May 2009 =
* BugFix : Template function is&#95;restricted&#95;rs / is&#95;exclusive&#95;rs was non-functional on home page (since rc9.9311)
* BugFix : With Attachments Filter enabled, attachments larger than 10MB fail to download on some installations
* BugFix : Fatal Error when viewing a single post entry after RS Options modified to disable front-end filtering
* BugFix : Auto-delete orphaned role assignments left in DB by previous versions following category / group deletion
* BugFix : After an empty group was deleted, its role assignments were left in the database
* BugFix : Event Calendar events without an associated post were not displayed without calendar refresh 
* BugFix : Post Restrictions and Post Roles did not display on PHP 4 servers
* BugFix : In Post/Page Edit Form, Author selection was inappropriately available to non-editors
* BugFix : Orphaned role assignments already stored to database will be autodeleted on RS version update
* BugFix : If the object type of a requested attachment parent cannot be determined, assume post
* BugFix : Teaser message displayed in header with some themes
* BugFix : http authentication prompt for RSS feeds with logged administrators on some installations
* BugFix : Hidden Editing Elements settings were not effective for unpublished posts/pages
* BugFix : If a memberless group was deleted, any assigned roles were left (orphaned) in the database
* Plugin :  Conflict with WP-Wall plugin caused non-listing or double-listing of wall comments
* Feature : Option to accept CSV entry for user role assignment
* Feature : Bottom-right submit button on bulk admin forms if SCOPER&#95;EXTRA&#95;SUBMIT&#95;BUTTON is defined

= 1.0.1 - 27 March 2009 =
* BugFix : In some situations, non-attachments were included in Media Library listing
* BugFix : Low level users could not edit uploads from Media Library based on a Post/Page/Category role assignment
* BugFix : Cannot set static front page with Role Scoper activated
* BugFix : Users with editing role via Page / Category assignment could not bulk-delete posts/pages
* BugFix : Post/Page Edit divs configured as Hidden Editing Elements were not hidden for draft posts/pages
* BugFix : After a group was deleted, its role assignments were left in the database
* BugFix : PHP warnings viewing users list with WP < 2.8
* Change : WP 2.7 users with hacked WP template.php user&#95;row code must define("scoper&#95;users&#95;custom&#95;column", "true");
* BugFix : Failed to return results for manual WP&#95;Query calls which include category exclusion argument
* BugFix : Role Scoper error messages were formatted with unreadable colors with WP 2.7
* BugFix : Conflict with ozhAdminMenus plugin - Page menus missing in some configurations
* BugFix : Conflict with WP-Wall plugin caused fatal error
* Feature : Options to hide User Groups, Scoped Roles from user profile

= 1.0.0 - 21 March 2009 =
* BugFix : In some installations, DB error for anonymous user front-end access (since rc9.9220)


v 0.9.27 - 24 July 2008
- fixed: Extremely slow loading of Page Parent dropdown due to recursive queries on page edit by non-administrator
- fixed: If a user who lacks editing capabilities in the default category saves a page without selecting a category, the post was stored as draft/pending in category "-1" and the user could not re-edit it
- feature: If post would be set to default category but user lacks save/edit/publish capability there, it is instead defaulted to first category in user's available list
- fixed: Post/Page counts on Manage Posts/Pages were not filtered correctly for users with ID > 9


v 0.9.26 - 24 July 2008
Page Categories (Page Category Plus plugin + Categorized Pages + Role Scoper "Section Roles for Pages" option):
- fixed: Using Page Categories with Teaser disabled for posts and pages, pages in an Exclusive Readers category were exposed in the posts listing
- fixed: Using Page Categories with Teaser disabled for posts and pages, visible pages did not force their category into the categories list
- fixed: Using Page Categories With Teaser enabled for posts or pages, various inappropriate exposure of private / exclusive pages and posts
- fixed: Using Page Categories, false teaser displayed for some posts/pages (though direct access granted)
- fixed: Using Page Categories, false teaser displayed to Administrator
- fixed: Using Page Categories, Pages were not correctly accounted in category count
- fixed: Using Page Categories, when Manage Posts list is filtered by Category, Category Roles and Object Roles Columns became invalid for mixed results of Posts and Pages

Admin - General:
- fixed: In Post/Page role assignement users list, indication of implicitly owned roles did not correctly account for Exclusive Sections settings
- fixed: 404 message instead of Teaser for direct access attempt to private Post/Page
- change: In the Role tabs of Post/Page Edit form, captions next to "Exclusive" checkbox are more descriptive
- change: In the Readers tab of Post/Page Edit form, caption cites "Readers" role (was "Private Page Readers")


v 0.9.25 - 23 July 2008
Admin - General:
- fixed: Vanished paging links in Manage Posts and Manage Pages
- fixed: In WP 2.6, Revision save caused a superfluous copy of object role assignments to be stored
- fixed: On Exclusive Object Roles page, some settings were hidden from Administrators (though displayed in single Post/Page edit and Manage Posts/Pages list)
- fixed: PHP warning in Dashboard if no comments were stored
- feature: After when viewing Roles->Section Roles, main Groups tab links to Groups->Section Roles.  Likewise for Blog Roles

Realm Settings:
- fixed: If "Object Roles for Posts/Pages" was switched off, Object Roles were not honored but Object Role requirements (Exclusive Object Roles) were still enforced.
- fixed: If "Object Roles for Posts/Pages" is switched off, the tabs still appeared in the Post/Page edit form and in the Manage Posts/Pages columns
- fixed: If front-end or admin filtering was switched off, some content restriction/allowance was still performed
- fixed: Disabling category, link category or other taxonomy filtering created errors.  Switch is now removed.
- fixed: More descriptive captions on Realm page


v 0.9.24 - 22 July 2008
Category Management by non-Administrator:
- fixed: When the parent category was hidden, cannot edit without changing actual parent category
- fixed: "Manage Categories" list was overly restricted

Hidden Content Teaser:
- fixed: Teaser was not working for pages (was always hiding them)

Admin - Exclusive Sections / Section Roles:
- change: Link to Exclusive Sections from single Category Edit page is now captioned "Access Restriction (Exclusive Sections)
- feature: Category Scroll links in Section Roles and Exclusive Sections are color-trended and size-trended to illustrate hierarchy


v 0.9.23 - 22 July 2008
Hidden Content Teaser:
- fixed: Hidden Content Teaser failed on some servers due to RS use of undeclared properties and unreliability of 	WordPress the_posts hook for this purpose (using posts_results instead)
- change: Code is now structured such that if teaser trigger fails as above, failure state is to hide everything
- fixed: potentially, other undiscovered bugs related to the failure of undeclared properties on some servers
- fixed: Comments were visible even in posts hidden with teaser
- fixed: With teaser on, visible pages below a private page did not retain their hierarchy
- fixed: Teaser was teasing unviewable private pages even if the "include private pages if user can read them" option was disabled.  Now, if that setting is activated, private pages will never be listed or teased.

Categories:
- fixed: For Users < WP editor, other users' published posts could be listed and edited (but not saved) if user had a Section Role assignment of Author in one of the post categories
- fixed: (theoretically) Imposed safeguards against potential stripping of existing post categories/tags, reported by one user and potentially possible if a post save operation was triggered from an unusual URI.  Now limit RS category/tag filtering to expected URIs
- fixed: Categories with Exclusive Section settings were not filtered properly with "Realms -> Section Roles for Pages" enabled.  This would pertain to installations that use Page Category Plus
- fixed: Non-admin users with Category management in a category could modify Exclusive Sections settings for roles they do not possess, effectively promoting themselves to a higher category role.
- fixed: After a Section Role or Exclusive Sections setting which lowers the user's own administration rights, newly inaccessable categories did not disappear from the UI until after the next page reload


v 0.9.22 - 20 July 2008
- feature: Activate Teaser separately for posts, pages
- fixed: Inaccessable pages were always hidden (never teased) regardless of Teaser setting
- fixed: Posts which are exclusive due to Exclusive Section were not flagged by is_exclusive_rs() template function
- fixed: For Category Management (including Section Role assignment and Exclusive Sections modification), non-Admin 	users were not properly limited by Exclusive Sections settings.
- fixed: WP 2.2 compatability was broken; restored now. (mainly an excercise to ensure support of custom data source and taxonomy schemas)


v 0.9.21 - 19 July 2008
- feature: All Post and Page Revision capabilities are governed by scoped role assignments and requirements.  Each user's revision access will match their Manage Post / Manage Pages access (whether greater or less than their WP Blog role would allow).


v 0.9.20 - 19 July 2008
Doc:
- doc: revised Usage Guide to include How To section, converted to html document

Front End:
- feature: Option to suppress private pages from front end listing even if user can read them
- fixed: In hierarchical page listings, Child Pages were not nested correctly with a hidden ancestor
- fixed: In hierarchical category listings, Subcategories were not nested correctly with a hidden ancestor

WP Bug Patch: 
- feature: For %page_name% permalink structure, WP was generating invalid page link with unpublished ancestors.  Convert these to page_id permalink

WP 2.6:
- fixed: Hidden content Teaser was not applied with WP 2.6
- fixed: WP 2.6 Page Revisions were completely hidden, even for administrator.  Restored, but do not yet honor scoped roles or exclusions.  Review & Rollback caps follow blog-wide role assignments, including Role Scoper Blog Roles.
- fixed: In WP 2.6, "header already sent" error message after saving a page

Dashboard Filtering:
- feature: Dashboard now includes private posts/pages in totals
- feature: Dashboard summary sentance now includes totals and link for draft/future/pending pages
- fixed: Dashboard filtering (total posts, Write Post/Page links, etc) was accidentally disabled in the last several versions
- fixed: Existing Dashboard filtering of comment totals became partially dysfunctional in WP 2.6 due to some revised queries

Admin General:
- fixed: Associate role assignment was hidden from non-admin users in Page Edit form
- fixed: When an ancestor term or object was deleted, its propagated roles were also deleted.  Now propagated roles are retained and converted to direct-assigned
- change: In Realms settings, default to NOT adjustable realm, hide underlying object type, access type activation UI until Adjustable Realm is activated. (This eliminates some option queries).

Navigation & Access for Elevated users (especially Subscribers/Contributors with Page-specific editing role):
- feature: Admin notice message if user lacking blog-wide edit_others_pages capability tries to associate a page with Main Page (or disassociate a current child of Main)
- feature: For posts/pages which have ever been published, hide admin divs (Password, Page Parent, etc. as defined in Role Scoper Options) if user doesn't have any blog-wide editing capabilities (i.e. if they are Subscribers)
- feature: Hide Editing/Association role assignment in post/page edit form if user doesn't have any blog-wide editing capabilities (i.e. if they are Subscribers)
- fixed: PHP warning at the bottom of Page Edit form on first entry by a Subscriber with Page Edit role
- fixed: Filtering of comments so uneditable comments are not listed at all
- fixed: In WP Admin, Manage Pages linked "Write" to page-new.php even if user can't edit_pages blog-wide
- fixed: If a user who can't edit pages accesses page-new.php directly, they got an edit form and could save posts
- fixed: Subscribers with a page/post editing role assignment were not included in the "post author" dropdown
- fixed: Pages/Posts listed though not editable if owned by current user but published and set to exclusive Editors with owner not assigned as an Editor.  Corrected to no edit listing or edit form access for "owner" in this situation.
- change: By default, DON'T exclude subscribers from Page/Post Contributor/Editor role assignments (can enforce limitation via Role Scoper Options)
- change: Category selection is NOT hidden from Contributors by default (appears as c-ategorydiv in Role Scoper "Css admin divs" option; change to categorydiv to hide from Contributors)

Usage with 'WP' Role Type:
- feature: Category and Post/Page role assignment indicator columns in Manage Posts, Manage Pages when using WP Role Type (but Exclusive indicator col and is_exclusive_rs() template function still only supported with RS role type)
- feature: When using "WP" role type, "Anonymous Reader" role may be set to set as an object role assignment or as an Exclusive Object role (ignoring the default role "assignment" which anonymous users have)
- fixed: When using "WP" role type, Exclusive Section settings for "Anonymous Reader" were not being stored
- fixed: Pages all hidden when using "WP" role type

Performance:
- fixed: LOTS of redundant queries in edit-comments.php for non-admin user
- fixed: Redundant option queries

Security:
- feature: On init failure due to already-plugged set_current_user function, default all defined data sources to zero content visibility
--------- end v0.9.20 changes ---------


v 0.9.19 - 11 July 2008
- fixed: Parse error in groups.php and exclusive_sections.php due on servers with PHP short tags disabled
- doc: revised to fix reference to "Users" tab (should be "Roles" tab)
- doc: converted UsageGuide to RTF format


v 0.9.18 - 10 July 2008
- doc: added usage guide
- fixed: removed "edit_private" and "delete_private" caps from Post Editor, Page Editor role defs
- fixed: in WP 2.6, failed redirect following group creation due to extra slash in redirect URL
- fixed: PHP warning in WP 2.2 (due to non-array return value from wpdb->get_col)
- fixed: PHP warning due to conflict with Recent Posts plugin, and possibly others that trigger a second posts_results filter


v 0.9.17 - 9 July 2008
- fixed: in blogs that originated with WP < 2.3 (categories with term_id <> term_taxonomy_id), some categories were excluded from the sidebar listing
- fixed: some inconsistencies with the crediting of WP Blog roles (especially involving scoped page roles and customized WP blog roles)
- fixed: On some servers, failed or noisy activation due to various invalid variable/method access
- fixed: XMLRPC page editing via Category or Page roles (tested with ScribeFire)
- caption: fixed "capbabilities" typo on Role Scoper Options page
- WP rev: support relocated wp-content folder (WP 2.6)
- feature: Admin footer on RS admin pages lists plugin version, links to agapetry.net, Support Forum


v 0.9.16 - 5 July 2008
- feature: template functions is_exclusive_rs(), is_teaser_rs() allow theme to format exclusive posts distinctively
- feature: New columns for Manage Posts, Manage Pages: Exclusive, Categ Roles, Post/Page Roles
- feature: Option to suppress "Private" and "Protected" prefix from post/page title
- feature: Suppress password form for posts that will be hidden by Role Scoper anyway.
- feature: In Post/Page edit, role edit tab caption indicates exclusive role
- performance: Cache listed_ids to eliminate redundant queries when WP has not set post_cache
- performance: eliminate some needless configuration code for front end execution
- fixed: When Page categories are enabled, Exclusive Sections interface for post roles disappeared
- fixed: Category listing was missing some subcategories if post count not enabled
- fixed: Some inaccessable categories were included in categories list for anonymous user
- fixed: For administrators, the category filtering intended to include missing private post categories was also omitting some categories by enforcing "exclusive sections" role requirements


v 0.9.15 - 2 July 2008
- fixed: Infinite recursion in edit-pages.php and page.php if admin selects as page parent one of its descendants (bug was introduced in 0.9.14).  Invalid database entry bewilders WP core, requiring installation of Role Scoper v0.9.15 to correct.  This repair is done automatically on version update from < v0.9.15, but can be forced by defining the constants SCOPER_NEED_ROLE_SYNC and SCOPER_FIX_PARENT_RECURSION
- fixed: In page edit, Contributors sometimes allowed to publish inappropriately if Editor role is assigned for another page.
- fixed: User group membership change via user profile edit was not updating cache
- fixed: In user profile, user's WP Role metagroup "membership" was indicated in group count but not listed as a group.
- fixed: various PHP warning messages for undeclared variables.


v 0.9.14 - 1 July 2008
- fixed: For users who are members of a group, cache was not being updated following role assignment.
- fixed: admin users did not have private post categories listed even though they have access (actually a WP bug, now worked around)
- fixed: Non-editor users could not select their own page as a parent if the desired parent is a child of an uneditable page.
- fixed: Object role selection UI was not highlighting users who have a role on the basis of WP Role metagroup "membership"
- fixed: In an as-yet-unexplained bug, one user had private posts included in anon user's post listing (but not in direct access attempts).  Added sanity safeguards should make this impossible.


v 0.9.13 - 27 June 2008
- fixed: Page Parent dropdown was not reflecting scoped role assignments
- fixed: Cache was not being updated following blog role assignment
- fixed: Association of page to Main Page was not being appropriately limited (now requires blog-wide edit_others_pages i.e. blog-wide Editor / Page Editor)


v 0.9.12 - 24 June 2008
- fixed: Remaining cache maint issues (via thorough review of all cache keys and flush calls)
- fixed: Empty cache files were being generated unnecessarily
- fixed: Non-admin category managers were unable to assign group roles
- fixed: Wasn't honoring wp_set_current_user name argument when in admin (potential cause of "you do not have sufficient permissions" error)


v 0.9.11 - 23 June 2008
- fixed: "Exclusive" object role settings were not being auto-flushed appropriately


v 0.9.10 - 20 June 2008
- fixed: Page Template selection was hidden in Page Edit form
- fixed: Newly created subcategories not visible in Manage Categories list
- fixed: get_categories child_of argument was ignored
- fixed: get_pages child_of argument was ignored
- fixed: PHP warning on user registration / edit
- fixed: Failure to modify group membership via "Members" page
- fixed: "Write" menu was displayed even if user can only edit some existing post(s) / page(s)
- fixed: Some object role assignments were not displayed in user's own profile
- fixed: Conflict with Role Manager was preventing instant refresh of capability settings
- fixed: Some cached data was not being auto-flushed appropriately


v0.9.9 - 8 June 2008
- feature: Meta Groups - each WP Role has corresponding auto-populated user group for role assignment
- fixed: Group Administrator assignments for non-admin users are now honored
- fixed: PHP4 was not being detected on some (Ubunutu) servers


v0.9.8 - 2 June 2008
- fixed: editing roles were not being credited under some conditions
- fixed: in post edit, categories were not being listed under some conditions
- fixed Category storage for new posts (new bug in v0.9.6 was storing storing term ID as term name)
- fixed Exclusive Objects listing for administrators (new bug in v0.9.6)
- better handling of Main Page association/disassiation (now revert to previously store parent if user tries to set/unset page parent to Main Page but lacks blog-wide edit_pages) 
- added automatic flushing of Role Scoper's internal cache following activation of any new version


v0.9.6 - 30 May 2008
- fixed various problems with crediting of roles to non-admin, non-editor users ("attempt has failed" error was 1 symptom)
- workaround for conflict with WP Security Scan plugin -- re-establish WP version if necessary
- fixed "call time pass by reference error" on edit post
- suppress Object Roles admin links for users without pertinent access
- in Exclusive Objects admin page, list only objects user can admin
- some Exclusive Objects edit links were missing
- rephrased caption on Object Roles admin page from "No object roles are set" to "No object roles to administer"
- added missing table caption in Object Roles, Exclusive Objects pages
- corrected one note at bottom of Exclusive Sections page
- on Role Scoper Options page, suppress revision notes for versions <= currently installed version


v0.9.5 - 24 May 2008
- fixed crediting of group roles (logged user's group membership was being ignored)
- fixed get_pages filtering to enable display of private pages if user has scoped role
- eliminated query error in WP 2.2-2.3 Write Post form


v0.9.4 - 23 May 2008
- reinstate Groups and Roles menu links (were hidden by 0.9.3)


v0.9.3 - 23 May 2008
- eliminated conflict with theme administration (RS admin filters now only added for a fixed subset of URIs)
- new filter hooks scoper_admin_uris, scoper_admin_hardway_uris allow other plugins to add their admin page(s) for filtering


v0.9.2 - 22 May 2008
- fixed PHP4 support (eliminated optional byref argument in Scoper::get_strict_terms function)
- re-enabled post-specific role assignment (was broken by my workaround for missing dbx_page_advanced in WP 2.5)
- slight change to subtext color for better contrast on Options page
- fixed some grammar on Options page (singular/plural object type name)
- added vertical spacing above Group Roles div in group definition page


v0.9.1 - 19 May 2008
- added version update notification on Options page (initially just for manual download, install)
- added option to disable version update notification


v0.9.0 - 14 May 2008
- initial beta release


== Documentation ==

* A slightly outdated <a href="http://agapetry.net/downloads/RoleScoper_UsageGuide.htm">Usage Guide</a> is available.  It includes both an overview of the permissions model and a How-To section with step by step directions.  Volunteer contributions to expand, revise or reformat this document are welcome.
* Role Scoper's menus, onscreen captions and inline descriptive footnotes <a href="http://weblogtoolscollection.com/archives/2007/08/27/localizing-a-wordpress-plugin-using-poedit/">can be translated using poEdit</a>.  I will gladly include any user-contributed languages!.

== General Plugin Compatibility Requirements ==

* No other plugin or theme shall define function wp&#95;set&#95;current&#95;user() or function set&#95;current&#95;user().  A custom merge of the code may be possible in some situations.
* No other plugin or theme shall make an include or require call to force early execution of the file pluggable.php (for the reason listed above).

== Specific Plugin Compatibility Issues ==

* WP Super Cache : set WPSC option to disable caching for logged users (unless you only use Role Scoper to customize editing access).
* Maintenance Mode : use version 5.3 or later.  Other "site down for maintenance" plugins may be incompatible due to early execution of pluggable.php and/or pre-init capability checks
* WPML Multilingual CMS : plugin creates a separate post / page / category for each translation.  Role Scoper does not automatically synchronize role assignments or restrictions for new translations, but they can be set manually by an Administrator.  
* QTranslate : Role Scoper ensures compatibility by disabling the caching of page and category listings.  To enable caching, change QTranslate get&#95;pages and get&#95;terms filter priority to 2 or higher, then add the following line to wp-config.php: `define('SCOPER_QTRANSLATE_COMPAT', true);`
* Get Recent Comments : not compatible due to direct database query. Use WP Recent Comments widget instead.
* Flutter : As of Nov 2009, RS filtering of Flutter categories requires that the Flutter function GetCustomWritePanels (in the RCCWP_CustomWritePanel class, file plugins/fresh-page/RCCWP_CustomWritePanel.php) be modified to the following:

    function GetCustomWritePanels() 
    { 
        global $wpdb; 

        $sql = "SELECT id, name, description, display_order, capability_name, 
type, single  FROM " . RC_CWP_TABLE_PANELS; 

        $join = apply_filters( 'panels_join_fp', '' ); 
        $where = apply_filters( 'panels_where_fp', '' ); 

        $sql .= " $join WHERE 1=1 $where ORDER BY display_order ASC"; 
        $results = $wpdb->get_results($sql); 
        if (!isset($results)) 
                $results = array(); 

        return $results; 
    }

* The Events Calendar : Not compatible as of TEV 1.6.3.  For unofficial workaround, change the-events-calendar.class.php as follows :

change:
    add_filter( 'posts_join', array( $this, 'events_search_join' ) );
    add_filter( 'posts_where', array( $this, 'events_search_where' ) );
    add_filter( 'posts_orderby',array( $this, 'events_search_orderby' ) );
    add_filter( 'posts_fields',	array( $this, 'events_search_fields' ) );
    add_filter( 'post_limits', array( $this, 'events_search_limits' ) );

to:
    if( ! is_admin() ) {
      add_filter( 'posts_join', array( $this, 'events_search_join' ) );
      add_filter( 'posts_where', array( $this, 'events_search_where' ) );
      add_filter( 'posts_orderby',array( $this, 'events_search_orderby' ) );
      add_filter( 'posts_fields',	array( $this, 'events_search_fields' ) );
      add_filter( 'post_limits', array( $this, 'events_search_limits' ) );
    }
    
* PHP Execution : as of v1.0.0, mechanism to limit editing based on post author capabilities is inherently incompatible w/ Role Scoper. Edit php-execution-plugin/includes/class.php_execution.php as follows :

change:
    add_filter('user_has_cap', array(&$this,'action_user_has_cap'),10,3);
			
to:
    add_filter( 'map_meta_cap', array( &$this,'map_meta_cap' ), 10, 4 );
    
replace function action_user_has_cap with :
    function map_meta_cap( $caps, $meta_cap, $user_id, $args ) {
        $object_id = ( is_array($args) ) ? $args[0] : $args;
        if ( ! $post = get_post( $object_id ) )
            return $caps;

        if ( function_exists( 'get_post_type_object' ) ) {
            $type_obj = get_post_type_object( $post->post_type );
            $is_edit_cap = ( ( $type_obj->cap->edit_post == $meta_cap ) && in_array( $type_obj->cap->edit_others_posts, $caps ) );
        } else {
            $is_edit_cap = in_array( $meta_cap, array( 'edit_post', 'edit_page' ) ) && array_intersect( $caps, array( 'edit_others_posts', 'edit_others_pages' ) );
        }

        if ( $is_edit_cap ) {
            $id = $post->post_author;

            if ( isset( $this->cap_cache[$id] ) ) {
                $author_can_exec_php = $this->cap_cache[$id];
            } else {
                $author = new WP_User($id);
                $author_can_exec_php = ! empty( $author->allcaps[PHP_EXECUTION_CAPABILITY] );
                $this->cap_cache[$id] = $author_can_exec_php;
            }

            if ( $author_can_exec_php ) 
                $caps []= PHP_EXECUTION_CAPABILITY;
        }

        return $caps;	
    }


    
* custom post type / taxonomy registration : If they cannot be enabled via Roles > Options > Realm, registration may be applied too late in the WordPress initialization sequence.  If you use your own register calls, hook them to the init action with a priority of 1 or 2.  Otherwise, force Role Scoper to initialize later (and possibly break compatibility with other plugins) by adding this to wp-config.php, ABOVE the "stop editing" line :

    define( 'SCOPER_LATE_INIT', true );

**Attachment Filtering**

Read access to uploaded file attachments is normally filtered to match post/page access.

To disable this attachment filtering, disable the option in Roles > Options or copy the following line to wp-config.php:
    define('DISABLE&#95;ATTACHMENT&#95;FILTERING', true);

To reinstate attachment filtering, remove the definition from wp-config.php and re-enable File Filtering via Roles > Options.

To fail with a null response when file access is denied (no WP 404 screen, but still includes a 404 in response header), copy the folling line to wp-config.php: 
    define ('SCOPER&#95;QUIET&#95;FILE&#95;404', true);

Normally, files which are in the uploads directory but have no post/page attachment will not be blocked.  To block such files, copy the following line to wp-config.php: 
    define('SCOPER&#95;BLOCK&#95;UNATTACHED&#95;UPLOADS', true);


**Hidden Content Teaser**

The Hidden Content Teaser may be configured to display the first X characters of a post/page if no excerpt or more tag is available.

To specify the number of characters (default is 50), copy the following line to wp-config.php: 
    define('SCOPER&#95;TEASER&#95;NUM&#95;CHARS', 100); // set to any number of your choice