User Role Editor

Version 3.5 is available. Click the Download button below if you wish to try it.

Take a look at the “User Role Editor” plugin main form screenshot:

• Select a role you wish to change from the drop down list at the top. Page will be refreshed automatically and show you the capabilities list for the selected role. Make your corrections, check/uncheck correspondent check boxes and click “Update” button to save your changes. If you wish to apply this change for all sites of your multi-site WordPress network, turn on “Apply to All Sites” check box at the top of the form.
• If you prefer to see capabilities names in form e.g. ‘Edit pages’ instead of WordPress ‘edit_pages’ standard form turn on the “Show capabilities in human readable form” checkbox at the right top corner of the main form. Move mouse over capability name and you will see its alternative form name.
• According to WordPress Codex User Levels were introduced in WordPress 1.5, they were replaced by Roles and Capabilities in WordPress 2.0, and were finaly deprecated in WordPress 3.0. Thus you can hide them in order they do not mess you in your work with roles. Keep “Show deprecated capabilities” check box at the to right corner of the form unchecked for that. If for any reason you need to see user levels, turn on that check box.
• If you don’t wish to save changes you can click “Cancel” button.
• If you are needed to restore roles capabilities you have before 1st visit “User Role Editor” main form, use “Reset” button.
  When you you open this form 1st time, plugin checks if backup copy of roles and capabilities exists. If it doesn’t, plugin creates backup copy automatically. Thus, when you some day click the Reset button plugin uses the previously saved role data backup copy to restore it. Be very careful with this operation as you will definitely lose any changes you or your plugins made to user roles from that time.

In order to add/remove your custom role, change default role for new user, add/remove custom user capability use “User Role Editor” management boxes, look on screenshot below:

• If you need your own custom role, create it with “Add New Role” feature. Input new role name into input text field at “Add New Role” box, select existing role from drop-down list if you wish to use its capabilities as starting point for further work and click “Add” button. Remember that you can use latin letters, digits and an “_” underscore sign in your role names. Subscriber role is copied by default if you don’t select such role yourself.
• Unnecessary self-made role can be deleted with “Delete Role” box. Select role and click “Delete” button for it. Only your self-made roles appears in the role list to delete. If some of your own roles is assigne to the user or selected as default role for new users it will not be appeared in the list for deletion.
• Select the role which you wish to use as default for any new created user from the list at “Default Role for New User” box. Click “Change” button to save your changes.
• Use “Add New Capability” box in order to add new user capability. Remember you can use only latin alphabet letters, digits and underscore sign in the capability name. How to use new added user capability? Turn it on in the role you select and check if current user has such capability in your plugin or active theme functions.php file. For example,

   if (!current_user_can('some_capability_you_added')) {
     echo "You don't have permission for it!";
     return;
  }

• If you need delete custom capability added by you or some of your old plugins, which you don’t use anymore use “Delete Capability” box. “User Role Editor” doesn’t allow to delete built-in WordPress capabilities.

With help of “User Role Editor” you can assign additional capabilities directly to the users. Open users list by click on the “All Users” link at the “Users” submenu. Find needed user, move mouse pointer to his name and click “Capabilities” link as on screenshot below:

At the form opened you can assign to user another role and/or add to him capabilities which not included to his role:

You can not turn off capabilities included to the role assigned to this user. You can add/remove other capabilities. They will be applied directly to the user as you click the “Update” button. If you wish to built a fully custom capabilities set for this user, without limitation of any role, select “No role for this site” from drop-down list at the top and make it.

For more information about WordPress user roles please read these articles
- WordPress Admin Menu Permissions;
- WordPress user capabilities;
- activate_plugins WordPress user capability;
- edit_dashboard WordPress user capability;
- Delete posts and pages WordPress user capabilities set;
- moderate_comments WordPress user capability;
- Roles and Capabilities article at codex.wordpress.org;

Translations

• Persian: Parsa, Good Life
• Russian: ShinePHP;
• Spanish: Dario Ferrer;
• Swedish: Christer Dahlbacka, Andréas Lundgren.

Русская версия этой статьи доступна по адресу ru.shinephp.com

