=== Custom Access Roles ===
Contributors: room34
Donate link: http://room34.com/donation
Tags: roles, access control
Requires at least: 4.0
Tested up to: 4.5.3
Stable tag: 0.3.4
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Create custom roles with editing capability for only specific pages, categories and post types.

== Description ==

**Custom Access Roles** allows you to create, edit and delete custom roles for editing content. It was created to fill a need for a role editor plugin that is focused on providing easy-to-use admin tools for *restricting content editing access*. It is not concerned with restricting *viewing* access on the front end.

It is specifically intended for large sites with multiple content editors, where editors (by role, not individually) need to be restricted to only being able to edit specific areas of the site.

With this plugin, administrators of large sites have relatively fine-grained control over which user roles can edit which content, making it possible to manage a team of editors without concern that they will (accidentally or deliberately) edit content they should not have access to.

You can define a fully customized set of capabilities for each role, along with defining a specific set of post categories, pages, and custom post types to which those capabilities apply. For all other content, the role will have read-only access.

**Custom Access Roles** provides an easy interface for managing these roles and capabilities, with checkboxes for each capability grouped by the standard roles they're associated with, plus checkboxes for each post category, page, and custom post type, presented in an organized hierarchy.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to **Users > Custom Access Roles** to manage roles and capabilities.

== Frequently Asked Questions ==

= How do I grant access to Custom Post Types? =
If your CPT has its own capabilities, assign those capabilities to the role. Otherwise, CPTs use the same permissions as Posts. Assign `edit_posts` and all similar `edit_*_posts` capabilities. Note that this will give these users the ability to edit Posts as well, but only for the specific categories they've been given access to using this plugin. This is why "publish_posts" is not enabled by default.

== Screenshots ==

1. The first screen of the plugin admin. You can edit an existing custom role, create a new one, or delete an existing one. By default the plugin allows you to delete existing roles even if there are users assigned to them, although core WordPress roles and certain popular third-party plugin roles are restricted. You can change this by modifying a variable in the plugin source code. A future update will allow admins to change this setting without modifying code.

2. The screen where role capabilities and content access are set. Pages and Categories are listed in hierarchical order, with checkboxes to select which ones for which the role will have the assigned capabilities. For all others, the role will have read-only access.

3. You can find the settings for the plugin under **Custom Access Roles** in the **Users** menu.

== Changelog ==

= 0.3.4 =
* Added banner image for WordPress Plugin Directory.
* Modified plugin description for clarity of purpose.

= 0.3.3 =
* Added PHPDoc-format comments to all class methods.

= 0.3.2 =
* Original version.

== Upgrade Notice ==

= 0.3.4 =
Improved descriptive information in WordPress Plugin Directory.

= 0.3.3 =
Initial release in WordPress Plugin Directory.