wp_get_active_and_valid_plugins()WP 3.0.0

Retrieve an array of active and valid plugin files.

While upgrading or installing WordPress, no plugins are returned.

The default directory is wp-content/plugins. To change the default directory manually, define WP_PLUGIN_DIR and WP_PLUGIN_URL in wp-config.php.

Internal function — this function is designed to be used by the kernel itself. It is not recommended to use this function in your code.

No Hooks.

Return

String[]. Array of paths to plugin files relative to the plugins directory.

Usage

wp_get_active_and_valid_plugins();

Examples

0

#1 An example of how the function works

$list = wp_get_active_and_valid_plugins();

print_r( $list );

/*
Array (
	[0] => F:\server\www\example.com/wp-content/plugins/query-monitor/query-monitor.php
	[1] => F:\server\www\example.com/wp-content/plugins/advanced-custom-fields-pro/acf.php
	[2] => F:\server\www\example.com/wp-content/plugins/akismet/akismet.php
	[3] => F:\server\www\example.com/wp-content/plugins/crypto-currencies-live-charts/crypto-currencies-live-charts.php
	[4] => F:\server\www\example.com/wp-content/plugins/cryptocurrency-reviews/cryptocurrency-reviews.php
	[5] => F:\server\www\example.com/wp-content/plugins/cyr3lat/cyr-to-lat.php
	[6] => F:\server\www\example.com/wp-content/plugins/democracy-poll/democracy.php
	[7] => F:\server\www\example.com/wp-content/plugins/font-awesome-4-menus/n9m-font-awesome-4.php
	[8] => F:\server\www\example.com/wp-content/plugins/image-watermark/image-watermark.php
	[9] => F:\server\www\example.com/wp-content/plugins/luckywp-scripts-control/luckywp-scripts-control.php
	[10] => F:\server\www\example.com/wp-content/plugins/profunctions/profunctions.php
	[11] => F:\server\www\example.com/wp-content/plugins/tablepress/tablepress.php
	[12] => F:\server\www\example.com/wp-content/plugins/widget-logic/widget_logic.php
	[13] => F:\server\www\example.com/wp-content/plugins/wp-subscribe/wp-subscribe.php
)
*/

Changelog

Since 3.0.0 Introduced.

wp_get_active_and_valid_plugins() code WP 6.5.3

function wp_get_active_and_valid_plugins() {
	$plugins        = array();
	$active_plugins = (array) get_option( 'active_plugins', array() );

	// Check for hacks file if the option is enabled.
	if ( get_option( 'hack_file' ) && file_exists( ABSPATH . 'my-hacks.php' ) ) {
		_deprecated_file( 'my-hacks.php', '1.5.0' );
		array_unshift( $plugins, ABSPATH . 'my-hacks.php' );
	}

	if ( empty( $active_plugins ) || wp_installing() ) {
		return $plugins;
	}

	$network_plugins = is_multisite() ? wp_get_active_network_plugins() : false;

	foreach ( $active_plugins as $plugin ) {
		if ( ! validate_file( $plugin )                     // $plugin must validate as file.
			&& str_ends_with( $plugin, '.php' )             // $plugin must end with '.php'.
			&& file_exists( WP_PLUGIN_DIR . '/' . $plugin ) // $plugin must exist.
			// Not already included as a network plugin.
			&& ( ! $network_plugins || ! in_array( WP_PLUGIN_DIR . '/' . $plugin, $network_plugins, true ) )
		) {
			$plugins[] = WP_PLUGIN_DIR . '/' . $plugin;
		}
	}

	/*
	 * Remove plugins from the list of active plugins when we're on an endpoint
	 * that should be protected against WSODs and the plugin is paused.
	 */
	if ( wp_is_recovery_mode() ) {
		$plugins = wp_skip_paused_plugins( $plugins );
	}

	return $plugins;
}