get_mu_plugins

Check the mu-plugins directory and retrieve all mu-plugin files with any plugin data.

Description

(array) get_mu_plugins(); 

WordPress only includes mu-plugin files in the base mu-plugins directory (wp-content/mu-plugins).

Returns (array)

Key is the mu-plugin file path and the value is an array of the mu-plugin data.

Usage

  1. if ( !function_exists( 'get_mu_plugins' ) ) { 
  2.     require_once ABSPATH . '/wp-admin/includes/plugin.php'; 
  3. } 
  4.  
  5.   
  6. // NOTICE! Understand what this does before running. 
  7. $result = get_mu_plugins(); 
  8.     

Defined (1)

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

/wp-admin/includes/plugin.php  
  1. function get_mu_plugins() { 
  2.     $wp_plugins = array(); 
  3.     // Files in wp-content/mu-plugins directory 
  4.     $plugin_files = array(); 
  5.  
  6.     if ( ! is_dir( WPMU_PLUGIN_DIR ) ) 
  7.         return $wp_plugins; 
  8.     if ( $plugins_dir = @ opendir( WPMU_PLUGIN_DIR ) ) { 
  9.         while ( ( $file = readdir( $plugins_dir ) ) !== false ) { 
  10.             if ( substr( $file, -4 ) == '.php' ) 
  11.                 $plugin_files[] = $file; 
  12.         } 
  13.     } else { 
  14.         return $wp_plugins; 
  15.     } 
  16.  
  17.     @closedir( $plugins_dir ); 
  18.  
  19.     if ( empty($plugin_files) ) 
  20.         return $wp_plugins; 
  21.  
  22.     foreach ( $plugin_files as $plugin_file ) { 
  23.         if ( !is_readable( WPMU_PLUGIN_DIR . "/$plugin_file" ) ) 
  24.             continue; 
  25.  
  26.         $plugin_data = get_plugin_data( WPMU_PLUGIN_DIR . "/$plugin_file", false, false ); //Do not apply markup/translate as it'll be cached. 
  27.  
  28.         if ( empty ( $plugin_data['Name'] ) ) 
  29.             $plugin_data['Name'] = $plugin_file; 
  30.  
  31.         $wp_plugins[ $plugin_file ] = $plugin_data; 
  32.     } 
  33.  
  34.     if ( isset( $wp_plugins['index.php'] ) && filesize( WPMU_PLUGIN_DIR . '/index.php') <= 30 ) // silence is golden 
  35.         unset( $wp_plugins['index.php'] ); 
  36.  
  37.     uasort( $wp_plugins, '_sort_uname_callback' ); 
  38.  
  39.     return $wp_plugins; 
  40. }