All other translations listed below are outdated and need to be updated. It’s very simple to get link to your site from this page – just update your native language translation file and send it to me. You are welcome!

• Belorussian: Marsis G.
• Brasilian Portuguese: Rafael Galdencio
• Chinese: Jackytsu
• Dutch: Rémi Bruggeman
• Finnish: Lauri Merisaari
• French: Whiler
• German: Peter
• Hebrew: Sagive
• Italian: Umberto Sartori, Talksina, Alessandro Mariani, Tristano Ajmone
• Japanese: Technolog.jp
• Polish: TagSite
• Turkish: Muhammed YILDIRIM, Sadri Ercan, Can KAYA

Dear plugin User,
if you wish to help me with this plugin translation I very appreciate it. Please contact me via Contact form and I will answer you by email. Do not forget include your site link in order I can show it with greetings for the translation help at shinephp.com, plugin settings page and in this readme.txt file. If you have better translation for some phrases send it to me. You are welcome!
Former translators! Please check your translations and provide the updated files corresponding to the current version of URE plugin.

Special Thanks to

• Lorenzo Nicoletti – for the code enhancement suggestion CUSTOM_USER_META_TABLE constant is used now for more compatibility with core WordPress API.
• Marcin – For the code enhancement. This contribution allows to not lose new custom capability if it is added to other than ‘Administrator’ role.
• FullThrottle – for the code to hide administrator role at admin backend.

You are welcome! Help me with bugs catching, share with me new ideas about plugin further development and link to your site will appear above.

People who donated for this plugin developement

• To The Nines Web Agency
• Miami
• quintain
• PriMoThemes.com / WebSharks, Inc.
• Eastwood

Change Log

• 3.5 = 19.02.2012
  - User Role Editor could be available now for single site administrators (Administrator role) under multi-site environment. You should define URE_ENABLE_SIMPLE_ADMIN_FOR_MULTISITE constant in your blog wp-config.php file for that. Insert this line

   define('URE_ENABLE_SIMPLE_ADMIN_FOR_MULTISITE', 1);

  there, if you decide to give single site admin such opportunity.
  - One of “User Role Editor” users with 1100+ sites in the multi-site network reported that URE doesn’t update roles for all sites, but stalls somewhere in the middle. Other network update method is realized as alternative. Due to my tests it works approximately 30 times faster. If you met the same problem, try it. It will be great if you share your experience with me. In order select alternative method of all sites update add this line to you blog wp-config.php file

   define('URE_MULTISITE_DIRECT_UPDATE', 1);

  But be careful. It’s recommended to make 1st try on the backup copy, not on a live site.
  - Persian translation is updated. Thanks to Parsa.

• 3.4 = 21.01.2012
  - You can see/edit “Administrator” role now. Insert this line of code

    define('URE_SHOW_ADMIN_ROLE', 1);

  into your wp-config.php file and login with administrator account for that.
  If for any reason your Administrator role missed some capabilities added by plugins or themes, you can fix that now. But be careful with changing “Administrator” role, do not turn off accidentally some critical capabilities to not block your admin users.

• 3.3.3 = 11.01.2012
  - Spanish (Dario) and Swedish (Andréas) translations update.
• 3.3.2 = 02.01.2012
  - Enhance server side validation for user input of new role name, minor bug fixes.
• 3.3.1 = 12.12.2011
  - Compatibility with Internet Explorer fix: It automatically replaced ‘&copy’ in ‘&copy_from_user_role’ URL parameter inside JavaScript code to copyright sign.So I should use other name for this parameter. Thanks to Michael Wiekenberg for the help with isolating this issue.
• 3.3 = 10.12.2011
  - New role can be created as a copy of other existing one.
  - You can hide/show deprecated capabilties (level_1 – level_10).
  - Users with “Administrator” role are not shown to other users with “list_users” capability.
  - Plugin data cleanup is added – plugin options will be automatically deleted if you delete plugin via WordPress link.
  - Some code enhancements are applied, e.g. optimization and using of WordPress API instead of self-written routine.
