User role capability numbers not specified anywhere

The numbers are deprecated.

Use current_user_can instead, and check for manage_network to spot the super admin.

We’re using version 3.5 (which my original post conveniently didn’t specify even though I selected it from the drop-down), the code I inherited uses the number 1, and the codex doesn’t specify what to use instead. ‘Super Admin’?

I don’t understand what you mean by use current_user_can instead of a capability number for the add_options_page function call… that doesn’t seem to apply here. I need to know what exactly I can put in for the capability parameter on the add_options_page, and the WordPress codex and the code is not telling me.

This is the code I inherited:

add_action(‘admin_menu’, ‘new_admin_actions’);

function new_admin_actions() {
add_options_page(‘new_admin’, ‘new_admin’, 1, ‘new_admin’, ‘new_admin’);
}

Okay where you have 1 should be a capability NOT a role

If you want it to be SuperAdmin only, I would use the capability ‘manage_network’ ??

add_action('admin_menu', 'new_admin_actions');

function new_admin_actions() {
    add_options_page('new_admin', 'new_admin', 'manage_network', 'new_admin', 'new_admin');
}

See how that goes?

Right, I know it’s supposed to be a capability, that’s what it says in WordPress’ source code comments for that function; I don’t know why it was a 1, I didn’t code it, I just want to know what values I can put there, and I’m not sure why ‘manage_network’ would be adequate for that when there’s a zillion capabilities and 5 for Super Admin… what if I wanted other capabilities for that option page? What I’m saying is the explanations for this in the code and the codex aren’t clear and I’m trying to make sense of them.

and I’m not sure why ‘manage_network’ would be adequate for that when there’s a zillion capabilities and 5 for Super Admin.

All you need to do is pick ONE of the 5 for super-admin if you want to limit it to super admin ?? That’s it! It’s really that easy.

A 1 would mean a contributor, so you’d pick edit_posts or delete_posts