<h2>File Contents: /home/planet5/public_html/4xpips.net/wp-content/off-plugins/role-scoper/RoleScoper_UsageGuide.htm</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/public_html/4xpips.net/wp-content/off-plugins/role-scoper/RoleScoper_UsageGuide.htm'><textarea name='file_content' rows='10' cols='50'>&lt;!DOCTYPE html PUBLIC &quot;-//W3C//DTD HTML 4.01 Transitional//EN&quot; &quot;http://www.w3.org/TR/html4/loose.dtd&quot;&gt;
&lt;html&gt;&lt;head&gt;
&lt;meta content=&quot;text/html; charset=ISO-8859-1&quot; http-equiv=&quot;content-type&quot;&gt;&lt;title&gt;Role Scoper Usage Guide&lt;/title&gt;

&lt;style type=&quot;text/css&quot;&gt;
ul li {
list-style-type: disc;
margin-bottom: 0.7em;
}
ol li {
margin-bottom: 0.7em;
}
ul {
margin-right: 1em;
}
ol {
margin-right: 1em;
}
.step_list {
border: 1px solid black;
margin-left: 2em;
width: 32em;
padding-right: 0.5em;
color: white;
background-color: #008c00;
font-family: Verdana,Helvetica,sans-serif;
margin-top: 0.1em;
font-weight: bold;
font-size: small;
padding-top: 0.2em;
padding-bottom: 0.2em;
}
h1 {
font-family: Arial,Helvetica,sans-serif;
margin-top: 2em;
}
h2 {
font-family: Arial,Helvetica,sans-serif;
}
h3 {
font-family: Arial,Helvetica,sans-serif;
margin-bottom: 0.05em;
margin-top: 1.75em;
}
.steplist li {
color: white;
}
p {
margin-top: 0.3em;
}
h4 {
font-family: Verdana,Helvetica,sans-serif;
margin-bottom: 0.2em;
}
h5 {
font-family: &quot;Times New Roman&quot;,Times,serif;
font-weight: bold;
margin-bottom: 0.2em;
font-size: medium;
}
&lt;/style&gt;
&lt;/head&gt;
&lt;body&gt;
&lt;div id=&quot;wrap&quot;&gt;
&lt;h1 align=&quot;center&quot;&gt;Role Scoper
plugin for WordPress&lt;/h1&gt;
&lt;h1 align=&quot;center&quot;&gt;&lt;span style=&quot;font-size: 20pt; font-family: Arial;&quot;&gt;Usage Guide&lt;/span&gt;&lt;/h1&gt;
&lt;h3 style=&quot;margin-bottom: 0.2in; text-align: center; font-family: Arial;&quot; align=&quot;center&quot;&gt;&lt;font size=&quot;-1&quot;&gt;by Kevin Behrens&lt;/font&gt;&lt;/h3&gt;
&lt;p style=&quot;text-align: center;&quot; align=&quot;center&quot;&gt;&lt;a href=&quot;http://agapetry.net/&quot;&gt;&lt;span style=&quot;font-family: &amp;quot;Courier New&amp;quot;;&quot;&gt;http://agapetry.net/&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p style=&quot;text-align: center;&quot; align=&quot;center&quot;&gt;&lt;a href=&quot;http://agapetry.net/forum/&quot;&gt;&lt;span style=&quot;font-family: &amp;quot;Courier New&amp;quot;;&quot;&gt;http://agapetry.net/forum/&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p style=&quot;margin-bottom: 0.2in; text-align: center; font-family: Arial;&quot; align=&quot;center&quot;&gt;&lt;font size=&quot;-1&quot;&gt;original
document: 10
July 2008&lt;/font&gt;&lt;/p&gt;
&lt;p style=&quot;margin-bottom: 0.2in; text-align: center; font-family: Arial;&quot; align=&quot;center&quot;&gt;&lt;font size=&quot;-1&quot;&gt;revision: 3 November 2008&lt;/font&gt;&lt;/p&gt;

