Add Custom User Capabilities Before or After the Custom User Role has Been Added?

There’s a reason why add_role() has the $capabilities as 3rd parameter.

First some insights on what happens, when you use the function.

  1. It calls WP_Roles->add_role() – the class method
  2. The method then does a check if the role already exists. If yes, it aborts.
  3. The next step is, that it adds the role to WP_Roles->roles[] array with the display_name (2nd arg) to the $wpdb->prefix . 'user_roles' option table entry (an array).

Conclusion

So if you don’t add the capabilities right when creating the role, then you save a role with empty capabilities.

A note about the Codex

NEVER EVER trust the codex. There simply is no function called add_cap(). There’re only class methods inside WP_Roles, WP_Role and WP_User that are named like this. (Will update the Codex entry if I find some time.)

Related Posts:

  1. what’s the meaning of the field wp_capabilities in table wp_usermeta
  2. How to Structure a New Role/Capability Scheme?
  3. How to allow Unfiltered HTML in a wordpress multisite install
  4. Is there a simple way to manage capabilities per user?
  5. Are User Levels Still Currently Used?
  6. Limit role to one plugin [duplicate]
  7. Roles for Custom Post Types
  8. Logout users upon login, based on caps/role?
  9. You do not have sufficient permissions to access this page on a submenu
  10. Hide custom post type by user roles
  11. Menu page with minimum capability as ‘Subscriber’ doesn’t allow ‘Admin’ to access it?
  12. Unable to access custom plugin backend
  13. How can I change my assigned user role in WordPress 3.5.1?
  14. insufficient permissions; coding an action for plugin governed by custom capability
  15. How to determine which capability to use?
  16. Allow contributor user role to perform copy operation PHP
  17. Buddy Press restrict the capability to edit users
  18. What is more secure checking capabilities of user or checking role of user in WordPress plugin development
  19. current_user_can() returning true for capability when the user and role do not have the capability
  20. Getting a List of Currently Available Roles on a WordPress Site?
  21. Editor can create any new user except administrator
  22. How do I create a custom role capability?
  23. Remove Ability for Other Users to View Administrator in User List?
  24. Send user activation email when programmatically creating user
  25. Groups of capabilities: users with multiple roles?
  26. User-edit role setting distinct from wp_capabilities? [closed]
  27. Export data as CSV in back end with proper HTTP headers
  28. Change default admin page for specific role(s)
  29. How to check username/password without signing in the user
  30. How to let contributors to create a new revision(draft) editing their published posts
  31. Disallowing Users of a Custom Role from Deleting or Adding Administrators?
  32. Disable posts, only allow to edit existing pages, not create new ones (create_posts)
  33. How to Change the Entire WordPress Admin panel Look and Feel?
  34. How to update user role without logout
  35. How to check user role without using current_user_can()
  36. WordPress Capabilities: edit_user vs edit_users
  37. WordPress REST API call generates nonce twice on every call
  38. Do not allow users to create new posts and pages
  39. \WP_User Object | What’s the Difference Between {caps} and {allcaps}?
  40. Allowing Custom Capability to Manage Plugin Options
  41. How to enable the theme editor cap for an editor role?
  42. How to assign capabilities to user NOT to User Role
  43. How to programmatically add a user to a role?
  44. Prevent user creating new users with specific roles
  45. How-to Delay The Capability To Publish Posts?
  46. How to restrict specific post types from being read or added by specific user roles (eg. author)?
  47. How to add more than 1 user role to sub-menu pages
  48. Custom user profile, registration, login page with theme
  49. How to use WP default post list tables in a plugin?
  50. Odd behaviour with submenu link creation
  51. Reapproval for edits and deletion after post is published
  52. How to add quick edit and bulk edit fields to users admin section
  53. Can I create users that have access to *some* other users posts instead of all other users posts?
  54. How to check if a role has a specific capability
  55. Set default page for user account in admin
  56. How to restrict plugin’s sub-menu pages to admin/subscribers?
  57. How to not let a user with a new role edit users that have administrator role?
  58. Execute plugin for specific user role(s) only
  59. How to remove sticky post capability for a specific user role?
  60. User role permissions based on taxonomies
  61. Generating User(s) with Settings API
  62. How can I have different groups of editors only allowed to edit certain parent+subpages?
  63. WordPress admin deleted user details not removed in database. How to delete WordPress Users from Database
  64. Print WordPress username id inside JavaScript
  65. query users by role
  66. Function Get User Object By Username?
  67. current_user_can Not Always Working Properly
  68. Check if someone is editing a post (this content is currently locked)
  69. Get User Role by ID not working
  70. Hide plugin dashboard menu item for specific roles
  71. Remove wordpress author’s capability to moderate comments on their own posts
  72. Getting users by specific capability, not role
  73. Can you set a role as author?
  74. Managing Users and Creating Groups [closed]
  75. Modify users.php page to create page/post on button clicked
  76. Subscribe to author?
  77. How to filter users list on user_status field with get_users()
  78. Frontend language per user
  79. get_posts() not working when accessing with a custom user role
  80. Display custom fields in frontside user profile
  81. Failed to Open Stream: Permission Denied While Writing to an XML File in a WordPress Plugin
  82. Applying roles to an admin sub-menu (eg Appearance -> Menus)
  83. Remove Capabilities from WP admin for specific user role
  84. Set different custom menu items for different user roles
  85. Fix permissions for users role
  86. Prevent third party plugin’s admin page access based on user type
  87. custom user role wordpress – grant guest access to edit.php without insert/update/delete
  88. Disable user from updating certain posts
  89. Add a role and give admin priviledges
  90. Where are $current_user->allcaps set?
  91. wp_dropdown_roles() to replace option value = code
  92. Create a custom capability to allow an ‘Editor’ to edit only ‘Subscriber’ users
  93. global $current_user not current user
  94. Featured image not working, because of custom user role?
  95. Display list of uploaded images, filtered by user under a specific user group
  96. What is the proper way to get logged in user id in a plugin?
  97. How do I let contributors edit their posts after being approved once?
  98. How to get a users list by who created them?
  99. How to build a fool proof AdSense revenue sharing model?
  100. How do I have now a duplicated user entry if this is not allowed (and I cannot replicate it)?

Leave a Comment

Hata!: SQLSTATE[HY000] [1045] Access denied for user 'divattrend_liink'@'localhost' (using password: YES)