mu_menu_items

Filters available network-wide administration menu options.

Description

apply_filters( 'mu_menu_items', (array) $array ); 

Options returned to this filter are output as individual checkboxes that, when selected, enable site administrator access to the specified administration menu in certain contexts.

Adding options for specific menus here hinges on the appropriate checks and capabilities being in place in the site dashboard on the other side. For instance, when the single default option, plugins is enabled, site administrators are granted access to the Plugins screen in their individual sites' dashboards.

Parameters (1)

0. $array — Optional. (array) => array( 'plugins' => __( 'Plugins' ) )
The menu items available.

Usage

To run the hook, copy the example below.
  1. $array = apply_filters( 'mu_menu_items', $array ); 
  2.  
  3. if ( !empty( $array ) ) { 
  4.  
  5. // everything has led up to this point... 
  6.  
  7.  
The following example is for adding a hook callback.
  1. // define the mu_menu_items callback 
  2. function filter_mu_menu_items( $array ) { 
  3. // make filter magic happen here... 
  4. return $array
  5. }; 
  6.  
  7. // add the filter 
  8. add_filter( 'mu_menu_items', 'filter_mu_menu_items', 10, 1 ); 
To remove a hook callback, use the example below.
  1. // remove the filter 
  2. remove_filter( 'mu_menu_items', 'filter_mu_menu_items', 10, 1 ); 

Defined (1)

The filter is defined in the following location(s).

/wp-admin/network/settings.php  
  1. $menu_items = apply_filters( 'mu_menu_items', array( 'plugins' => __( 'Plugins' ) ) );