Function and usage of delete_plugins() in wordpress


Answers ( 1 )


    The delete_plugins() function in WordPress is a utility for removing the directory and files of one or more plugins. Here's a detailed breakdown of its usage:

    Function Signature

    delete_plugins( string[] $plugins, string $deprecated = '' ): bool|null|WP_Error


    • Purpose: This function is used to delete plugin files from the WordPress installation. It is typically used in scenarios where you want to programmatically uninstall plugins from your site.


    1. $plugins (string[] - required): This parameter is an array of plugin paths that you wish to delete. Each path should be relative to the WordPress plugins directory. For example, if your plugin directory is wp-content/plugins, and you want to delete a plugin located at wp-content/plugins/my-plugin, you would pass my-plugin/my-plugin.php in the array.

    2. $deprecated (string - optional): This is a deprecated parameter that is not used in the function. It's maintained for backward compatibility. The default value is an empty string.

    Return Values

    • bool: The function returns true if the deletion is successful.
    • null: If the function requires filesystem credentials to proceed and these are not provided, it will return null.
    • WP_Error: If the function encounters an error during the deletion process (e.g., if the specified plugin files do not exist or there are permissions issues), it returns a WP_Error object with details about the failure.

    Sample Usage

    Here's an example of how you might use delete_plugins():

    $plugins_to_delete = array( 'plugin-folder/plugin-file.php' );
    $result = delete_plugins( $plugins_to_delete );
    if ( is_wp_error( $result ) ) {
        // Handle error: display error message or take other actions.
        echo 'Error: ' . $result->get_error_message();
    } elseif ( $result === true ) {
        echo 'Plugins deleted successfully.';
    } elseif ( $result === null ) {
        // Handle the case where filesystem credentials are required.
        echo 'Filesystem credentials required to proceed.';
    } else {
        echo 'No plugins specified for deletion.';

    In this example:

    • An array $plugins_to_delete is defined with the relative path(s) to the plugin(s) you want to delete.
    • The delete_plugins() function is called with this array.
    • The return value is checked to determine whether the deletion was successful, an error occurred, or additional filesystem credentials are required.

Leave an answer