User Role Editor

Version 3.6.1 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 before press “Update”.
• 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;
- delete_plugins WordPress user capability;
- moderate_comments WordPress user capability;
- Roles and Capabilities article at codex.wordpress.org;

Translations

• Dutch: Frank Groeneveld
• French: Presse et Multimedia

, Whiler

• Hebrew: Aryo Digital
• Italian: Tristano Ajmone, Umberto Sartori
• Lithuanian: Vincent G
• Persian: Parsa
• Russian: ShinePHP
• Spanish: Victor Ricardo Díaz, Dario Ferrer;
• Swedish: Christer Dahlbacka, Andréas Lundgren.
• Turkish: Muhammed YILDIRIM

Русская версия этой статьи доступна по адресу 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
• Finnish: Lauri Merisaari
• German: Peter
• Japanese: Technolog.jp
• Polish: TagSite

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.6.1 = 07.05.2012
  - Italian translation is updated. Thanks to Tristano Ajmone.
• 3.6 = 30.04.2012
  - CSS and page layout fix for compatibility with WordPress 3.4.
  - WordPress multi-site: when new blog created default role setting is copied for it from the main blog default role value now.
  - Minor translations files updates, e.g synchronizing them with plugin source code, Russian roles names in plugin are identical to those WordPress uses itself now, etc.
• 3.5.4 = 04.04.2012
  - Lithuanian translation is added, thanks to Vincent G.
  - Spanish translation is updated, thanks to Victor Ricardo Díaz.
• 3.5.3 = 24.03.2012
  - French translation is updated, thanks to Presse et Multimedia.
  - Hebrew translation is updated, thanks to Aryo Digital.
  - Persian translation is updated, thanks to Parsa.
  - Minor CSS fix to provide compatibility with RTL languages.
• 3.5.2 = 17.03.2012
  - Turkish translation is updated, thanks to Muhammed YILDIRIM.
  - Dutch translation is updated, thanks to Frank Groeneveld.
• 3.5.1 = 24.02.2012
  - Bugs for multi-site WordPress network installation were discovered and fixed:
  1) blocked login to admin back-end;
  2) empty users list for administrators of single sites;
  3) empty authors drop down list at the post editor page.
  - If URE plugin is not enabled for single site administrator, then URE is automatically excluded from plugins list available to that administrator.
• 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.

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 to select alternative method of all sites update add this line to you blog wp-config.php file

define('URE_MULTISITE_DIRECT_UPDATE', 1);

It does nothing automatically, just select other algorithm when you press “Update” with “Apply to All Sites” checkbox turned on next time.
If you define WP_DEBUG equal to 1 or true constant in wp-config.php file, URE with this directive shows update execution time in milliseconds as additional technical information.

- 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.