WordPress filter hook

priv_menu_roles

Fired by 2 WordPress plugins, running on 1,020+ sites between them.

How to use priv_menu_roles

It's a filter: your callback receives the value, and must return the (changed) value. Add this to your theme's functions.php or a small custom plugin:

functions.php
add_filter( 'priv_menu_roles', function( $role_names ) {
	// Change $role_names here.
	return $role_names;
}, 10, 1 );

Argument names come from Privilege Menu's source. Other plugins may pass different values: check the call in the plugin you're targeting below.

2 plugins that fire priv_menu_roles

Sorted by active installs. Each entry shows where the plugin calls the hook and what it passes.

  1. Privilege Menu icon Privilege Menu1,000+ installs apply_filters( 'priv_menu_roles', $wp_roles->role_names ) customWalker.php:234
  2. PBP Restricted Menu-Widget by role icon PBP Restricted Menu-Widget by role20+ installs apply_filters( 'priv_menu_roles', $wp_roles->role_names ) customWalker.php:208

Need a customisation built on this hook?

Tell us what you want to change and which plugin it's for. We'll write it, test it and send it back as a small plugin.