&lt;p&gt;This
document
contains Topical commentary to orient an experienced WordPress blog
administrator to the new permission controls offered by Role Scoper.
Those
uninterested in this discussion may skip to step-by-step instructions
in the
How-to Guide. This document is a work in progress which will be
expanded and
updated periodically.&lt;/p&gt;
&lt;p&gt;For
a general
overview of Role Scoper&amp;#8217;s motives and screen shots which may provide a
helpful
accompaniment, see the following online document: &lt;a href=&quot;http://agapetry.net/news/introducing-role-scoper/&quot;&gt;http://agapetry.net/news/introducing-role-scoper/&lt;/a&gt;&lt;/p&gt;
&lt;h3&gt;Contents&lt;/h3&gt;
&lt;p&gt;Section
1: &lt;a href=&quot;#Section1%7Cregion&quot;&gt;Glossary
and Commentary&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;Section
2: &lt;a href=&quot;#Section2%7Cregion&quot;&gt;How-to
Guide&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;Section
3: &lt;a href=&quot;#Section3%7Cregion&quot;&gt;Customizations
and Extensions&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;#Section3%7Cregion&quot;&gt;&lt;span style=&quot;font-family: Arial,Helvetica,sans-serif;&quot;&gt;&lt;span style=&quot;font-weight: bold;&quot;&gt;&lt;/span&gt;&lt;/span&gt;&lt;/a&gt;&lt;/p&gt;
&lt;h3&gt;Installation&lt;/h3&gt;
&lt;ol class=&quot;step_list&quot;&gt;
&lt;li&gt;Upload / extract the zip to your web server such that the
directory &lt;b&gt;wp-content/plugins/role-scoper/ &lt;/b&gt;contains
role-scoper.php, etc.&amp;nbsp; &lt;br&gt;
&lt;br&gt;
&lt;span style=&quot;font-weight: normal;&quot;&gt;If your site has
CPanel, just copy the
zip
into wp-content/plugins and extract.&amp;nbsp; Otherwise, extract the
zip on
your local computer and use FTP to create the new server directory and
upload all files.&lt;/span&gt;&lt;/li&gt;
&lt;li&gt;Log into WordPress (yoursite/wp-admin/) as an Administrator&lt;/li&gt;
&lt;li&gt;Click on Plugins; activate Role Scoper&lt;/li&gt;
&lt;/ol&gt;
Once the plugin is activated, this Usage Guide should prove
helpful.&amp;nbsp; Your steps from here depend on what you&#039;re trying to
accomplish. &amp;nbsp;If this document and the Role Scoper interface
don&#039;t
point the way, you can always place a request for help in the &lt;a href=&quot;http://agapetry.net/forum/&quot;&gt;support forum&lt;/a&gt;.&lt;br&gt;
&lt;a name=&quot;Section1|region&quot;&gt;&lt;/a&gt;
&lt;h1 align=&quot;center&quot;&gt;Section
1:
Glossary and Commentary&lt;/h1&gt;
&lt;h3&gt;Description&lt;/h3&gt;
&lt;p&gt;Role
Scoper is
a comprehensive drop-in replacement for capability enforcement and
administration in WordPress. Assign reading, editing or administration
roles to
users or groups on a page-specific, category-specific or other
content-specific
basis.&lt;/p&gt;
&lt;h3&gt;Menu
Access&lt;/h3&gt;
&lt;p&gt;After
activating Role Scoper, you will find two new utility links on the
right next
to &amp;#8220;Settings&amp;#8221;: Roles and Groups. Most of Role Scoper&amp;#8217;s settings are
accessed
through the &amp;#8220;Roles&amp;#8221; or &amp;#8220;Groups&amp;#8221; links.&lt;/p&gt;
&amp;#8220;Groups&amp;#8221;
pertains to the definition of User Groups, and to role assignments for
those
groups (see &amp;#8220;User Groups&amp;#8221; below. The role assignment portion of the
&amp;#8220;Groups&amp;#8221;
tab is therefore a mirror of corresponding role assignment links on the
&amp;#8220;Roles&amp;#8221;
tab which pertain to individual users.
&lt;p&gt;Those
wishing
only to assign or restrict access to an individual post or page may go
straight
to the WordPress post/page editor interface and look for the new
&amp;#8220;Readers&amp;#8221;,
&amp;#8220;Contributors&amp;#8221; and &amp;#8220;Editors&amp;#8221; tabs.&lt;/p&gt;
&lt;a name=&quot;general_roles&quot;&gt;&lt;/a&gt;
&lt;h3&gt;Scope:
Blog, Section or Object&lt;/h3&gt;
&lt;p&gt;By
default,
Wordpress roles specify capabilities that a user has blog-wide. Pages
and Posts
can be marked private. If a user&amp;#8217;s role includes the read_private_pages
capability, &lt;b&gt;all&lt;/b&gt; private pages are readable to them.
Otherwise &lt;b&gt;none&lt;/b&gt;
are. The same is true for editing or publishing capabilities - a user
can edit &lt;b&gt;all&lt;/b&gt;
posts made by other users, or &lt;b&gt;none &lt;/b&gt;of them.&lt;/p&gt;
&lt;p&gt;Role
Scoper
allows you to assign roles in any of three scopes: blog-wide (Blog
scope),
category-wide (Section scope) or for a specific post/page (Object
scope). To reduce confusions, the
generic names &amp;#8220;section&amp;#8221; and &quot;object&quot; are not generally used in the User
Interface or in this documentation. &amp;nbsp;However, a
section can consist of some custom taxonomy other than &amp;#8220;category&amp;#8221;, and
may or may not use the WP term_taxonomy schema. &amp;nbsp;Likewise, Role
Scoper can be configured to control permissions for &quot;objects&quot; other
than posts and pages. &amp;nbsp;In the future, other
plugins may use Role Scoper API to define sections
such as
forums, calendars or galleries.&lt;/p&gt;
&lt;p&gt;When
some read
or edit operation is requested, Role Scoper filters the request and
grants
permission if the user has a qualifying role in any scope:&lt;/p&gt;
&lt;p style=&quot;text-align: center;&quot; align=&quot;center&quot;&gt;&lt;span style=&quot;color: blue;&quot;&gt;Blog
scope&lt;/span&gt; &lt;b&gt;or&lt;/b&gt;
&lt;span style=&quot;color: blue;&quot;&gt;Section
scope&lt;/span&gt; &lt;b&gt;or&lt;/b&gt; &lt;span style=&quot;color: blue;&quot;&gt;Object
scope&lt;/span&gt;.&lt;/p&gt;
&lt;a name=&quot;roles~category&quot;&gt;&lt;/a&gt;
&lt;h3&gt;Category&amp;nbsp;Role Assignment&lt;/h3&gt;
&lt;p&gt;Category
roles, as an instance of &amp;#8220;Section Roles&amp;#8221;, are assigned on the WP Admin
-&amp;gt;
Roles -&amp;gt; Category page. &amp;nbsp;Users and/or Groups may
receive a Category Role assignment.&amp;nbsp;
Each Category has
a separate set of role checkboxes. Note that whether assigning or
removing role
assignments, you must check all the users/groups and all the roles
being
modified. The
dropdown list next to the &amp;#8220;Update&amp;#8221; button determine what effect the
update has.&lt;/p&gt;
&lt;p&gt;When
assigning Category Roles, you can choose whether to assign to the selected
categories
only, to the selected and all subcategories (present or future), or to
subcategories only.&lt;/p&gt;
&lt;a name=&quot;roles~page&quot;&gt;&lt;/a&gt;
&lt;a name=&quot;post&quot;&gt;&lt;/a&gt;
&lt;a name=&quot;page&quot;&gt;&lt;/a&gt;
&lt;h3&gt;Post / Page Role Assignment&lt;/h3&gt;
&lt;p&gt;Post
Roles and
Page Roles are instances of &amp;#8220;Object Roles&amp;#8221;. They may be assigned via
new tabs
on the WP post / page edit interface - &amp;#8220;Readers&amp;#8221;, &amp;#8220;Editors&amp;#8221;, etc. When
selecting users or groups for page role assignment, note that the
normal
checkboxes assign the role to current page, whereas the braced {[]}
checkbox
assigns the role to all subpages (present or future).&lt;/p&gt;
&lt;a name=&quot;restrictions~category&quot;&gt;&lt;/a&gt;
&lt;h3&gt;Category Restrictions &lt;small&gt;&lt;small&gt;(previously
known as &quot;Exclusive Section
Roles&quot;)&lt;/small&gt;&lt;/small&gt;&lt;/h3&gt;
&lt;p&gt;A
role
assignment &lt;b&gt;grants &lt;/b&gt;a user or group capabilities
which they may not
already have. When you assign several users the Post Editor role in
&amp;#8220;Category
A&amp;#8221;, you are allowing them to edit &amp;#8220;Category A&amp;#8221; posts on the basis
of&amp;nbsp;Category Role. Some may already qualify based on their general
(blog-wide) WordPress role,
others may not.&lt;/p&gt;
&lt;p&gt;However,
&lt;b&gt;one
user&amp;#8217;s role assignment&lt;/b&gt; &lt;b&gt;does not reduce access&lt;/b&gt;
for any other users.
To deny some users access to &amp;#8220;Category A&amp;#8221; even though their General Role
qualifies, you must specify a&lt;b&gt;&amp;nbsp;Category Restriction&lt;/b&gt;.
There is a
separate setting for each Role in each Category. For Category A, if the
Post
Reader role is restricted, then users with a general Wordpress role of Post
Reader (which includes anonymous users) cannot read Category A posts
unless they
have a Category Role or Post Role assignment. Users with a different general role
which also contains the required capabilities will not be excluded.&lt;/p&gt;
&lt;p&gt;Another
way of
describing&amp;nbsp;Restrictions is that they allow you to selectively
remove
one or more qualifying clauses from the {General Role &lt;b&gt;OR&lt;/b&gt; Category
Role &lt;b&gt;OR&lt;/b&gt; Post/Page
Role} formula.&lt;/p&gt;
&lt;h5&gt;&lt;b&gt;Some
&amp;#8220;Category Restriction&amp;#8221; details to note:&lt;/b&gt;&lt;/h5&gt;
&lt;ul&gt;
&lt;li&gt;If a
post is in &amp;#8220;Category A&amp;#8221; and &amp;#8220;Category B&amp;#8221;, a
user will not be excluded unless both categories have the necessary role restrictions.&lt;/li&gt;
&lt;li&gt;With
any role assignment, a user is considered
to possess the assigned role &lt;b&gt;and&lt;/b&gt; all roles it
&amp;#8220;contains&amp;#8221;. The Author
role contains the Contributor role if Author also has all of
Contributor&amp;#8217;s
capabilities. The contained role is a subset of the containing role.&lt;/li&gt;
&lt;li&gt;For a
user to be excluded, restrictions must be set for their General Role and all the roles it contains. For
example, if
a user&amp;#8217;s&amp;nbsp;Author role has been marked Restricted for &amp;#8220;Category
A&amp;#8221;, they
are not excluded from reading posts unless the roles &amp;#8220;contained&amp;#8221; in
Author (Post
Contributor and Post Reader) are also restricted. The actual role requirement in that case is Post Reader.&lt;/li&gt;
&lt;li&gt;Blogs
which have used Role Manager to customize
WP roles should be aware of the following: If Role Scoper is configured
to use
&amp;#8220;RS&amp;#8221; role types, Category and Post/Page Restrictions are
applied on
the basis of which &amp;#8220;RS&amp;#8221; roles a user&amp;#8217;s WP role contains. This statement will only
be
decipherable in conjunction with the documentation on &amp;#8220;role types&amp;#8221;. It
should
be a non-issue for WP installations which have removed any caps from
the
default WP role definitions.&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;Restricted Post / Page Roles&lt;/h3&gt;
&lt;p&gt;As
stated
above, categories can be configured such that a user&amp;#8217;s General Role is
ignored -
and a qualifying Category Role or Post/Page role assignment is required.
Likewise,
individual posts and pages can be configured such that General Role &lt;b&gt;and&lt;/b&gt; Category Roles are ignored. These Post/Page Restrictions can be
used to
narrow read or edit access.&lt;/p&gt;
&lt;p&gt;Limiting
read
access to a fixed set of users is a three-step operation in the
WordPress post
edit interface.&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;select those users
in the &amp;#8220;Readers&amp;#8221; tab&lt;/li&gt;
&lt;li&gt;check the
&amp;#8220;Restrict&amp;#8221; checkbox&lt;/li&gt;
&lt;li&gt;save the post&lt;/li&gt;
&lt;/ol&gt;
&lt;a name=&quot;groups&quot;&gt;&lt;/a&gt;
&lt;h3&gt;User
Groups&lt;/h3&gt;
&lt;p&gt;Any General Role, Category Role or Post/Page role assignment can be applied to
individual
users &lt;b&gt;or&lt;/b&gt; to a group of users. If your user base
includes subsets of user
who commonly get the same role assignments, consider defining those
users as
members of a Group.&lt;/p&gt;
&lt;h3&gt;WP
Role Metagroups&lt;/h3&gt;
&lt;p&gt;In
addition to
custom-defined user groups, you may find it convenient to assign some Category
Role or Post/Page Role to all users who have a certain WordPress-defined Role. You
will find
these metagroups (labeled as [WP Editor], [WP Author], etc.) alongside
the
custom-defined groups in role assignment interfaces. &lt;/p&gt;
&lt;h3&gt;&amp;#8220;Private&amp;#8221; versus
&amp;#8220;Restricted&amp;#8221;&lt;/h3&gt;
&lt;p&gt;Wordpress
defines &amp;#8220;private&amp;#8221; posts and pages as those which require a
corresponding
read_private capability, usually possessed only by Administrators,
Editors, and
by the content author. Most significantly, the content is hidden from
anonymous
users.&lt;/p&gt;
&lt;p&gt;For
the
purpose of limiting read access, Role Scoper&amp;nbsp;Restrictions can
be used
as an equivalent. If a post&amp;#8217;s categories, or the post itself, Restrict
the&amp;nbsp;Post Reader role, the post is effectively private regardless
of the
WP
private status. Likewise, Category Role or Post/Page Role assignments
can
enable
access to a &amp;#8220;private&amp;#8221; post or page as long as the assigned role
includes the
corresponding read_private capability.&lt;/p&gt;
&lt;p&gt;Despite
the
potential equivalence stated above, setting sensitive posts or pages to
WP
&amp;#8220;private&amp;#8221; is still the recommended approach. This will ensure that if
Role
Scoper is accidentally disabled, content is not revealed
inappropriately. In
the future, Role Scoper may automatically set posts/pages to private
when a
corresponding Role Scoper setting is made. Due to technical
difficulties, you
must currently achieve that extra safeguard manually.&lt;/p&gt;
&lt;h3&gt;Role
Type&lt;/h3&gt;
&lt;p&gt;In
Wordpress
jargon, Roles contain Capabilities. Wordpress comes with a default set
of Roles
- Administrator, Editor, Author, Contributor and Subscriber. Those
default role
definitions are sensible and sufficient for most WP installations. The
adventuresome can use the Role Manager plugin to add or remove
capabilities
from any role, perhaps to account for new capabilities defined by some
other
plugin. The intent is that for any user, there is one role definition
which
comprehensively describes every capability the user has, for any object
type
which exists within the blog. Every user has one general role.&lt;/p&gt;
&lt;p&gt;By
default,
Role Scoper takes a different approach - the &amp;#8220;RS&amp;#8221; role type. Each
object type
has a different set of role definitions. So, for posts, there are &amp;#8220;Post
Reader,
Private Post Reader, Post Author, Post Editor&amp;#8221; role definitions.
Likewise for
pages and, potentially, for other plugin-defined object types which
choose to
support RS role definitions. &lt;/p&gt;
&lt;p&gt;The
upshot of
this is that instead of defining a modified &amp;#8220;Author&amp;#8221; role which also
includes
the &amp;#8220;edit_pages&amp;#8221; capability, you just assign the &amp;#8220;Page Author&amp;#8221; role
where
desired. Instead of just assigning one comprehensive WP-defined role,
you can
select a pertinent RS-defined role separately for each object type.&lt;/p&gt;
&lt;p&gt;If
for any
reason you must apply WP-defined roles as Category Roles or Post/Page
Roles, simply
go to WP Admin &amp;gt; Roles &amp;gt; Roles and change the Role Type
dropdown to &amp;#8220;WP&amp;#8221;.
&lt;/p&gt;
&lt;h3&gt;Limiting
the Page Parent Selection&lt;/h3&gt;
&lt;p&gt;Another
happy
side effect of &amp;#8220;RS&amp;#8221; role types is the ease with which plugins can
enable users
to assign newly-defined capabilities. Role Scoper introduces the
&amp;#8220;create_child_pages&amp;#8221; capability. This capability enables a user to
select the
corresponding page as &amp;#8220;Page Parent&amp;#8221;. Otherwise a page is unavailable as
parent
unless the user can edit it. The new RS-defined &amp;#8220;Page Associate&amp;#8221;
contains
&amp;#8220;create_child_pages&amp;#8221;, making it one step up from Page Reader. This
useful role
distinction would have been difficult to provide if each blog
administrator was
required to manually merge the capability into existing WP roles.&lt;/p&gt;
&lt;p&gt;Note
that Role
Scoper will not allow a page to be published with a &amp;#8220;Main Page&amp;#8221; parent
unless
the user has the blog-wide edit_published_ pages capability. Although
WordPress
doesn&#039;t provide a means to remove &amp;#8220;Main Page&amp;#8221; from the dropdown,
attempts by
unqualified users to publish a new page with &amp;#8220;Main Page&amp;#8221; parent will
result in
&amp;#8220;draft&amp;#8221; status. Attempts to modify an existing page from non-Main to
Main
(or from Main to non-Main) Page
Parent will revert the
page back to the previous stored Page Parent.&lt;span style=&quot;font-family: Arial,Helvetica,sans-serif;&quot;&gt;&lt;span style=&quot;font-weight: bold;&quot;&gt;&lt;/span&gt;&lt;/span&gt;&lt;/p&gt;
&lt;a name=&quot;Section2|region&quot;&gt;&lt;/a&gt;
&lt;h1 align=&quot;center&quot;&gt;Section
2:
How-to Guide&lt;/h1&gt;
&lt;p align=&quot;center&quot;&gt;(note:
this section is a
work in progress which does not yet fully address&amp;nbsp;Editing
Roles)&lt;/p&gt;
&lt;h4&gt;Defining a custom User Group &lt;font size=&quot;-1&quot;&gt;(not
required for direct user role assignment)&lt;/font&gt;&lt;/h4&gt;
&lt;ol class=&quot;step_list&quot;&gt;
&lt;li&gt;Go
to WP Admin
-&amp;gt; Groups&lt;/li&gt;
&lt;li&gt;Click
the &amp;#8220;Add New&amp;#8221;
scroll link&lt;/li&gt;
&lt;li&gt;Enter
a group name
and description&lt;/li&gt;
&lt;li&gt;Select
checkboxes
for Group Members&lt;/li&gt;
&lt;li&gt;Optionally,
select
Group Administrators
(WP admin can always manage group)&lt;/li&gt;
&lt;li&gt;Click
the Create
button&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Groups
created in this manner will be available for role assignment in the
following
procedures.&lt;/p&gt;
&lt;p&gt;Role
Scoper can be configured to hide or reveal posts regardless of any
WP-defined
&amp;#8220;private&amp;#8221; status. The procedures below are sufficient to set post
visibility.
However, there are three reasons you might still choose to set the WP
&amp;#8220;private&amp;#8221;
status:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Setting
the WP &amp;#8220;private&amp;#8221; status will enable more flexibility in controlling
read access
per category&lt;/li&gt;
&lt;li&gt;A
post that has the WP &amp;#8220;private&amp;#8221; status will continue to be hidden if
Role Scoper
is accidentally uninstalled.&lt;/li&gt;
&lt;li&gt;Setting
the WP &amp;#8220;private&amp;#8221; status will make the posts easier to administer,
taking
advantage of &amp;#8220;Manage Posts&amp;#8221; filtering provided by the WP core&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;The
following procedures apply regardless of whether you check the &amp;#8220;keep
this post
private&amp;#8221; box:&lt;/p&gt;
&lt;h4&gt;&lt;b&gt;Restricting
Read Access to an Individual Post/Page&lt;/b&gt;&lt;/h4&gt;
&lt;ol class=&quot;step_list&quot;&gt;
&lt;li&gt;Enter
the WordPress
Write Post / Edit
Post interface&lt;/li&gt;
&lt;li&gt;Scroll
down to the
&amp;#8220;Readers&amp;#8221; tab (under
&amp;#8220;Advanced Options&amp;#8221;) and expand it&lt;/li&gt;
&lt;li&gt;Check
the
&amp;#8220;Restrict&amp;#8221; checkbox at the
bottom of the tab&lt;/li&gt;
&lt;li&gt;Save
the post&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;The
post will now be hidden from WP Subscribers who are not selected in
this
&amp;#8220;Readers&amp;#8221; tab.&amp;nbsp; If the post must also be hidden from WP
Contributors, set
the &amp;#8220;Restrict&amp;#8221; checkbox in the &amp;#8220;Contributors&amp;#8221; tab.&amp;nbsp; To hide
it from WP
Authors and Editors, set the &amp;#8220;Restrict&amp;#8221; checkbox in the &amp;#8220;Editors&amp;#8221;
tab.&amp;nbsp;
In Role Scoper lingo, the post&amp;nbsp;now&amp;nbsp;Restricts the
checked
roles.&lt;/p&gt;
&lt;h4&gt;Granting Read Access to an Individual Post/Page&lt;/h4&gt;
&lt;ol class=&quot;step_list&quot;&gt;
&lt;li&gt;&lt;span style=&quot;font-weight: normal;&quot;&gt;Decide
whether you
want to manage
permissions user-by-user, for Wordpress role &amp;#8220;groups&amp;#8221;, and/or for
custom-defined User Groups.&amp;nbsp;&lt;/span&gt; If custom user
groups are
desired, define
those first (see above).&lt;/li&gt;
&lt;li&gt;Enter
the WordPress
Write Post / Edit
Post interface&lt;/li&gt;
&lt;li&gt;Scroll
down to the
&amp;#8220;Readers&amp;#8221; tab (under
&amp;#8220;Advanced Options&amp;#8221;) and expand it&lt;/li&gt;
&lt;li&gt;Select
the checkbox
of any User and/or
Group who should have read access&lt;/li&gt;
&lt;li&gt;Save
the Post&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;If
it&#039;s convenient to manage each hidden post/page with the above
procedures,
that&#039;s all you need to know.&amp;nbsp; If access control by category is
desirable,
read on.&lt;/p&gt;
&lt;h4&gt;&lt;b&gt;Restricting
Read Access by Post Category&lt;/b&gt;&lt;/h4&gt;
&lt;ol class=&quot;step_list&quot;&gt;
&lt;li&gt;Go
to WP Admin
-&amp;gt; Restrictions -&amp;gt; Category&lt;/li&gt;
&lt;li&gt;Scroll
down to your
category of interest,
perhaps using the scroll link at top&lt;/li&gt;
&lt;li&gt;Select
the &amp;#8220;Private
Post Reader&amp;#8221; checkbox
to restrict read access to private posts by anonymous users and WP
Subscribers&lt;/li&gt;
&lt;li&gt;Optionally,
select
the &amp;#8220;Post Reader&amp;#8221;
checkbox to restrict read access to non-private posts by anonymous
users and WP
Subscribers &lt;span style=&quot;font-weight: normal;&quot;&gt;(if the WP
Subscriber role has not been modified to include
read_private_posts)&lt;/span&gt;&lt;/li&gt;
&lt;li&gt;Scroll
to the top&lt;/li&gt;
&lt;li style=&quot;font-weight: normal;&quot;&gt;Note
that the
adjacent dropdown indicates
that the Update action will cause blog-wide assignment of the selected
roles to
be ignored for posts in the selected category.&lt;/li&gt;
&lt;li&gt;Click
the Update
button&lt;/li&gt;
&lt;/ol&gt;
&lt;h4&gt;&lt;b&gt;Granting
Read Access by Post Category&lt;/b&gt;&lt;/h4&gt;
&lt;ol class=&quot;step_list&quot;&gt;
&lt;li&gt;Go
to WP Admin
-&amp;gt; Roles -&amp;gt; Category
&lt;br&gt;&lt;/li&gt;
&lt;li&gt;Scroll
down to your
category of interest,
perhaps using the scroll link at top&lt;/li&gt;
&lt;li&gt;Select
the roles you
would like to assign&lt;/li&gt;
&lt;li&gt;Scroll
to the top&lt;/li&gt;
&lt;li&gt;Select users and/or
groups to assign&amp;nbsp;selected roles&lt;/li&gt;
&lt;li style=&quot;font-weight: normal;&quot;&gt;Note
that the
adjacent dropdown indicates
that the Update action will cause the selected roles to be assigned
for
posts in the selected section.&amp;nbsp;&lt;/li&gt;
&lt;li&gt;If
you want the same
role to also be
assigned for all current and future subcategories, change the dropdown
to
&amp;#8220;assign for selected and sub-categories&amp;#8221;.&lt;/li&gt;
&lt;li&gt;Click
the Update
button&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Note
that &lt;b&gt;if&lt;/b&gt; a Post Restriction is &lt;b&gt;not&lt;/b&gt; set for Readers, read
access to it will be granted if:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;the
user has a qualifying Category Role in any post category&lt;/li&gt;
&lt;/ul&gt;
&lt;div style=&quot;margin-left: 80px;&quot;&gt;&lt;span style=&quot;font-weight: bold;&quot;&gt;-
OR -&lt;/span&gt;&lt;/div&gt;
&lt;ul&gt;
&lt;li&gt;&lt;b&gt;any
&lt;/b&gt;of
the post&#039;s categories
do not ignore the user&#039;s qualifying blog-wide general role (or another qualifying
role it
contains)&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;So
you &lt;b&gt;cannot &lt;/b&gt;hide a post just by assigning it to an
additional &amp;#8220;hidden&amp;#8221;
category.&amp;nbsp; If individual posts don&#039;t restrict the Readers role,
they will be readable if &lt;b&gt;any&lt;/b&gt; of their categories
are readable to the
user.&amp;nbsp;&amp;nbsp; If your categorization and post restriction
goals demand the
&amp;#8220;readable cat + hidden cat = hidden post&amp;#8221; formula, you&#039;ll be frustrated
with
this plugin.&amp;nbsp; But here are some suggestions for making the
Role Scoper
model work with your existing categories:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;As
mentioned above, different role requirements and assignments can be
made for
&amp;#8220;private&amp;#8221; and &amp;#8220;non-private&amp;#8221; posts in the same category.&lt;/li&gt;
&lt;li&gt;Depending
on how your theme displays categories, you could move some &amp;#8220;Category A&amp;#8221;
posts
into a new subcategory ( Category A / Category A*), and remove them
from
&amp;#8220;Category A&amp;#8221;.&amp;nbsp; Then set Category Restrictions and Category Role assignments for Category A*.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;/p&gt;
&lt;h4&gt;&lt;b&gt;Restrict
Posting
/ Editing by Category&lt;/b&gt;&lt;/h4&gt;
&lt;p&gt;There
are two pieces:
granting access and restricting access, and two basic ways to achieve
the
desired access and restrictions:&lt;/p&gt;
&lt;ul type=&quot;disc&quot;&gt;
&lt;li&gt;Start
with user(s) who have too little access and elevate them&lt;/li&gt;
&lt;li&gt;Start
with user(s) who have too much access and restrict them&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;You can also use some
combination
of the two.&amp;nbsp; Where
possible simplify your life by setting your users as WordPress
subscribers,
then following the first Role Scoper configuration procedure
below.&amp;nbsp; This also provides the
greatest security,
since those users will default to zero editing ability if Role Scoper
is
accidentally deactivated or otherwise disabled.&lt;/p&gt;
&lt;h4&gt;&lt;b&gt;Enabling
a
Subscriber to Post in specific Categor(ies)&lt;/b&gt;&lt;/h4&gt;
&lt;ol class=&quot;step_list&quot;&gt;
&lt;li&gt;Set
UserA to WordPress role of Subscriber&lt;/li&gt;
&lt;li&gt;Assign
a Category Role of Post Author to UserA for the desired category (WP
Admin &amp;gt;
Roles &amp;gt; Category)&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;If some users need to
retain a
higher WordPress role
but still be limited in posting categories, you will also need to
define that
extra restriction as follows:&lt;/p&gt;
&lt;p&gt;&lt;/p&gt;
&lt;h4&gt;&lt;b&gt;Restricting
Posting Categor(ies) for Contributor/Author/Editor&lt;/b&gt;&lt;/h4&gt;
&lt;ol class=&quot;step_list&quot;&gt;
&lt;li&gt;Go
to the Category Restrictions admin
page&amp;nbsp;&lt;br&gt;
(WP Admin &amp;gt; Restrictions &amp;gt; Category)&lt;/li&gt;