• 3.2.1 = 01.08.2011
  - This is a bug-fix update. If you didn’t met this bug you can skip this update. “usermeta” table doesn’t exist bug appearing on some multi-site blogs is fixed. Read [this post](http://wordpress.org/support/topic/multisite-setup-gives-usermeta-table-error) for more information. Thanks to harpinder for discovering this bug and for the help with testing updated code. “usermeta” Db table name is define by more universal way now.
• 3.2 = 25.07.2011
  - If you run multi-site WordPress network, User Role Editor will automatically duplicate all roles from the main blog (blog with mininal ID) to every new created blog.
  - Some fixes, refactoring and logic change were applied to code to enhance its productivity. There were some complaints for PHP timeout error after trying to open plugin Settings page.
  - Thanks to Grant Norwood for code fix to hide PHP warnings he met during plugin usage.
  - Hebrew translation is added. Thanks to Sagive.
  - French translation is updated. Thanks to Whiler.
  - Japan translation is updated. Thanks to Kaz.
  - Spanish translation is updated. Thanks to Dario.
• 3.1.1 = 07.07.2011
  - CUSTOM_USER_META_TABLE constant is used now for more compatibility with core WordPress API. Thanks to Lorenzo Nicoletti.
  - Turkish translation is updated. Thanks to Muhammed YILDIRIM. Other language translators are welcome!
• 3.1 = 03.06.2011
  - Add/Remove capability boxes are added to the User Role Editor
  - Capabilities could be assigned directly to the user, additionally to the assigned role
  - PHP4 is not supported by this plugin anymore. Update your site to PHP5 in order to use this plugin and near to release WordPress 3.2
  - Minor compatibility issues with other plugins were fixed

Click here to get full list of User Role Editor updates.

FAQ

- Does it work in multi-site environment?
Yes, it works with multi-site installation. By default plugin works for every blog from your multi-site network as for locally installed blog without multi-site feature.

URE Multi-site feature

- How to duplicate my custom created roles from main blog of my multi-site network to new created one?
“User Role Editor” makes it for you automatically. As new blog added to your network, “User Role Editor” copies full roles staff from your main blog to the new created one.

- Why administrators of single site of multi-site network do not see “User Role Editor” under “Users” menu?
URE is disabled for single site administrator by default. If you wish to enable it for single site adminitstrator add this line of code into your blog wp-config.php file

define('URE_ENABLE_SIMPLE_ADMIN_FOR_MULTISITE', 1);

- I have large multi-site network. After click “Update” button with “Save to all sites” checkbox turned on nothing is happened. I got the blank page.
It is PHP script execution time limit problem. Other network update method is available as alternative from version 3.5. Due to my tests it works approximately 30 times faster. Try it. It will be great, if you share your experience with me. In order select alternative method of all sites update add this line to you blog wp-config.php file

define('URE_MULTISITE_DIRECT_UPDATE', 1);

It shows execution time in milliseconds if you define WP_DEBUG equal to 1 or true constant in wp-config.php file.

- How to edit “Administrator” role? I don’t see it in the roles drop down list.
“Administrator” role is hidden from the roles drop down list by default.
You can see/edit “Administrator” role starting from version 3.4. Insert this line of code

  define('URE_SHOW_ADMIN_ROLE', 1);

into your wp-config.php file and login with administrator account for that.
If for any reason your “Administrator” role missed some capabilities added by plugins or themes, you can fix that now. But be careful with changing “Administrator” role, do not turn off accidentally some critical capabilities to not block your admin users.

- Does it work with WordPress versions prior 3.0?
Starting from version 2.2 plugin works with WordPress 3.0 and higher only. For earlier WordPress versions use plugin version 2.1.10

I am ready to answer on your questions about this plugin usage and help with possible problems. Use User Role Editor plugin forum or this page comments and site contact form for that please.

Thanks,
Vladimir ShinePHP.com

The testking offers guaranteed testking VCP-410 training with best quality testking 350-001 braindumps and testking 70-680 practice exam.

Tags: WordPress, wordpress plugin

This entry was posted on Saturday, March 20th, 2010 at 10:09 and is filed under Security, ShinePHP WordPress Plugins, WordPress, WordPress Capabilities. You can follow any responses to this entry through the RSS 2.0 feed. You can skip to the end and leave a response. Pinging is currently not allowed.