Custom Capabilities - How??

[leewillis77]

I have a plugin that offers certain bits of functionality. For most sites this should be restricted to only some users.

Currently, my plugin limits the functionality to administrators using:

if (current_user_can('manage_options')) {

Ideally I'd like to leave this as a default (It works for most people). However I'd really like to have a custom capability so that people can assign this to users (Or roles) that they want to be able to use the functionality.

I've read a few articles, but none of them really seem to explain this.

Currently, I'm thinking of using something like this:

if (current_user_can('manage_options') || current_use_can('do_my_plugin_stuff') ) {

So that the standard case works, but also people would be able to assign the capability 'do_my_plugin_stuff' to roles they want to be able to do stuff.

Is that it? Do I need to register the capability as well? How do people actually assign this capability - do they need to use something like the "Role Manager" plugin?

[Jeffro]

I would take a look at http://wordpress.org/extend/plugins/members/ because I think it enables you to create news roles and assign them.

[leewillis77]

Thanks - I'll take a look...

[greenshady]

You can also apply filters to this to allow it to be changed:

 current_user_can( apply_filters( 'my_plugin_capability_check', 'manage_options' ) ) 
  

Or, you can set a custom capability to the administrator role on the plugin activation hook and just a check like:

 current_user_can( 'do_cool_stuff' ) 
  

Users would still need a plugin like "Members" to assign this cap to others though.

[leewillis77]

Perfect, tested out some of these with the members plugin and everything works just great!

Thanks for all the advice everyone!