Using WordPress ‘allow_subdirectory_install’ PHP filter

by

The allow_subdirectory_install WordPress filter allows you to enable or disable the subdirectory installation feature in Multisite.

Usage

add_filter('allow_subdirectory_install', function($allow) {
    // your custom code here
    return $allow;
});

Parameters

  • $allow (bool): Whether to enable the subdirectory installation feature in Multisite. Default is false.

More information

See WordPress Developer Resources: allow_subdirectory_install

Examples

Enable subdirectory installation

To enable the subdirectory installation feature in Multisite, return true.

add_filter('allow_subdirectory_install', function($allow) {
    return true;
});

Disable subdirectory installation

To disable the subdirectory installation feature in Multisite, return false.

add_filter('allow_subdirectory_install', function($allow) {
    return false;
});

Conditional subdirectory installation

Enable subdirectory installation only if a certain condition is met.

add_filter('allow_subdirectory_install', function($allow) {
    $condition = true; // Replace with your condition
    if ($condition) {
        return true;
    }
    return $allow;
});

Toggle subdirectory installation based on user role

Enable subdirectory installation only for users with the “administrator” role.

add_filter('allow_subdirectory_install', function($allow) {
    if (current_user_can('administrator')) {
        return true;
    }
    return $allow;
});

Enable subdirectory installation with custom function

Create a custom function that enables subdirectory installation and use it with the filter.

function custom_enable_subdir_install($allow) {
    return true;
}
add_filter('allow_subdirectory_install', 'custom_enable_subdir_install');