Everybody who had the uninstall function in their Plugin, doesn’t have to change a lot. For everybody who likes to know, you can find the function for uninstall in wp-admin/includes/plugin.php

1. is_uninstallable_plugin($plugin)
2. uninstall_plugin($plugin)

and the associated hook wp-includes/plugin.php

1. register_uninstall_hook($file, $callback)

You can use two possibilities to add the additional function.

1. A file with the name uninstall.php has to be in the Plugin.
2. A hook for uninstall register_uninstall_hook has to talk to.

Up to Version 2.7 you were also able to delete the data from the database, but only if you deactivated the Plugin (Hook register_deactivation_hook()) or with help of a formular.

To use also other versions of WordPress, I suggest to use the constant WP_UNINSTALL_PLUGIN, because this one exists in version 2.7. Alternative you can use the hook register_uninstall_hook(), since this one is necessary to function via hook. Both possibles are listed in the following examples.

The following function for example should be in the Plugin and deleting the entry example from the database table options.

/**
 * Delete options in database
 */
function example_deinstall() {
 
	delete_option('example');
}

via Data uninstall.php

Easiest possibility is to create the file unistall.php with according entries to delete data in the table options.

delete_option('example');

To avoid an error in older WordPress versions, I recommend to use a constant. Isn’t there a constant defined, it will just stop in this example.

if ( !defined('WP_UNINSTALL_PLUGIN') ) {
    exit();
}
delete_option('example');

via hook register_uninstall_hook()

Alternatively you can register the deinstallation via hook, so that you are not depend on the file and you can use a easier possibility to integrate an uninstallation in your Plugin. For that you can use the hook register_uninstall_hook().

 /**
 * Check for hook
 */
if ( function_exists('register_uninstall_hook') )
	register_uninstall_hook(__FILE__, 'example_deinstall');
 
 /**
 * Delete options in database
 */
function example_deinstall() {
 
	delete_option('example');
}

The possibility, to delete Plugins directly in your backend, certainly makes it easier for the user to get rid off unused data. But for that, the Plugin authors have to support this feature and the table options certainly will be thankful for that.

Related posts:

• WordPress FTP Data With Constant
• Use WordPress Cron
• Use WordPress Cache
• Embed WordPress Functions Outside WordPress
• Exclude A Category From Turn Off Comments Automatically

Thanks for subscribing our feed! Sponsor the WP Engineer Blog and get your brand in front of several hundred users per day!
© WP Engineer Team, All rights reserved (Digital Fingerprint: WPEngineer-be0254ce2b4972feb4b9cb72034a092d)