Filters for the Plugin Dependencies API.

Filters

wp_plugin_dependencies_slug

Filters a dependency slug before validation against WordPress.org slug format.

apply_filters( 'wp_plugin_dependencies_slug', string $slug )

Returns: Modified slug string.

Since: 6.5.0

Context: Applied during read_dependencies_from_plugin_headers() before slug format validation.

Use Cases

Switch Between Free and Premium Slugs

add_filter( 'wp_plugin_dependencies_slug', function( $slug ) {
    // Map premium slug to free version for dependency checks
    $premium_to_free = array(
        'woocommerce-pro' => 'woocommerce',
        'acf-pro'         => 'advanced-custom-fields',
    );
    
    return $premium_to_free[ $slug ] ?? $slug;
} );

Normalize Slug Variations

add_filter( 'wp_plugin_dependencies_slug', function( $slug ) {
    // Handle common slug variations
    $normalized = array(
        'woo'  => 'woocommerce',
        'wp-seo' => 'wordpress-seo',
    );
    
    return $normalized[ $slug ] ?? $slug;
} );

Custom Plugin Repository Support

add_filter( 'wp_plugin_dependencies_slug', function( $slug ) {
    // Strip custom prefix for internal plugins
    if ( str_starts_with( $slug, 'internal-' ) ) {
        return substr( $slug, 9 );
    }
    return $slug;
} );

Transients

The Plugin Dependencies API uses these transients for caching:

Clearing Cache:

// Force refresh of all dependency data
delete_site_transient( 'wp_plugin_dependencies_plugin_data' );

// Force refresh for specific plugin
delete_site_transient( 'wp_plugin_dependencies_plugin_timeout_woocommerce' );