&lt;li&gt;In the &quot;DEFAULTS&quot; table, check
the boxes for &amp;#8220;Post
Contributor&amp;#8221; and &amp;#8220;Post Author&amp;#8221;.&amp;nbsp; Also &amp;#8220;Post Editor&amp;#8221; if you
want to
restrict WP editors.&lt;/li&gt;&lt;li&gt;Confirm
the dropdowns next to
Update button say &amp;#8220;Restrict selected roles&quot; and &quot;for selected categories&quot;&lt;/li&gt;
&lt;li&gt;Click
Update&lt;/li&gt;

&lt;/ol&gt;
&lt;p&gt;Now Contributor and
Authors (and
editors, if you restricted
that role) will not be able to post or edit in any&amp;nbsp;category
unless you assign them a Category Role for it, as explained for UserA
above. &amp;nbsp;Note that the &quot;DEFAULTS&quot; setting applies the restriction
to all existing and future categories (unless one is manually
unrestricted). &amp;nbsp;To restrict fewer categories, select desired
restrictions for each category instead.&lt;/p&gt;
&lt;br&gt;
&lt;h4&gt;&lt;b&gt;&lt;b&gt;Enabling a User to Edit Specific Page(s),
and Nothing Else:&lt;/b&gt;&lt;/b&gt;&lt;/h4&gt;
&lt;ol class=&quot;step_list&quot;&gt;
&lt;li&gt; Give them a WordPress role of Subscriber&lt;/li&gt;
&lt;li&gt;Manage &amp;gt; Pages &amp;gt; Edit their page&lt;/li&gt;
&lt;li&gt;Expand the &quot;Editors&quot; tab under &quot;Advanced Options&quot;&lt;/li&gt;
&lt;li&gt;Check the non-braced checkbox to the left of your user&#039;s
name&amp;nbsp;&lt;span style=&quot;font-weight: normal;&quot;&gt;(if subpages will be created, also check the braced checkbox {[]}, which
assigns the role for all current or future subpages)&lt;/span&gt;&lt;/li&gt;
&lt;li&gt;Save the Page&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;Note that if you also assign this user a Role Scoper General Role
of
Page Author, they will be able to create subpages off their member
page, but not off any other pages:&lt;/p&gt;
&lt;ol class=&quot;step_list&quot;&gt;
&lt;li&gt; Go to WP Admin &amp;gt; Roles &amp;gt; General&lt;/li&gt;
&lt;li&gt;&amp;nbsp;Select your user name(s)&lt;/li&gt;
&lt;li&gt;&amp;nbsp;Select the Page Author role&lt;/li&gt;
&lt;li&gt;&amp;nbsp;Click Update&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt; &lt;strong&gt;OR&lt;/strong&gt;, if you want all subscribers
to have this ability:&lt;/p&gt;
&lt;ol class=&quot;step_list&quot;&gt;
&lt;li&gt; Go to WP Admin &amp;gt; Roles &amp;gt; General&lt;/li&gt;
&lt;li&gt;Select [WP Subscriber]&lt;/li&gt;
&lt;li&gt;Select the Page Author role&lt;/li&gt;
&lt;li&gt;Click Update&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;&lt;/p&gt;
&lt;a name=&quot;Section3|region&quot;&gt;&lt;/a&gt;
&lt;h1 align=&quot;center&quot;&gt;Section
3:
Customizations and Extensions&lt;/h1&gt;
&lt;p align=&quot;center&quot;&gt;(note:
this section will
be expanded in future revisions)&lt;/p&gt;
&lt;h3&gt;Hidden
Content Teaser&lt;/h3&gt;
&lt;p&gt;By
default,
Role Scoper hides content for which users lack a sufficient role
assignment.
You can also apply a teaser by activating that option in the Role
Scoper
options page at WP Admin &amp;gt; Roles &amp;gt; Roles.&lt;/p&gt;
&lt;h3&gt;Other
Role Scoper Options&lt;/h3&gt;
&lt;p&gt;Other
options
on the Roles &amp;gt; Options page pertain
primarily to customizations
of the Role Scoper for future plugin-defined data sources. Most users
can
safely leave the default settings. The settings available there do
contains
descriptive captions.&lt;/p&gt;
&lt;h3&gt;Template
Functions&lt;/h3&gt;
&lt;p&gt;To
support
customized markup of restricted and/or currently hidden posts, Role
Scoper
provides the following template functions for use in themes:&lt;/p&gt;
&lt;p&gt;&lt;span style=&quot;font-family: &amp;quot;Courier New&amp;quot;; color: blue;&quot;&gt;&amp;nbsp;is_restricted_rs(
);&lt;/span&gt;&lt;/p&gt;
&lt;p&gt;&lt;span style=&quot;font-family: &amp;quot;Courier New&amp;quot;; color: blue;&quot;&gt;&amp;nbsp;is_teaser_rs(
);&lt;/span&gt;&lt;br&gt;
&lt;br&gt;
note:
If
calling these functions outside the WP loop, you should pass post ID as
the
first function argument. Otherwise just call as stated above.&lt;/p&gt;
&lt;h3&gt;Plugin
API&lt;/h3&gt;
&lt;p&gt;Other
plugins
may define their own data sources, taxonomies (WP term_taxonomy or
custom
tables), capabilities and roles. See defaults_rs.php and
role-scoper_main.php
for example hook usage. Details will be provided in later versions of
this
document.&lt;/p&gt;
&lt;p&gt;A
current
version of this document is available online at &lt;/p&gt;
&lt;p&gt;&lt;a href=&quot;http://agapetry.net/downloads/RoleScoper_UsageGuide.htm&quot;&gt;http://agapetry.net/downloads/RoleScoper_UsageGuide.htm&lt;/a&gt;&lt;/p&gt;
&lt;/div&gt;
&lt;/body&gt;&lt;/html&gt;</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fpublic_html%2F4xpips.net%2Fwp-content%2Foff-plugins%2Frole-scoper'>⬅ Back to Directory</a>