=== Plugin Name === Contributors: justinticktock Tags: multisite, roles, user, help, notes, cms, documents, groups, teams, collaboration, BuddyPress Requires at least: 3.5 Tested up to: 3.8 Stable tag: 1.2.4 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Help Notes/Posts private to assigned users of a wordpress role. == Description == Do you want to give users a private area to share information based on a role they have been assigned? ...this plugin allows you to quickly create a custom post type for user roles. This allows users, with a specific role, the ability to create and edit their own 'help notes' providing a private set of notes for use. It can be used for anything else that fits with that role (e.g. creating minutes-of-meetings notes etc...). To add new roles to the basic wordpress roles (Administrator, Editor, Subscriber ..etc) you will need to use another plugin refer to [Roles_and_Capabilities](http://codex.wordpress.org/Roles_and_Capabilities#Resources) and Resources.. Plugins. You can then use one of these plugins (e.g. [User Role Editor](http://wordpress.org/extend/plugins/user-role-editor/ "User Role Editor")) to allocate users to multiple roles. So if you want to quickly give a group a private area to share and post ideas/notes .. 1. Create a new role. 2. Add users to the role. 3. Enable the Help Notes from the settings. A global 'General Help Notes' type is also available which is not tided to a specific role, this has the same access/capabilities as the standard wordpress 'post' type for read/write access. There is a widget available to list all users with access to the current Help Note type on display. The user display_name is shown and can be selected by each user within their own profile. Extensions: If you select the options for extending functionality through other plugins the following are selectable for ease of installing.. * [Simple Page Ordering](http://wordpress.org/plugins/simple-page-ordering/) for easing re-ordering of Help Notes. * [Simple FootNotes](http://wordpress.org/plugins/simple-footnotes/) by [Andrew Nacin](http://profiles.wordpress.org/nacin/) to add a footnote shortcode [ref][/ref]. * [Email Post Changes](http://wordpress.org/plugins/email-post-changes/) for emailing out changes to a Help Note as they occur. * [post_type_switcher](http://wordpress.org/plugins/post-type-switcher/) useful to change the role associated with a Help Note after it has been created. * [Post type archive in menu](http://wordpress.org/plugins/post-type-archive-in-menu/) plugin by [lpeharda](http://profiles.wordpress.org/lpeharda/) to add 'Help Notes' archives to your menus. [Plugin site](http://justinandco.com/plugins/role-based-help-notes/). [GitHub page](http://github.com/justinticktock/role-based-help-notes). == Installation == 1. Upload `plugin-name.php` to the `/wp-content/plugins/` directory 2. Activate the plugin through the 'Plugins' menu in WordPress 3. Goto the "Settings" Menu and "Help Notes" sub menu, select which roles are to have Help Notes. == Frequently Asked Questions == = I have a new role how can I add it? = You will need to use another plugin to manage roles and capabilities such as the [User Role Editor](http://wordpress.org/extend/plugins/user-role-editor/ "User Role Editor") plugin. = Is there a theme template I can modify in my child theme? = Yes ... [Answer](http://wordpress.org/support/topic/is-there-a-theme-template-i-can-modify-in-my-child-theme?replies=3#post-4929519) == Screenshots == 1. The Settings Screen. 2. A front end example Help Note for a user with the 'Proof Reader' role, also showing the user widget listing all proof readers. 3. Dashboard showing Help Notes at WordPress 3.8 4. The 'Appearance..Widgets' Admin screen using the 'Help Note Users' widget with the 'twenty fourteen' theme sidebar 5. The 'twenty fourteen' theme showing the Contents page for a user with 'Proof Reader' role access. == Changelog == = 1.2.4 = * 2014-01-02 * Fixed widget and contents page for Roles with more than 18 characters. * New feature: Added the suggested plugin extension ["post_type_switcher"](http://wordpress.org/plugins/post-type-switcher/) * New feature: Unused capabilities are now removed on deselecting a Help Notes Role rather than waiting until the plugin is uninstalled. * New feature: Made ready for translation. * New feature: Added `rbhn_dashicon` filter. = 1.2.3 = * 2013-12-18 * removed the 'tgmpa_register' hook after use in-case other plugins/themes have also used tgmpa_register. * Re-ordered the 'Plugin Extensions' in order of suggested value. * Cleaned code by use of 'clean_post_type_name()' * Added dashicon support for WordPress 3.8+ * Added the suggested plugin extension ["email_post_changes"](http://wordpress.org/plugins/email-post-changes/) = 1.2.2 = * 2013-11-22 * New feature: Added `rbhn_author_url` filter. * New feature: BuddyPress & BuddyDrive Compatibility added to the 'user widget'; user links now go to the BP public user profile when `BP_ENABLE_ROOT_PROFILES` has been defined. * Fix for hijacking secondary queries for author. = 1.2.1 = * 2013-11-18 * Added Settings link to the admin active plugin listing * Added Widget to allow sidebars to list all users with access to read/edit a Help Note type. * Code re-factoring = 1.2.01 = * 2013-11-11 * Fix for where no Contents Page is defined (thanks to [Vernon Fowler](http://wordpress.org/support/profile/vernonfowler)) * Grammatical corrections. = 1.2.0 = * 2013-11-04 * Added new setting to enable/disable the 'General Help Notes'. * Added the Plugin Extension for Simple Page Ordering. = 1.1.0 = * 2013-10-21 * Added new setting to select a page for a Help Notes Contents to be listed. * Added the Plugin Extension for Simple FootNotes by [Andrew Nacin](http://profiles.wordpress.org/nacin/) * Fixed settings listing order to alphanumeric. * Fixed php warnings. = 1.01 = * Added Capabilities for Administrator. * capability naming now match post_type name * Help notes now at the top admin level, this is a workround to the non-admins not being able to create new posts when the post type is beneath a menu page. = 1.0 = * Release into the wild. == Upgrade Notice == = 1.2.4 = You may see a few php warnings if you are in debug mode while the option structure is updated but nothing after that. = 1.2.0 = The 'General Help Notes' are now selectable and initially not-selected, if you wish to continue to use the 'General Help Notes' go to settings and make the selection. = 1.01 = * uninstall 1.0 completely to clean up capabilities before installing 1.01.